3 pcc \- APE C compiler driver
14 compiles and loads C programs,
15 using APE (ANSI C/POSIX) include files and libraries.
16 Named files ending with
20 then compiled with one of the compilers described in
22 as specified by the environment variable
24 The object files are then loaded using one of the loaders described in
27 .TP \w'\fL-D\ \fIname=def\ 'u
34 Place loader output in file
36 instead of the default
42 Omit the compilation and loading phases;
43 leave the result of preprocessing
51 but send the result to standard output.
54 Omit the loading phase.
57 Insert profiling code into the executable output.
60 Print compiler warning messages.
64 .BI / $objtype /lib/ape/lib lib .a
65 as a library during the linking phase.
68 Don't complain about functions used without
69 ANSI function prototypes.
74 conversion warnings, as in
78 Echo the preprocessing, compiling, and loading commands
79 before they are executed.
91 If no definition is given, the name is defined as
103 files whose names do not begin with
106 sought first in the directory
110 then in directories named in
114 .BR /$objtype/include/ape .
117 Don't optimize compiled code.
120 Print an assembly language version of the object code
124 Instead of compiling, print on standard output acid functions (see
126 for examining structures declared in the source files.
131 except that functions for structures declared in included header files
135 Enable vararg type checking as described in
137 This is of limited use without the appropriate
141 The APE environment contains all of the include
142 files and library routines specified in the ANSI C standard
143 (X3.159-1989), as well as those specified in the IEEE Portable
144 Operating System Interface standard (POSIX, 1003.1-1990, ISO 9945-1).
145 In order to access the POSIX routines, source programs should
146 define the preprocessor constant
149 .TF /$objtype/lib/ape/libap.a
152 directory for machine-independent
156 .B /$objtype/include/ape
157 directory for machine-dependent
161 .B /$objtype/lib/ape/libap.a
162 ANSI C/POSIX library.
175 ``APE \(em The ANSI/POSIX Environment''
177 .B /sys/src/cmd/pcc.c
179 The locale manipulation functions are minimal.
180 Signal functions and terminal characteristic
181 handlers are only minimally implemented.
183 always fails, because Plan 9 doesn't support multiple links to a file.
184 The functions related to setting effective user and group ids
185 cannot be implemented because the concept doesn't exist in Plan 9.