gcc教程.txt

对gcc编译器进行了深入且系统的介绍

-traditional  
试图支持传统C编译器的某些方面.详见GNU C手册,我们已经把细节清单从这里删除,这样当内容过时后,人们也不会 埋怨我们.  
除了一件事:对于C++程序(不是C), `-traditional’选项带来一个附加效应,允许对 this赋值.他和`-fthis-is-variable’选项的效果一样.  


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

-fdollars-in-identifiers  
允许在标识符(identifier)中使用`$’字符(仅针对C++).你可以指定 `-fno-dollars-in-identifiers’选项显明禁止使用`$’符. (GNU C++在某些 目标系统缺省允许`$’符,但不是所有系统.)  

-fenum-int-equiv  
允许int类型到枚举类型(enumeration)的隐式转换(仅限于C++).正常情况下GNU C++允许从 enum到int的转换,反之则不行.  

-fexternal-templates  
为模板声明(template declaration)产生较小的代码(仅限于C++),方法是对于每个模板函数 (template function),只在定义他们的地方生成一个副本.想要成功使用这个选项,你必须在所有使用模板的 文件中,标记`#pragma implementation’ (定义)或`#pragma interface’ (声明).  
当程序用`-fexternal-templates’编译时,模板实例(template instantiation) 全部是外部类型.你必须让需要的实例在实现文件中出现.可以通过typedef实现这一点,他引用所需的每个 实例.相对应的,如果编译时使用缺省选项`-fno-external-templates’,所有模板实例明确的设为内置.  


-fall-virtual  
所有可能的成员函数默认为虚函数.所有的成员函数(除了构造子函数和new或delete 成员操作符)视为所在类的虚函数.  
这不表明每次调用成员函数都将通过内部虚函数表.有些情况下,编译器能够判断出可以直接调用某个虚函数;这时就 直接调用.  


-fcond-mismatch  
允许条件表达式的第二和第三个参数的类型不匹配.这种表达式的值是void.  

-fthis-is-variable  
允许对this赋值(仅对C++).合并用户自定义的自由存储管理机制到C++后,使可赋值的 `this’显得不合时宜.因此,默认情况下,类成员函数内部对this赋值是无效操作.然而为了 向后兼容,你可以通过`-fthis-is-variable’选项使这种操作有效.  

-funsigned-char  
把char定义为无符号类型,如同unsigned char.  
各种机器都有自己缺省的char类型.既可能是unsigned char也可能是signed char .  

理想情况下,当依赖于数据的符号性时,一个可移植程序总是应该使用signed char或unsigned char.但是许多程序已经写成只用简单的char,并且期待这是有符号数(或者无符号数,具体情况取决于 编写程序的目标机器).这个选项,和它的反义选项,使那样的程序工作在对应的默认值上.  

char的类型始终应该明确定义为signed char或unsigned char,即使 它表现的和其中之一完全一样.  


-fsigned-char  
把char定义为有符号类型,如同signed char.  
这个选项等同于`-fno-unsigned-char’,他是the negative form of `-funsigned-char’的相反选项.同样, `-fno-signed-char’等价于 `-funsigned-char’.  


-fsigned-bitfields  
-funsigned-bitfields  
-fno-signed-bitfields  
-fno-unsigned-bitfields  
如果没有明确声明`signed’或`unsigned’修饰符,这些选项用来定义有符号位域 (bitfield)或无符号位域.缺省情况下,位域是有符号的,因为他们继承的基本整数类型,如int,是 有符号数.  
然而,如果指定了`-traditional’选项,位域永远是无符号数.  


-fwritable-strings  
把字符串常量存储到可写数据段,而且不做特别对待.这是为了兼容一些老程序,他们假设字符串常量是可写的. `-traditional’选项也有相同效果.  
篡改字符串常量是一个非常糟糕的想法; ``常量’’就应该是常量.  


   
预处理器选项(Preprocessor Option) 
下列选项针对C预处理器,预处理器用在正式编译以前,对C 源文件进行某种处理.  
如果指定了`-E’选项, GCC只进行预处理工作.下面的某些选项必须和`-E’选项一起才 有意义,因为他们的输出结果不能用于编译.  


-include file  
在处理常规输入文件之前,首先处理文件file,其结果是,文件file的内容先得到编译. 命令行上任何`-D’和`-U’选项永远在`-include file’之前处理, 无论他们在命令行上的顺序如何.然而`-include’和`-imacros’选项按书写顺序处理.  

-imacros file  
在处理常规输入文件之前,首先处理文件file,但是忽略输出结果.由于丢弃了文件file的 输出内容, `-imacros file’选项的唯一效果就是使文件file中的宏定义生效, 可以用于其他输入文件.在处理`-imacrosfile’选项之前,预处理器首先处理`-D’ 和`-U’选项,并不在乎他们在命令行上的顺序.然而`-include’和 `-imacros’选项按书写顺序处理.  

-idirafter dir  
把目录dir添加到第二包含路径中.如果某个头文件在主包含路径(用`-I’添加的路径)中没有 找到,预处理器就搜索第二包含路径.  

-iprefix prefix  
指定prefix作为后续`-iwithprefix’选项的前缀.  

-iwithprefix dir  
把目录添加到第二包含路径中.目录名由prefix和dir合并而成,这里 prefix被先前的`-iprefix’选项指定.  

-nostdinc  
不要在标准系统目录中寻找头文件.只搜索`-I’选项指定的目录(以及当前目录,如果合适).  
结合使用`-nostdinc’和`-I-’选项,你可以把包含文件搜索限制在显式指定的目录.  


-nostdinc++  
不要在C++专用标准目录中寻找头文件,但是仍然搜索其他标准目录. (当建立`libg++’时使用 这个选项.)  
-undef  
不要预定义任何非标准宏. (包括系统结构标志).  

-E  
仅运行C预处理器.预处理所有指定的C源文件,结果送往标准输出或指定的输出文件.  

-C  
告诉预处理器不要丢弃注释.配合`-E’选项使用.  

-P  
告诉预处理器不要产生`#line’命令.配合`-E’选项使用.  

-M  [ -MG ]  
告诉预处理器输出一个适合make的规则,用于描述各目标文件的依赖关系.对于每个源文件,预处理器输出 一个make规则,该规则的目标项(target)是源文件对应的目标文件名,依赖项(dependency)是源文件中 `#include引用的所有文件.生成的规则可以是单行,但如果太长,就用`\’-换行符续成多行.规则 显示在标准输出,不产生预处理过的C程序.  
`-M’隐含了`-E’选项.  

`-MG’要求把缺失的头文件按存在对待,并且假定他们和源程序文件在同一目录下.必须和 `-M’选项一起用.  


-MM  [ -MG ]  
和`-M’选项类似,但是输出结果仅涉及用户头文件,象这样`#include file"’.忽略系统头文件如`#include <file>’.  

-MD  
和`-M’选项类似,但是把依赖信息输出在文件中,文件名通过把输出文件名末尾的`.o’替换为 `.d’产生.同时继续指定的编译工作---`-MD’不象`-M’那样阻止正常的编译任务.  
Mach的实用工具`md’能够合并`.d’文件,产生适用于`make’命令的单一的 依赖文件.  


-MMD  
和`-MD’选项类似,但是输出结果仅涉及用户头文件,忽略系统头文件.  

-H  
除了其他普通的操作, GCC显示引用过的头文件名.  

-Aquestion(answer)  
如果预处理器做条件测试,如`#if #question(answer)’,该选项可以断言(Assert) question的答案是answer. -A-’关闭一般用于描述目标机的标准断言.  

-Dmacro  
定义宏macro,宏的内容定义为字符串`1’.  

-Dmacro=defn  
定义宏macro的内容为defn.命令行上所有的`-D’选项在 `-U’选项之前处理. 

wy79 2005-1-5 11:09 
 
-Umacro  
取消宏macro. `-U’选项在所有的`-D’选项之后处理,但是优先于任何 `-include’或`-imacros’选项.  

-dM  
告诉预处理器输出有效的宏定义列表(预处理结束时仍然有效的宏定义).该选项需结合`-E’选项使用.  

-dD  
告诉预处理器把所有的宏定义传递到输出端,按照出现的顺序显示.  

-dN  
和`-dD’选项类似,但是忽略宏的参量或内容.只在输出端显示`#define name.  

   
汇编器选项(ASSEMBLER OPTION) 
-Wa,option  
把选项option传递给汇编器.如果option含有逗号,就在逗号处分割成多个选项.  

   
连接器选项(LINKER OPTION) 
下面的选项用于编译器连接目标文件,输出可执行文件的时候.如果编译器不进行 连接,他们就毫无意义.  

object-file-name  
如果某些文件没有特别明确的后缀a special recognized suffix, GCC就认为他们是目标文件或库文件. (根据文件内容,连接器能够区分目标文件和库文件).如果GCC执行连接操作,这些目标文件将成为连接器的输入文件.  

-llibrary  
连接名为library的库文件.  
连接器在标准搜索目录中寻找这个库文件,库文件的真正名字是`liblibrary.a’.连接器会 当做文件名得到准确说明一样引用这个文件.  

搜索目录除了一些系统标准目录外,还包括用户以`-L’选项指定的路径.  

一般说来用这个方法找到的文件是库文件---即由目标文件组成的归档文件(archive file).连接器处理归档文件的 方法是:扫描归档文件,寻找某些成员,这些成员的符号目前已被引用,不过还没有被定义.但是,如果连接器找到普通的 目标文件,而不是库文件,就把这个目标文件按平常方式连接进来.指定`-l’选项和指定文件名的唯一区别是, `-l选项用`lib’和`.a’把library包裹起来,而且搜索一些目录.  


-lobjc  
这个-l选项的特殊形式用于连接Objective C程序.  

-nostartfiles  
不连接系统标准启动文件,而标准库文件仍然正常使用.  

-nostdlib  
不连接系统标准启动文件和标准库文件.只把指定的文件传递给连接器.  

-static  
在支持动态连接(dynamic linking)的系统上,阻止连接共享库.该选项在其他系统上无效.  

-shared  
生成一个共享目标文件,他可以和其他目标文件连接产生可执行文件.只有部分系统支持该选项.  

-symbolic  
建立共享目标文件的时候,把引用绑定到全局符号上.对所有无法解析的引用作出警告(除非用连接编辑选项 `-Xlinker -z -Xlinker defs’取代).只有部分系统支持该选项.  


-Xlinker option  
把选项option传递给连接器.可以用他传递系统特定的连接选项, GNU CC无法识别这些选项.  
如果需要传递携带参数的选项,你必须使用两次`-Xlinker’,一次传递选项,另一次传递他的参数. 例如,如果传递`-assert definitions’,你必须写成`-Xlinker -assert -Xlinker definitions’,而不能写成`-Xlinker "-assert definitions"’,因为这样会把整个 字符串当做一个参数传递,显然这不是连接器期待的.  


-Wl,option  
把选项option传递给连接器.如果option中含有逗号,就在逗号处分割成多个选项.  

-u symbol  
使连接器认为取消了symbol的符号定义,从而连接库模块以取得定义.你可以使用多个 `-u’选项,各自跟上不同的符号,使得连接器调入附加的库模块.  

   
目录选项(DIRECTORY OPTION) 
下列选项指定搜索路径,用于查找头文件,库文件,或编译器的某些成员:  
-Idir  
在头文件的搜索路径列表中添加dir 目录.  

-I-  
任何在`-I-’前面用`-I’选项指定的搜索路径只适用于`#include "file"’这种情况;他们不能用来搜索`#include <file>’包含的头文件.  
如果用`-I’选项指定的搜索路径位于`-I-’选项后面,就可以在这些路径中搜索所有的 `#include’指令. (一般说来-I选项就是这么用的.)  

还有, `-I-’选项能够阻止当前目录(存放当前输入文件的地方)成为搜索`#include "file"’的第一选择.没有办法克服`-I-’选项的这个效应.你可以指定 `-I.’搜索那个目录,它在调用编译器时是当前目录.这和预处理器的默认行为不完全一样,但是结果通常 令人满意.  

`-I-’不影响使用系统标准目录,因此, `-I-’和`-nostdinc’是不同的选项.  


-Ldir  
在`-l’选项的搜索路径列表中添加dir目录.  

-Bprefix  
这个选项指出在何处寻找可执行文件,库文件,以及编译器自己的数据文件.  
编译器驱动程序需要执行某些下面的子程序: `cpp’, `cc1’ (或C++的 `cc1plus’), `as’和`ld’.他把prefix当作欲执行的程序的 前缀,既可以包括也可以不包括`machine/version/’.  

对于要运行的子程序,编译器驱动程序首先试着加上`-B’前缀(如果存在).如果没有找到文件,或没有指定 `-B’选项,编译器接着会试验两个标准前缀`/usr/lib/gcc/’和 `/usr/local/lib/gcc-lib/’.如果仍然没能够找到所需文件,编译器就在`PATH’环境变量 指定的路径中寻找没加任何前缀的文件名.  

如果有需要,运行时(run-time)支持文件`libgcc.a’也在`-B’前缀的搜索范围之内. 如果这里没有找到,就在上面提到的两个标准前缀中寻找,仅此而已.如果上述方法没有找到这个文件,就不连接他了.多数 情况的多数机器上, `libgcc.a’并非必不可少.  

你可以通过环境变量GCC_EXEC_PREFIX获得近似的效果;如果定义了这个变量,其值就和上面说的 一样用做前缀.如果同时指定了`-B’选项和GCC_EXEC_PREFIX变量,编译器首先使用 `-B’选项,然后才尝试环境变量值.  


   
警告选项(WARNING OPTION) 
警告是针对程序结构的诊断信息,程序不一定有错误,而是存在风险,或者可能存在 错误.  
下列选项控制GNU CC产生的警告的数量和类型:  


-fsyntax-only  
检查程序中的语法错误,但是不产生输出信息.  
-w  
禁止所有警告信息.  
-Wno-import  
禁止所有关于#import的警告信息.  
-pedantic  
打开完全服从ANSI C标准所需的全部警告诊断;拒绝接受采用了被禁止的语法扩展的程序.  
无论有没有这个选项,符合ANSI C标准的程序应该能够被正确编译(虽然极少数程序需要`-ansi’ 选项).然而,如果没有这个选项,某些GNU扩展和传统C特性也得到支持.使用这个选项可以拒绝这些程序.没有理由 使用这个选项,他存在只是为了满足一些书呆子(pedant).  

对于替选关键字(他们以`__’开始和结束) `-pedantic’不会产生警告信息. Pedantic 也不警告跟在__extension__后面的表达式.不过只应该在系统头文件中使用这种转义措施,应用程序最好 避免.