Quick Search:

View

Revision:
Expand:  
Changeset: MAIN:plunky:20140421213639

Diff

Diff from 1.40 to:

Annotations

Annotate by Age | Author | Mixed | None
/fisheye/browse/pcc/pcc/cc/cc/cc.1

Annotated File View

plunky
1.40
1 .\"     $Id: cc.1,v 1.40 2014/04/21 21:36:39 plunky Exp $
reed
1.8
2 .\"
ragge
1.1
3 .\" Copyright (c) 2007 Jeremy C. Reed <reed@reedmedia.net>
reed
1.12
4 .\"
5 .\" Permission to use, copy, modify, and/or distribute this software for any
6 .\" purpose with or without fee is hereby granted, provided that the above
ragge
1.1
7 .\" copyright notice and this permission notice appear in all copies.
reed
1.12
8 .\"
9 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR AND CONTRIBUTORS DISCLAIM
10 .\" ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
11 .\" WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL AUTHOR AND
12 .\" CONTRIBUTORS BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
13 .\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
14 .\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
15 .\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
ragge
1.1
16 .\" THIS SOFTWARE.
17 .\"
plunky
1.38
18 .Dd September 12, 2012
reed
1.12
19 .Dt CC 1
ragge
1.1
20 .Os
21 .Sh NAME
22 .Nm cc
23 .Nd front-end to the C compiler
24 .Sh SYNOPSIS
25 .Nm
plunky
1.39
26 .Op Fl cEgkMPStvX
plunky
1.29
27 .Op Fl B Ns Ar prefix
plunky
1.27
28 .Op Fl D Ar macro Ns Oo = Ns Ar value Oc
plunky
1.35
29 .Op Fl f Ns Ar feature
plunky
1.27
30 .Op Fl I Ar path
plunky
1.28
31 .Op Fl include Ar file
plunky
1.26
32 .Op Fl isystem Ar path
plunky
1.39
33 .Op Fl L Ns Ar path
gmcgarry
1.11
34 .Op Fl m Ns Ar option
plunky
1.20
35 .Op Fl nodefaultlibs
reed
1.7
36 .Op Fl nostartfiles
ragge
1.2
37 .Op Fl nostdinc
38 .Op Fl nostdlib
plunky
1.24
39 .Op Fl O Ns Oo Ar level Oc
plunky
1.26
40 .Op Fl o Ar outfile
ragge
1.2
41 .Op Fl pg
42 .Op Fl pthread
plunky
1.25
43 .Op Fl shared
ragge
1.2
44 .Op Fl static
plunky
1.27
45 .Op Fl U Ar macro
plunky
1.36
46 .Op Fl Wa Ns , Ns Ar options
47 .Op Fl Wc Ns , Ns Ar options
48 .Op Fl Wl Ns , Ns Ar options
49 .Op Fl Wp Ns , Ns Ar options
plunky
1.30
50 .Op Fl x Ar language
reed
1.7
51 .Op Ar
ragge
1.1
52 .Sh DESCRIPTION
53 The
54 .Nm
ragge
1.3
55 utility provides a front-end to the
reed
1.12
56 .Dq portable C compiler .
ragge
1.1
57 Multiple files may be given on the command line.
58 Unrecognized options are all sent directly to
59 .Xr ld 1 .
60 .Pp
61 .\" Brief description of its syntax:
62 Filenames that end with
reed
1.8
63 .Sy \&.c
ragge
1.1
64 are passed via
reed
1.16
65 .Xr cpp 1
66 \(->
67 .Xr ccom 1
68 \(->
69 .Xr as 1
70 \(->
ragge
1.1
71 .Xr ld 1 .
72 .Pp
73 Filenames that end with
reed
1.8
74 .Sy \&.i
ragge
1.4
75 are passed via
reed
1.16
76 .Xr ccom 1
77 \(->
78 .Xr as 1
79 \(->
ragge
1.4
80 .Xr ld 1 .
81 .Pp
82 Filenames that end with
reed
1.8
83 .Sy \&.s
ragge
1.1
84 are passed via
reed
1.16
85 .Xr as 1
86 \(->
ragge
1.1
87 .Xr ld 1 .
88 .Pp
89 Filenames that end with
ragge
1.14
90 .Sy \&.S
91 are passed via
reed
1.16
92 .Xr cpp 1
93 \(->
94 .Xr as 1
95 \(->
ragge
1.14
96 .Xr ld 1 .
97 .Pp
98 Filenames that end with
reed
1.8
99 .Sy \&.o
ragge
1.1
100 are passed directly to
101 .Xr ld 1 .
102 .Pp
103 .\"
104 The options are as follows:
105 .Bl -tag -width Ds
plunky
1.29
106 .It Fl B Ns Ar prefix
ragge
1.1
107 Define alternate prefix path for
108 .Xr cpp 1 ,
109 .Xr ccom 1 ,
110 .Xr as 1 ,
111 or
112 .Xr ld 1
113 executables.
114 .\" TODO: provide an example of -B
reed
1.6
115 .It Fl C
116 Passed to the
117 .Xr cpp 1
118 preprocessor to not discard comments.
ragge
1.1
119 .It Fl c
plunky
1.33
120 Stop after generating object code with
121 .Xr as 1 .
ragge
1.1
122 Do not link.
ragge
1.4
123 The resulting object output is saved
124 as a filename with a
reed
1.10
125 .Dq \&.o
ragge
1.4
126 suffix unless
127 .Fl o
128 option is used.
ragge
1.1
129 Note: cannot be combined with
130 .Fl o
131 if multiple files are given.
plunky
1.27
132 .It Fl D Ar macro Ns Oo = Ns Ar value Oc
reed
1.7
133 Passed to the
134 .Xr cpp 1
135 preprocessor to define
plunky
1.27
136 .Ar macro
137 with an optional
138 .Ar value .
ragge
1.1
139 .It Fl E
140 Stop after preprocessing with
141 .Xr cpp 1 .
142 Do not compile, assemble, or link.
reed
1.6
143 Output is sent to standard output unless the
144 .Fl o
145 option is used.
plunky
1.34
146 .It Fl ffreestanding
147 Assume a freestanding environment.
reed
1.7
148 .It Fl fPIC
149 Generate PIC code.
150 .\" TODO: document about avoiding machine-specific maximum size?
ragge
1.4
151 .It Fl fpic
152 Tells C compiler to generate PIC code
153 and tells assembler that PIC code has been generated.
154 .\" TODO: document difference between PIC and pic
ragge
1.1
155 .\" other -f GCC compatibility flags are ignored for now
156 .It Fl g
157 Send
158 .Fl g
159 flag to
160 .Xr ccom 1
161 to create debug output.
ragge
1.17
162 Debug information output can be disabled with
163 .Fl g0 .
reed
1.7
164 .It Fl I Ar path
165 Passed to the
166 .Xr cpp 1
167 preprocessor to add header search directory to override system defaults.
reed
1.6
168 .It Fl include Ar file
169 Tells the
reed
1.12
170 .Xr cpp 1
reed
1.6
171 preprocessor to include the
172 .Ar file
173 during preprocessing.
ragge
1.1
174 .It Fl isystem Ar path
reed
1.6
175 Defines
176 .Ar path
177 as a system header directory for the
178 .Xr cpp 1
179 preprocessor.
ragge
1.1
180 .It Fl k
ragge
1.4
181 Generate PIC code.
182 See
183 .Fl fpic
184 option.
plunky
1.39
185 .It Fl L Ns Ar path
186 Passed to the linker, to add
187 .Ar path
188 to the list of directories searched for shared libraries.
ragge
1.1
189 .It Fl M
190 Pass
191 .Fl M
192 flag to
193 .Xr cpp 1
194 to generate dependencies for
195 .Xr make 1 .
plunky
1.21
196 .It Fl m Ns Ar option
197 Target-dependent options.
198 Multiple
199 .Fl m
200 options can be given, the following are supported:
gmcgarry
1.13
201 .Bl -tag -width PowerPC
202 .It ARM
reed
1.16
203 \-mlittle-endian \-mbig-endian \-mfpe=fpa \-mfpe=vpf \-msoft-float \-march=armv1 \-march=armv2 \-march=armv2a \-march=armv3 \-march=armv4 \-march=armv4t \-march=armv4tej \-march=armv5 \-march=armv6 \-march=armv6t2 \-march=armv6kz \-march=armv6k \-march=armv7
gmcgarry
1.13
204 .It HPPA
205 .It i386
206 .It MIPS
reed
1.16
207 \-mlittle-endian \-mbig-endian \-mhard-float \-msoft-float
gmcgarry
1.13
208 .It PDP-10
209 .It PowerPC
210 .It Sparc64
211 .It VAX
212 .El
plunky
1.20
213 .It Fl nodefaultlibs
214 Do not link with the system default libraries (libc, etc.)
reed
1.7
215 .It Fl nostartfiles
reed
1.12
216 Do not link with the system startup files (crt0.c, etc.)
ragge
1.1
217 .It Fl nostdinc
reed
1.12
218 Do not use the system include paths (/usr/include, etc.)
ragge
1.1
219 .It Fl nostdlib
plunky
1.20
220 Do not link with the system default libraries or startup files.
plunky
1.24
221 .It Fl O Ns Oo Ar level Oc
222 Enable compiler optimizations.
223 Currently, for levels higher than zero,
224 this defines
225 .Dv __OPTIMIZE__
226 in the
227 .Xr cpp 1
228 preprocessor, and passes
plunky
1.38
229 .Fl xdce ,
ragge
1.17
230 .Fl xdeljumps ,
231 .Fl xtemps
reed
1.6
232 and
ragge
1.17
233 .Fl xinline
ragge
1.3
234 to
235 .Xr ccom 1 .
plunky
1.24
236 If no level is given the optimization level is increased, or
237 optimizations can be disabled using
ragge
1.17
238 .Fl O0 .
reed
1.7
239 .It Fl o Ar outfile
240 Save result to
241 .Ar outfile .
242 .It Fl P
plunky
1.39
243 Inhibit generation of line markers in preprocessor output.
244 This is sometimes useful when running the preprocessor on something other than C code.
reed
1.7
245 .It Fl pg
gmcgarry
1.13
246 Enable profiling on the generated executable.
ragge
1.1
247 .It Fl pthread
plunky
1.23
248 Defines the
249 .Dv _PTHREADS
250 preprocessor identifier for
251 .Xr cpp 1 , and
252 adds
253 .Fl lpthread
254 to the
reed
1.12
255 .Xr ld 1
plunky
1.23
256 linker arguments.
ragge
1.1
257 .It Fl S
258 Stop after compilation by
259 .Xr ccom 1 .
260 Do not assemble and do not link.
ragge
1.3
261 The resulting assembler-language output is saved
ragge
1.4
262 as a filename with a
reed
1.10
263 .Dq \&.s
ragge
1.4
264 suffix unless the
265 .Fl o
266 option is used.
ragge
1.1
267 Note: cannot be combined with
268 .Fl o
269 if multiple files are given.
plunky
1.25
270 .It Fl shared
271 Create a shared object of the result.
272 Tells the linker not to generate an executable.
reed
1.7
273 .It Fl static
274 Do not use dynamic linkage.
275 By default, it will link using the dynamic linker options
276 and/or shared objects for the platform.
ragge
1.1
277 .It Fl t
plunky
1.31
278 Passed to
ragge
1.1
279 .Xr cpp 1
plunky
1.31
280 to suppress some default macro definitions and enable use
281 of traditional C preprocessor syntax.
ragge
1.3
282 .It Fl U Ar macro
reed
1.12
283 Passes to the
ragge
1.3
284 .Xr cpp 1
285 preprocessor to remove the initial macro definition.
ragge
1.1
286 .It Fl v
287 Outputs the version of
288 .Nm
reed
1.12
289 and shows what commands will be run with their command line arguments.
plunky
1.36
290 .It Fl Wa Ns , Ns Ar options
291 Comma separated list of options for the assembler.
292 .It Fl Wc Ns , Ns Ar options
293 Comma separated list of options for the compiler.
294 .It Fl Wl Ns , Ns Ar options
295 Comma separated list of options for the linker.
296 .It Fl Wp Ns , Ns Ar options
297 Comma separated list of options for the preprocessor.
reed
1.7
298 .It Fl X
stefan
1.9
299 Don't remove temporary files on exit.
plunky
1.30
300 .It Fl x Ar language
301 GCC compatibility option; specify the language in use rather than
302 interpreting the filename extension.
303 Currently known language values are
plunky
1.40
304 .Sy none ,
plunky
1.30
305 .Sy c ,
plunky
1.37
306 .Sy c++ ,
307 .Sy assembler
plunky
1.30
308 and
309 .Sy assembler-with-cpp .
310 Any unknown
311 .Fl x
312 options are passed to
313 .Xr ccom 1 .
ragge
1.1
314 .El
reed
1.12
315 .Ss Predefined Macros
ragge
1.2
316 A few
317 macros are predefined by
318 .Nm
reed
1.8
319 when sent to
ragge
1.2
320 .Xr cpp 1 .
321 .Bl -diag
322 .It __PCC__
323 Set to the major version of
324 .Xr pcc 1 .
325 These macros can be used to select code based on
326 .Xr pcc 1
327 compatibility.
reed
1.12
328 See the
ragge
1.2
329 .Fl v
330 option.
331 .It __PCC_MINOR__
332 Set to the minor version.
333 .It __PCC_MINORMINOR__
reed
1.16
334 Set to the minor-minor version \(em the number after the minor version.
ragge
1.2
335 .It _PTHREADS
336 Defined when
337 .Fl pthread
338 switch is used.
plunky
1.40
339 .It __ASSEMBLER__
340 Defined when input files have a .S suffix, or if the
341 .Fl x Ns assembler-with-cpp
342 option is specified.
ragge
1.2
343 .El
ragge
1.3
344 .Pp
ragge
1.4
345 Also system- and/or machine-dependent macros may also be predefined;
346 for example:
347 .Dv __NetBSD__ ,
348 .Dv __ELF__ ,
ragge
1.3
349 and
350 .Dv __i386__ .
ragge
1.1
351 .Sh SEE ALSO
352 .Xr as 1 ,
353 .Xr ccom 1 ,
ragge
1.2
354 .Xr cpp 1 ,
355 .Xr ld 1
ragge
1.1
356 .Sh HISTORY
357 The
358 .Nm
plunky
1.32
359 command comes from the original Portable C Compiler by
360 .An "S. C. Johnson" ,
reed
1.12
361 written in the late 70's.
ragge
1.1
362 .Pp
363 This product includes software developed or owned by Caldera
364 International, Inc.
FishEye: Open Source License registered to PCC.
Your maintenance has expired. You can renew your license at http://www.atlassian.com/fisheye/renew
Atlassian FishEye, CVS analysis. (Version:1.6.3 Build:build-336 2008-11-04) - Administration - Page generated 2014-09-21 04:04 +0200