3 9c, 9a, 9l, 9ar \- C compiler, assembler, linker, archiver
52 These programs are shell scripts that invoke the appropriate standard tools
53 for the current operating system and architecture.
54 One can use them to write portable recipes for mkfiles.
59 into object files for the current system.
60 The system C compiler is invoked with warnings enabled.
70 in the C preprocessor.
75 defined in the C preprocessor and adds
84 on Linux systems with 2.6-series kernels.
87 assembles the named files into object files for the current system.
88 Unlike some system assemblers, it does
90 promise to run the C preprocessor on the source files.
93 links the named object files and libraries to create the target executable.
96 option specifies that a library named
101 option adds directories to the library search path.
103 invokes the system linker with
105 already on the library search path.
108 searches the named objects and libraries for symbols of the form
109 .BI __p9l_autolib_ name \fR,
110 which it takes as indication that it should link
111 .BI $PLAN9/lib/lib name .a
113 It also examines such libraries to find their own dependencies.
116 option at the beginning of the command line disables this behavior.
118 .BI __p9l_autolib_ name
119 is added to an object file by the macro
120 .B AUTOLIB( name )\fR,
123 Header files associated with libraries contain
125 annotations; ordinary programs need not use them.
126 Due to shortcomings in the implementation, a source file may not
129 statement multiple times.
132 maintains object file archives called libraries.
133 The exact set of valid command keys varies from system to system,
136 always provides the following key characters:
141 from the archive file.
146 in the archive file, or add them if missing.
149 List a table of contents of the archive.
150 If names are given, only those files are listed.
153 Extract the named files.
154 If no names are given, all files in the archive are
158 alter the archive file.
163 description of the making of a
164 new archive file from the old archive and the constituent files.
167 give a long listing of all information about the files,
168 somewhat like a listing by
175 mode uid/gid size date name
181 will create a new archive when
183 does not exist, and give a warning.
186 discards any old contents and suppresses the warning.
197 inserts a table of contents, required by the linker, at
198 the front of the library.
199 The table of contents is
200 rebuilt whenever the archive is modified.
204 9c file1.c file2.c file3.c
205 Compile three C source files.
209 Assemble one assembler source file.
212 9ar rvc lib.a file[12].o
213 Archive the first two object files into a library.
216 9l -o prog file3.o file4.o lib.a
217 Link the final two object files and any necessary objects from the library