3 0ed5e9f8 2020-12-30 rsc 9c, 9l, 9ar \- C compiler, assembler, linker, archiver
4 058b0118 2005-01-03 devnull .SH SYNOPSIS
20 058b0118 2005-01-03 devnull .I target
22 058b0118 2005-01-03 devnull .I object
25 058b0118 2005-01-03 devnull .I library
29 058b0118 2005-01-03 devnull .BI -L path
33 c8b6342d 2005-01-13 devnull .BI -l name
40 058b0118 2005-01-03 devnull .I posname
47 058b0118 2005-01-03 devnull .SH DESCRIPTION
48 058b0118 2005-01-03 devnull These programs are shell scripts that invoke the appropriate standard tools
49 058b0118 2005-01-03 devnull for the current operating system and architecture.
50 058b0118 2005-01-03 devnull One can use them to write portable recipes for mkfiles.
53 058b0118 2005-01-03 devnull compiles the named C
55 058b0118 2005-01-03 devnull into object files for the current system.
56 c8b6342d 2005-01-13 devnull The system C compiler is invoked with warnings enabled.
59 c8b6342d 2005-01-13 devnull option adds
61 c8b6342d 2005-01-13 devnull to the include path,
64 c8b6342d 2005-01-13 devnull option defines
66 c8b6342d 2005-01-13 devnull in the C preprocessor.
69 c8b6342d 2005-01-13 devnull defines the symbol
70 058b0118 2005-01-03 devnull .B PLAN9PORT
71 c8b6342d 2005-01-13 devnull defined in the C preprocessor and adds
72 058b0118 2005-01-03 devnull .B $PLAN9/include
73 c8b6342d 2005-01-13 devnull to the include path.
76 058b0118 2005-01-03 devnull also defines
77 058b0118 2005-01-03 devnull .B __sun__
78 cb8f7357 2020-01-20 rsc on SunOS systems.
81 058b0118 2005-01-03 devnull links the named object files and libraries to create the target executable.
84 058b0118 2005-01-03 devnull option specifies that a library named
85 c8b6342d 2005-01-13 devnull .BI lib name .a
86 058b0118 2005-01-03 devnull be found and linked.
89 058b0118 2005-01-03 devnull option adds directories to the library search path.
91 058b0118 2005-01-03 devnull invokes the system linker with
92 058b0118 2005-01-03 devnull .B $PLAN9/lib
93 058b0118 2005-01-03 devnull already on the library search path.
96 c8b6342d 2005-01-13 devnull searches the named objects and libraries for symbols of the form
97 c8b6342d 2005-01-13 devnull .BI __p9l_autolib_ name \fR,
98 c8b6342d 2005-01-13 devnull which it takes as indication that it should link
99 c8b6342d 2005-01-13 devnull .BI $PLAN9/lib/lib name .a
100 c8b6342d 2005-01-13 devnull as well.
101 c8b6342d 2005-01-13 devnull It also examines such libraries to find their own dependencies.
102 c8b6342d 2005-01-13 devnull A single
104 c8b6342d 2005-01-13 devnull option at the beginning of the command line disables this behavior.
105 c8b6342d 2005-01-13 devnull The symbol
106 c8b6342d 2005-01-13 devnull .BI __p9l_autolib_ name
107 c8b6342d 2005-01-13 devnull is added to an object file by the macro
108 c8b6342d 2005-01-13 devnull .B AUTOLIB( name )\fR,
109 c8b6342d 2005-01-13 devnull defined in
110 c8b6342d 2005-01-13 devnull .B <u.h>.
111 c8b6342d 2005-01-13 devnull Header files associated with libraries contain
112 c8b6342d 2005-01-13 devnull .B AUTOLIB
113 c8b6342d 2005-01-13 devnull annotations; ordinary programs need not use them.
114 c8b6342d 2005-01-13 devnull Due to shortcomings in the implementation, a source file may not
115 c8b6342d 2005-01-13 devnull contain the same
116 c8b6342d 2005-01-13 devnull .B AUTOLIB
117 c8b6342d 2005-01-13 devnull statement multiple times.
120 058b0118 2005-01-03 devnull maintains object file archives called libraries.
121 058b0118 2005-01-03 devnull The exact set of valid command keys varies from system to system,
124 058b0118 2005-01-03 devnull always provides the following key characters:
129 058b0118 2005-01-03 devnull from the archive file.
134 058b0118 2005-01-03 devnull in the archive file, or add them if missing.
137 058b0118 2005-01-03 devnull List a table of contents of the archive.
138 058b0118 2005-01-03 devnull If names are given, only those files are listed.
141 058b0118 2005-01-03 devnull Extract the named files.
142 058b0118 2005-01-03 devnull If no names are given, all files in the archive are
143 058b0118 2005-01-03 devnull extracted.
144 058b0118 2005-01-03 devnull In neither case does
146 058b0118 2005-01-03 devnull alter the archive file.
149 058b0118 2005-01-03 devnull Verbose.
150 058b0118 2005-01-03 devnull Give a file-by-file
151 058b0118 2005-01-03 devnull description of the making of a
152 058b0118 2005-01-03 devnull new archive file from the old archive and the constituent files.
155 058b0118 2005-01-03 devnull give a long listing of all information about the files,
156 058b0118 2005-01-03 devnull somewhat like a listing by
157 d32deab1 2020-08-16 rsc .MR ls (1) ,
163 058b0118 2005-01-03 devnull mode uid/gid size date name
167 058b0118 2005-01-03 devnull Normally
169 058b0118 2005-01-03 devnull will create a new archive when
170 058b0118 2005-01-03 devnull .I afile
171 058b0118 2005-01-03 devnull does not exist, and give a warning.
174 058b0118 2005-01-03 devnull discards any old contents and suppresses the warning.
183 058b0118 2005-01-03 devnull is specified,
185 058b0118 2005-01-03 devnull inserts a table of contents, required by the linker, at
186 058b0118 2005-01-03 devnull the front of the library.
187 058b0118 2005-01-03 devnull The table of contents is
188 058b0118 2005-01-03 devnull rebuilt whenever the archive is modified.
189 c8b6342d 2005-01-13 devnull .SH EXAMPLES
192 058b0118 2005-01-03 devnull 9c file1.c file2.c file3.c
193 058b0118 2005-01-03 devnull Compile three C source files.
196 058b0118 2005-01-03 devnull 9ar rvc lib.a file[12].o
197 058b0118 2005-01-03 devnull Archive the first two object files into a library.
200 058b0118 2005-01-03 devnull 9l -o prog file3.o file4.o lib.a
201 058b0118 2005-01-03 devnull Link the final two object files and any necessary objects from the library
202 058b0118 2005-01-03 devnull into an executable.
203 058b0118 2005-01-03 devnull .SH SOURCE
204 c3674de4 2005-01-11 devnull .B \*9/bin