gcc 中文手册.htm

linux/unix下面使用GCC编译工具的一个很好的指导电子书籍

-mno-tail-call -mcomplex-addr -mno-complex-addr -mcode-ali<BR>gn -mno-code-align 
-mic-compat -mic2.0-compat -mic3.0-compat -masm-compa<BR>t -mintel-asm 
-mstrict-align -mno-strict-align -mold-align -mno-old-alig<BR>n<BR><BR>DEC 
Alpha选项<BR><BR>-mfp-regs -mno-fp-regs -mno-soft-float -msoft-float<BR><BR>System 
V选项<BR><BR>-G -Qy -Qn -YP,paths -Ym,dir<BR><BR>代码生成选项(Code Generation 
Option)<BR><BR>-fcall-saved-reg -fcall-used-reg -ffixed-reg 
-finhibit-size-directive -f<BR>nonnull-objects -fno-common -fno-ident 
-fno-gnu-linker -fpcc-struct-retu<BR>rn -fpic -fPIC -freg-struct-return 
-fshared-data -fshort-enums -fshort-d<BR>ouble -fvolatile -fvolatile-global 
-fverbose-asm<BR><BR><BR><BR>总体选项(Overall Option)<BR><BR>-x 
language<BR><BR>明确指出后面输入文件的语言为language (而不是从文件名后缀得到的默认选择).<BR>这个选项应用于后面 
所有的输入文件,直到遇着下一个`-x'选项. language的可选<BR>值有`c', `objective-c', `c-header', `c++', 
`cpp-output', `assembler',和`<BR>assembler-with-cpp'.<BR><BR>-x 
none<BR><BR>关闭任何对语种的明确说明,因此依据文件名后缀处理后面的文件(就象是从未使用<BR>过`-x'选项).<BR><BR>如果只操作四个阶段(预处理,编译,汇编,连接)中的一部分,可以使用`-x'选项(或文<BR>件名后缀)告诉 
gcc从哪里开始,用`-c', `-S',或`-E'选项告诉gcc到 哪里结束.注<BR>意,某些选项组合(例如, `-x cpp-output 
-E')使gcc不作任何事情.<BR><BR>-c<BR><BR>编译或汇编源文件,但是不作连接.编译器输出对应于源文件的目标文件.<BR><BR>缺省情况下, 
GCC通过用`.o'替换源文件名后缀`.c', `.i', 
`.s',等等,产生目标文<BR>件名.可以使用-o选项选择其他名字.<BR><BR>GCC忽略-c选项后面任何无法识别的输入文件(他们不需要编译或汇编).<BR><BR>-S<BR><BR>编译后即停止,不进行汇编.对于每个输入的非汇编语言文件,输出文件是汇编语言文<BR>件.<BR><BR>缺省情况下, 
GCC通过用`.o'替换源文件名后缀`.c', `.i',等等,产生 
目标文件名<BR>可以使用-o选项选择其他名字.<BR><BR>GCC忽略任何不需要编译的输入文件.<BR><BR>-E<BR><BR>预处理后即停止,不进行编译.预处理后的代码送往标准输出.<BR><BR>GCC忽略任何不需要预处理的输入文件.<BR><BR>-o 
file<BR><BR>指定输出文件为file.该选项不在乎GCC产生什么输出,无论是可执行文件,目标文件<BR>,汇编文件还是 
预处理后的C代码.<BR><BR>由于只能指定一个输出文件,因此编译多个输入文件时,使用`-o'选项没有意义,除非<BR>输出一个可执行文件.<BR><BR>如果没有使用`-o'选项,默认的输出结果是:可执行文件为`a.out', 
`source.suffi<BR>x '的目标文件是`source.o',汇编文件是 
`source.s',而预处理后的C源代码送往标<BR>准输出.<BR><BR>-v<BR><BR>(在标准错误)显示执行编译阶段的命令.同时显示编译器驱动程序,预处理器,编译器<BR>的版本号.<BR><BR>-pipe<BR><BR>在编译过程的不同阶段间使用管道而非临时文件进行通信.这个选项在某些系统上无<BR>法工作,因为那些系统的 
汇编器不能从管道读取数据. GNU的汇编器没有这个问题.<BR><BR><BR>语言选项(LANGUAGE 
OPTIONS)<BR><BR>下列选项控制编译器能够接受的C 
"方言":<BR><BR>-ansi<BR><BR>支持符合ANSI标准的C程序.<BR><BR>这样就会关闭GNU C中某些不兼容ANSI 
C的特性,例如asm, inline和 typeof关键字<BR>,以及诸如unix和vax这些表明当前系统类型的预定义宏.同时开启 
不受欢迎和极少<BR>使用的ANSI 
trigraph特性,以及禁止`$'成为标识符的一部分.<BR><BR>尽管使用了`-ansi'选项,下面这些可选的关键字, __asm__, 
__extension__, __in<BR>line__和__typeof__仍然有效.你当然不会把 他们用在ANSI 
C程序中,但可以把他们<BR>放在头文件里,因为编译包含这些头文件的程序时,可能会指定 
`-ansi'选项.另外一<BR>些预定义宏,如__unix__和__vax__,无论有没有使用 
`-ansi'选项,始终有效.<BR><BR>使用`-ansi'选项不会自动拒绝编译非ANSI程序,除非增加`-pedantic'选项作为 
`-<BR>ansi'选项的补充.<BR><BR>使用`-ansi'选项的时候,预处理器会预定义一个__STRICT_ANSI__宏.有些头文件 
关<BR>注此宏,以避免声明某些函数,或者避免定义某些宏,这些函数和宏不被ANSI标准调用<BR>;这样就不会干扰在其他地方 
使用这些名字的程序了.<BR><BR>-fno-asm<BR><BR>不把asm, inline或typeof当作关键字,因此这些词可以用做标识符.用 
__asm__, _<BR>_inline__和__typeof__能够替代他们. `-ansi' 
隐含声明了`-fno-asm'.<BR><BR>-fno-builtin<BR><BR>不接受不是两个下划线开头的内建函数(built-in 
function).目前受影响的函数有<BR>_exit, abort, abs, alloca, cos, exit, fabs, labs, memcmp, 
memcpy, sin, s<BR>qrt, strcmp, 
strcpy,和strlen.<BR><BR>`-ansi'选项能够阻止alloca和_exit成为内建函数.<BR><BR>-fhosted<BR><BR>按宿主环境编译;他隐含声明了`-fbuiltin'选项,而且警告不正确的main函数声明.<BR><BR><BR>-ffreestanding<BR><BR>按独立环境编译;他隐含声明了`-fno-builtin'选项,而且对main函数没有特别要求<BR><BR><BR>(译注:宿主环境(hosted 
environment)下所有的标准库可用, main函数返回一个in<BR>t值,典型例子是除了 
内核以外几乎所有的程序.对应的独立环境(freestanding en<BR>vironment)不存在标准库,程序入口也不一定是 
main,最明显的例子就是操作系统内<BR>核.详情参考gcc网站最近的资料)<BR><BR>-fno-strict-prototype<BR><BR>对于没有参数的函数声明,例如`int 
foo ();',按C风格处理---即不说明参数个数或<BR>类型. 
(仅针对C++).正常情况下,这样的函数foo在C++中意味着参数为空.<BR><BR>-trigraphs<BR><BR>支持ANSI C 
trigraphs. 
`-ansi'选项隐含声明了`-trigraphs'.<BR><BR>-traditional<BR><BR>试图支持传统C编译器的某些方面.详见GNU 
C手册,我们已经把细节清单从这里删除<BR>,这样当内容过时后,人们也不会 埋怨我们.<BR><BR>除了一件事:对于C++程序(不是C), 
`-traditional'选项带来一个附加效应,允许对<BR>this赋值.他和`-fthis-is-variable'选项的效果一样.<BR><BR>-traditional-cpp<BR><BR>试图支持传统C预处理器的某些方面.特别是上面提到有关预处理器的内容,但是不包<BR>括 
`-traditional'选项的其他效应.<BR><BR>-fdollars-in-identifiers<BR><BR>允许在标识符(identifier)中使用`$'字符(仅针对C++).你可以指定 
`-fno-dollar<BR>s-in-identifiers'选项显明禁止使用`$'符. (GNU C++在某些 
目标系统缺省允许`<BR>$'符,但不是所有系统.)<BR><BR>-fenum-int-equiv<BR><BR>允许int类型到枚举类型(enumeration)的隐式转换(仅限于C++).正常情况下GNU 
C+<BR>+允许从 enum到int的转换,反之则不行.<BR><BR>-fexternal-templates<BR><BR>为模板声明(template 
declaration)产生较小的代码(仅限于C++),方法是对于每个<BR>模板函数 (template 
function),只在定义他们的地方生成一个副本.想要成功使用<BR>这个选项,你必须在所有使用模板的 文件中,标记`#pragma 
implementation' (定义<BR>)或`#pragma interface' 
(声明).<BR><BR>当程序用`-fexternal-templates'编译时,模板实例(template instantiation) 
全<BR>部是外部类型.你必须让需要的实例在实现文件中出现.可以通过typedef实现这一点<BR>,他引用所需的每个 
实例.相对应的,如果编译时使用缺省选项`-fno-external-tem<BR>plates',所有模板实例明确的设为内置.<BR><BR>-fall-virtual<BR><BR>所有可能的成员函数默认为虚函数.所有的成员函数(除了构造子函数和new或delet<BR>e 
成员操作符)视为所在类的虚函数.<BR><BR>这不表明每次调用成员函数都将通过内部虚函数表.有些情况下,编译器能够判断出<BR>可以直接调用某个虚函数;这时就 
直接调用.<BR><BR>-fcond-mismatch<BR><BR>允许条件表达式的第二和第三个参数的类型不匹配.这种表达式的值是void.<BR><BR>-fthis-is-variable<BR><BR>允许对this赋值(仅对C++).合并用户自定义的自由存储管理机制到C++后,使可赋值<BR>的 
`this'显得不合时宜.因此,默认情况下,类成员函数内部对this赋值是无效操作<BR>然而为了 
向后兼容,你可以通过`-fthis-is-variable'选项使这种操作有效.<BR><BR>-funsigned-char<BR><BR>把char定义为无符号类型,如同unsigned 
char.<BR><BR>各种机器都有自己缺省的char类型.既可能是unsigned char也可能是signed 
char<BR><BR><BR>理想情况下,当依赖于数据的符号性时,一个可移植程序总是应该使用signed char或<BR>unsigned 
char.但是许多程序已经写成只用简单的char,并且期待这是有符号数(或<BR>者无符号数,具体情况取决于 
编写程序的目标机器).这个选项,和它的反义选项,使<BR>那样的程序工作在对应的默认值上.<BR><BR>char的类型始终应该明确定义为signed 
char或unsigned char,即使 
它表现的和其<BR>中之一完全一样.<BR><BR>-fsigned-char<BR><BR>把char定义为有符号类型,如同signed 
char.<BR><BR>这个选项等同于`-fno-unsigned-char',他是the negative form of 
`-funsigned-<BR>char'的相反选项.同样, `-fno-signed-char'等价于 
`-funsigned-char'.<BR><BR>-fsigned-bitfields<BR><BR>-funsigned-bitfields<BR><BR>-fno-signed-bitfields<BR><BR>-fno-unsigned-bitfields<BR><BR>如果没有明确声明`signed'或`unsigned'修饰符,这些选项用来定义有符号位域 
(b<BR>itfield)或无符号位域.缺省情况下,位域是有符号的,因为他们继承的基本整数类型<BR>,如int,是 
有符号数.<BR><BR>然而,如果指定了`-traditional'选项,位域永远是无符号数.<BR><BR>-fwritable-strings<BR><BR>把字符串常量存储到可写数据段,而且不做特别对待.这是为了兼容一些老程序,他们<BR>假设字符串常量是可写的. 
`-traditional'选项也有相同效果.<BR><BR>篡改字符串常量是一个非常糟糕的想法; 
``常量''就应该是常量.<BR><BR><BR><BR>预处理器选项(Preprocessor 
Option)<BR><BR>下列选项针对C预处理器,预处理器用在正式编译以前,对C 源文件进行某种处理.<BR><BR>如果指定了`-E'选项, 
GCC只进行预处理工作.下面的某些选项必须和`-E'选项一起<BR>才 有意义,因为他们的输出结果不能用于编译.<BR><BR>-include 
file<BR><BR>在处理常规输入文件之前,首先处理文件file,其结果是,文件file的内容先得到编译<BR>命令行上任何`-D'和`-U'选项永远在`-include 
file'之前处理, 无论他们在命令<BR>行上的顺序如何.然而`-include'和`-imacros'选项按书写顺序处理.<BR><BR>-imacros 
file<BR><BR>在处理常规输入文件之前,首先处理文件file,但是忽略输出结果.由于丢弃了文件f<BR>ile的 输出内容, `-imacros 
file'选项的唯一效果就是使文件file中的宏定义生效<BR>, 
可以用于其他输入文件.在处理`-imacrosfile'选项之前,预处理器首先处理`-D'<BR>和`-U'选项,并不在乎他们在命令行上的顺序.然而`-include'和 
`-imacros'选项<BR>按书写顺序处理.<BR><BR>-idirafter 
dir<BR><BR>把目录dir添加到第二包含路径中.如果某个头文件在主包含路径(用`-I'添加的路径<BR>)中没有 
找到,预处理器就搜索第二包含路径.<BR><BR>-iprefix 
prefix<BR><BR>指定prefix作为后续`-iwithprefix'选项的前缀.<BR><BR>-iwithprefix