gcc使用手册(3)

-print-libgcc-file-name

和`-print-file-name=libgcc.a'一样.

-print-prog-name=program

类似于`-print-file-name',但是查找程序program如`cpp'.



优化选项(OPTIMIZATION OPTION)

这些选项控制多种优化措施:

-O

-O1

优化.对于大函数,优化编译占用稍微多的时间和相当大的内存.

不使用`-O'选项时,编译器的目标是减少编译的开销,使编译结果能够调试.语句是独
立的:如果在 两条语句之间用断点中止程序,你可以对任何变量重新赋值,或者在函
数体内把程序计数器指到其他语句,以及从源程序中 精确地获取你期待的结果.

不使用`-O'选项时,只有声明了register的变量才分配使用寄存器.编译结果比不用
`-O'选项的PCC要略逊一筹.

使用了`-O'选项,编译器会试图减少目标码的大小和执行时间.

如果指定了`-O'选项, `-fthread-jumps'和`-fdefer-pop'选项将被 打开.在有del
ay slot的机器上, `-fdelayed-branch'选项将被打开.在即使没有帧指针 (frame
pointer)也支持调试的机器上, `-fomit-frame-pointer'选项将被打开.某些机器上
还可能会打开其他选项.

-O2

多优化一些.除了涉及空间和速度交换的优化选项,执行几乎所有的优化工作.例如不
进行循环展开(loop unrolling)和函数内嵌(inlining).和-O选项比较,这个选项既
增加了编译时间,也提高了生成代码的 运行效果.

-O3

优化的更多.除了打开-O2所做的一切,它还打开了-finline-functions选项.

-O0

不优化.

如果指定了多个-O选项,不管带不带数字,最后一个选项才是生效的选项.

诸如`-fflag'此类的选项描述一些机器无关的开关.大多数开关具有肯定和否定两种
格式; `-ffoo'开关选项的否定格式应该是`-fno-foo'.下面的列表只展示了一种格
式---那个不是 默认选项的格式.你可以通过去掉或添加`no-'构造出另一种格式.


-ffloat-store

不要在寄存器中存放浮点变量.这样可以防止某些机器上不希望的过高精度,如6800
0的浮点寄存器(来自 68881)保存的精度超过了double应该具有的精度.

对于大多数程序,过高精度只有好处.但是有些程序严格依赖于IEEE浮点数的定义.对
这样的程序可以使用 `-ffloat-store'选项.

-fmemoize-lookups

-fsave-memoized

使用探索法(heuristic)进行更快的编译(仅对C++).默认情况下不使用探索法.由于
探索法只对某些输入文件 有效,其他程序的编译速度会变得更慢.

第一次编译器必须对成员函数(或对成员数据的引用)建立一个调用.它必须(1)判断
出这个类是否实现了那个名字的 成员函数; (2)决定调用哪个成员函数(涉及到推测
需要做哪种类型转换); (3)检查成员函数对调用者是否可见.所有这些构成 更慢的
编译.一般情形,第二次对成员函数(或对成员数据的引用)建立的调用,必须再次经过
相同长度的处理.这意味着象 这样的代码

cout << "This " << p << " has " << n << " legs.\n";

对整个三步骤要做六次遍历.通过使用软件缓存, ``命中''能够显著地减少这种代价
然而不幸的是,使用这种缓存 必须实现其他机制,带来了它自己的开销. `-fmemoi
ze-lookups'选项打开软件缓存.

因为函数的正文环境不同,函数对成员和成员函数的访问权(可见性)也可能不同, g
++可能需要刷新缓存. 使用`-fmemoize-lookups'选项,每编译完一个函数就刷新缓
存.而`-fsave-memoized'选项 也启用同样的缓存,但是当编译器发觉最后编译的函
数的正文环境产生的访问权和下一个待编译的函数相同,编译器就 保留缓存内容.这
对某个类定义许多成员函数时非常有用:除了某些其他类的友函数,每个成员函数拥
有和其他成员函数完全一样 的访问权,因而无需刷新缓存.

-fno-default-inline

默认为不要把成员函数内嵌,因为它们定义在类的作用域内(仅C++).

-fno-defer-pop

一旦函数返回,参数就立即弹出.对于那些调用函数后必须弹出参数的机器,编译器一
般情况下让几次函数调用的参数 堆积在栈上,然后一次全部弹出.

-fforce-mem

做数学运算前把将要使用的内存操作数送入寄存器.通过把内存访问转换成潜在的公
共子表达式,它可能产生较好的目标码. 如果它们不是公共子表达式,指令组合应该
消除各自的寄存器载荷.我乐意倾听不同意见.

-fforce-addr

做数学运算前把将要使用的内存地址常数送入寄存器.它可能和`-fforce-mem'一样
产生较好的 目标码.我乐意倾听不同意见.

-fomit-frame-pointer

对于不需要帧指针(frame pointer)的函数,不要在寄存器中保存帧指针.这样能够避
免保存,设置和恢复 帧指针的指令;同时对许多函数提供一个额外的寄存器. 但是在
大多数机器上将无法调试.

某些机器上,如Vax,这个选项无效,因为标准调用序列自动处理帧指针,通过假装不存
在而不保存任何东西.机器描述宏 FRAME_POINTER_REQUIRED控制目标机是否支持这
个选项.

-finline-functions

把所有简单的函数集成进调用者.编译器探索式地决定哪些函数足够简单,值得这种
集成.

如果集成了所有给定函数的调用,而且函数声明为static,那么一般说来GCC有权不按
汇编代码输出函数.

-fcaller-saves

允许在寄存器里分配数值,但是这个方案通常受到各个函数调用的冲击,因此GCC生成
额外的代码,在函数调用的 前后保存和复原寄存器内容.仅当生成代码看上去优于反
之结果时才实现这样的分配.

某些机器上该选项默认为允许,通常这些机器没有调用保护寄存器代替使用.

-fkeep-inline-functions

即使集成了某个函数的所有调用,而且该函数声明为static,仍然输出这个函数一个
独立的,运行时可调用 的版本.

-fno-function-cse

不要把函数地址存入寄存器;让调用固定函数的指令显式给出函数地址.

这个选项产生效率较低的目标码,但是如果不用这个选项,某些不寻常的hack,改变汇
编器的输出,可能因优化而带来 困惑.

-fno-peephole

禁止任何机器相关的peephole优化.

-ffast-math

这个选项出于速度优化,允许GCC违反某些ANSI或IEEE规则/规格.例如,它允许编译器
假设sqrt 函数的参数是非负数.

这个选项不被任何`-O'选项打开,因为对于严格依靠IEEE或ANSI规则/规格实现的数
学函数,程序可能 会产生错误的结果.

下列选项控制特定的优化. `-O2'选项打开下面的大多数优化项,除了`-funroll-lo
ops'和 `-funroll-all-loops'项.

而`-O'选项通常打开`-fthread-jumps'和`-fdelayed-branch' 优化项,但是特定的
机器上的默认优化项有可能改变.

如果特别情况下非常需要``微调''优化,你可以使用下面的选项.

-fstrength-reduce

执行循环强度缩小(loop strength reduction)优化,并且消除重复变量.

-fthread-jumps

执行优化的地点是,如果某个跳转分支的目的地存在另一个条件比较,而且该条件比
较包含在前一个比较语句之内,那么 执行优化.根据条件是true或者false,前面那条
分支重定向到第二条分支的目的地或者紧跟在第二条分支后面.

-funroll-loops

执行循环展开(loop unrolling)优化.仅对循环次数能够在编译时或运行时确定的循
环实行.

-funroll-all-loops

执行循环展开(loop unrolling)优化.对所有循环实行.通常使程序运行的更慢.

-fcse-follow-jumps

在公共子表达式消元(common subexpression elimination)的时候,如果没有其他路
径到达某个跳转的 目的地,就扫过这条jump指令.例如,如果CSE遇到带有else从句的
if语句,当条件测试为 false时, CSE就跟在jump后面.

-fcse-skip-blocks

它类似于`-fcse-follow-jumps'选项,但是CSE跟在条件跳转后面,条件跳转跳过了
语句块(block).如果CSE遇到一条简单的if语句,不带else从句, `-fcse-skip-bloc
ks'选项将导致CSE跟在if产生的跳转后面.

-frerun-cse-after-loop

执行循环优化后,重新进行公共子表达式消元.

-felide-constructors

如果看上去合理就省略构造子(仅C++).根据这个选项,对于下面的代码, GNU C++直
接从调用foo 初始化y,而无需通过临时变量:

A foo (); A y = foo ();

如果没有这个选项, GNU C++首先通过调用类型A 合适的构造子初始化y;然后把 fo
o的结果赋给临时变量;最后,用临时变量替换`y'的初始值.

ANSI C++标准草案规定了默认行为(`-fno-elide-constructors').如果程序的构造
子存在 副效应, `-felide-constructors'选项能够使程序有不同的表现,因为可能
忽略一些构造子的调用.

-fexpensive-optimizations

执行一些相对开销较大的次要优化.

-fdelayed-branch

如果对目标机支持这个功能,它试图重新排列指令,以便利用延迟分支(delayed bra
nch)指令后面的指令空隙.

-fschedule-insns

如果对目标机支持这个功能,它试图重新排列指令,以便消除因数据未绪造成的执行
停顿.这可以帮助浮点运算或内存访问 较慢的机器调取指令,允许其他指令先执行,
直到调取指令或浮点运算完成.

-fschedule-insns2

类似于`-fschedule-insns'选项,但是在寄存器分配完成后,需要一个额外的指令调
度过程.对于 寄存器数目相对较少,而且取内存指令大于一个周期的机器,这个选项
特别有用.



目标机选项(TARGET OPTION)

缺省情况下, GNU CC编译出本机类型的目标码.然而也可以把他安装成交叉编译器,
为其他机型编译程序.事实上,针对不同的目标机,可以同时安装GNU CC相应的配置
然后用`-b'选项指定 目标机种.

顺便提一下,新版本和旧版本的GNU CC可以共存.其中一个版本(可能是最新的那个)
为缺省版本,但是有时候你希望使用 其他版本.

-b machine

参数machine指出编译的目标机种.这个选项用于安装为交叉编译器的GNU CC.

参数machine的值和配置GNU CC交叉编译器时设置的机器类型一样.例如,如果交叉编
译器配置有 `configure i386v',意思是编译80386上的System V目标码,那么你可以
通过`-b i386v'运行交叉编译器.

如果没有指定`-b'选项,通常指编译本机目标码.

-V version

参数version指出运行哪个版本的GNU CC.这个选项用于安装了多个版本的GCC.例如
,如果 version是`2.0',意味着运行GNU CC 2.0版.

如果没有指定`-V'选项,缺省版本取决于GNU CC的安装方式,一般说来推荐使用通用
版本.



机器相关选项(MACHINE DEPENDENT OPTION)

每一种目标机型都有自己的特别选项,这些选项用`-m '开关引导,选择不同的硬件型
号或配置---例如, 68010还是68020,有没有浮点协处理器.通过指定选项,安装 编译
器的一个版本能够为所有的型号或配置进行编译.

此外,编译器的某些配置支持附加的特殊选项,通常是为了在命令行上兼容这个平台
的其他编译器.

下面是针对68000系列定义的`-m'选项:

-m68000

-mc68000

输出68000的目标码.如果编译器按基于68000的系统配置,这个选项就是缺省选项.


-m68020

-mc68020

输出68020的目标码(而不是68000).如果编译器按基于68020的系统配置,这个选项就
是缺省选项.

-m68881

输出包含68881浮点指令的目标码.对于大多数基于68020的系统这是缺省选项,除非
设置编译器时指定了 -nfp .

-m68030

输出68030的目标码.如果编译器按基于68030的系统配置,这个选项就是缺省选项.


-m68040

输出68040的目标码.如果编译器按基于68040的系统配置,这个选项就是缺省选项.


-m68020-40

输出68040的目标码,但是不使用新指令.生成的代码可以在68020/68881上,也可以在
68030或 68040上较有效地运行.

-mfpa

输出包含SUN FPA浮点指令的目标码.

-msoft-float

输出包含浮点库调用的目标码. 警告:所需的库不是GNU CC的组成部分.一般说来GC
C使用该机型本地C 编译器的相应部件,但是作交叉编译时却不能直接使用.你必须自
己管理提供合适的函数库用于交叉编译.

-mshort

认为int类型是16位宽,相当于short int.

-mnobitfield

不使用位域(bit-field)指令. `-m68000'隐含指定了`-mnobitfield'.

-mbitfield

使用位域指令. `-m68020'隐含指定了`-mbitfield'.如果你使用未改装的gcc,这就
是 默认选项.

-mrtd

采用另一种函数调用约定,函数接受固定数目的参数,用rtd指令返回,该指令返回时
弹出栈内的参数.这个 方法能够使调用者节省一条指令,因为他这里不需要弹出参数


这种调用约定不兼容UNIX的正常调用.因此如果你需要调用UNIX编译器编译的库函数
,你就不能使用这个选项.

此外,所有参数数量可变地函数必须提供函数原型(包括printf);否则编译器会生成
错误的调用代码.

另外,如果调用函数时携带了过多的参数,编译器将生成严重错误的代码. (正常情况
下,多余的参数被安全无害的忽略.)

68010和68020处理器支持rtd指令,但是68000不支持.

下面是针对VAX定义的`-m'选项:

-munix

禁止输出某些跳转指令(aobleq等等), VAX的UNIX汇编器无法跨越长范围(long ran
ges) 进行处理.

-mgnu

如果使用GNU汇编器,则输出那些跳转指令,

-mg

输出g-format浮点数,取代d-format.

下面是SPARC支持的`-m'选项开关:

-mfpu

-mhard-float

输出包含浮点指令的目标码.这是缺省选项.

-mno-fpu

-msoft-float

输出包含浮点库调用的目标码. 警告:没有为SPARC提供GNU浮点库.一般说来使用该
机型本地C编译器 的相应部件,但是不能直接用于交叉编译.你必须自己安排,提供用
于交叉编译的库函数.

-msoft-float改变了输出文件中的调用约定;因此只有用这个选项编译整个程序才有
意义.

-mno-epilogue

-mepilogue

使用-mepilogue (缺省)选项时,编译器总是把函数的退出代码放在函数的尾部.任何
在函数中间 的退出语句(例如C中的return语句)将产生出跳转指令指向函数尾部.


使用-mno-epilogue选项时,编译器尽量在每个函数退出点嵌入退出代码.

-mno-v8

-mv8

-msparclite

这三个选项选择不同种类的SPARC系统.

默认情况下(除非特别为Fujitsu SPARClite配置), GCC生成SPARC v7目标码.

-mv8生成SPARC v8目标码.他和v7目标码唯一的区别是,编译器生成整数乘法和整数
除法指令, SPARC v8支持该指令,而v7体系不支持.

-msparclite生成SPARClite目标码.增加了SPARClite支持的整数乘法,整数除法单步
扫描 (integer divide step and scan (ffs))指令. v7体系不支持这些指令.

-mcypress

-msupersparc

这两个选项选择处理器型号,针对处理器进行代码优化.

-mcypress选项(默认项)使编译器对Cypress CY7C602芯片优化代码, SparcStation
/SparcServer 3xx系列使用这种芯片.该选项也适用于老式的SparcStation 1, 2,
IPX 等机型..

-msupersparc选项使编译器对SuperSparc处理器优化代码, SparcStation 10, 100
0 和2000系列使用这种芯片.同时该选项启用完整的SPARC v8指令集.

下面是针对Convex定义的`-m'选项:

-mc1

输出C1的目标码.当编译器对C1配置时,这是默认选项.

-mc2

输出C2的目标码.当编译器对C2配置时,这是默认选项.

-margcount

在每个参数列表的前面放置一个参数计数字(argument count word).某些不可移植
的Convex和Vax 程序需要这个参数计数字. (调试器不需要他,除非函数带有变长参
数列表;这个信息存放在符号表中.)

-mnoargcount

忽略参数计数字.如果你使用未改装的gcc,这是默认选项.

下面是针对AMD Am29000定义的`-m'选项:

-mdw

生成的目标码认为DW置位,就是说,字节和半字操作由硬件直接支持.该选项是默认选
项.

-mnodw

生成的目标码认为DW没有置位.

-mbw

生成的目标码认为系统支持字节和半字写操作.该选项是默认选项.

-mnbw

生成的目标码认为系统不支持字节和半字写操作.该选项隐含开启了`-mnodw'选项.


-msmall

使用小内存模式,小内存模式假设所有函数的地址位于某个256 KB段内,或者所有函
数的绝对地址小于256K.这样 就可以用call指令代替const, consth, calli指令序
列.

-mlarge

假设不能使用call指令;这是默认选项.

-m29050

输出Am29050的目标码.

-m29000

输出Am29000的目标码.这是默认选项.

-mkernel-registers

生成的目标码引用gr64-gr95寄存器而不是gr96-gr127寄存器.该选项可以用于编译
内核代码,内核需要一组全局寄存器,这些全局寄存器和用户模式使用的寄存器完全
无关.

注意,使用这个选项时, `-f'选项中的寄存器名字必须是normal, user-mode, name
s.

-muser-registers

使用普通全局寄存器集gr96-gr127.这是默认选项.

-mstack-check

在每次堆栈调整后插入一条__msp_check调用.这个选项常用于内核代码.

下面是针对Motorola 88K体系定义的`-m'选项:

-m88000

生成的目标码可以在m88100和m88110上正常工作.

-m88100

生成的目标码在m88100上工作的最好,但也可以在m88110上运行.

-m88110

生成的目标码在m88110上工作的最好,可能不能在m88100上运行.

-midentify-revision

在汇编器的输出端包含一条ident指令,记录源文件名,编译器名字和版本,时标,以及
使用的编译选项,

-mno-underscores

在汇编器的输出端,符号名字前面不添加下划线.默认情况是在每个名字前面增加下
划线前缀.

-mno-check-zero-division

-mcheck-zero-division

早期型号的88K系统在除零操作上存在问题,特定情况下许多机器无法自陷.使用这些
选项可以避免包含(或可以 显明包含)附加的代码,这些代码能够检查除零错,发送例
外信号. GCC所有88K的配置默认使用 `-mcheck-zero-division'选项.

-mocs-debug-info

-mno-ocs-debug-info

包含(或忽略)附加的调试信息(关于每个栈架结构中寄存器的使用), 88Open Objec
t Compatibility Standard, ``OCS'',对此信息做了说明. GDB不需要这些额外信息
DG/UX, SVr4,和Delta 88 SVr3.2的默认配置是包含调试信息,其他88k机型的默认
配置是忽略这个信息.

-mocs-frame-position

-mno-ocs-frame-position

强制(或不要求)把寄存器值存储到栈架结构中的指定位置(按OCS的说明). DG/UX,
Delta88 SVr3.2和 BCS的默认配置使用`-mocs-frame-position'选项;其他88k机型
的默认配置是 `-mno-ocs-frame-position'.

-moptimize-arg-area

-mno-optimize-arg-area

控制如何在堆栈结构中存储函数参数. `-moptimize-arg-area'节省空间,但是有可
能宕掉某些 调试器(不是GDB). `-mno-optimize-arg-area'证实比标准选项好.默认
情况下GCC不优化参数域.

-mshort-data-

num通过和r0关联,产生较小的数据引用(data reference),这样就可以用单指令调入
一个数值(而不是平常的双指令).用户通过选项中的num控制改变哪种数据引用.例
如,如果你指定了 `-mshort-data-512',那么受影响的数据引用是小于512字节的数
据移动. -mshort-data-num选项对大于64K的num 无效.

-mserialize-volatile

-mno-serialize-volatile

产生,或不产生代码来保证对易变内存访问的结果一致.

对于常用的处理器子型号, GNU CC始终默认保证这种一致性.如何实现结果一致取决
于处理器子型号.

m88100处理器不对内存引用重新安排,因此访问结果始终一致.如果使用了`-m88100
'选项, GNU CC 不产生任何针对结果一致的特别指令.

m88110处理器的内存引用顺序并不始终符合指令请求的引用顺序.特别是某条读取指
令可能在先前的存储指令之前执行. 多处理器环境下,乱序访问扰乱了易变内存访问
的结果一致.因此当使用`-m88000'或`-m88110' 选项时, GNU CC在适当的时候产生
特别的指令迫使执行顺序正确.

这些用于保证一致性的额外代码有可能影响程序的性能.如果你确认能够安全地放弃
这种保证,你可以使用 `-mno-serialize-volatile'选项.

如果你使用`-m88100'选项,但是需要在m88110处理器上运行时的结果一致,你应该加
上 `-mserialize-volatile'选项.

-msvr4

-msvr3

打开(`-msvr4')或关闭(`-msvr3')和System V第四版(SVr4)相关的 编译器扩展.效
果如下:

*

输出哪种汇编语法(你可以使用`-mversion-03.00'选项单独选择).

*

`-msvr4'使C预处理器识别`#pragma weak'指令

*

`-msvr4'使GCC输出额外的声明指令(declaration directive),用于SVr4.

除了SVr4配置, `-msvr3'是所有m88K配置的默认选项.

-mtrap-large-shift

-mhandle-large-shift

包含一些指令,用于检测大于31位的位移(bit-shift);根据相应的选项,对这样的位
移发出自陷 (trap)或执行适当的处理代码.默认情况下, GCC对大位移不做特别处理


-muse-div-instruction

很早以前的88K型号没有(div)除法指令,因此默认情况下GCC避免产生这条指令.而这
个选项告诉GCC该指令是 安全的.

-mversion-03.00

在DG/UX配置中存在两种风格的SVr4.这个选项修改-msvr4 ,选择hybrid-COFF或 re
al-ELF风格.其他配置均忽略该选项.

-mwarn-passed-structs

如果某个函数把结构当做参数或结果传递, GCC发出警告.随着C语言的发展,人们已
经改变了传递结构的约定, 它往往导致移植问题.默认情况下, GCC不会发出警告.


下面的选项用于IBM RS6000:

-mfp-in-toc

-mno-fp-in-toc

控制是否把浮点常量放到内容表(TOC)中,内容表存放所有的全局变量和函数地址.默
认情况下, GCC把浮点常量放到 这里;如果TOC溢出, `-mno-fp-in-toc'选项能够减
少TOC的大小,这样就可以避免溢出.

下面的`-m'选项用于IBM RT PC:

-min-line-mul

对于整数乘法使用嵌入代码.这是默认选项.

-mcall-lib-mul

对于整数乘法使用lmul$$ .

-mfull-fp-blocks

生成全尺寸浮点数据块,包括IBM建议的最少数量的活动空间(scratch space).这是
默认选项.

-mminimum-fp-blocks

不要在浮点数据块中包括额外的活动空间.这样就产生较小但是略慢的可执行程序,
因为活动空间必须动态分配.

-mfp-arg-in-fpregs

采用不兼容IBM调用约定的调用序列,通过浮点寄存器传送浮点参数.注意,如果指定
了这个选项, varargs.h和stdargs.h将无法支持浮点单元.

-mfp-arg-in-gregs

使用正常的调用约定处理浮点参数.这是默认选项.

-mhc-struct-return

通过内存返回大于一个字的结构,而不是通过寄存器.用于兼容MetaWare HighC (hc
)编译器.使用 `-fpcc-struct-return'选项可以兼容Portable C编译器(pcc).

-mnohc-struct-return

如果可以,通过寄存器返回某些大于一个字的结构.这是默认选项.如果打算兼容IBM
提供的编译器,请使用 `-fpcc-struct-return'或`-mhc-struct-return'选项.