GCC中文手册中国linux论坛man手册翻译计划.pdf

发布时间：2022-06-07 发布人：admin 分类：说明书资料大小：0.34M 资料格式：pdf 举报版权申诉

第1页 / 共42页

第2页 / 共42页

第3页 / 共42页

第4页 / 共42页

第5页 / 共42页

第6页 / 共42页

第7页 / 共42页

第8页 / 共42页

GCC

Index

NAME

总览(SYNOPSIS)

警告(WARNING)

描述(DESCRIPTION)

选项(OPTIONS)

总体选项(Overall Option)

语言选项(LANGUAGE OPTIONS)

预处理器选项(Preprocessor Option)

汇编器选项(ASSEMBLER OPTION)

连接器选项(LINKER OPTION)

目录选项(DIRECTORY OPTION)

警告选项(WARNING OPTION)

调试选项(DEBUGGING OPTION)

优化选项(OPTIMIZATION OPTION)

目标机选项(TARGET OPTION)

机器相关选项(MACHINE DEPENDENT OPTION)

代码生成选项(CODE GENERATION OPTION)

PRAGMAS

文件(FILE)

另见(SEE ALSO)

BUGS

版权(COPYING)

作者(AUTHORS)

[中文版维护人]

[中文版最新更新]

《中国Linux论坛man手册页翻译计划》

GCC 中文手册 GCC Section: GNU Tools (1) Updated: 2003/12/05 Index Return to Main Contents Index NAME 总览 (SYNOPSIS) 警告 (WARNING) 描述 (DESCRIPTION) 选项 (OPTIONS) 总体选项 (Overall Option) 语言选项 (LANGUAGE OPTIONS) 预处理器选项 (Preprocessor Option) 汇编器选项 (ASSEMBLER OPTION) 连接器选项 (LINKER OPTION) 目录选项 (DIRECTORY OPTION) 警告选项 (WARNING OPTION) 调试选项 (DEBUGGING OPTION) 优化选项 (OPTIMIZATION OPTION) 目标机选项 (TARGET OPTION) 机器相关选项 (MACHINE DEPENDENT OPTION) 代码生成选项 (CODE GENERATION OPTION) PRAGMAS 文件 (FILE) 另见 (SEE ALSO) BUGS 版权 (COPYING) 作者 (AUTHORS) [中文版维护人] [中文版最新更新] 《中国Linux论坛man手册页翻译计划》 NAME gcc,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-freestanding -fsigned-char -fno-strict-prototype -fthis-is-variable -funsigned-char -fwritable-strings -traditional -traditional-cpp -trigraphs -ffreestanding -fsigned-bitfields -funsigned-bitfields -fno-hosted 警告选项(Warning Option) -pedantic -w -W -Werror -Wconversion -Wenum-clash -pedantic-errors -fsyntax-only -Wall -Waggregate-return -Wcast-align -Wcast-qual -Wchar-subscript -Wcomment -Wformat -Wid-clash-len -Wimplicit-int -Wimplicit-function-declaration -Winline -Wlong-long -Wmain -Wmissing-prototypes -Wmissing-declarations -Wnested-externs -Wno-import -Wparentheses -Wpointer-arith -Wredundant-decls -Wreturn-type -Wswitch -Wtemplate-debugging -Wtraditional -Wtrigraphs -Wuninitialized -Wunused -Wwrite-strings -Wstrict-prototypes -Wimplicit -Wshadow 调试选项(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-prog-name=program 优化选项(Optimization Option) -print-libgcc-file-name -ffloat-store -fforce-addr -fcse-follow-jumps -fcse-skip-blocks -fcaller-saves -fdelayed-branch -felide-constructors -fexpensive-optimizations -ffast-math -fforce-mem -finline-functions -fkeep-inline-functions -fmemoize-lookups -fno-default-inline -fno-defer-pop -fno-function-cse -fno-inline -frerun-cse-after-loop -fno-peephole -fschedule-insns -fstrength-reduce -fthread-jumps -funroll-all-loops -funroll-loops -O -O2 -O3 -fomit-frame-pointer -fschedule-insns2 预处理器选项(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 -llibrary -nostartfiles -nostdlib -static -shared -symbolic -Xlinker option -Wl,option -u symbol 汇编器选项(Assembler Option) -Wa,option 连接器选项(Linker Option) 目录选项(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-used-reg -ffixed-reg -fcall-saved-reg -finhibit-size-directive -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 -fnonnull-objects 总体选项(Overall Option) -x language -x none 明确指出后面输入文件的语言为 language (而不是从文件名后缀得到的默认选择). 这个选项应用于后面所有的输入文件,直到遇着下一个`-x'选项. language 的可选值有` c', `objective-c', `c-header', `c++', `cpp-output', `assembler',和`assembler-with-cpp'. 关闭任何对语种的明确说明,因此依据文件名后缀处理后面的文件(就象是从未使用过 `-x'选项). 如果只操作四个阶段(预处理,编译,汇编,连接)中的一部分,可以使用`-x'选项(或文件名后缀)告诉 gcc 从哪里开始,用`-c', `-S',或`-E'选项告诉 gcc 到哪里结束.注意,某些选项组合(例如, `-x cpp-output -E')使 gcc 不作任何事情. -c 编译或汇编源文件,但是不作连接.编译器输出对应于源文件的目标文件. 缺省情况下, GCC 通过用`.o'替换源文件名后缀`.c', `.i', `.s',等等,产生目标文件名.可以使用-o 选项选择其他名字. GCC 忽略-c 选项后面任何无法识别的输入文件(他们不需要编译或汇编). -S -E 编译后即停止,不进行汇编.对于每个输入的非汇编语言文件,输出文件是汇编语言文件. 缺省情况下, GCC 通过用`.o'替换源文件名后缀`.c', `.i',等等,产生目标文件名. 可以使用-o 选项选择其他名字. GCC 忽略任何不需要编译的输入文件. 预处理后即停止,不进行编译.预处理后的代码送往标准输出. 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 -fno-builtin 不把asm, inline 或typeof 当作关键字,因此这些词可以用做标识符.用 __asm__, __inline__和__typeof__能够替代他们. `-ansi' 隐含声明了`-fno-asm'. 不接受不是两个下划线开头的内建函数(built-in function).目前受影响的函数有

_exit, abort, abs, alloca, cos, exit, fabs, labs, memcmp, memcpy, sin, sqrt, strcmp, strcpy,和 strlen. `-ansi'选项能够阻止 alloca 和_exit 成为内建函数. -fhosted -ffreestanding 按宿主环境编译;他隐含声明了`-fbuiltin'选项,而且警告不正确的 main 函数声明. 按独立环境编译;他隐含声明了`-fno-builtin'选项,而且对 main 函数没有特别要求. (译注:宿主环境(hosted environment)下所有的标准库可用, main 函数返回一个 int 值,典型例子是除了内核以外几乎所有的程序.对应的独立环境(freestanding environment)不存在标准库,程序入口也不一定是 main,最明显的例子就是操作系统内核.详情参考 gcc 网站最近的资料) -fno-strict-prototype 对于没有参数的函数声明,例如`int foo ();',按 C 风格处理---即不说明参数个数或类型. (仅针对 C++).正常情况下,这样的函数 foo 在 C++中意味着参数为空. 支持 ANSI C trigraphs. `-ansi'选项隐含声明了`-trigraphs'. -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 -fexternal-templates 允许 int 类型到枚举类型(enumeration)的隐式转换(仅限于 C++).正常情况下 GNU C++允许从 enum 到 int 的转换,反之则不行. 为模板声明(template declaration)产生较小的代码(仅限于 C++),方法是对于每个模板函数 (template function),只在定义他们的地方生成一个副本.想要成功使用这个选项,你必须在所有使用模板的文件中,标记`#pragma implementation' (定义)或`#pragma interface' (声明).

分享到：

赞收藏

资料库

GCC中文手册中国linux论坛man手册翻译计划.pdf

相关推荐

操作系统

热门标签

最新资料