GCC中文手册.docx
《GCC中文手册.docx》由会员分享，可在线阅读，更多相关《GCC中文手册.docx（58页珍藏版）》请在冰豆网上搜索。
GCC中文手册
GCC中文手册
GCC中文手册
作者：
徐明
GCC
Section:
GNUTools
（1）
Updated:
2003/12/05
IndexReturntoMainContents
------------------------------------------------------------------------
NAME
gcc,g++-GNU工程的C和C++编译器（egcs-1.1.2）
总览（SYNOPSIS）
gcc[option|filename]...
g++[option|filename]...
警告（WARNING）
本手册页内容摘自GNUC编译器的完整文档,仅限于解释选项的含义.
除非有人自愿维护,否则本手册页不再更新.如果发现手册页和软件之间有所矛盾,请
查对Info文件,Info文件是权威文档.
如果我们发觉本手册页的内容由于过时而导致明显的混乱和抱怨时,我们就停止发布
它.不可能有其他选择,象更新Info文件同时更新man手册,因为其他维护GNUCC的工
作没有留给我们时间做这个.GNU工程认为man手册是过时产物,应该把时间用到别的
地方.
如果需要完整和最新的文档,请查阅Info文件`gcc'或UsingandPortingGNUCC（
forversion2.0）（使用和移植GNUCC2.0）手册.二者均来自Texinfo原文件gcc
texinfo.
描述（DESCRIPTION）
C和C++编译器是集成的.他们都要用四个步骤中的一个或多个处理输入文件:
预处理
（preprocessing）,编译（compilation）,汇编（assembly）和连接（linking）.源文件后
缀名标识源文件的语言,但是对编译器来说,后缀名控制着缺省设定:
gcc
认为预处理后的文件（.i）是C文件,并且设定C形式的连接.
g++
认为预处理后的文件（.i）是C++文件,并且设定C++形式的连接.
源文件后缀名指出语言种类以及后期的操作:
cC源程序;预处理,编译,汇编
CC++源程序;预处理,编译,汇编
ccC++源程序;预处理,编译,汇编
cxxC++源程序;预处理,编译,汇编
mObjective-C源程序;预处理,编译,汇编
i预处理后的C文件;编译,汇编
ii预处理后的C++文件;编译,汇编
s汇编语言源程序;汇编
S汇编语言源程序;预处理,汇编
h预处理器文件;通常不出现在命令行上
其他后缀名的文件被传递给连接器（linker）.通常包括:
o目标文件（Objectfile）
a归档库文件（Archivefile）
除非使用了-c,-S,或-E选项（或者编译错误阻止了完整的过程）,否则连接总是最后
的步骤.在连接阶段中,所有对应于源程序的.o文件,-l库文件,无法识别的文件名（
包括指定的.o目标文件和.a库文件）按命令行中的顺序传递给连接器.
选项（OPTIONS）
选项必须分立给出:
`-dr'完全不同于`-d-r'.
大多数`-f'和`-W'选项有两个相反的格式:
-fname和-fno-name（或-Wname和-Wno
-name）.这里只列举不是默认选项的格式.
下面是所有选项的摘要,按类型分组,解释放在后面的章节中.
总体选项（OverallOption）
-c-S-E-ofile-pipe-v-xlanguage
语言选项（LanguageOption）
-ansi-fall-virtual-fcond-mismatch-fdollars-in-identifiers-fenum-int-
equiv-fexternal-templates-fno-asm-fno-builtin-fhosted-fno-hosted-f
freestanding-fno-freestanding-fno-strict-prototype-fsigned-bitfields
-fsigned-char-fthis-is-variable-funsigned-bitfields-funsigned-char-f
writable-strings-traditional-traditional-cpp-trigraphs
警告选项（WarningOption）
-fsyntax-only-pedantic-pedantic-errors-w-W-Wall-Waggregate-return
-Wcast-align-Wcast-qual-Wchar-subscript-Wcomment-Wconversion-Wenum-
clash-Werror-Wformat-Wid-clash-len-Wimplicit-Wimplicit-int-Wimplic
it-function-declaration-Winline-Wlong-long-Wmain-Wmissing-prototypes
-Wmissing-declarations-Wnested-externs-Wno-import-Wparentheses-Wpoi
nter-arith-Wredundant-decls-Wreturn-type-Wshadow-Wstrict-prototypes
-Wswitch-Wtemplate-debugging-Wtraditional-Wtrigraphs-Wuninitialized
-Wunused-Wwrite-strings
调试选项（DebuggingOption）
-a-dletters-fpretend-float-g-glevel-gcoff-gxcoff-gxcoff+-gdwarf
-gdwarf+-gstabs-gstabs+-ggdb-p-pg-save-temps-print-file-name=libr
ary-print-libgcc-file-name-print-prog-name=program
优化选项（OptimizationOption）
-fcaller-saves-fcse-follow-jumps-fcse-skip-blocks-fdelayed-branch-fe
lide-constructors-fexpensive-optimizations-ffast-math-ffloat-store-f
force-addr-fforce-mem-finline-functions-fkeep-inline-functions-fmemo
ize-lookups-fno-default-inline-fno-defer-pop-fno-function-cse-fno-in
line-fno-peephole-fomit-frame-pointer-frerun-cse-after-loop-fschedul
e-insns-fschedule-insns2-fstrength-reduce-fthread-jumps-funroll-all-
loops-funroll-loops-O-O2-O3
预处理器选项（PreprocessorOption）
-Aassertion-C-dD-dM-dN-Dmacro[=defn]-E-H-idirafterdir-include
file-imacrosfile-iprefixfile-iwithprefixdir-M-MD-MM-MMD-nostd
inc-P-Umacro-undef
汇编器选项（AssemblerOption）
-Wa,option
连接器选项（LinkerOption）
-llibrary-nostartfiles-nostdlib-static-shared-symbolic-Xlinkeropt
ion-Wl,option-usymbol
目录选项（DirectoryOption）
-Bprefix-Idir-I--Ldir
目标机选项（TargetOption）
-bmachine-Vversion
配置相关选项（ConfigurationDependentOption）
M680x0选项
-m68000-m68020-m68020-40-m68030-m68040-m68881-mbitfield-mc68000-
mc68020-mfpa-mnobitfield-mrtd-mshort-msoft-float
VAX选项
-mg-mgnu-munix
SPARC选项
-mepilogue-mfpu-mhard-float-mno-fpu-mno-epilogue-msoft-float-mspar
clite-mv8-msupersparc-mcypress
Convex选项
-margcount-mc1-mc2-mnoargcount
AMD29K选项
-m29000-m29050-mbw-mdw-mkernel-registers-mlarge-mnbw-mnodw-msmal
l-mstack-check-muser-registers
M88K选项
-m88000-m88100-m88110-mbig-pic-mcheck-zero-division-mhandle-large-s
hift-midentify-revision-mno-check-zero-division-mno-ocs-debug-info-m
no-ocs-frame-position-mno-optimize-arg-area-mno-serialize-volatile-mn
o-underscores-mocs-debug-info-mocs-frame-position-moptimize-arg-area
-mserialize-volatile-mshort-data-num-msvr3-msvr4-mtrap-large-shift-
muse-div-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-mh
c-struct-return-min-line-mul-mminimum-fp-blocks-mnohc-struct-return
MIPS选项
-mcpu=cputype-mips2-mips3-mint64-mlong64-mmips-as-mgas-mrnames-
mno-rnames-mgpopt-mno-gpopt-mstats-mno-stats-mmemcpy-mno-memcpy-m
no-mips-tfile-mmips-tfile-msoft-float-mhard-float-mabicalls-mno-abi
calls-mhalf-pic-mno-half-pic-Gnum-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-mlo
ng-calls-mdisable-fpregs-mdisable-indexing-mtrailing-colon
i960选项
-mcpu-type-mnumerics-msoft-float-mleaf-procedures-mno-leaf-procedure
s-mtail-call-mno-tail-call-mcomplex-addr-mno-complex-addr-mcode-ali
gn-mno-code-align-mic-compat-mic2.0-compat-mic3.0-compat-masm-compa
t-mintel-asm-mstrict-align-mno-strict-align-mold-align-mno-old-alig
n
DECAlpha选项
-mfp-regs-mno-fp-regs-mno-soft-float-msoft-float
SystemV选项
-G-Qy-Qn-YP,paths-Ym,dir
代码生成选项（CodeGenerationOption）
-fcall-saved-reg-fcall-used-reg-ffixed-reg-finhibit-size-directive-f
nonnull-objects-fno-common-fno-ident-fno-gnu-linker-fpcc-struct-retu
rn-fpic-fPIC-freg-struct-return-fshared-data-fshort-enums-fshort-d
ouble-fvolatile-fvolatile-global-fverbose-asm
总体选项（OverallOption）
-xlanguage
明确指出后面输入文件的语言为language（而不是从文件名后缀得到的默认选择）.
这个选项应用于后面所有的输入文件,直到遇着下一个`-x'选项.language的可选
值有`c',`objective-c',`c-header',`c++',`cpp-output',`assembler',和`
assembler-with-cpp'.
-xnone
关闭任何对语种的明确说明,因此依据文件名后缀处理后面的文件（就象是从未使用
过`-x'选项）.
如果只操作四个阶段（预处理,编译,汇编,连接）中的一部分,可以使用`-x'选项（或文
件名后缀）告诉gcc从哪里开始,用`-c',`-S',或`-E'选项告诉gcc到哪里结束.注
意,某些选项组合（例如,`-xcpp-output-E'）使gcc不作任何事情.
-c
编译或汇编源文件,但是不作连接.编译器输出对应于源文件的目标文件.
缺省情况下,GCC通过用`.o'替换源文件名后缀`.c',`.i',`.s',等等,产生目标文
件名.可以使用-o选项选择其他名字.
GCC忽略-c选项后面任何无法识别的输入文件（他们不需要编译或汇编）.
-S
编译后即停止,不进行汇编.对于每个输入的非汇编语言文件,输出文件是汇编语言文
件.
缺省情况下,GCC通过用`.o'替换源文件名后缀`.c',`.i',等等,产生目标文件名
可以使用-o选项选择其他名字.
GCC忽略任何不需要编译的输入文件.
-E
预处理后即停止,不进行编译.预处理后的代码送往标准输出.
GCC忽略任何不需要预处理的输入文件.
-ofile
指定输出文件为file.该选项不在乎GCC产生什么输出,无论是可执行文件,目标文件
汇编文件还是预处理后的C代码.
由于只能指定一个输出文件,因此编译多个输入文件时,使用`-o'选项没有意义,除非
输出一个可执行文件.
如果没有使用`-o'选项,默认的输出结果是:
可执行文件为`a.out',`source.suffi
x'的目标文件是`source.o',汇编文件是`source.s',而预处理后的C源代码送往标
准输出.
-v
（在标准错误）显示执行编译阶段的命令.同时显示编译器驱动程序,预处理器,编译器
的版本号.
-pipe
在编译过程的不同阶段间使用管道而非临时文件进行通信.这个选项在某些系统上无
法工作,因为那些系统的汇编器不能从管道读取数据.GNU的汇编器没有这个问题.
语言选项（LANGUAGEOPTIONS）
下列选项控制编译器能够接受的C"方言":
-ansi
支持符合ANSI标准的C程序.
这样就会关闭GNUC中某些不兼容ANSIC的特性,例如asm,inline和typeof关键字
以及诸如unix和vax这些表明当前系统类型的预定义宏.同时开启不受欢迎和极少
使用的ANSItrigraph特性,以及禁止`$'成为标识符的一部分.
尽管使用了`-ansi'选项,下面这些可选的关键字,__asm__,__extension__,__in
line__和__typeof__仍然有效.你当然不会把他们用在ANSIC程序中,但可以把他们
放在头文件里,因为编译包含这些头文件的程序时,可能会指定`-ansi'选项.另外一
些预定义宏,如__unix__和__vax__,无论有没有使用`-ansi'选项,始终有效.
使用`-ansi'选项不会自动拒绝编译非ANSI程序,除非增加`-pedantic'选项作为`-
ansi'选项的补充.
使用`-ansi'选项的时候,预处理器会预定义一个__STRICT_ANSI__宏.有些头文件关
注此宏,以避免声明某些函数,或者避免定义某些宏,这些函数和宏不被ANSI标准调用
;这样就不会干扰在其他地方使用这些名字的程序了.
-fno-asm
不把asm,inline或typeof当作关键字,因此这些词可以用做标识符.用__asm__,_
_inline__和__typeof__能够替代他们.`-ansi'隐含声明了`-fno-asm'.
-fno-builtin
不接受不是两个下划线开头的内建函数（built-infunction）.目前受影响的函数有
_exit,abort,abs,alloca,cos,exit,fabs,labs,memcmp,memcpy,sin,s
qrt,strcmp,strcpy,和strlen.
`-ansi'选项能够阻止alloca和_exit成为内建函数.
-fhosted
按宿主环境编译;他隐含声明了`-fbuiltin'选项,而且警告不正确的main函数声明.
-ffreestanding
按独立环境编译;他隐含声明了`-fno-builtin'选项,而且对main函数没有特别要求
（译注:
宿主环境（hostedenvironment）下所有的标准库可用,main函数返回一个in
t值,典型例子是除了内核以外几乎所有的程序.对应的独立环境（freestandingen
vironment）不存在标准库,程序入口也不一定是main,最明显的例子就是操作系统内
核.详情参考gcc网站最近的资料）
-fno-strict-prototype
对于没有参数的函数声明,例如`intfoo（）;',按C风格处理---即不说明参数个数或
类型.（仅针对C++）.正常情况下,这样的函数foo在C++中意味着参数为空.
-trigraphs
支持ANSICtrigraphs.`-ansi'选项隐含声明了`-trigraphs'.
-traditional
试图支持传统C编译器的某些方面.详见GNUC手册,我们已经把细节清单从这里删除
这样当内容过时后,人们也不会埋怨我们.
除了一件事:
对于C++程序（不是C）,`-traditional'选项带来一个附加效应,允许对
this赋值.他和`-fthis-is-variable'选项的效果一样.
-traditional-cpp
试图支持传统C预处理器的某些方面.特别是上面提到有关预处理器的内容,但是不包
括`-traditional'选项的其他效应.
-fdollars-in-identifiers
允许在标识符（identifier）中使用`$'字符（仅针对C++）.你可以指定`-fno-dollar
s-in-identifiers'选项显明禁止使用`$'符.（GNUC++在某些目标系统缺省允许`
$'符,但不是所有系统.）
-fenum-int-equiv
允许int类型到枚举类型（enumeration）的隐式转换（仅限于C++）.正常情况下GNUC+
+允许从enum到int的转换,反之则不行.
-fexternal-templates
为模板声明（templatedeclaration）产生较小的代码（仅限于C++）,方法是对于每个
模板函数（templatefunction）,只在定义他们的地方生成一个副本.想要成功使用
这个选项,你必须在所有使用模板的文件中,标记`#pragmaimplementation'（定义
）或`#pragmainterface'（声明）.
当程序用`-fexternal-templates'编译时,模板实例（templateinstantiation）全
部是外部类型.你必须让需要的实例在实现文件中出现.可以通过typedef实现这一点
他引用所需的每个实例.相对应的,如果编译时使用缺省选项`-fno-external-tem
plates',所有模板实例明确的设为内置.
-fall-virtual
所有可能的成员函数默认为虚函数.所有的成员函数（除了构造子函数和new或delet
e成员操作符）视为所在类的虚函数.
这不表明每次调用成员函数都将通过内部虚函数表.有些情况下,编译器能够判断出
可以直接调用某个虚函数;这时就直接调用.
-fcond-mismatch
允许条件表达式的第二和第三个参数的类型不匹配.这种表达式的值是void.
-fthis-is-variable
允许对this赋值（仅对C++）.合并用户自定义的自由存储管理机制到C++后,使可赋值
的`this'显得不合时宜.因此,默认情况下,类成员函数内部对this赋值是无效操作
然而为了向后兼容,你可以通过`-fthis-is-variable'选项使这种操作有效.
-funsigned-char
把char定义为无符
升级会员 