3 0l, 1l, 2l, 5l, 6l, 7l, 8l, kl, ql, vl \- loaders
18 into executable files for the corresponding architectures; see
20 for the correspondence between an architecture and the character
23 etc.) that specifies it.
24 The files should be object files or libraries (archives of object files)
25 for the appropriate architecture.
28 represents the library
38 The libraries must have tables of contents
44 options are rarely necessary as the header files for
45 the libraries cause their archives to be included automatically in the load
48 For example, any program that includes header file
51 to search the C library
52 .BR /$objtype/lib/libc.a .
53 Also, the loader creates an undefined symbol
57 if profiling is enabled) to force loading of the
58 startup linkage from the C library.
60 The order of search to resolve undefined symbols is to load all files and libraries
61 mentioned explicitly on the command line, and then to resolve remaining symbols
62 by searching in topological order
63 libraries mentioned in header files included by files already loaded.
64 When scanning such libraries, the algorithm is to scan each library repeatedly until
65 no new undefined symbols are picked up, then to start on the next library. Thus if library
71 again, it may be necessary to mention
73 explicitly so it will be read a second time.
75 The loader options are:
79 Suppress the default loading of the startup linkage and libraries
80 specified by header files.
89 is the first letter of the loader name.
92 Insert profiling code into the executable output; no special action is needed
93 during compilation or assembly.
96 Insert (\fLe\fPmbedded) tracing code into the executable output; no special action is needed
97 during compilation or assembly.
106 (ARM only) Don't generate VFP hardware floating point instructions.
109 Strip the symbol tables from the output file.
112 Print the object code in assembly language, with addresses.
115 Print debugging output that annotates the activities of the load.
119 only) Generate instructions rather than calls to emulation routines
120 for multiply and divide.
123 The entry point for the binary is
132 Produce an export table in the executable.
135 restricts the exported symbols to those listed in the file.
138 Produce an export table, import table
139 and a dynamic load section in the executable.
142 restricts the imported symbols to those listed in the file.
150 Move strings into the text segment.
153 Executable header is type
155 The meaning of the types is architecture-dependent; typically
156 type 1 is Plan 9 boot format and type 2 is the
157 regular Plan 9 format, the default. These are reversed on the MIPS.
158 The Next boot format is 3. Type 4 in
160 creates a MIPS executable for an SGI Unix system.
163 The text segment starts at address
167 The data segment starts at address
171 The text segment is rounded to a multiple of
177 The numbers in the above options can begin with
181 to change the default base from decimal to hexadecimal or octal.
182 The defaults for the values depend on the compiler and the
185 The loaded image has several symbols inserted by the loader:
187 is the address of the end of the text segment;
189 is the address of the beginning of the data segment;
191 is the address of the end of the data segment;
194 is the address of the end of the bss segment, and of the program.
214 ``How to Use the Plan 9 C Compiler''
216 The list of loaders given above is only partial,
217 not all architectures are supported on all systems,
218 some have been retired and some
219 are provided by third parties.