makerel

Description

makerel is a tool for games that use the relocatable module system. This tool has the following two purposes:

1. Makes valid function lists from partially linked file lists.

If you supply a list of partially linked files (PLFs) as arguments, makerel generates a list of functions that must not be dead stripped.

% makerel partial-link-file.preplf ...

The list of functions is saved in a file called import.lst.

2. Generates relocatable module and module name string table files.

If you supply as arguments a PLF list and a file name of an ELF file in the static portion of the program, makerel generates relocatable module files (.rel) and the module name string table file (.str).

% makerel exec-type-file.elf partial-link-file.plf ...

The generated relocatable module files (.rel) must be copied to the Game Disc. The module name string table file must also be copied to the Game Disc to use the program debugger. The runtime debug monitor references the module name string table file for locating the original PLFs residing in the host disc drive.

Using the Library

%  makerel [-W] files [@response]

The optional response file can contain the list of PLF and ELF file names if the command prompt environment does not allow a large number of module names in its command line argument. The number sign (#), together with all characters following it until the next line, will be ignored in the response file. A backslash (\) is the escape text character. The text character immediately following the backslash is escaped.

The optional -W command line option lets makerel detect external symbols defined in multiple modules and displays warning messages for those symbols.

Location

$REVOLUTION_SDK_ROOT/X86/bin/makerel.exe

See Also

Relocatable Module System

Revision History

2006/03/01 Initial version.


CONFIDENTIAL