starlink(1)
Name
starlink - static link editor for the URSA architecture
Synopsis
starlink [-DdhMmTtv?] [-o outprefix] file …
Description
The starlink program combines one or more ELF object files for the URSA architecture into an output format suitable for execution. This process consists of laying out the target sections, performing symbol resolution, and applying relocations. If no outprefix is supplied, then “out” is used as a default.
Options
The following flags may be specified in any order.
- -D
- Do not include the .data segment among the output files. This overrides any prior occurrence of the -d flag.
- -d
- Include the .data segment among the output files. This is the default. This overrides any prior occurrence of the -D flag.
- -h, -?
- Print a brief help message and exit.
- -M
- Do not emit a symbol map. This is the default.
- -m
- Emit a symbol map to “outprefix.map”
- -o outprefix
- Use outprefix as the base name for output files. This prefix will be suffixed according to the output. For Logisim Evolution, the .text segment is written to “outprefix.lcode”, and the .data segment is written to “outprefix.ldata”.
- -T
- Do not include the .text segment among the output files. This overrides any prior occurrence of the -t flag.
- -t
- Include the .text segment among the output files. This is the default. This overrides any prior occurrence of the -T flag.
- -v
- Print the version of the program and exit.
Exit Status
The starlink utility exits 0 on success, and >0 if an error occurs.