GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
CC(1) FreeBSD General Commands Manual CC(1)

cc
front-end to the C compiler

cc [-cEgkMPStvX] [-Bprefix] [-D macro[=value]] [-dflags] [-ffeature] [-I path] [-include file] [-isystem path] [-Lpath] [-moption] [-nodefaultlibs] [-nostartfiles] [-nostdinc] [-nostdlib] [-O[level]] [-o outfile] [-pg] [-pthread] [-shared] [-static] [-U macro] [-Wa,options] [-Wc,options] [-Wl,options] [-Wp,options] [-x language] [file ...]

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:

prefix
Define alternate prefix path for cpp(1), ccom(1), as(1), or ld(1) executables.
Passed to the cpp(1) preprocessor to not discard comments.
Stop after generating object code with as(1). 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.
macro[=value]
Passed to the cpp(1) preprocessor to define macro with an optional value.
flags
Debug options. flags is a string of characters, which signify the following actions.
M
Cause the preprocessor to output a list of macro definitions.

any unknown flags are ignored.

Stop after preprocessing with cpp(1). Do not compile, assemble, or link. Output is sent to standard output unless the -o option is used.
Assume a freestanding environment.
Generate PIC code.
Tells C compiler to generate PIC code and tells assembler that PIC code has been generated.
Tell the compiler to treat ‘char’ types as if they were unsigned unless explicitly defined otherwise. -fsigned-char can be used to signify the opposite behaviour. The default for the ‘char’ type depends on the compiler target architecture.
Tell the compiler to wrap functions with code which checks at runtime that a stack overflow has not occurred. When stack protection is in effect, the __SSP__ macro will be defined.
Send -g flag to ccom(1) to create debug output. Debug information output can be disabled with -g0.
path
Passed to the cpp(1) preprocessor to add header search directory to override system defaults.
file
Tells the cpp(1) preprocessor to include the file during preprocessing.
path
Defines path as a system header directory for the cpp(1) preprocessor.
Generate PIC code. See -fpic option.
path
Passed to the linker, to add path to the list of directories searched for shared libraries.
Pass -M flag to cpp(1) to generate dependencies for make(1).
option
Target-dependent options. Multiple -m options can be given, the following are supported:
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
 
Do not link with the system default libraries (libc, etc.)
Do not link with the system startup files (crt0.c, etc.)
Do not use the system include paths (/usr/include, etc.)
Do not link with the system default libraries or startup files.
[level]
Enable compiler optimizations. Currently, for levels higher than zero, this defines __OPTIMIZE__ in the cpp(1) preprocessor, and passes -xdce, -xdeljumps, -xtemps and -xinline to ccom(1). If no level is given the optimization level is increased, or optimizations can be disabled using -O0.
outfile
Save result to outfile.
Inhibit generation of line markers in preprocessor output. This is sometimes useful when running the preprocessor on something other than C code.
Enable profiling on the generated executable.
Defines the _PTHREADS preprocessor identifier for cpp(1), and adds -lpthread to the ld(1) linker arguments.
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.
Create a shared object of the result. Tells the linker not to generate an executable.
Do not use dynamic linkage. By default, it will link using the dynamic linker options and/or shared objects for the platform.
Passed to cpp(1) to suppress some default macro definitions and enable use of traditional C preprocessor syntax.
macro
Passes to the cpp(1) preprocessor to remove the initial macro definition.
Outputs the version of cc and shows what commands will be run with their command line arguments.
,options
Comma separated list of options for the assembler.
,options
Comma separated list of options for the compiler.
,options
Comma separated list of options for the linker.
,options
Comma separated list of options for the preprocessor.
Don't remove temporary files on exit.
language
GCC compatibility option; specify the language in use rather than interpreting the filename extension. Currently known language values are none, c, c++, assembler and assembler-with-cpp. Any unknown -x options are passed to ccom(1).

A few macros are predefined by cc when sent to cpp(1).
__PCC__
Set to the major version of pcc(1). These macros can be used to select code based on pcc(1) compatibility. See the -v option.
__PCC_MINOR__
Set to the minor version.
__PCC_MINORMINOR__
Set to the minor-minor version — the number after the minor version.
_PTHREADS
Defined when -pthread switch is used.
__ASSEMBLER__
Defined when input files have a .S suffix, or if the -xassembler-with-cpp option is specified.

Also system- and/or machine-dependent macros may also be predefined; for example: __NetBSD__, __ELF__, and __i386__.

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

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.

June 20, 2014 FreeBSD 13.1-RELEASE

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.