学步园

最权威各版本的GNU 手册见 http://gcc.gnu.org/onlinedocs/

--------------------------------------------------------------------------------------------------------------------------------------------

转自 http://blog.csdn.net/dai_weitao/article/details/1765785 && http://www.shanghai.ws/gnu/gcc_1.htm

<序 >  

伟大的GNU认为man手册是Open Source发展的过时产物, 于是他们针对各种当家软件出了各自的手册, 如GNU Emacs, GNU Vim, 当然gcc是不可缺少的, 这是Stallman一生最伟大的产物之一.

Richard Stallman 是Open Source界的伟大人物之一, 他是gcc, gdb, emacs的作者, 名声在OS界不可谓不大. 有一次, 他去某企业面试, 面试方问他, 你会用gdb吗? Stallman一语惊人: 会, 那就是我写的.

好了, 闲话少说, 还是说gcc吧.

1. 前言:

gcc是一款编译器, 它主要在UNIX-BASE的系统上使用, windows版也有, 集成在MinGW中, 为了把GNU推广到Windows, 真是煞费苦心啊.

gcc编译器主要用于编译C和C++程序, 编译C++程序时通常使用g++命令, 实际上是gcc连接了libstdc++库.

编译命令:

2. 编译步骤:

gcc编译器在编译时, 都需要用四个步骤里的一个或多个处理输入文件, 这四个步骤是:

• 预处理(Pre-Processing)
• 编译(Compilation)
• 汇编(Assembly)
• 连接(Linking)

在这个过程中, 源文件的后缀名控制着编译器的缺省设定. 这个后缀指示出了程序代码所用语言

• gcc: 认为预处理后的文件(.i)是C文件.
• g++: 认为预处理后的文件(.i)是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, 否则连接总是最后的步骤.

总览(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-templates -fno-asm -fno-builtin -fhosted -fno-hosted -ffreestanding -fno-freestanding -fno-strict-prototype -fsigned-bitfields
-fsigned-char -fthis-is-variable -funsigned-bitfields -funsigned-char -fwritable-strings -traditional -traditional-cpp -trigraphs

警告选项(Warning Option)

-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 -Wimplicit-function-declaration -Winline -Wlong-long -Wmain -Wmissing-prototypes -Wmissing-declarations -Wnested-externs -Wno-import -Wparentheses -Wpointer-arith -Wredundant-decls -Wreturn-type -Wshadow -Wstrict-prototypes -Wswitch -Wtemplate-debugging
-Wtraditional -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-functions -fkeep-inline-functions
-fmemoize-lookups -fno-default-inline -fno-defer-pop -fno-function-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 -iprefix 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 symbol

目录选项(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 -mnobitfield -mrtd -mshort -msoft-float

VAX选项 
-mg -mgnu -munix

SPARC选项 
-mepilogue -mfpu -mhard-float -mno-fpu -mno-epilogue -msoft-float -msparclite -mv8 -msupersparc -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-revision -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 -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 -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 -mhard-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-fpregs -mdisable-indexing -mtrailing-colon

i960选项 
-mcpu-type -mnumerics -msoft-float -mleaf-procedures -mno-leaf-procedures -mtail-call -mno-tail-call -mcomplex-addr -mno-complex-addr -mcode-align -mno-code-align -mic-compat -mic2.0-compat
-mic3.0-compat -masm-compat -mintel-asm -mstrict-align -mno-strict-align -mold-align -mno-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
-fshared-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 "方言":

-ansi

支持符合ANSI标准的C程序.

这样就会关闭GNU C中某些不兼容ANSI C的特性,例如asm, inline和 typeof关键字,以及诸如unix和vax这些表明当前系统类型的预定义宏.同时开启
不受欢迎和极少使用的ANSI trigraph特性,以及禁止`$'成为标识符的一部分.

尽管使用了`-ansi'选项,下面这些可选的关键字, __asm__, __extension__, __inline__和__typeof__仍然有效.你当然不会把
他们用在ANSI C程序中,但可以把他们放在头文件里,因为编译包含这些头文件的程序时,可能会指定 `-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-in function).目前受影响的函数有_exit, abort, abs, alloca, cos, exit, fabs, labs, memcmp, memcpy, sin, sqrt, strcmp,strcpy,和strlen.

`-ansi'选项能够阻止alloca和_exit成为内建函数.

-fhosted

按宿主环境编译;他隐含声明了`-fbuiltin'选项,而且警告不正确的main函数声明.

-ffreestanding

按独立环境编译;他隐含声明了`-fno-builtin'选项,而且对main函数没有特别要求.

(译注:宿主环境(hosted
environment)下所有的标准库可用, main函数返回一个int值,典型例子是除了
内核以外几乎所有的程序.对应的独立环境(freestanding environment)不存在标准库,程序入口也不一定是 main,最明显的例子就是操作系统内核.详情参考gcc网站最近的资料)

-fno-strict-prototype

对于没有参数的函数声明,例如`int foo ();',按C风格处理---即不说明参数个数或类型.
(仅针对C++).正常情况下,这样的函数foo在C++中意味着参数为空.

-trigraphs

支持ANSI C trigraphs. `-ansi'选项隐含声明了`-trigraphs'.

-traditional

试图支持传统C编译器的某些方面.详见GNU
C手册,我们已经把细节清单从这里删除,这样当内容过时后,人们也不会
埋怨我们.

除了一件事:对于C++程序(不是C),
`-traditional'选项带来一个附加效应,允许对 this赋值.他和`-fthis-is-variable'选项的效果一样.

-traditional-cpp

试图支持传统C预处理器的某些方面.特别是上面提到有关预处理器的内容,但是不包括 `-traditional'选项的其他效应.

-fdollars-in-identifiers

允许在标识符