cc.1

来自「<B>Digital的Unix操作系统VAX 4.2源码</B>」· 1 代码 · 共 751 行 · 第 1/2 页

.TP 15
.B \-volatile
Causes all variables to be treated as
.I volatile.
.TP 15
.B \-varargs
Prints warnings for lines that may require the
.I varargs.h
macros.
.TP 15
.B \-f
Causes the compiler not to promote expressions of type
.I float
to type
.I double.
.TP 15
.B \-float
Same as the 
.B \-f 
option.
.TP 15
\fB\-fill \fInumber\fR
Set the fill pattern for ``holes'' within an output section.  
The \fInumber\fR argument is a four byte hex constant.
.NT
The 
.B \-EB
and
.B \-EL
options are needed only when compiling for RISC 
machines from vendors other than Digital.
.NE
The default target byte ordering matches the machine 
where the compiler is running.  The options
.B \-EB
and
.B \-EL
specify the target byte ordering (big-endian and little-endian,
respectively).
The compiler also defines a C preprocessor macro for the
target byte ordering.  These C preprocessor macros are
.B MIPSEB
and
.B MIPSEL
for big-endian and little-endian byte ordering respectively.
.PP
If the specified target byte ordering does not match the machine where the
compiler is running, then the runtime startups and libraries come from
.B /usr/libeb
for big-endian runtimes on a little-endian machine and from
.B /usr/libel
for little-endian runtimes on a big-endian machine.
.TP 15
.B \-EB
Produce object files targeted for big-endian byte ordering.  The C preprocessor
macro
.B MIPSEB
is defined by the compiler.
.TP 15
.B \-EL
Produce object files targeted for little-endian byte ordering.  The
C preprocessor macro
.B MIPSEL
is defined by the compiler.
.PP
The following options primarily aid compiler
development and are not generally used:
.TP 15
.BI \-H c
Halt compiling after the pass specified by the character
.IR c ,
producing an intermediate file for the next pass.  The
.I c
can be
.B [ fjusmoca ].
It selects the compiler pass in the same way as the
.B \-t
option.
If this option is used, the symbol table file produced and used by the passes
is the last component of the source file with the suffix changed to .T.
It is not removed.
.TP 15
.B \-K
Build and use intermediate file names with the last component of the
source file's  name replacing its suffix with the conventional suffix for the
type of file (for example, .B file for binary
.I ucode,
produced by the front end).  These intermediate files are never removed
even when a pass encounters a fatal error.
When ucode linking is performed and the
.B \-K
option is specified, the base name of the files created after the ucode link is
u.out by default.  If
.BI \-ko " output"
is specified, the base name of the object file is 
.I output
without the suffix.  Suffixes are appended to
.I output
if it does not have a suffix.
.TP 15
.B \-#
Converts binary
.I ucode
files (.B) or optimized binary ucode files (.O) to symbolic
.I ucode
(a .U file).
If a symbolic ucode file is to be produced by converting the binary
.I ucode
from the C compiler front end then the front end option
.B \-Xu is used.
.TP 15
.BI \-W c[c...],arg1[,arg2...]
Pass the argument[s]
.I argi
to the compiler pass[es]
.I c[c..].
The
.I c's
are one of
.B [ pfjusmocablyz ].
The c's selects the compiler pass in the same way as the
.B \-t
option.
.PP
The options
.BR \-t [ hpfjusmocablyzrnt ],
.BI \-h path,
and
.BI \-B string
select a name to use for a particular pass, startup routine, or standard library.
These arguments are processed from left to right so their order is significant.
When the
.B \-B
option is encountered, the selection of names takes place using the last
.B \-h
and
.B \-t
options.  Therefore, the
.B \-B
option is always required when using
.B \-h
or
.BR \-t .
Sets of these options can be used to select any combination of names.
.PP
The
.B \-EB
or
.B \-EL
options and the
.B \-p[01]
options must precede all
.B \-B
options because they can affect the location of runtime libraries and which
runtime libraries are used.
.TP 15
.BR \-t [ hpfjusmocablyzrnt ]
Select the names.  The names must be selected from the options in the
following table:
.br
.ta \w'btou, utob\ \ 'u
.SM "Name      Character"
.br
include	h  (see note below)
.br
cpp	p
.br
ccom	f
.br
ujoin	j
.br
uld	u
.br
usplit	s
.br
umerge	m
.br
uopt	o
.br
ugen	c
.br
as0	a
.br
as1	b
.br
ld	l
.br
ftoc	y
.br
cord	z
.br
[m]crt0.o	r
.br
libprof1.a	n
.br
btou, utob	t
.br
.sp +.5
If the character h is in the
.B \-t
argument then a directory is added to the list of directories to be used in 
searching for #include files.  This directory name has the form
.SM COMP_TARGET_ROOT\fR/usr/include\fIstring\fR .
This directory is to contain the include files for the
.I string
release of the compiler.  The standard directory is still searched.
.TP 15
.BI \-h \*Spath
Use
.I path
rather than the directory where the name is normally found.
.TP 15
.BI \-B \*Sstring
Append
.I string
to all names specified by the
.B \-t
option.  If the
.B \-t
option has not been processed before the
.B \-B,
the
.B \-t
option is assumed to be the following: hpfjusmocablyzrnt.  This list 
designates all names.
If the
.B \-t
argument has not been processed before the
.B \-B
argument,
.BI \-B string
is passed to the loader to use with its
.BI \-l x
arguments.
.PP
Invoking the compiler with a name of the form
.BI cc string
has the same effect as using a
.BI \-B string
option on the command line.
.PP
If the environment variable
.SM COMP_HOST_ROOT
is set, the value is used as the root
directory for all pass names rather than the default slash (/).
If the environment variable
.SM COMP_TARGET_ROOT
is set, the value is used as the root
directory for all include and library names rather than the default
slash (/).
This affects the standard directory for #include files, /usr/include,
and the standard library, /usr/lib/libc.a.  If this is set then the only
directory that is searched for libraries, using the
.BI \-l x
option, is
.SM COMP_TARGET_ROOT\fR/usr/lib .
.PP
If the environment variable
.SM TMPDIR
is set, the value is used as the directory to place any temporary files
rather than the default
.B /tmp/ .
.PP
If the environment variable
.SM RLS_ID_OBJECT
is set, the value is used as the name of an object to link in if a link takes
place.  This is used to add release identification information to objects.
It is always the last object specified to the loader.  
.PP
Other arguments are assumed to be either loader options or 
C\-compatible
object files, typically produced by an earlier
.PN cc
run, or perhaps libraries of 
C\-compatible
routines.  These files, together with the results of any
compilations specified, are loaded in the order
given, producing an executable program with the default name
.B a.out.
.SH Options
The ULTRIX C compiler provides the following default symbols
for your use.  These symbols are useful in ifdef statements
to isolate code for one of the particular cases.  Thus, these
symbols can be useful for ensuring portable code.
.TP 15
unix
Any UNIX system
.TP
bsd4_2
Berkeley UNIX Version 4.2
.TP
ultrix
ULTRIX only
.TP
mips
Any RISC architecture
.TP
MIPSEL
Little endian variant of MIPS architecture
.TP
host_mips
Native compilation environment (as opposed to cross-compiler)
.SH Restrictions
The standard library, /usr/lib/libc.a, is loaded by using the \-lc loader
option and not a full path name. The wrong library may be loaded if
there are files with the name
.RI libc.a string
in the directories specified with the 
.B \-L
loader option or in the default directories searched by the loader.
.PP
The handling of include directories and libc.a is confusing.
.SH Files
.ta \w'/usr/lib/libprof1.a\ \ 'u
file.c			input file
.br
file.o			object file
.br
a.out			loaded output
.br
/tmp/ctm?		temporary
.br
/usr/lib/cpp	C macro preprocessor
.br
/usr/lib/ccom	C front end
.br
/usr/lib/ujoin	binary ucode and symbol table joiner
.br
/usr/bin/uld	ucode loader
.br
/usr/lib/usplit	binary ucode and symbol table splitter
.br
/usr/lib/umerge	procedure intergrator
.br
/usr/lib/uopt	optional global ucode optimizer
.br
/usr/lib/ugen	code generator
.br
/usr/lib/as0	symbolic to binary assembly language translator
.br
/usr/lib/as1	binary assembly language assembler and reorganizer
.br
/usr/lib/crt0.o	runtime startup
.br
/usr/lib/mcrt0.o	startup for profiling
.br
/usr/lib/libc.a	standard library, see intro(3)
.br
/usr/lib/libprof1.a	level 1 profiling library
.br
/usr/include	standard directory for #include files
.br
/usr/bin/ld	MIPS loader
.br
/usr/lib/ftoc	interface between 
.MS prof 1
and cord
.br
/usr/lib/cord	procedure-rearranger
.br
/usr/bin/btou	binary to symbolic ucode translator
.br
/usr/bin/utob	symbolic to binary ucode translator
.br
mon.out		file produced for analysis by
.MS prof 1
.PP
Runtime startups and libraries for the opposite byte sex of machine the
compiler is running on have the same names but are located in different
directories.  For big-endian runtimes on a little-endian machine the
directory is /usr/libeb and for little-endian runtimes on
a big-endian machine the directory is /usr/libel.
.SH See Also
dbx(1), ld(1), pixie(1), prof(1), what(1), monitor(3)