object programs into one, resolves external
references, and searches libraries.
In the simplest case several object
an object module which can be either executed or
become the input for a further
to preserve the relocation bits.)
This file is made executable
only if no errors occurred during the load.
The argument routines are concatenated in the order
specified. The entry point of the output is the
beginning of the first routine.
If any argument is a library, it is searched exactly once
at the point it is encountered in the argument list.
Only those routines defining an unresolved external
If a routine from a library
references another routine in the library,
and the library has not been processed by
the referenced routine must appear after the
referencing routine in the library.
Thus the order of programs within libraries
If the first member of a library is named
then it is understood to be a dictionary for the
the dictionary is searched
iteratively to satisfy as many references as possible.
The symbols `\_etext', `\_edata' and `\_end'
(`etext', `edata' and `end' in C)
are reserved, and if referred to,
are set to the first location above the program,
the first location above initialized data,
and the first location above all data respectively.
It is erroneous to define these symbols.
understands several options.
they should appear before the file names.
`Strip' the output, that is, remove the symbol table
and relocation bits to save space (but impair the
usefulness of the debugger).
This information can also be removed by
Take the following argument as a symbol and enter
it as undefined in the symbol table. This is useful
for loading wholly from a library, since initially the symbol
table is empty and an unresolved reference is needed
to force the loading of the first routine.
option is an abbreviation for the library name
A library is searched when its name is encountered,
(non-.globl) symbols in the output symbol table; only enter
This option saves some space in the output file.
except for those whose names begin with `L'.
to discard internally generated labels while
retaining symbols local to routines.
Generate relocation bits in the output file
so that it can be the subject of another
This flag also prevents final definitions from being
and suppresses the `undefined symbol' diagnostics.
Force definition of common storage
when the output file is executed,
the text portion will be read-only and shared
among all users executing the file.
This involves moving the data areas up to the first
possible 4K word boundary following the
When the output file is executed, the program
text and data areas will live in separate address spaces.
The only difference between this option
is that here the data starts at location 0.
is used as the name of the
The following argument is taken to be the
name of the entry point of the loaded
program; location 0 is the default.
This is an overlay file, only the text segment
Shared data must have the same layout as in
The next argument is a decimal number that sets
the size of the data segment.
.ta \w'/usr/lib/lib*.a\ \ 'u
/usr/lib/lib*.a more libraries
as(1), ar(1), cc(1), ranlib(1)