NAME¶

cc — front-end to the C compiler

SYNOPSIS¶

DESCRIPTION¶

The cc utility provides a front-end to the “portable C compiler”. Multiple files may be given on the command line. Unrecognized options are all sent directly to ld(1).

Filenames that end with .c are passed via cpp(1) → ccom(1) → as(1) → ld(1).

Filenames that end with .i are passed via ccom(1) → as(1) → ld(1).

Filenames that end with .s are passed via as(1) → ld(1).

Filenames that end with .S are passed via cpp(1) → as(1) → ld(1).

Filenames that end with .o are passed directly to ld(1).

The options are as follows:

-B prefix

Define alternate prefix path for cpp(1), ccom(1), as(1), or ld(1) executables.

-C

Passed to the cpp(1) preprocessor to not discard comments.

-c

Only compile or assemble and then stop. Do not link. The resulting object output is saved as a filename with a “.o” suffix unless -o option is used. Note: cannot be combined with -o if multiple files are given.

-D macro[=value]

Passed to the cpp(1) preprocessor to define macro.

-d option

Passed to the as(1) assembler.

-E

Stop after preprocessing with cpp(1). Do not compile, assemble, or link. Output is sent to standard output unless the -o option is used.

-fPIC

Generate PIC code.

-fpic

Tells C compiler to generate PIC code and tells assembler that PIC code has been generated.

-g

Send -g flag to ccom(1) to create debug output. This unsets the -O option.

-I path

Passed to the cpp(1) preprocessor to add header search directory to override system defaults.

-include file

Tells the cpp(1) preprocessor to include the file during preprocessing.

-isystem path

Defines path as a system header directory for the cpp(1) preprocessor.

-k

Generate PIC code. See -fpic option.

-L

TODO

-M

Pass -M flag to cpp(1) to generate dependencies for make(1).

-moptions

Target-dependent option.

ARM

-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

HPPA

 

i386

 

MIPS

-mlittle-endian -mbig-endian -mhard-float -msoft-float

PDP-10

 

PowerPC

 

Sparc64

 

VAX

 

-nostartfiles

Do not link with the system startup files (crt0.c, etc.)

-nostdinc

Do not use the system include paths (/usr/include, etc.)

-nostdlib

Do not link with the system C library (libc).

-O

Enable optimizations. Currently passes -xdeljumps and -xtemps to ccom(1). Note: this is unset if the -g option is used.

-o outfile

Save result to outfile.

-P

TODO

-pg

Enable profiling on the generated executable.

-pthread

Defines _PTHREADS preprocessor directive for cpp(1). Uses -lpthread for the ld(1) linker.

-S

Stop after compilation by ccom(1). Do not assemble and do not link. The resulting assembler-language output is saved as a filename with a “.s” suffix unless the -o option is used. Note: cannot be combined with -o if multiple files are given.

-static

Do not use dynamic linkage. By default, it will link using the dynamic linker options and/or shared objects for the platform.

-shared

Create a shared object of the result. Tells the linker not to generate an executable.

-t

Passes -t to cpp(1) for traditional C preprocessor syntax.

-U macro

Passes to the cpp(1) preprocessor to remove the initial macro definition.

-v

Outputs the version of cc and shows what commands will be run with their command line arguments.

-Wl flags

Options for the linker.

-X

Don't remove temporary files on exit.

-x

May be used to give separate optimization flags to ccom, see -O for options.

-x c

Gcc compatibility option; specify that the language in use is c.

SEE ALSO¶

as(1), ccom(1), cpp(1), ld(1)

HISTORY¶

The cc command comes from the original Portable C Compiler by S. C. Johnson, written in the late 70's.

This product includes software developed or owned by Caldera International, Inc.