4.3BSD-Reno/share/man/cat1/cc.0

Compare this file to the similar file:
Show the results in this format:

CC(1) UNIX Reference Manual CC(1)

NNAAMMEE
cccc - C compiler

SSYYNNOOPPSSIISS
cccc [option] _f_i_l_e ...

DDEESSCCRRIIPPTTIIOONN
CCcc is the UNIX C compiler. CCcc accepts several types of arguments:

Arguments whose names end with `.c' are taken to be C source programs;
they are compiled, and each object program is left on the file whose name
is that of the source with `.o' substituted for `.c'. The `.o' file is
normally deleted, however, if a single C program is compiled and loaded
all at one go.

In the same way, arguments whose names end with `.s' are taken to be as-
sembly source programs and are assembled, producing a `.o' file.

The following options are interpreted by cccc. See ld(1) for load-time op-
tions.

--cc Suppress the loading phase of the compilation, and force an object
file to be produced even if only one program is compiled.

--gg Have the compiler produce additional symbol table information for
dbx(1) Also pass the --llgg flag to ld(1).

--ggoo Have the compiler produce additional symbol table information for
the obsolete debugger sdb(1). Also pass the --llgg flag to ld(1).

--ww Suppress warning diagnostics.

--pp Arrange for the compiler to produce code which counts the number of
times each routine is called. If loading takes place, replace the
standard startup routine by one which automatically calls moni-
tor(3) at the start and arranges to write out a _m_o_n._o_u_t file at
normal termination of execution of the object program. An execu-
tion profile can then be generated by use of prof(1).

--ppgg Causes the compiler to produce counting code in the manner of --pp
but invokes a run-time recording mechanism that keeps more exten-
sive statistics and produces a _g_m_o_n._o_u_t file at normal termination.
Also, a profiling library is searched, in lieu of the standard C
library. An execution profile can then be generated by use of
gprof(1).

--OO Invoke an object-code improver.

--RR Passed on to as(1) making initialized variables shared and read-
only.

--SS Compile the named C programs, and leave the assembler-language out-
put on corresponding files suffixed `.s'.

--MM Run only the macro preprocessor on the named C programs, requesting
it to generate Makefile dependencies and send the result to the
standard output.

--EE Run only the macro preprocessor on the named C programs, and send
the result to the standard output.

--CC prevent the macro preprocessor from eliding comments.

--oo_o_u_t_p_u_t
Name the final output file _o_u_t_p_u_t. If this option is used the file
`a.out' will be left undisturbed.

--DD_n_a_m_e=_d_e_f
--DD_n_a_m_e
Define the _n_a_m_e to the preprocessor, as if by `#define'. If no de-
finition is given, the name is defined as "1".

--UU_n_a_m_e
Remove any initial definition of _n_a_m_e.

--II_d_i_r
`#include' files whose names do not begin with `/' are always
sought first in the directory of the _f_i_l_e argument, then in direc-
tories named in --II options, then in directories on a standard list.

--LL_d_i_r
Library archives are sought first in directories named in --LL op-
tions, then in directories on a standard list.

--ff Use an alternate compiler which does not convert expressions in-
volving only floats to double. This does not conform to the stan-
dard which states that all intermediate results should be converted
to double but does provide a speed improvement for programs which
don't require full double precision. This option also makes
rreeggiisstteerr ffllooaatt variables work appropriately.

--BB_p_a_t_h
Find substitute compiler passes in the named path with the suffixes
cpp, ccom and c2.

--tt[p012]
Find only the designated compiler passes in the files whose names
are constructed by a --BB option.

Other arguments are taken to be either loader option arguments, or C-
compatible object programs, typically produced by an earlier cccc run, or
perhaps libraries of C-compatible routines. These programs, together
with the results of any compilations specified, are loaded (in the order
given) to produce an executable program with name _a._o_u_t.

FFIILLEESS
_f_i_l_e._c input file
_f_i_l_e._o object file
_a._o_u_t loaded output
_c_t_m? temporary
/_u_s_r/_b_i_n/_c_p_p preprocessor
/_u_s_r/_l_i_b_e_x_e_c/_c_c_o_m compiler
/_u_s_r/_l_i_b_e_x_e_c/_c_c_o_m compiler for single precision floats
/_u_s_r/_l_i_b_e_x_e_c/_c_2 optional optimizer
/_u_s_r/_l_i_b/_c_r_t_0._o runtime startoff
/_u_s_r/_l_i_b/_m_c_r_t_0._o startoff for profiling
/_u_s_r/_l_i_b/_g_c_r_t_0._o startoff for gprof-profiling
/_u_s_r/_l_i_b/_l_i_b_c._a standard library, see intro(3)
/_u_s_r/_l_i_b/_l_i_b_c__p._a profiling library, see intro(3)
/_u_s_r/_i_n_c_l_u_d_e standard directory for `#include' files
_m_o_n._o_u_t file produced for analysis by prof(1)
_g_m_o_n._o_u_t file produced for analysis by gprof(1)

SSEEEE AALLSSOO
B. W. Kernighan and D. M. Ritchie, _T_h_e _P_r_o_g_r_a_m_m_i_n_g _L_a_n_g_u_a_g_e, Prentice-
Hall, 1978

B. W. Kernighan, _P_r_o_g_r_a_m_m_i_n_g _i_n _C - _a _t_u_t_o_r_i_a_l

D. M. Ritchie, _C _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l

monitor(3), prof(1), gprof(1), adb(1), ld(1), dbx(1), as(1)

DDIIAAGGNNOOSSTTIICCSS
The diagnostics produced by C itself are intended to be self-explanatory.
Occasional messages may be produced by the assembler or loader.

HHIISSTTOORRYY
The cccc compiler was distributed with Version 6 AT&T UNIX.

BBUUGGSS
The compiler currently ignores advice to put cchhaarr, uunnssiiggnneedd cchhaarr, sshhoorrtt,
uunnssiiggnneedd sshhoorrtt, ffllooaatt, or ddoouubbllee variables in registers, except as noted
above. It previously produced poor, and in some cases incorrect, code
for such declarations.