 GCC 中文手册(上) 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 -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 允许在标识符(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 ’. -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’选项之前处理. -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 ’包含的头文档. 假如用`-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__后面的表达式.但是只应该在系统头文档中使用这种转义措施,应用程式最好 避免. -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能够避免某些似是而非的警告. -Wparentheses 在某些情况下假如忽略了括号,编译器就发出警告. -Wtemplate-debugging 当在C++程式中使用template的时候,假如调试(debugging)没有完全生效,编译器就发出警告. (仅用于C++). -Wall 结合任何上述的`-W’选项.通常我们建议避免这些被警告的用法，我们相信,恰当结合宏的使用能够 轻易避免这些用法。 剩下的`-W...’选项不包括在`-Wall’中,因为我们认为在必要情况下,这些被编译器警告 的程式结构,能够合理的用在"干净的"程式中. -Wtraditional 假如某些程式结构在传统C中的表现和ANSI C不同,编译器就发出警告. * 宏参出现在宏体的字符串常量内部.传统C会替换宏参,而ANSI C则视其为常量的一部分. * 某个函数在块(block)中声明为外部,但在块结束后才调用. * switch语句的操作数类型是long. -Wshadow 一旦某个局部变量屏蔽了另一个局部变量,编译器就发出警告. -Wid-clash-len 一旦两个确定的标识符具备相同的前len个字符,编译器就发出警告.他能够协助您研发一些将要在某些 过时的,危害大脑的编译器上编译的程式. -Wpointer-arith 任何语句假如依赖于函数类型的大小(size)或void类型的大小,编译器就发出警告. GNU C为了 便于计算void *指针和函数指针,就把这些类型的大小定义为1. -Wcast-qual 一旦某个指针强制类型转换以便移除类型修饰符时,编译器就发出警告.例如,假如把const char * 强制转换为普通的char *时,警告就会出现. -Wcast-align 一旦某个指针类型强制转换时,导致目标所需的地址对齐(alignment)增加,编译器就发出警告.例如,某些机器上 只能在2或4字节边界上访问整数,假如在这种机型上把char *强制转换成int *类型, 编译器就发出警告. -Wwrite-strings 规定字符串常量的类型是const char[length],因此,把这样的地址复制给 non-const char *指针将产生警告.这些警告能够帮助您在编译期间发现企图写入字符串常量 的代码,但是您必须很仔细的在声明和原形中使用const,否则他们只能带来麻烦;所以我们没有让 `-Wall’提供这些警告. -Wconversion 假如某函数原形导致的类型转换和无函数原形时的类型转换不同,编译器就发出警告.这里包括定点数和浮点数的 互相转换,改变定点数的宽度或符号,除非他们和缺省声明(default promotion)相同. -Waggregate-return 假如定义或调用了返回结构或联合的函数,编译器就发出警告. (从语言角度您能够返回一个数组,然而同样会 导致警告.) -Wstrict-prototypes 假如函数的声明或定义没有指出参数类型,编译器就发出警告. (假如函数的前向引用说明指出了参数类型,则允许后面 使用旧式风格的函数定义,而不会产生警告.) -Wmissing-prototypes 假如没有预先声明函数原形就定义了全局函数,编译器就发出警告.即使函数定义自身提供了函数原形也会产生这个警告. 他的目的是检查没有在头文档中声明的全局函数. -Wmissing-declarations 假如没有预先声明就定义了全局函数,编译器就发出警告.即使函数定义自身提供了函数原形也会产生这个警告.这个选项 的目的是检查没有在头文档中声明的全局函数. -Wredundant-decls 假如在同一个可见域某定义多次声明,编译器就发出警告,即使这些重复声明有效并且毫无差别. -Wnested-externs 假如某extern声明出现在函数内部,编译器就发出警告. -Wenum-clash 对于不同枚举类型之间的转换发出警告(仅适用于C++). -Wlong-long 假如使用了long long 类型就发出警告.该警告是缺省项.使用`-Wno-long-long’ 选项能够防止这个警告. `-Wlong-long’和`-Wno-long-long’仅在 `-pedantic’之下才起作用. -Woverloaded-virtual (仅适用于C++.)在继承类中,虚函数的定义必须匹配虚函数在基类中声明的类型特征(type signature).当 继承类声明了某个函数,他可能是个错误的尝试企图定义一个虚函数,使用这个选项能够产生警告:就是说,当某个函数和基类 中的虚函数同名,但是类型特征不符合基类的任何虚函数,编译器将发出警告. -Winline 假如某函数不能内嵌(inline),无论是声明为inline或是指定了-finline-functions 选项,编译器都将发出警告. -Werror 视警告为错误;出现任何警告即放弃编译. 调试选项(DEBUGGING OPTION)GNU CC拥有许多特别选项,既能够调试用户的程式,也能够对GCC排错: -g 以操作系统的本地格式(stabs, COFF, XCOFF,或DWARF).产生调试信息. GDB能够使用这些调试信息. 在大多数使用stabs格式的系统上, `-g’选项启动只有GDB才使用的额外调试信息;这些信息使GDB 调试效果更好,但是有可能导致其他调试器崩溃,或拒绝读入程式.假如您确定要控制是否生成额外的信息, 使用`-gstabs+’, `-gstabs’, `-gxcoff+’, `-gxcoff’, `-gdwarf+’,或`-gdwarf’ (见下文). 和大多数C编译器不同, GNU CC允许结合使用`-g’和`-O’选项.优化的代码偶尔制造 一些惊异的结果:某些声明过的变量根本不存在;控制流程直接跑到没有预料到的地方;某些语句因为计算结果是常量或已确定而 没有执行;某些语句在其他地方执行,因为他们被移到循环外面了. 然而他证实了调试优化的输出是可能的.对可能含有错误的程式使用优化器是合理的. 假如GNU CC支持输出多种调试信息,下面的选项则很有用. -ggdb 以本地格式(假如支持)输出调试信息,尽可能包括GDB扩展. -gstabs 以stabs格式(假如支持)输出调试信息,不包括GDB扩展.这是大多数BSD系统上DBX使用的格式. -gstabs+ 以stabs格式(假如支持)输出调试信息,使用只有GNU调试器(GDB)理解的GNU扩展.使用这些扩展有可能导致 其他调试器崩溃或拒绝读入程式. -gcoff 以COFF格式(假如支持)输出调试信息.这是在System V第四版以前的大多数System V系统上SDB使用的 格式. -gxcoff 以XCOFF格式(假如支持)输出调试信息.这是IBM RS/6000系统上DBX调试器使用的格式. -gxcoff+ 以XCOFF格式(假如支持)输出调试信息,使用只有GNU调试器(GDB)理解的GNU扩展.使用这些扩展有可能导致 其他调试器崩溃或拒绝读入程式. -gdwarf 以DWARF格式(假如支持)输出调试信息.这是大多数System V第四版系统上SDB使用的格式. -gdwarf+ 以DWARF格式(假如支持)输出调试信息,使用只有GNU调试器(GDB)理解的GNU扩展.使用这些扩展有可能导致 其他调试器崩溃或拒绝读入程式. -glevel -ggdblevel -gstabslevel -gcofflevel -gxcofflevel -gdwarflevel 请求生成调试信息,同时用level指出需要多少信息.默认的level值是2. Level 1输出最少量的信息,仅够在不打算调试的程式段内backtrace.包括函数和外部变量的描述,但是 没有局部变量和行号信息. Level 3包含更多的信息,如程式中出现的任何宏定义.当使用`-g3’选项的时候,某些调试器支持 宏扩展. -p 产生额外代码,用于输出profile信息,供分析程式prof使用. -pg 产生额外代码,用于输出profile信息,供分析程式gprof使用. -a 产生额外代码,用于输出基本块(basic block)的profile信息,他记录各个基本块的执行次数,供诸如 tcov此类的程式分析.但是注意,这个数据格式并非tcov期待的.最终GNU gprof 将处理这些数据. -ax 产生额外代码,用于从’bb.in’文档读取基本块的profile参数,把profile的结果写到’bb.out’ 文档. `bb.in’包含一张函数列表.一旦进入列表中的某个函数, profile操作就开始,离开最外层的函数后, profile操作就结束.以`-’为前缀名的函数排除在profile操作之外.假如函数名不是唯一的,他能够写成 `/path/filename.d:functionname’来澄清. `bb.out’将列出一些有效的文档名.这四个函数名具备 特别含义: `__bb_jumps__’导致跳转(jump)频率写进`bb.out’. `__bb_trace__’导致基本块序列通过 管道传到`gzip’,输出`bbtrace.gz’文档. `__bb_hidecall__’导致从跟踪(trace)中排除call 指令. `__bb_showret__’导致在跟踪中包括返回指令. -dletters 编译的时候,在letters指定的时刻做调试转储(dump).用于调试编译器.大多数转储的文档名 通过源文档名添加字词获得(例如`foo.c.rtl’或`foo.c.jump’). -dM 预处理结束的时候转储任何的宏定义,不输出到文档. -dN 预处理结束的时候转储任何的宏名. -dD 预处理结束的时候转储任何的宏定义,同时进行正常输出. -dy 语法分析(parse)的时候在标准错误转储调试信息. -dr RTL阶段后转储到`file.rtl’. -dx 仅对函数生成RTL,而不是编译.通常和`r’联用. -dj 第一次跳转优化后转储到`file.jump’. -ds CSE (包括有时候跟在CSE后面的跳转优化)后转储到`file.cse’. -dL 循环优化后转储到`file.loop’. -dt 第二次CSE处理(包括有时候跟在CSE后面的跳转优化)后转储到`file.cse2’. -df 流程分析(flow analysis)后转储到`file.flow’. -dc 指令组合(instruction combination)后转储到`file.combine’. -dS 第一次指令安排(instruction schedule)后转储到`file.sched’. -dl 局部寄存器分配后转储到`file.lreg’. -dg 全局寄存器分配后转储到`file.greg’. -dR 第二次指令安排(instruction schedule)后转储到`file.sched2’. -dJ 最后一次跳转优化后转储到`file.jump2’. -dd 推迟分支调度(delayed branch scheduling)后转储到`file.dbr’. -dk 寄存器-堆栈转换后转储到`file.stack’. -da 产生以上任何的转储. -dm 运行结束后,在标准错误显示内存使用统计. -dp 在汇编输出加注指明使用了哪些模式(pattern)及其替代模式. -fpretend-float 交叉编译的时候,假定目标机和宿主机使用同样的浮点格式.他导致输出错误的浮点常数,但是在目标机上运行的时候, 真实的指令序列有可能和GNU CC希望的相同. -save-temps 保存那些通常是``临时’’的中间文档;置于当前目录下,并且根据源文档命名.因此,用`-c -save-temps’选项编译`foo.c ’会生成` foo.cpp’和`foo.s’ 连同`foo.o’文档. -print-file-name=library 显示库文档library的全路径名,连接时会使用这个库---其他什么事情都不作.根据这个选项, GNU CC既不编译,也不连接,仅仅显示文档名. -print-libgcc-file-name 和`-print-file-name=libgcc.a’相同. -print-prog-name=program 类似于`-print-file-name’,但是查找程式program如`cpp’. 本文来自ChinaUnix博客，假如查看原文请点：http://blog.chinaunix.net/u1/59740/showart_468405.html |
喜欢本文，那就收藏到： |
.text:''):(d.getSelection?d.getSelection():'');void(keyit=window.open('http://my.poco.cn/fav/storeIt.php?t='+escape(d.title)+'&u='+escape(d.location.href)+'&c='+escape(t)+'&img=http://www.h-strong.com/blog/logo.gif','keyit','scrollbars=no,width=475,height=575,status=no,resizable=yes'));keyit.focus(); "添加到POCO网摘"){kind=logo}
Rss Feed
