o | ROMable, default: enabled if a HexFile or BinFile command is present, disabled otherwise. If this option is enabled, RTLoc will issue a warning message if the application is not ROMable. If it is disabled, a warning is produced if any data is placed in ROM. |
b | Binary, default: disabled if a HexFile command or BinFile command is present, enabled otherwise. Controls the generation of an RTTarget-32 Binary File (.RTB file). .RTB files are required for the Reserve command, cross debugging, program RTRun, program BootDisk, and UEFI booting. |
g | Debug symbol conversion, default: disabled. Controls the generation of Borland style debug symbol tables for the RTD32 debugger. Symbol table conversion is only required for Microsoft compilers when RTD32 is to be used. |
c | Compression, default: enabled if compression code is located, disabled otherwise. Controls whether copied sections should be compressed. |
d | Discard discardable entities, default: enabled. Discardable entities are only needed for program initialization. If they are discarded, their address space can be reused by the program's heap and stack. Disabling this option prevents RTLoc from allocating the same address space to a discardable entity and the heap or stack. Discardable entities are: copied sections, decompression code and data, boot vectors, and the disk buffer. By default, discardable entities in RAM are allocated top-down (as opposed to bottom-up for all other entities). |
h | Hex files based, default: disabled. Intel hex files contain address information to inform the reading program or device (usually an EPROM programmer) of the addresses to receive data. Usually, an EPROM programmer will expect all addresses to be relative to the start of the EPROM chip. However, other software (such as download utilities) or devices may interpret these addresses as relative to the target system's physical address space. Adding option -h to RTLoc's command line or configuration file will produce hex files with addresses of the target's address space. If the option is disabled (default), addresses relative to the start address given in the HexFile command are generated. |
t | Truncate bin files, default: disabled. If enabled, RTLoc will truncate bin files to the size actually used instead of writing out a file of the size specified in the BinFile command. |
s | Start address record in hex files. When this option is enabled, the execution start address (the address of the boot vector) is written into hex files for each hex file which contains a Locate BootVector command. If option -s is not specified, RTLoc defaults to -s+ if such a record can be generated and to -s- otherwise. A valid start address record cannot be generated for targets booting in real mode with a boot vector outside the real mode address space. However, even in this case, a start address record can be forced by specifying -s+ on the RTLoc command line. |
q | Quiet, default: disabled. If enabled, RTLoc will write no messages to standard output; however, messages are still written to the .LOC file. |
w | Warnings, default: enabled. If disabled, no warning messages are issued. This option also affects the .LOC file. |
i | Information messages, default: enabled. If disabled, no information messages are issued. This option also affects the .LOC file. |
m | Max messages, default: disabled. Usually, RTLoc will stop when more than 20 warning or error messages have been encountered. With this option enabled, there is no upper limit for the number of warnings. |
n | Report an error when a Locate Section or Locate NTSection command references a non-existent section name. By default, RTLoc silently ignores such commands. |
DSym[=Val] | Defines a preprocessor symbol. Such symbols can be used in configuration files for symbol substitution or for conditional processing with #ifdef. |
FPath | Search for data files in Path. The path given in this option is used by RTLoc to search files given in Locate File commands. |
+Cmd | Process string Cmd as a configuration file command. This option does not follow the same syntax as other options. It must start with character "+" and it cannot have a trailing "+" or "-". The string Cmd may not contain blanks or the whole option must be quoted. |
Rc | Configuration report, default: enabled. Controls the generation of a configuration report in the .LOC file. |
Rr | Raw configuration report, default: disabled. If enabled, all configuration file lines read will be listed in the configuration report of the .LOC file, even if they are not executed due to an #ifdef 0. |
Ri | When this option is enabled, all preprocessor symbols are replaced by their respective values in the configuration report. |
Ry | When this option is disabled with -Ry-, the preprocessor symbol list at the end of the configuration report is suppressed. |
Re | EXE file report, default: enabled. Controls the generation of an EXE file report in the .LOC file. |
Rf | Fixup table report, default: disabled. Controls the generation of a fixup table report in the .LOC file. |
Rd | Dynamic link report, default: disabled. Controls the generation of a link report for imported functions. |
Rl | Locate report, default: enabled. Controls the generation of a locate report in the .LOC file. |
Ro | Compression report, default: enabled. Controls the generation of a compression report in the .LOC file. |
Rp | Page table detailed report, default: disabled. Controls the generation of a detailed page table report in the .LOC file. |
Rs | Summary page table report, default: enabled. Controls the generation of a summary page table report in the .LOC file. |
Rb | Boot code configuration report, default: enabled. Controls the generation of a boot code configuration report in the .LOC file. The option is ignored if the application does not contain boot code. |
Ra | Application output report, default: enabled. Controls the generation of an application output report in the .LOC file. |
R | Reports: all reports. Enables or disables all reports in the .LOC file. |
? | Shows a help screen with an options summary. |