FILEFIX v6.50 - Sept. 29, 1994 ------------------------------ FILEFIX is a utility that converts an executable file output by the ALN linker (.COF or .ABS files) into separate files containing the raw data for the TEXT and DATA sections of the program, and a symbol table containing the symbol information for the program, and an RDBJAG script file for loading it all into the ALPINE board of a Jaguar Development System. FILEFIX also has an option for writing out ROM image files. These files are 2mb or 4mb in length and consist of the program's text segment and data segment, with the rest of the file set to zero bytes. There are also some other new options. See the information below. Usage: ------ filefix [options] = A DRI or BSD/COFF format absolute-position executable file. A filename extension of .COF or .ABS is assumed if none is given. (i.e. "FILEFIX testprog\" will look for , then , then , before giving up. Options ------- -q = Quiet mode, don't print information about executable file. -r = Create ROM image file named from executable -rs = Same as -r, except also create DB script to load and run file. -p = Pad ROM file with zero bytes to next 2mb boundary. (this must be used along with the -r or -rs switch) -p4 = Same as -p, except pads to a 4mb boundary (this must be used along with the -r or -rs switch) Examples: --------- filefix program This example finds 'program', 'program.cof', or 'program.abs' Creates program.txt, program.dta, program.db, and program.sym (if the file is not a COFF-format file) filefix program.abs Finds program.abs, creates same files as previous example. filefix -rs program.rom -p -q program Finds 'program', 'program.cof', or 'program.abs. Creates a ROM image file named PROGRAM.ROM, pads the size to 2mb boundary, and prints only minimal information to screen. Some developers have wondered why FILEFIX is needed, since RDBJAG can read .ABS & .COF files directly. Perhaps the most important reason is that when you want to build a Jaguar ROM or EPROM cartridge from your program, you need access to the raw data that cooresponds to what will become the ROM image of the cartridge. FILEFIX makes this very easy and convenient. FILEFIX also creates a symbol file that has been sorted and had duplicates removed. When you send a program to Atari that may end up becoming a cartridge (like an early version of a game), please use FILEFIX and send the resulting files rather than sending an ABS file (or in addition to sending an ABS file). CHANGES ------- Sept. 29, 1994 -------------- Filefix now supports a number of new command line options, primarily related to the new capability of writing out ROM image files. See the list of command line switches for more information. July 20, 1994 ------------- FILEFIX still does not output a .SYM symbol file when the source file is a COFF-format executable, but this new version now adds a command to the output script file to make the debugger load symbols from the original executable file. This does not provide everything the separate .SYM file does, but it should cover most situations. (The difference is that the symbol table in a .SYM file is sorted and has had duplicate symbols deleted.) Also, there was a bug in the PC version of FILEFIX which caused RDBJAG/WDB to print an error message when you did a GETSYM command on one of the .SYM files it created. (The error message would be either "Out of Memory" or "This file was created by a buggy version of FILEFIX".) This has been fixed. June 28, 1994 ------------- There was a bug fixed that would cause FILEFIX to create DTA and TXT files that were zero bytes long if the data section and/or text section was empty, rather than simply not creating the files in the first place. As of this version, when a section is empty the files are not created and the references to them are left out of the debugger script file that is output. The tools now use a default filename extension of .COF for BSD/COFF format executables, and FILEFIX has been updated to support this. Now FILEFIX will first look for the filename exactly as specified on the commandline. If that file is not found, and no extension was specified, then it will try for .COF and .ABS in that order. If the filename specified did have an extension, then an error message is displayed and the program aborts with an error code. May 13, 1994 ------------ The FILEFIX utility has been updated to work with the new BSD/COFF file format used by GCC, MADMAC, and ALN. Please Note: when reading BSD/COFF files, FILEFIX will not output a symbol file, and the RDBJAG script file it outputs will not reference the symbol file.