Next: GNU Free Documentation License, Previous: Reporting Bugs, Up: Top

## Appendix A MRI Compatible Script Files

To aid users making the transition to gnu `ld` from the MRI linker, `ld` can use MRI compatible linker scripts as an alternative to the more general-purpose linker scripting language described in Scripts. MRI compatible linker scripts have a much simpler command set than the scripting language otherwise used with `ld`. gnu `ld` supports the most commonly used MRI linker commands; these commands are described here.

In general, MRI scripts aren't of much use with the `a.out` object file format, since it only has three sections and MRI scripts lack some features to make use of them.

You can specify a file containing an MRI-compatible script using the ``-c`' command-line option.

Each command in an MRI-compatible script occupies its own line; each command line starts with the keyword that identifies the command (though blank lines are also allowed for punctuation). If a line of an MRI-compatible script begins with an unrecognized keyword, `ld` issues a warning message, but continues processing the script.

Lines beginning with ``*`' are comments.

You can write these commands using all upper-case letters, or all lower case; for example, ``chip`' is the same as ``CHIP`'. The following list shows only the upper-case form of each command.

`ABSOLUTE` secname
`ABSOLUTE` secname`,` secname`, ...` secname
  Normally, `ld` includes in the output file all sections from all the input files. However, in an MRI-compatible script, you can use the `ABSOLUTE` command to restrict the sections that will be present in your output program. If the `ABSOLUTE` command is used at all in a script, then only the sections named explicitly in `ABSOLUTE` commands will appear in the linker output. You can still use other input sections (whatever you select on the command line, or using `LOAD`) to resolve addresses in the output file.

`ALIAS` out-secname`,` in-secname
  Use this command to place the data from input section in-secname in a section called out-secname in the linker output file.

  in-secname may be an integer.

`ALIGN` secname`=` expression
  Align the section called secname to expression. The expression should be a power of two.

`BASE` expression
  Use the value of expression as the lowest address (other than absolute addresses) in the output file.

`CHIP` expression
`CHIP` expression`,` expression
  This command does nothing; it is accepted only for compatibility.

`END`
  This command does nothing whatever; it's only accepted for compatibility.

`FORMAT` output-format
  Similar to the `OUTPUT_FORMAT` command in the more general linker language, but restricted to one of these output formats:
  1. S-records, if output-format is ``S`'
  2. IEEE, if output-format is ``IEEE`'
  3. COFF (the ``coff-m68k`' variant in BFD), if output-format is ``COFF`'

`LIST` anything`...`
  Print (to the standard output file) a link map, as produced by the `ld` command-line option ``-M`'.

  The keyword `LIST` may be followed by anything on the same line, with no change in its effect.

`LOAD` filename
`LOAD` filename`,` filename`, ...` filename
  Include one or more object file filename in the link; this has the same effect as specifying filename directly on the `ld` command line.

`NAME` output-name
  output-name is the name for the program produced by `ld`; the MRI-compatible command `NAME` is equivalent to the command-line option ``-o`' or the general script language command `OUTPUT`.

`ORDER` secname`,` secname`, ...` secname
`ORDER` secname secname secname
  Normally, `ld` orders the sections in its output file in the order in which they first appear in the input files. In an MRI-compatible script, you can override this ordering with the `ORDER` command. The sections you list with `ORDER` will appear first in your output file, in the order specified.

`PUBLIC` name`=`expression
`PUBLIC` name`,`expression
`PUBLIC` name expression
  Supply a value (expression) for external symbol name used in the linker input files.

`SECT` secname`,` expression
`SECT` secname`=`expression
`SECT` secname expression
  You can use any of these three forms of the `SECT` command to specify the start address (expression) for section secname. If you have more than one `SECT` statement for the same secname, only the first sets the start address.