GCC 中文手册
GCC
Section: GNU Tools (1)
Updated: 2003/12/05
Index Return to Main Contents
NAME
gcc,g++-GNU 工程的 C 和 C++编译器(egcs-1.1.2)
总览(SYNOPSIS)
gcc[option|filename ]...
g++[option|filename ]...
警告(WARNING)
本手册页内容摘自 GNU C 编译器的完整文档,仅限于解释选项的含义.
除非有人自愿维护,否则本手册页不再更新.如果发现手册页和软件之间有所矛盾,请查对 Info 文件, Info 文件是权威文档.
如果我们发觉本手册页的内容由于过时而导致明显的混乱和抱怨时,我们就停止发布它.不可能有其他选择,象更新 Info 文件同时
更新 man 手册,因为其他维护 GNU CC 的工作没有留给我们时间做这个. GNU 工程认为 man 手册是过时产物,应该把时间用到别的地
方.
如果需要完整和最新的文档,请查阅 Info 文件`gcc'或 Using and Porting GNU CC (for version 2.0) (
使用和移植
GNU
CC 2.0) 手册.二者均来自 Texinfo 原文件 gcc.texinfo.
描述(DESCRIPTION)
C 和 C++编译器是集成的.他们都要用四个步骤中的一个或多个处理输入文件: 预处理(preprocessing),编译(compilation),
汇编(assembly)和连接(linking).源文件后缀名标识源文件的 语言,但是对编译器来说,后缀名控制着缺省设定:
gcc
认为预处理后的文件(.i)是 C 文件,并且设定 C 形式的连接.
g++
认为预处理后的文件(.i)是 C++文件,并且设定 C++形式的连接.
源文件后缀名指出语言种类以及后期的操作:
.c C 源程序;预处理,编译,汇编
.C C++源程序;预处理,编译,汇编
.cc C++源程序;预处理,编译,汇编
.cxx C++源程序;预处理,编译,汇编
.m Objective-C 源程序;预处理,编译,汇编
.i 预处理后的 C 文件;编译,汇编
.ii 预处理后的 C++文件;编译,汇编
.s 汇编语言源程序;汇编
.S 汇编语言源程序;预处理,汇编
.h 预处理器文件;通常不出现在命令行上
其他后缀名的文件被传递给连接器(linker).通常包括:
.o 目标文件(Object file)
.a 归档库文件(Archive file)
除非使用了-c, -S,或-E 选项(或者编译错误阻止了完整的过程),否则连接总是 最后的步骤.在连接阶段中,所有对应于源程序的.
o 文件, -l 库文件,无法识别的文件名(包括指定的 .o 目标文件和.a 库文件)按命令行中的顺序传递给连接器.
选项(OPTIONS)
选项必须分立给出: `-dr'完全不同于`-d -r '.
大多数`-f'和`-W'选项有两个相反的格式: -fname 和 -fno-name (或-Wname 和-Wno-name).这里 只列举不是默认选项的格
式.
下面是所有选项的摘要,按类型分组,解释放在后面的章节中.
总体选项(Overall Option)
-c -S -E -o file -pipe -v -x language
语言选项(Language Option)
-ansi -fall-virtual -fcond-mismatch -fdollars-in-identifiers -fenum-int-equiv -fexternal-tem
plates -fno-asm -fno-builtin -fhosted -fno-hosted -ffreestanding -fno-freestanding -fno-stric
t-prototype -fsigned-bitfields -fsigned-char -fthis-is-variable -funsigned-bitfields -funsig
ned-char -fwritable-strings -traditional -traditional-cpp -trigraphs
警告选项(Warning Option)
-fsyntax-only -pedantic -pedantic-errors -w -W -Wall -Waggregate-return -Wcast-align -Wcast-qu
al -Wchar-subscript -Wcomment -Wconversion -Wenum-clash -Werror -Wformat -Wid-clash-len -Wimpl
icit -Wimplicit-int -Wimplicit-function-declaration -Winline -Wlong-long -Wmain -Wmissing-pr
ototypes -Wmissing-declarations -Wnested-externs -Wno-import -Wparentheses -Wpointer-arith -
Wredundant-decls -Wreturn-type -Wshadow -Wstrict-prototypes -Wswitch -Wtemplate-debugging -W
traditional -Wtrigraphs -Wuninitialized -Wunused -Wwrite-strings
调试选项(Debugging Option)
-a -dletters -fpretend-float -g -glevel -gcoff -gxcoff -gxcoff+ -gdwarf -gdwarf+ -gstabs -gstabs
+ -ggdb -p -pg -save-temps -print-file-name=library -print-libgcc-file-name -print-prog-name=
program
优化选项(Optimization Option)
-fcaller-saves -fcse-follow-jumps -fcse-skip-blocks -fdelayed-branch -felide-constructors -
fexpensive-optimizations -ffast-math -ffloat-store -fforce-addr -fforce-mem -finline-functio
ns -fkeep-inline-functions -fmemoize-lookups -fno-default-inline -fno-defer-pop -fno-functio
n-cse -fno-inline -fno-peephole -fomit-frame-pointer -frerun-cse-after-loop -fschedule-insns
-fschedule-insns2 -fstrength-reduce -fthread-jumps -funroll-all-loops -funroll-loops -O -O2
-O3
预处理器选项(Preprocessor Option)
-Aassertion -C -dD -dM -dN -Dmacro[=defn] -E -H -idirafter dir -include file -imacros file -iprefi
x file -iwithprefix dir -M -MD -MM -MMD -nostdinc -P -Umacro -undef
汇编器选项(Assembler Option)
-Wa,option
连接器选项(Linker Option)
-llibrary -nostartfiles -nostdlib -static -shared -symbolic -Xlinker option -Wl,option -u symb
ol
目录选项(Directory Option)
-Bprefix -Idir -I- -Ldir
目标机选项(Target Option)
-b machine -V version
配置相关选项(Configuration Dependent Option)
M680x0
选项
-m68000 -m68020 -m68020-40 -m68030 -m68040 -m68881 -mbitfield -mc68000 -mc68020 -mfpa -mnobitfi
eld -mrtd -mshort -msoft-float
VAX
选项
-mg -mgnu -munix
SPARC
选项
-mepilogue -mfpu -mhard-float -mno-fpu -mno-epilogue -msoft-float -msparclite -mv8 -msuperspar
c -mcypress
Convex
选项
-margcount -mc1 -mc2 -mnoargcount
AMD29K
选项
-m29000 -m29050 -mbw -mdw -mkernel-registers -mlarge -mnbw -mnodw -msmall -mstack-check -muser-
registers
M88K
选项
-m88000 -m88100 -m88110 -mbig-pic -mcheck-zero-division -mhandle-large-shift -midentify-revi
sion -mno-check-zero-division -mno-ocs-debug-info -mno-ocs-frame-position -mno-optimize-arg
-area -mno-serialize-volatile -mno-underscores -mocs-debug-info -mocs-frame-position -moptim
ize-arg-area -mserialize-volatile -mshort-data-num -msvr3 -msvr4 -mtrap-large-shift -muse-di
v-instruction -mversion-03.00 -mwarn-passed-structs
RS6000
选项
-mfp-in-toc -mno-fop-in-toc
RT
选项
-mcall-lib-mul -mfp-arg-in-fpregs -mfp-arg-in-gregs -mfull-fp-blocks -mhc-struct-return -min
-line-mul -mminimum-fp-blocks -mnohc-struct-return
MIPS
选项
-mcpu=cpu type -mips2 -mips3 -mint64 -mlong64 -mmips-as -mgas -mrnames -mno-rnames -mgpopt -mno
-gpopt -mstats -mno-stats -mmemcpy -mno-memcpy -mno-mips-tfile -mmips-tfile -msoft-float -mhar
d-float -mabicalls -mno-abicalls -mhalf-pic -mno-half-pic -G num -nocpp
i386
选项
-m486 -mno-486 -msoft-float -mno-fp-ret-in-387
HPPA
选项
-mpa-risc-1-0 -mpa-risc-1-1 -mkernel -mshared-libs -mno-shared-libs -mlong-calls -mdisable-f
pregs -mdisable-indexing -mtrailing-colon
i960
选项
-mcpu-type -mnumerics -msoft-float -mleaf-procedures -mno-leaf-procedures -mtail-call -mno-t
ail-call -mcomplex-addr -mno-complex-addr -mcode-align -mno-code-align -mic-compat -mic2.0-c
ompat -mic3.0-compat -masm-compat -mintel-asm -mstrict-align -mno-strict-align -mold-align -m
no-old-align
DEC Alpha
选项
-mfp-regs -mno-fp-regs -mno-soft-float -msoft-float
System V
选项
-G -Qy -Qn -YP,paths -Ym,dir
代码生成选项(Code Generation Option)
-fcall-saved-reg -fcall-used-reg -ffixed-reg -finhibit-size-directive -fnonnull-objects -fno
-common -fno-ident -fno-gnu-linker -fpcc-struct-return -fpic -fPIC -freg-struct-return -fshar
ed-data -fshort-enums -fshort-double -fvolatile -fvolatile-global -fverbose-asm
总体选项(Overall Option)
-x language
明确指出后面输入文件的语言为 language (而不是从文件名后缀得到的默认选择).这个选项应用于后面 所有的输入文件
,直到遇着下一个`-x'选项. language 的可选值有`c', `objective-c', `c-header', `c++', `cpp-output',
`assembler',和`assembler-with-cpp'.
-x none
关闭任何对语种的明确说明,因此依据文件名后缀处理后面的文件(就象是从未使用过`-x'选项).
如果只操作四个阶段(预处理,编译,汇编,连接)中的一部分,可以使用`-x'选项(或文件名后缀)告诉 gcc 从哪里开始,用`-c', `
-S',或`-E'选项告诉 gcc 到 哪里结束.注意,某些选项组合(例如, `-x cpp-output -E')使 gcc 不作任何事情.
-c
编译或汇编源文件,但是不作连接.编译器输出对应于源文件的目标文件.
缺省情况下, GCC 通过用`.o'替换源文件名后缀`.c', `.i', `.s',等等,产生目标文件名.可以使用-o 选项选择其他名
字.
GCC 忽略-c 选项后面任何无法识别的输入文件(他们不需要编译或汇编).
-S
编译后即停止,不进行汇编.对于每个输入的非汇编语言文件,输出文件是汇编语言文件.
缺省情况下, GCC 通过用`.o'替换源文件名后缀`.c', `.i',等等,产生 目标文件名.可以使用-o 选项选择其他名字.
GCC 忽略任何不需要编译的输入文件.
-E
预处理后即停止,不进行编译.预处理后的代码送往标准输出.
GCC 忽略任何不需要预处理的输入文件.
-o file
指定输出文件为 file.该选项不在乎 GCC 产生什么输出,无论是可执行文件,目标文件,汇编文件还是 预处理后的 C 代码.
由于只能指定一个输出文件,因此编译多个输入文件时,使用`-o'选项没有意义,除非输出一个可执行文件.
如果没有使用`-o'选项,默认的输出结果是:可执行文件为`a.out', `source.suffix '的目标文件是`source.o',汇
编文件是 `source.s',而预处理后的 C 源代码送往标准输出.
-v
(在标准错误)显示执行编译阶段的命令.同时显示编译器驱动程序,预处理器,编译器的版本号.
-pipe
在编译过程的不同阶段间使用管道而非临时文件进行通信.这个选项在某些系统上无法工作,因为那些系统的 汇编器不能
从管道读取数据. GNU 的汇编器没有这个问题.
语言选项(LANGUAGE OPTIONS)
下列选项控制编译器能够接受的 C "方言":