GCCSection: GNU Tools (1)
Updated: 2003/12/05
Index Return to Main Contents NAMEgcc,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-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 -d
letters -fpretend-float -g -g
level -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)
-
-A
assertion -C -dD -dM -dN -D
macro[=
defn] -E -H -idirafter
dir -include
file -imacros
file -iprefix
file -iwithprefix
dir -M -MD -MM -MMD -nostdinc -P -U
macro -undef
-
汇编器选项(Assembler Option)
-
-Wa,
option
-
连接器选项(Linker Option)
-
-l
library -nostartfiles -nostdlib -static -shared -symbolic -Xlinker
option -Wl,
option -u
symbol
-
目录选项(Directory Option)
-
-B
prefix -I
dir -I- -L
dir
-
目标机选项(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
-
允许在标识符 (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 中的宏定义生效 , 可以用于其他输入文件 . 在处理 `
-imacros
file' 选项之前 , 预处理器首先处理 `
-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 显示引用过的头文件名 .
-
-A
question
(
answer
)
-
如果预处理器做条件测试 , 如 `
#if #
question
(
answer
)', 该选项可以断言 (Assert)
question 的答案是
answer.
-A-' 关闭一般用于描述目标机的标准断言 .
-
-D
macro
-
定义宏
macro, 宏的内容定义为字符串 `
1'.
-
-D
macro
=
defn
-
定义宏
macro 的内容为
defn. 命令行上所有的 `
-D' 选项在 `
-U' 选项之前处理 .
-
-U
macro
-
取消宏
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 执行连接操作 , 这些目标文件将成为连接器的输入文件 .
-
-l
library
-
连接名为
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)下列选项指定搜索路径,用于查找头文件,库文件,或编译器的某些成员:
-
-I
dir
-
在头文件的搜索路径列表中添加
dir 目录 .
-
-I-
-
任何在 `
-I-' 前面用 `
-I' 选项指定的搜索路径只适用于 `
#include "
file
"' 这种情况 ; 他们不能用来搜索 `
#include <
file>' 包含的头文件 .
如果用`-I'选项指定的搜索路径位于`-I-'选项后面,就可以在这些路径中搜索所有的 `#include'指令. (一般说来-I选项就是这么用的.)
还有, `-I-'选项能够阻止当前目录(存放当前输入文件的地方)成为搜索`#include "file"'的第一选择.没有办法克服`-I-'选项的这个效应.你可以指定 `-I.'搜索那个目录,它在调用编译器时是当前目录.这和预处理器的默认行为不完全一样,但是结果通常 令人满意.
`-I-'不影响使用系统标准目录,因此, `-I-'和`-nostdinc'是不同的选项.
-
-L
dir
-
在 `
-l' 选项的搜索路径列表中添加
dir 目录 .
-
-B
prefix
-
这个选项指出在何处寻找可执行文件 , 库文件 , 以及编译器自己的数据文件 .
编译器驱动程序需要执行某些下面的子程序: `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__后面的表达式.不过只应该在系统头文件中使用这种转义措施,应用程序最好 避免.
-
-pedantic-errors
-
该选项和 `
-pedantic' 类似 , 但是显示错误而不是警告 .
-
-W
-
对下列事件显示额外的警告信息 :
-
*
-
非易变自动变量 (nonvolatile automatic variable) 可能在调用
longjmp 时发生改变 . 这些警告仅在优化编译时发生 .
编译器只知道对setjmp的调用,他不可能知道会在哪里调用longjmp,事实上一个 信号处理例程可以在程序的任何地点调用他.其结果是,即使程序没有问题,你也可能会得到警告,因为无法在可能出现问题 的地方调用longjmp.
-
*
-
既可以返回值 , 也可以不返回值的函数 . ( 缺少结尾的函数体被看作不返回函数值 ) 例如 , 下面的函数将导致这种警告 :
foo (a)
{
if (a > 0)
return a;
}
由于 GNU CC 不知道某些函数永不返回 ( 含有
abort 和
longjmp), 因此有可能出现 虚假警告 .
-
*
-
表达式语句或逗号表达式的左侧没有产生作用 (side effect). 如果要防止这种警告 , 应该把未使用的表达式强制转换 为 void 类型 . 例如 , 这样的表达式 `
x[i,j]' 会导致警告 , 而 `
x[(void)i,j]' 就不会 .
-
*
-
无符号数用 `
>' 或 `
<=' 和零做比较 .
-
-Wimplicit-int
-
警告没有指定类型的声明 .
-
-Wimplicit-function-declaration
-
警告在声明之前就使用的函数 .
-
-Wimplicit
-
同 -Wimplicit-int 和 -Wimplicit-function-declaration.
-
-Wmain
-
如果把
main 函数声明或定义成奇怪的类型 , 编译器就发出警告 . 典型情况下 , 这个函数用于外部连接 , 返回
int 数值 , 不需要参数 , 或指定两个参数 .
-
-Wreturn-type
-
如果函数定义了返回类型 , 而默认类型是
int 型 , 编译器就发出警告 . 同时警告那些不带返回值的
return 语句 , 如果他们所属的函数并非
void 类型 .
-
-Wunused
-
如果某个局部变量除了声明就没再使用 , 或者声明了静态函数但是没有定义 , 或者某条语句的运算结果显然没有使用 , 编译器就发出警告 .
-
-Wswitch
-
如果某条
switch 语句的参数属于枚举类型 , 但是没有对应的
case 语句使用枚举元素 , 编译器 就发出警告 . (
default 语句的出现能够防止这个警告 .) 超出枚举范围的
case 语句同样会 导致这个警告 .
-
-Wcomment
-
如果注释起始序列 `
/*' 出现在注释中 , 编译器就发出警告 .
-
-Wtrigraphs
-
警告任何出现的 trigraph ( 假设允许使用他们 ).
-
-Wformat
-
检查对
printf 和
scanf 等函数的调用 , 确认各个参数类型和格式串中的一致 .
-
-Wchar-subscripts
-
警告类型是
char 的数组下标 . 这是常见错误 , 程序员经常忘记在某些机器上 char 有符号 .
-
-Wuninitialized
-
在初始化之前就使用自动变量 .
这些警告只可能做优化编译时出现,因为他们需要数据流信息,只有做优化的时候才估算数据流信息.如果不指定 `-O'选项,就不会出现这些警告.
这些警告仅针对等候分配寄存器的变量.因此不会发生在声明为volatile的变量上面,不会发生在已经 取得地址的变量,或长度不等于1, 2, 4, 8字节的变量.同样也不会发生在结构,联合或数组上面,即使他们在 寄存器中.
注意,如果某个变量只计算了一个从未使用过的值,这里可能不会警告.因为在显示警告之前,这样的计算已经被 数据流分析删除了.
这些警告作为可选项是因为GNU CC还没有智能到判别所有的情况,知道有些看上去错误的代码其实是正确的.下面是 一个这样的例子:
{
int x;
switch (y)
{
case 1: x = 1;
break;
case 2: x = 4;
break;
case 3: x = 5;
}
foo (x);
}
如果
y 始终是 1, 2 或 3, 那么
x 总会被初始化 , 但是 GNU CC 不知道这一点 . 下面是 另一个普遍案例 :
{
int save_y;
if (change_y) save_y = y, y = new_y;
...
if (change_y) y = save_y;
}
这里没有错误 , 因为只有设置了
save_y 才使用他 .
把所有不返回的函数定义为volatile可以避免某些似是而非的警告.
|
