Commands, Directives, and Keywords

The rest of this chapter consists of explanations of all valid LCF functions, keywords, directives, and commands, in alphabetic order.

• . (location counter)
  Denotes the current output location.
• ADDR
  Returns the address of the named section or memory segment.
• ALIGN
  Returns the location-counter value, aligned on a specified boundary.
• ALIGNALL
  Forces minimum alignment for all objects in the current segment to the specified value.
• BIND
  Specifies a section modifier for setting an address.
• BIN_FILE_TYPE
  Controls the generation of a binary file.
• BYTE
  Inserts a byte of data at the current address of a section.
• EXCEPTION
  Creates the exception table index in the output file.
• EXCLUDEFILES
  Ignores object code in files.
• EXPORTSTRTAB
  Creates a string table from the names of exported symbols.
• EXPORTSYMTAB
  Creates a jump table of the exported symbols.
• EXTERNAL_SYMBOL
  Specifies objects that may be referred to by modules outside of an object code file.
• FORCEACTIVE
  Specifies objects that must not be deadstripped.
• GROUP
  Organizes objects listed in a linker command file.
• IMPORTSTRTAB
  Creates a string table from the names of imported symbols.
• IMPORTSYMTAB
  Creates a jump table of the imported symbols.
• INCLUDE
  Include a specified binary file in the output file.
• INCLUDEDWARF
  Allows source-level kernel debugging.
• INTERNAL_LOAD
  Loads one or several segments at an address not specified at link time.
• INTERNAL_SYMBOL
  Symbols created in a linker command file are considered external unless they are redefined using INTERNAL_SYMBOL.
• KEEP
  Forces the linker to not dead strip the unused symbols in the specified section.
• LOAD
  Loads one or several segments at a specific address.
• LONG
  Inserts a word of data at the current address of a section.
• MEMORY
  Starts the LCF memory segment, which defines segments of target memory.
• MAX_BIN_GAP
  Controls the maximum gap size value between two segments.
• NEXT
  Specifies an expression for setting an address.
• NO_INIT_BSS
  Prevents initializing a BSS section to zero to avoid uninitialized variable to be iniatialized to zero by the startup.
• NO_TRAILING_BSS_IN_BIN_FILES
  Removes uninitiallized data contained in a binary file.
• OBJECT
  Sections-segment keyword that specifies a function. Multiple OBJECT keywords control the order of functions in the output file.
• REF_INCLUDE
  Starts an optional LCF closure segment that specifies sections the linker should not deadstrip, if program code references the files that contain these sections.
• REGISTER
  Use the REGISTER directive to assign one of the EPPC processor's non-volatile registers to a user-defined small data section.
• ROMADDR
  Equivalent to ADDR. Returns ROM address.
• SECTIONS
  Starts the LCF sections segment, which defines the contents of target-memory sections. Also defines global symbols to be used in the output file.
• SHORT
  Inserts a halfword of data at the current address of a section.
• SIZEOF
  Returns the size (in bytes) of the specified segment or section.
• SIZEOF_ROM
  Returns the size (in bytes) that a segment occupies in ROM.
• WRITES0COMMENT
  Inserts an S0 comment record into an S-record file.