总览 (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-floatVAX 选项
-mg -mgnu -munixSPARC 选项
-mepilogue -mfpu -mhard-float -mno-fpu -mno-epilogue -msoft-float -msparclite -mv8 -msupersparc -mcypressConvex 选项
-margcount -mc1 -mc2 -mnoargcountAMD29K 选项
-m29000 -m29050 -mbw -mdw -mkernel-registers -mlarge -mnbw -mnodw -msmall -mstack-check -muser-registersM88K 选项
-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-structsRS6000 选项
-mfp-in-toc -mno-fop-in-tocRT 选项
-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-returnMIPS 选项
-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 -nocppi386 选项
-m486 -mno-486 -msoft-float -mno-fp-ret-in-387HPPA 选项
-mpa-risc-1-0 -mpa-risc-1-1 -mkernel -mshared-libs -mno-shared-libs -mlong-calls -mdisable-fpregs -mdisable-indexing -mtrailing-coloni960 选项
-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-alignDEC Alpha 选项
-mfp-regs -mno-fp-regs -mno-soft-float -msoft-floatSystem 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++ 中 意味着 参数 为 空.
-
支持 ANSI C trigraphs. ` -ansi' 选项 隐含声明了 ` -trigraphs'.
-
试图 支持 传统 C 编译器 的 某些方面. 详见 GNU C 手册, 我们 已经把 细节清单从这里 删除, 这样 当内容 过时后, 人们 也不会 埋怨 我们.
除了 一件事: 对于 C++ 程序 (不是 C), `-traditional' 选项 带来 一个 附加效应, 允许 对 this 赋值. 他 和 `-fthis-is-variable' 选项 的 效果 一样.
-traditional-cpp
-
试图 支持 传统 C 预处理器 的 某些方面. 特别是 上面 提到 有关 预处理器 的内容, 但是 不包括 ` -traditional' 选项 的 其他 效应.
-
允许 在 标识符(identifier) 中 使用 ` $' 字符 (仅针对 C++). 你 可以 指定 ` -fno-dollars-in-identifiers' 选项 显明 禁止 使用 ` $' 符. (GNU C++ 在 某些 目标系统 缺省允许 ` $' 符, 但不是 所有系统.)
-
允许 int 类型 到 枚举类型 (enumeration) 的 隐式转换 (仅限于 C++). 正常情况下 GNU C++ 允许 从 enum 到 int 的 转换, 反之则 不行.
-
为 模板声明 (template declaration) 产生 较小的 代码 (仅限于 C++), 方法 是 对于 每个 模板函数 (template function), 只在 定义 他们 的 地方生成 一个 副本. 想要 成功 使用 这个选项, 你 必须 在 所有 使用 模板 的 文件 中, 标记 ` #pragma implementation' (定义) 或 ` #pragma interface' (声明).
当 程序 用 `-fexternal-templates' 编译 时, 模板实例 (template instantiation) 全部是 外部类型. 你 必须 让 需要的 实例 在 实现文件 中 出现. 可以 通过 typedef 实现 这一点, 他 引用 所需的 每个 实例. 相对应的, 如果 编译时 使用 缺省选项 `-fno-external-templates', 所有 模板实例 明确的 设为 内置.
-fall-virtual
-
所有 可能的 成员函数 默认为 虚函数. 所有的 成员函数 (除了 构造子函数 和 new 或 delete 成员操作符) 视为 所在类 的 虚函数.
这 不表明 每次 调用 成员函数 都将 通过 内部 虚函数表. 有些 情况 下, 编译器 能够 判断出 可以 直接 调用 某个 虚函数; 这时 就 直接 调用.
-fcond-mismatch
-
允许 条件表达式 的 第二 和 第三个 参数 的 类型 不匹配. 这种 表达式 的 值 是 void.
-
允许 对 this 赋值 (仅对 C++). 合并 用户自定义 的 自由存储管理 机制 到 C++ 后, 使 可赋值 的 ` this' 显得 不合时宜. 因此, 默认 情况 下, 类成员函数 内部 对 this 赋值 是 无效操作. 然而 为了 向后兼容, 你 可以 通过 ` -fthis-is-variable' 选项 使 这种 操作 有效.
-
把 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' 选项 按 书写顺序 处理.
-
在 处理 常规 输入文件 之前, 首先 处理 文件 file, 但是 忽略 输出结果. 由于 丢弃了 文件 file 的 输出内容, ` -imacros file' 选项 的 唯一 效果 就是 使 文件 file 中 的 宏定义 生效, 可以 用于 其他 输入文件. 在 处理 ` -imacros file' 选项 之前, 预处理器 首先 处理 ` -D' 和 ` -U' 选项, 并不在乎 他们 在 命令行上 的 顺序. 然而 ` -include' 和 ` -imacros' 选项 按 书写顺序 处理.
-
把 目录 dir 添加到 第二包含路径 中. 如果 某个 头文件 在 主包含路径 (用` -I' 添加的 路径) 中 没有 找到, 预处理器 就搜索 第二包含路径.
-
指定 prefix 作为 后续 ` -iwithprefix' 选项 的 前缀.
-
把 目录 添加到 第二包含路径 中. 目录名 由 prefix 和 dir 合并 而成, 这里 prefix 被 先前的 ` -iprefix' 选项 指定.
-
不要 在 标准系统目录 中 寻找 头文件. 只 搜索 ` -I' 选项 指定的 目录 (以及 当前目录, 如果 合适).
结合 使用 `-nostdinc' 和 `-I-' 选项, 你 可以 把 包含文件 搜索 限制在 显式 指定的 目录.
-nostdinc++
- 不要 在 C++ 专用标准目录 中 寻找 头文件, 但是 仍然 搜索 其他 标准目录. (当 建立 ` libg++' 时 使用 这个选项.) -undef
-
不要 预定义 任何 非标准宏. (包括 系统结构 标志).
-
仅运行 C 预处理器. 预处理 所有 指定的 C 源文件, 结果 送往 标准输出或 指定的 输出文件.
-
告诉 预处理器 不要 丢弃 注释. 配合 ` -E' 选项 使用.
-
告诉 预处理器 不要 产生 ` #line' 命令. 配合 ` -E' 选项 使用.
-
告诉 预处理器 输出 一个 适合 make 的 规则, 用于 描述 各目标文件的 依赖 关系. 对于 每个 源文件, 预处理器 输出 一个 make 规则, 该规则 的 目标项 (target) 是 源文件 对应的 目标文件名, 依赖项 (dependency) 是 源文件中 ` #include 引用的 所有文件. 生成的 规则 可以是 单行, 但如果 太长, 就用 ` \'-换行符 续成 多行. 规则 显示在 标准输出, 不产生 预处理过的 C 程序.
`-M' 隐含了 `-E' 选项.
`-MG' 要求 把 缺失的 头文件 按 存在 对待, 并且 假定 他们 和 源程序文件在 同一目录 下. 必须 和 `-M' 选项 一起用.
-MM [ -MG ]
-
和 ` -M' 选项 类似, 但是 输出结果 仅涉及 用户头文件, 象 这样 ` #include file"'. 忽略 系统头文件 如 ` #include < file>'.
-
和 ` -M' 选项 类似, 但是 把 依赖 信息 输出在 文件中, 文件名 通过 把 输出文件名末尾的 ` .o' 替换为 ` .d' 产生. 同时 继续 指定的 编译工作 ---` -MD' 不象 ` -M' 那样 阻止 正常的 编译任务.
Mach 的 实用工具 `md' 能够 合并 `.d' 文件, 产生 适用于 `make' 命令 的 单一的 依赖文件.
-MMD
-
和 ` -MD' 选项 类似, 但是 输出结果 仅涉及 用户头文件, 忽略 系统头文件.
-
除了 其他 普通 的 操作, GCC 显示 引用过的 头文件 名.
-
如果 预处理器 做 条件测试, 如 ` #if # question ( answer )', 该选项 可以 断言 (Assert) question 的 答案 是 answer. -A-' 关闭 一般用于 描述 目标机 的 标准 断言.
-
定义 宏 macro, 宏 的 内容 定义为 字符串 ` 1'.
-
定义 宏 macro 的 内容 为 defn. 命令行 上 所有的 ` -D' 选项 在 ` -U' 选项 之前 处理.
-
取消 宏 macro. ` -U' 选项 在 所有的 ` -D' 选项 之后 处理, 但是 优先于 任何 ` -include' 或 ` -imacros' 选项.
-
告诉 预处理器 输出 有效的 宏定义 列表 (预处理 结束时 仍然 有效的 宏定义). 该选项 需 结合 ` -E' 选项 使用.
-
告诉 预处理器 把 所有的 宏定义 传递到 输出端, 按照 出现的 顺序 显示.
-
和 ` -dD'选项 类似, 但是 忽略 宏的 参量 或 内容. 只在 输出端 显示 ` #define name.
汇编器选项 (ASSEMBLER OPTION)
- -Wa, option
-
把 选项 option 传递给 汇编器. 如果 option 含有 逗号, 就在 逗号 处 分割成 多个 选项.
连接器选项 (LINKER OPTION)
下面的 选项 用于 编译器 连接 目标文件, 输出 可执行文件 的 时候. 如果 编译器 不进行 连接, 他们 就 毫无意义.
- object-file-name
-
如果 某些文件 没有 特别明确的 后缀 a special recognized suffix, GCC 就 认为 他们 是 目标文件 或 库文件. (根据 文件内容, 连接器 能够 区分目标文件 和 库文件). 如果 GCC 执行 连接 操作, 这些 目标文件 将 成为连接器 的 输入文件.
-
连接 名为 library 的 库文件.
连接器 在 标准搜索目录 中 寻找 这个 库文件, 库文件 的 真正 名字 是 `liblibrary.a'. 连接器 会 当做 文件名 得到 准确 说明 一样 引用 这个文件.
搜索目录 除了 一些 系统标准目录 外, 还包括 用户 以 `-L' 选项 指定 的 路径.
一般说来 用 这个方法 找到的 文件 是 库文件---即由 目标文件 组成的 归档文件 (archive file). 连接器 处理 归档文件 的 方法 是: 扫描 归档文件, 寻找 某些 成员, 这些 成员 的 符号 目前 已 被引用, 不过 还没有 被定义. 但是, 如果 连接器 找到 普通的 目标文件, 而不是 库文件, 就把 这个 目标文件按 平常方式 连接 进来. 指定 `-l' 选项 和 指定 文件名 的 唯一 区别 是, `-l选项 用 `lib' 和 `.a' 把 library 包裹 起来, 而且 搜索 一些 目录.
-lobjc
-
这个 -l 选项 的 特殊形式 用于 连接 Objective C 程序.
-
不连接 系统 标准启动文件, 而 标准库文件 仍然 正常 使用.
-
不连接 系统 标准启动文件 和 标准库文件. 只把 指定的 文件 传递给 连接器.
-
在 支持 动态连接 (dynamic linking) 的 系统 上, 阻止 连接 共享库. 该选项 在 其他系统上 无效.
-
生成 一个 共享目标文件, 他 可以 和 其他 目标文件 连接 产生 可执行文件. 只有 部分 系统 支持 该选项.
-
建立 共享目标文件 的 时候, 把 引用 绑定到 全局符号上. 对 所有 无法解析的 引用 作出 警告 (除非 用 连接编辑选项 ` -Xlinker -z -Xlinker defs' 取代). 只有 部分 系统 支持 该选项.
-
把 选项 option 传递给 连接器. 可以 用 他 传递 系统 特定的 连接 选项, GNU CC 无法 识别 这些 选项.
如果 需要 传递 携带 参数 的 选项, 你 必须 使用 两次 `-Xlinker', 一次 传递 选项, 另一次 传递 他的 参数. 例如, 如果 传递 `-assert definitions', 你 必须 写成 `-Xlinker -assert -Xlinker definitions', 而不能 写成 `-Xlinker "-assert definitions"', 因为 这样 会把 整个 字符串 当做 一个 参数 传递, 显然 这 不是连接器 期待的.
-Wl, option
-
把 选项 option 传递给 连接器. 如果 option 中 含有 逗号, 就在 逗号 处 分割成 多个 选项.
-
使 连接器 认为 取消了 symbol 的 符号定义, 从而 连接 库模块 以 取得 定义. 你 可以 使用 多个 ` -u' 选项, 各自 跟上 不同的 符号, 使得 连接器 调入 附加的 库模块.
目录选项 (DIRECTORY OPTION)
下列 选项 指定 搜索路径, 用于 查找 头文件, 库文件, 或 编译器 的 某些成员:
- -I dir
-
在 头文件 的 搜索路径 列表 中 添加 dir 目录.
-
任何 在 ` -I-' 前面 用 ` -I' 选项 指定 的 搜索路径 只适用于 ` #include " file "' 这种 情况; 他们 不能 用来 搜索 ` #include < file>' 包含 的 头文件.
如果 用 `-I' 选项 指定的 搜索路径 位于 `-I-' 选项 后面, 就可以 在 这些 路径 中 搜索 所有的 `#include' 指令. (一般说来 -I 选项 就是 这么 用的.)
还有, `-I-' 选项 能够 阻止 当前目录 (存放 当前 输入文件 的 地方) 成为 搜索 `#include "file"' 的 第一选择. 没有 办法 克服 `-I-' 选项 的 这个效应. 你 可以 指定 `-I.' 搜索 那个目录, 它 在 调用 编译器 时 是 当前目录. 这 和 预处理器 的 默认行为 不完全 一样, 但是 结果 通常 令人满意.
`-I-' 不影响 使用 系统标准目录, 因此, `-I-' 和 `-nostdinc' 是 不同的 选项.
-L dir
-
在 ` -l' 选项 的 搜索路径 列表 中 添加 dir 目录.
-
这个选项 指出 在何处 寻找 可执行文件, 库文件, 以及 编译器 自己 的 数据文件.
编译器 驱动程序 需要 执行 某些 下面的 子程序: `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-int 和 -Wimplicit-function-declaration.
-
如果 把 main 函数 声明 或 定义 成 奇怪 的 类型, 编译器 就 发出 警告. 典型情况下, 这个 函数 用于 外部连接, 返回 int 数值, 不需要 参数, 或 指定 两个 参数.
-
如果 函数 定义了 返回类型, 而 默认 类型 是 int 型, 编译器 就 发出 警告. 同时 警告 那些 不带 返回值 的 return 语句, 如果 他们 所属的 函数 并非 void 类型.
-
如果 某个 局部变量 除了 声明 就 没再 使用, 或者 声明了 静态函数 但是 没有定义, 或者 某条 语句 的 运算结果 显然 没有 使用, 编译器 就 发出 警告.
-
如果 某条 switch 语句 的 参数 属于 枚举类型, 但是 没有 对应的 case 语句 使用 枚举元素, 编译器 就 发出 警告. ( default 语句 的 出现 能够 防止 这个 警告.) 超出 枚举 范围 的 case 语句 同样 会 导致 这个 警告.
-
如果 注释起始序列 ` /*' 出现在 注释 中, 编译器 就 发出 警告.
-
警告 任何 出现的 trigraph (假设 允许 使用 他们).
-
检查 对 printf 和 scanf 等 函数 的 调用, 确认 各个 参数 类型 和 格式串 中的 一致.
-
警告 类型 是 char 的 数组 下标. 这是 常见 错误, 程序员 经常 忘记 在 某些 机器 上 char 有 符号.
-
在 初始化 之前 就 使用 自动变量.
这些警告 只可能 做 优化编译 时 出现, 因为 他们 需要 数据流信息, 只有做 优化 的 时候 才 估算 数据流信息. 如果 不指定 `-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
-
在 某些 情况 下 如果 忽略了 括号, 编译器 就 发出 警告.
-
当 在 C++ 程序 中 使用 template 的 时候, 如果 调试 (debugging) 没有 完全 生效, 编译器 就 发出 警告. (仅用于 C++).
-
结合 所有 上述 的 ` -W' 选项. 通常 我们 建议 避免 这些 被警告的 用法，我们 相信, 恰当 结合 宏 的 使用 能够 轻易 避免 这些 用法。
剩下的 `-W...' 选项 不包括 在 `-Wall' 中, 因为 我们 认为 在 必要情况 下, 这些 被 编译器 警告 的 程序结构, 可以 合理的 用在 "干净的" 程序 中.
- -Wtraditional
-
如果 某些 程序结构 在 传统 C 中 的 表现 和 ANSI C 不同, 编译器 就 发出 警告.
-
宏参 出现在 宏体 的 字符串常量 内部. 传统 C 会 替换 宏参, 而 ANSI C 则 视其为 常量 的 一部分.
-
某个函数 在 块(block) 中 声明为 外部, 但在 块 结束后 才 调用.
- switch 语句 的 操作数 类型 是 long.
- -Wshadow
-
一旦 某个 局部变量 屏蔽了 另一个 局部变量, 编译器 就 发出 警告.
-
一旦 两个 确定的 标识符 具有 相同的 前 len 个 字符, 编译器 就 发出 警告. 他 可以 协助 你 开发 一些 将要在某些 过时的, 危害大脑的 编译器 上 编译 的 程序.
-
任何 语句 如果 依赖于 函数类型 的 大小(size) 或者 void 类型 的 大小, 编译器 就 发出 警告. GNU C 为了 便于 计算 void * 指针 和 函数指针, 就把 这些 类型 的 大小 定义 为 1.
-
一旦 某个 指针 强制类型转换 以便 移除 类型修饰符 时, 编译器 就 发出 警告. 例如, 如果 把 const char * 强制转换 为 普通的 char * 时, 警告 就会 出现.
-
一旦 某个 指针类型 强制转换 时, 导致 目标 所需的 地址对齐 (alignment) 增加, 编译器 就 发出 警告. 例如, 某些 机器 上 只能 在 2 或 4 字节 边界 上 访问 整数, 如果 在 这种 机型 上 把 char * 强制转换 成 int * 类型, 编译器 就 发出 警告.
-
规定 字符串常量 的 类型 是 const char[ length ], 因此, 把 这样的 地址 复制给 non- const char * 指针 将 产生 警告. 这些 警告 能够 帮助 你 在 编译期间 发现 企图 写入 字符串常量 的 代码, 但是 你 必须 非常 仔细 的 在 声明 和 原形 中 使用 const, 否则 他们 只能 带来 麻烦; 所以 我们 没有 让 ` -Wall' 提供 这些 警告.
-
如果 某函数原形 导致 的 类型转换 和 无函数原形 时的 类型转换 不同, 编译器 就 发出 警告. 这里 包括 定点数 和 浮点数 的 互相转换, 改变 定点数 的 宽度 或 符号, 除非 他们 和 缺省声明 (default promotion) 相同.
-
如果 定义 或 调用 了 返回 结构 或 联合 的 函数, 编译器 就 发出 警告. (从 语言角度 你 可以 返回 一个 数组, 然而 同样 会 导致 警告.)
-
如果 函数 的 声明 或 定义 没有 指出 参数类型, 编译器 就 发出 警告. (如果 函数 的 前向引用说明 指出了 参数类型, 则 允许 后面 使用 旧式风格的 函数定义, 而 不会产生 警告.)
-
如果 没有 预先 声明 函数原形 就 定义了 全局函数, 编译器 就 发出 警告. 即使 函数定义 自身 提供了 函数原形 也会 产生 这个 警告. 他 的 目的是 检查 没有 在 头文件 中 声明 的 全局函数.
-
如果 没有 预先 声明 就 定义了 全局函数, 编译器 就 发出 警告. 即使 函数定义 自身 提供了 函数原形 也会 产生 这个 警告. 这个选项 的 目的是 检查 没有 在 头文件 中 声明 的 全局函数.
-
如果 在 同一个 可见域 某定义 多次 声明, 编译器 就 发出 警告, 即使 这些重复声明 有效 并且 毫无差别.
-
如果 某 extern 声明 出现在 函数 内部, 编译器 就 发出 警告.
-
对于 不同 枚举类型 之间 的 转换 发出 警告 (仅适用于 C++).
-
如果 使用了 long long 类型 就 发出 警告. 该 警告 是 缺省项. 使用 ` -Wno-long-long' 选项 能够 防止 这个 警告. ` -Wlong-long' 和 ` -Wno-long-long' 仅 在 ` -pedantic' 之下 才起作用.
-
(仅适用于 C++.) 在继承类中, 虚函数 的 定义 必须 匹配 虚函数 在 基类中 声明 的 类型特征 (type signature). 当 继承类 声明了 某个函数, 它 可能 是个 错误的 尝试 企图 定义一个 虚函数, 使用 这个 选项 能够 产生 警告: 就是说, 当 某个函数 和 基类 中的 虚函数 同名, 但是 类型特征 不符合 基类的 任何 虚函数, 编译器 将发出 警告.
-
如果 某函数 不能 内嵌(inline), 无论 是 声明为 inline 或者是 指定了 -finline-functions 选项, 编译器 都将 发出 警告.
-
视 警告 为 错误; 出现 任何 警告 即 放弃 编译.
调试选项 (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 扩展.
-
以 stabs 格式 (如果支持) 输出 调试信息, 不包括 GDB 扩展. 这是 大多数 BSD 系统 上 DBX 使用 的 格式.
-
以 stabs 格式 (如果支持) 输出 调试信息, 使用 只有 GNU 调试器 (GDB) 理解的 GNU 扩展. 使用 这些扩展 有可能 导致 其他 调试器 崩溃 或 拒绝读入 程序.
-
以 COFF 格式 (如果支持) 输出 调试信息. 这是 在 System V 第四版 以前的 大多数 System V 系统 上 SDB 使用 的 格式.
-
以 XCOFF 格式 (如果支持) 输出 调试信息. 这是 IBM RS/6000 系统上 DBX 调试器 使用 的 格式.
-
以 XCOFF 格式 (如果支持) 输出 调试信息, 使用 只有 GNU 调试器 (GDB) 理解的 GNU 扩展. 使用 这些扩展 有可能 导致 其他 调试器 崩溃 或 拒绝读入 程序.
-
以 DWARF 格式 (如果支持) 输出 调试信息. 这是 大多数 System V 第四版系统 上 SDB 使用 的 格式.
-
以 DWARF 格式 (如果支持) 输出 调试信息, 使用 只有 GNU 调试器 (GDB) 理解的 GNU 扩展. 使用 这些扩展 有可能 导致 其他 调试器 崩溃 或 拒绝读入 程序.
-glevel
-ggdblevel
-gstabslevel
-gcofflevel -gxcofflevel
- -gdwarf level
-
请求 生成 调试信息, 同时 用 level 指出 需要 多少 信息. 默认的 level 值 是 2.
Level 1 输出 最少量 的 信息, 仅够 在 不打算 调试 的 程序段 内 backtrace. 包括 函数 和 外部变量 的 描述, 但是 没有 局部变量 和 行号 信息.
Level 3 包含 更多的 信息, 如 程序中出现 的 所有 宏定义. 当 使用 `-g3' 选项 的 时候, 某些 调试器 支持 宏扩展.
-p
-
产生 额外代码, 用于 输出 profile 信息, 供 分析程序 prof 使用.
-
产生 额外代码, 用于 输出 profile 信息, 供 分析程序 gprof 使用.
- 产生 额外代码, 用于 输出 基本块 (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__' 导致 在 跟踪 中 包括 返回指令.
-
编译 的 时候, 在 letters 指定 的 时刻 做 调试转储 (dump). 用于 调试 编译器. 大多数 转储 的 文件名 通过 源文件名 添加 字词 获得 (例如 ` foo.c.rtl' 或 ` foo.c.jump').
-
预处理 结束 的 时候 转储 所有的 宏定义, 不输出到 文件.
-
预处理 结束 的 时候 转储 所有的 宏名.
-
预处理 结束 的 时候 转储 所有的 宏定义, 同时 进行 正常 输出.
-
语法分析 (parse) 的 时候 在 标准错误 转储 调试信息.
-
RTL 阶段 后 转储到 ` file .rtl'.
-
仅对 函数 生成 RTL, 而不是 编译. 通常 和 ` r' 联用.
-
第一次 跳转优化 后 转储到 ` file .jump'.
-
CSE (包括 有时候 跟在 CSE 后面的 跳转优化) 后 转储到 ` file .cse'.
-
循环优化 后 转储到 ` file .loop'.
-
第二次 CSE 处理 (包括 有时候 跟在 CSE 后面的 跳转优化) 后 转储到 ` file .cse2'.
-
流程分析 (flow analysis) 后 转储到 ` file .flow'.
-
指令组合 (instruction combination) 后 转储到 ` file .combine'.
-
第一次 指令安排 (instruction schedule) 后 转储到 ` file .sched'.
-
局部寄存器分配 后 转储到 ` file .lreg'.
-
全局寄存器分配 后 转储到 ` file .greg'.
-
第二次 指令安排 (instruction schedule) 后 转储到 ` file .sched2'.
-
最后一次 跳转优化 后 转储到 ` file .jump2'.
-
推迟分支调度 (delayed branch scheduling) 后 转储到 ` file .dbr'.
-
寄存器-堆栈转换 后 转储到 ` file .stack'.
-
产生 以上 所有的 转储.
-
运行结束后, 在 标准错误 显示 内存使用统计.
-
在 汇编输出 加注 指明 使用了 哪些 模式 (pattern) 及其 替代模式.
-
交叉编译 的 时候, 假定 目标机 和 宿主机 使用 同样的 浮点格式. 它 导致 输出 错误的 浮点常数, 但是 在 目标机 上 运行 的 时候, 真实的 指令序列 有可能 和 GNU CC 希望 的 一样.
-
保存 那些 通常 是 ``临时'' 的 中间文件; 置于 当前目录 下, 并且 根据 源文件 命名. 因此, 用 ` -c -save-temps' 选项 编译 ` foo.c ' 会 生成 ` foo.cpp' 和 ` foo.s' 以及 ` foo.o' 文件.
-
显示 库文件 library 的 全路径名, 连接 时 会 使用 这个库 --- 其他 什么事情 都不作. 根据 这个选项, GNU CC 既不编译, 也不连接, 仅仅 显示 文件名.
-
和 ` -print-file-name=libgcc.a' 一样.
-
类似于 ` -print-file-name', 但是 查找 程序 program 如 ` cpp'.
优化选项 (OPTIMIZATION OPTION)
这些选项 控制 多种 优化措施:
- -O
- -O1
-
优化. 对于 大函数, 优化编译 占用 稍微多 的 时间 和 相当大 的 内存.
不使用 `-O' 选项 时, 编译器 的 目标 是 减少 编译 的 开销, 使 编译结果 能够 调试. 语句 是 独立的: 如果 在 两条语句 之间 用 断点 中止 程序, 你 可以 对任何 变量 重新 赋值, 或者 在 函数体 内 把 程序计数器 指到 其他语句, 以及 从 源程序 中 精确地 获取 你 期待 的 结果.
不使用 `-O' 选项 时, 只有 声明了 register 的 变量 才 分配使用 寄存器. 编译结果 比 不用 `-O' 选项 的 PCC 要 略逊一筹.
使用了 `-O' 选项, 编译器 会试图 减少 目标码 的 大小 和 执行时间.
如果 指定了 `-O' 选项, `-fthread-jumps' 和 `-fdefer-pop' 选项 将被 打开. 在 有 delay slot 的 机器 上, `-fdelayed-branch' 选项 将被 打开. 在 即使 没有 帧指针 (frame pointer) 也支持 调试 的 机器 上, `-fomit-frame-pointer' 选项 将被 打开. 某些机器 上 还可能会 打开 其他选项.
-O2
-
多优化一些. 除了 涉及 空间 和 速度 交换 的 优化选项, 执行 几乎 所有的优化工作. 例如 不进行 循环展开 (loop unrolling) 和 函数内嵌 (inlining). 和 -O 选项 比较, 这个选项 既增加了 编译时间, 也提高了 生成代码 的 运行效果.
-
优化的更多. 除了 打开 -O2 所做的 一切, 它 还 打开 了 -finline-functions 选项.
-
不优化.
如果 指定了 多个 -O 选项, 不管 带不带 数字, 最后一个 选项 才是 生效 的 选项.
诸如 `-fflag' 此类 的 选项 描述 一些 机器无关 的 开关. 大多数 开关 具有 肯定 和 否定 两种格式; `-ffoo' 开关选项 的 否定格式 应该是 `-fno-foo'. 下面的 列表 只展示了 一种 格式 --- 那个 不是 默认选项 的 格式. 你 可以 通过 去掉 或 添加 `no-' 构造出 另一种 格式.
- -ffloat-store
-
不要 在 寄存器 中 存放 浮点变量. 这样 可以 防止 某些 机器 上 不希望的 过高 精度, 如 68000 的 浮点寄存器 (来自 68881) 保存的 精度 超过了 double 应该 具有的 精度.
对于 大多数 程序, 过高 精度 只有 好处. 但是 有些 程序 严格 依赖于 IEEE 浮点数的 定义. 对 这样的 程序 可以 使用 `-ffloat-store' 选项.
-fmemoize-lookups
- -fsave-memoized
-
使用 探索法 (heuristic) 进行 更快的 编译 (仅对 C++). 默认情况下 不使用 探索法. 由于 探索法 只对 某些 输入文件 有效, 其他程序 的 编译速度 会变得 更慢.
第一次 编译器 必须 对 成员函数 (或对 成员数据 的 引用) 建立 一个 调用. 它 必须 (1) 判断出 这个类 是否 实现了 那个 名字 的 成员函数; (2) 决定调用 哪个 成员函数 (涉及到 推测 需要 做 哪种 类型转换); (3) 检查 成员函数对 调用者 是否 可见. 所有 这些 构成 更慢的 编译. 一般情形, 第二次 对 成员函数 (或对 成员数据 的 引用) 建立 的 调用, 必须再次 经过 相同 长度 的 处理. 这 意味着 象 这样的 代码
cout << "This " << p << " has " << n << " legs.\n";
对 整个 三步骤 要做 六次 遍历. 通过 使用 软件缓存, ``命中'' 能够 显著地 减少 这种 代价. 然而 不幸的 是, 使用 这种 缓存 必须实现 其他 机制, 带来了 它 自己的 开销. `-fmemoize-lookups' 选项 打开 软件缓存.
因为 函数 的 正文环境 不同, 函数 对 成员 和 成员函数 的 访问权 (可见性) 也可能 不同, g++ 可能 需要 刷新 缓存. 使用 `-fmemoize-lookups' 选项, 每 编译完 一个 函数 就 刷新 缓存. 而 `-fsave-memoized' 选项 也 启用 同样的 缓存, 但是 当 编译器 发觉 最后 编译 的 函数的 正文环境 产生 的 访问权 和 下一个 待编译的 函数 相同, 编译器 就 保留缓存 内容. 这对 某个类 定义 许多 成员函数 时 非常 有用: 除了 某些 其他类 的 友函数, 每个 成员函数 拥有 和 其他 成员函数 完全一样 的 访问权, 因而 无需 刷新 缓存.
-fno-default-inline
-
默认为 不要 把 成员函数 内嵌, 因为 它们 定义在 类的 作用域 内 (仅C++).
-
一旦 函数 返回, 参数 就 立即 弹出. 对于 那些 调用 函数 后 必须 弹出 参数的 机器, 编译器 一般情况下 让 几次 函数调用 的 参数 堆积 在 栈 上, 然后 一次 全部 弹出.
-
做 数学运算 前 把 将要 使用的 内存操作数 送入 寄存器. 通过 把 内存访问转换成 潜在的 公共子表达式, 它 可能 产生 较好的 目标码. 如果 它们 不是公共子表达式, 指令组合 应该 消除 各自的 寄存器载荷. 我 乐意 倾听 不同意见.
-
做 数学运算 前 把 将要 使用的 内存地址常数 送入 寄存器. 它 可能 和 ` -fforce-mem' 一样 产生 较好的 目标码. 我 乐意 倾听 不同意见.
-
对于 不需要 帧指针 (frame pointer) 的 函数, 不要 在 寄存器 中 保存 帧指针. 这样 能够 避免 保存, 设置 和 恢复 帧指针 的 指令; 同时 对 许多 函数 提供一个 额外的 寄存器. 但是 在 大多数 机器 上将 无法 调试.
某些机器上, 如 Vax, 这个 选项 无效, 因为 标准调用序列 自动 处理 帧指针, 通过 假装 不存在 而 不保存 任何 东西. 机器描述宏 FRAME_POINTER_REQUIRED 控制 目标机 是否 支持 这个选项.
-finline-functions
-
把 所有 简单的 函数 集成进 调用者. 编译器 探索式地 决定 哪些 函数 足够简单, 值得 这种 集成.
如果 集成了 所有 给定函数 的 调用, 而且 函数 声明为 static, 那么 一般说来 GCC 有权 不按 汇编代码 输出 函数.
-fcaller-saves
-
允许 在 寄存器 里 分配 数值, 但是 这个方案 通常 受到 各个 函数调用 的 冲击, 因此 GCC 生成 额外的 代码, 在 函数调用 的 前后 保存 和 复原 寄存器 内容. 仅当 生成代码 看上去 优于 反之结果 时 才 实现 这样 的 分配.
某些 机器 上 该选项 默认为 允许, 通常 这些 机器 没有 调用保护寄存器 代替 使用.
-fkeep-inline-functions
-
即使 集成了 某个 函数 的 所有 调用, 而且 该函数 声明为 static, 仍然 输出 这个函数 一个 独立的, 运行时 可调用 的 版本.
-
不要 把 函数地址 存入 寄存器; 让 调用 固定函数 的 指令 显式 给出 函数地址.
这个选项 产生 效率 较低 的 目标码, 但是 如果 不用 这个选项, 某些 不寻常的 hack, 改变 汇编器 的 输出, 可能 因 优化 而 带来 困惑.
-fno-peephole
-
禁止 任何 机器相关的 peephole 优化.
-
这个选项 出于 速度优化, 允许 GCC 违反 某些 ANSI 或 IEEE 规则/规格. 例如, 它 允许 编译器 假设 sqrt 函数 的 参数 是 非负数.
这个选项 不被 任何 `-O' 选项 打开, 因为 对于 严格 依靠 IEEE 或 ANSI 规则/规格 实现的 数学函数, 程序 可能 会产生 错误的 结果.
下列 选项 控制 特定的 优化. `-O2' 选项 打开 下面的 大多数 优化项, 除了 `-funroll-loops' 和 `-funroll-all-loops' 项.
而 `-O' 选项 通常 打开 `-fthread-jumps' 和 `-fdelayed-branch' 优化项, 但是 特定的 机器 上的 默认优化项 有可能 改变.
如果 特别情况 下 非常 需要 ``微调'' 优化, 你 可以 使用 下面的 选项.
- -fstrength-reduce
-
执行 循环强度缩小 (loop strength reduction) 优化, 并且 消除 重复变量.
-
执行 优化 的 地点 是, 如果 某个 跳转分支 的 目的地 存在 另一个 条件比较, 而且 该 条件比较 包含在 前一个 比较语句 之内, 那么 执行 优化. 根据 条件 是 true 或者 false, 前面 那条 分支 重定向 到 第二条 分支的 目的地 或者 紧跟在 第二条 分支 后面.
-
执行 循环展开 (loop unrolling) 优化. 仅对 循环次数 能够 在 编译时 或运行时 确定 的 循环 实行.
-
执行 循环展开 (loop unrolling) 优化. 对 所有 循环 实行. 通常 使 程序 运行的 更慢.
-
在 公共子表达式消元 (common subexpression elimination) 的 时候, 如果 没有 其他 路径 到达 某个 跳转 的 目的地, 就 扫过 这条 jump 指令. 例如, 如果 CSE 遇到 带有 else从句 的 if 语句, 当 条件测试 为 false 时, CSE 就 跟在 jump 后面.
-
它 类似于 ` -fcse-follow-jumps' 选项, 但是 CSE 跟在 条件跳转 后面, 条件跳转 跳过了 语句块(block). 如果 CSE 遇到 一条 简单的 if 语句, 不带 else 从句, ` -fcse-skip-blocks' 选项 将导致 CSE 跟在 if 产生 的 跳转 后面.
-
执行 循环优化 后, 重新 进行 公共子表达式消元.
-
如果 看上去 合理 就 省略 构造子 (仅C++). 根据 这个选项, 对于 下面的 代码, GNU C++ 直接 从 调用 foo 初始化 y, 而无需 通过 临时变量:
A foo (); A y = foo ();
如果 没有 这个选项, GNU C++ 首先 通过 调用 类型 A 合适的 构造子 初始化 y; 然后 把 foo 的 结果 赋给 临时变量; 最后, 用 临时变量 替换 `y' 的 初始值.
ANSI C++ 标准草案 规定了 默认行为 (`-fno-elide-constructors'). 如果 程序的 构造子 存在 副效应, `-felide-constructors' 选项 能够 使 程序 有 不同的 表现, 因为 可能 忽略 一些 构造子 的 调用.
-fexpensive-optimizations
-
执行 一些 相对 开销 较大 的 次要 优化.
-
如果 对 目标机 支持 这个 功能, 它 试图 重新 排列 指令, 以便 利用延迟分支 (delayed branch) 指令 后面的 指令 空隙.
-
如果 对 目标机 支持 这个 功能, 它 试图 重新 排列 指令, 以便 消除 因数据未绪 造成的 执行停顿. 这可以 帮助 浮点运算 或 内存访问 较慢 的 机器调取 指令, 允许 其他 指令 先执行, 直到 调取 指令 或 浮点运算 完成.
-
类似于 ` -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 的 系统 配置, 这个 选项 就是 缺省选项.
- -mc68020
-
输出 68020 的 目标码 (而不是 68000). 如果 编译器 按 基于 68020 的 系统 配置, 这个 选项 就是 缺省选项.
-
输出 包含 68881 浮点指令 的 目标码. 对于 大多数 基于 68020 的 系统 这是 缺省选项, 除非 设置 编译器 时 指定了 -nfp .
-
输出 68030 的 目标码. 如果 编译器 按 基于 68030 的 系统 配置, 这个 选项 就是 缺省选项.
-
输出 68040 的 目标码. 如果 编译器 按 基于 68040 的 系统 配置, 这个 选项 就是 缺省选项.
-
输出 68040 的 目标码, 但是 不使用 新指令. 生成 的 代码 可以 在 68020/68881 上, 也可以 在 68030 或 68040 上 较有效地 运行.
-
输出 包含 SUN FPA 浮点指令 的 目标码.
-
输出 包含 浮点库调用 的 目标码. 警告: 所需的库 不是 GNU CC 的 组成部分. 一般说来 GCC 使用 该机型 本地 C 编译器 的相应部件, 但是 作 交叉编译 时 却不能 直接 使用. 你 必须 自己 管理 提供 合适的函数库 用于 交叉编译.
-
认为 int 类型 是 16 位宽, 相当于 short int.
-
不使用 位域 (bit-field) 指令. ` -m68000' 隐含指定了 ` -mnobitfield'.
-
使用 位域指令. ` -m68020' 隐含指定了 ` -mbitfield'. 如果 你 使用 未改装的 gcc, 这就是 默认选项.
-
采用 另一种 函数调用约定, 函数 接受 固定 数目的 参数, 用 rtd 指令 返回, 该指令 返回时 弹出 栈内的 参数. 这个 方法 能够 使 调用者节省 一条 指令, 因为 他 这里 不需要 弹出 参数.
这种 调用约定 不兼容 UNIX 的 正常 调用. 因此 如果 你 需要 调用 UNIX 编译器 编译的 库函数, 你 就不能 使用 这个选项.
此外, 所有 参数数量 可变地 函数 必须 提供 函数原型 (包括 printf); 否则 编译器 会生成 错误的 调用 代码.
另外, 如果 调用 函数 时 携带了 过多的 参数, 编译器 将 生成 严重错误的代码. (正常情况下, 多余的 参数 被 安全无害的 忽略.)
68010 和 68020 处理器 支持 rtd 指令, 但是 68000 不支持.
下面是 针对 VAX 定义 的 `-m' 选项:
- -munix
-
禁止 输出 某些 跳转指令 ( aobleq 等等), VAX 的 UNIX 汇编器 无法 跨越 长范围 (long ranges) 进行 处理.
-
如果 使用 GNU 汇编器, 则 输出 那些 跳转指令,
-
输出 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, 1000 和 2000 系列 使用 这种 芯片. 同时 该选项 启用完整的 SPARC v8 指令集.
下面是 针对 Convex 定义 的 `-m' 选项:
- -mc1
- 输出 C1 的 目标码. 当 编译器 对 C1 配置时, 这是 默认选项. -mc2
- 输出 C2 的 目标码. 当 编译器 对 C2 配置时, 这是 默认选项. -margcount
-
在 每个 参数列表 的 前面 放置 一个 参数计数字 (argument count word). 某些 不可移植 的 Convex 和 Vax 程序 需要 这个 参数计数字. (调试器 不需要 他, 除非 函数 带有 变长参数 列表; 这个 信息 存放在 符号表 中.)
-
忽略 参数计数字. 如果 你 使用 未改装 的 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, names.
-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 Object 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 不优化 参数域.
- 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 对 大位移 不做 特别处理.
-
很早以前 的 88K 型号 没有 (div) 除法指令, 因此 默认情况下 GCC 避免 产生这条 指令. 而 这个 选项 告诉 GCC 该指令 是 安全的.
-
在 DG/UX 配置 中 存在 两种 风格 的 SVr4. 这个选项 修改 -msvr4 , 选择 hybrid-COFF 或 real-ELF 风格. 其他 配置 均 忽略 该选项.
-
如果 某个函数 把 结构 当做 参数 或 结果 传递, 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 将 无法 支持 浮点单元.
-
使用 正常的 调用约定 处理 浮点参数. 这是 默认选项.
-
通过 内存 返回 大于 一个字 的 结构, 而不是 通过 寄存器. 用于 兼容 MetaWare HighC (hc) 编译器. 使用 ` -fpcc-struct-return' 选项 可以 兼容 Portable C 编译器 (pcc).
-
如果可以, 通过 寄存器 返回 某些 大于 一个字 的 结构. 这是 默认选项. 如果 打算 兼容 IBM 提供 的 编译器, 请使用 ` -fpcc-struct-return' 或 ` -mhc-struct-return' 选项.
下面的 `-m' 选项 用于 MIPS 家族 的 计算机:
- -mcpu= cpu-type
-
生成 指令 的 时候, 假设 默认的 机器类型 是 cpu-type . 默认情况下 的 cpu-type 是 default, GCC 将选取 任何机型 上 都是 最长周期时间 的 指令, 这样 才能使 代码在 所有的 MIPS 处理器 上 以 合理 的 速度 运行. cpu-type 的 其他 选择 是 r2000, r3000, r4000, 和 r6000. 虽然 选定 某个 cpu-type 后, GCC 将 针对 选定的 芯片 安排 对应的 工作, 但是 如果 不指定�1�7 -mips2 或 -mips3 选项, 编译器 不会 输出 任何 不符合 MIPS ISA (instruction set architecture) 一级 的 代码.
-
输出 MIPS ISA 二级指令 (可能的扩展, 如平方根指令). -mcpu=r4000 或 -mcpu=r6000 选项 必须 和 -mips2 联用.
-
输出 MIPS ISA 三级指令 (64位指令). -mcpu=r4000 选项 必须 和 -mips2 联用. (译注: 疑为 -mips3)
- -mlong64
- -mlonglong128
-
这些 选项 目前 不起作用.
-
产生 用于 MIPS 汇编器 的 代码, 同时 使用 mips-tfile 添加 普通的 调试信息. 对于 大多数 平台 这是 默认选项, 除了 OSF/1 参考平台, 它 使用 OSF/rose 目标 格式. 如果 打开了 任一个 -ggdb, -gstabs, 或 -gstabs+ 选项开关, mips-tfile 程序 就把 stab 封装在 MIPS ECOFF 里面.
-
产生 用于 GNU 汇编器 的 代码. 在 OSF/1 参考平台 上 这是 默认选项, 它 使用 OSF/rose 目标 格式.
- -mno-rnames
- -mrnames 开关选项 告诉 输出代码 使用 MIPS 软件名称 说明 寄存器, 而不是 硬件名称 (就是说, 用 a0 代替 $4). GNU 汇编器 不支持 -mrnames 选项, 而 MIPS 汇编器 则 运行 MIPS C 预处理器 处理 源文件. -mno-rnames 是 默认选项.
- -mno-gpopt
- -mgpopt 开关选项 要求 在 正文段 中 把 所有的 数据声明 写到 指令 前面, 使 各种 MIPS 汇编器 对 短类型 全局 或 静态 数据项 (short global or static data items) 输出 单字内存访问 而不是 双字内存访问. 当 打开 编译优化 时, 这是 默认功能.
- -mno-stats
-
每次 处理完 非嵌入函数 (non-inline function) 后, -mstats 开关选项 使 编译器 向 标准错误文件 输出 一行 关于 程序 的 统计资料 (保存的 寄存器 数目, 堆栈 大小, 等等).
- -mno-memcpy
- -mmemcpy 开关选项 使 所有 的 块移动 操作 调用 适当的 string 函数 ( memcpy 或 bcopy), 而不是 生成 嵌入代码.
- -mno-mips-tfile
-
当 MIPS 汇编器 生成 mips-tfile 文件 (用于 帮助 调试) 后, -mno-mips-tfile 开关选项 阻止 编译器 使用 mips-tfile 后期处理 (postprocess) 目标文件. 不运行 mips-tfile 就 没有 调试器 关注的 局部变量. 另外, stage2 和 stage3 目标文件 将把 临时文件名 传递给 汇编器, 嵌在 目标文件 中, 这 意味着不比较 目标文件 是否 相同.
-
输出 包含 浮点库调用. 警告: 所需库 不是 GNU CC 的 一部分. 一般说来 使用 该机型 本地 C 编译器 的相应部件, 但是 不能 直接 用于 交叉编译, 你 必须 自己 安排, 提供交叉编译 适用的 库函数.
-
输出 包含 浮点指令. 如果 编译器 没有 被改动, 这就是 默认选项.
-
编译器 认为 状态字 的 FR 置位(on), 也就是说 存在 32 64-bit 浮点寄存器, 而不是 32 32-bit 浮点寄存器. 同时 必须 打开 -mcpu=r4000 和 -mips3 开关.
-
认为 存在 32 32-bit 浮点寄存器. 这是 默认选项.
-mabicalls
- -mno-abicalls
-
输出 (或 不输出) .abicalls, .cpload, 和 .cprestore 伪指令, 某些 System V.4 版本 用于 位置无关代码.
- -mno-half-pic
- -mhalf-pic 开关选项 要求 把 外部引用 的 指针 放到 数据段, 并且 载入 内存, 而不放到正文段. 该选项 目前 不起作用.
-
把 小于等于 num 字节 的 全局 或 静态 数据 放到 小的 数据段 或 bss 段, 而不是普通的 数据段 或 bss 段. 这样 汇编器 可以 输出 基于 全局指针 ( gp 或 $28), 的 单字内存访问指令 而非 普通的 双字指令. 默认情况下, 用 MIPS 汇编器 时 num 是 8, 而 GNU 汇编器 则为 0. 另外, -G num 选项 也被 传递 给 汇编器 和 连接器. 所有 的 模块 必须在 相同的 -G num 值下 编译.
-
汇编 用户汇编文件 (带有 ` .s' 后缀) 时, 告诉 MIPS 汇编器 不要 运行 预处理器.
下面的 `-m' 选项 用于 Intel 80386 族 计算机: -m486
- -mno-486
-
控制 是否 生成 对 486 优化 的 代码.
-
输出 包含 浮点库调用. 警告: 所需库 不是 GNU CC 的 一部分. 一般说来 使用 该机型 本地 C 编译器 的相应部件, 但是 不能 直接 用于 交叉编译, 你 必须 自己 安排, 提供 交叉编译 适用的 库函数.
在 函数 把 浮点返回值 放在 80387 寄存器栈 的 机器 上, 即使 设置了 `-msoft-float' 选项, 也可能会 发出 一些 浮点操作码.
-mno-fp-ret-in-387
-
不用 FPU 寄存器 返回 函数值.
通常 函数调用约定 把 float 和 double 的 返回值 放在 FPU 寄存器 中, 即使 不存在 FPU. 这种作法 的 理念是 操作系统 应该 仿真出 FPU.
而 `-mno-fp-ret-in-387' 选项 使 浮点值 通过 普通的 CPU 寄存器 返回.
下面的 `-m' 选项 用于 HPPA 族 计算机:
- -mpa-risc-1-0
- 生成 PA 1.0 处理器 的 目标码. -mpa-risc-1-1
-
生成 PA 1.1 处理器 的 目标码.
-
生成 适用于 内核 的 目标码. 特别要 避免 add 指令, 它 有 一个 参数 是 DP 寄存器; 用 addil 代替 add指令. 这样 可以 避免 HP-UX 连接器 的 某个 严重 bug.
-
生成 能够 连接 HP-UX 共享库 的 目标码. 该选项 还没有 实现 全部功能, 对 PA 目标 默认为 关闭. 使用 这个选项 会 导致 编译器 生成 错误的 目标码.
-
不生成 连接 HP-UX 共享库 的 目标码. 这是 PA 目标 的 默认选项.
-
生成的 目标码 允许 同一个 源文件 中的 函数调用, 调用点 和 被调函数的 距离 可以 超过 256K 之远. 不需要 打开 这个 开关选项, 除非 连接器给出 ``branch out of range errors`` 这样的 错误.
-
防止 任何情况下 使用 浮点寄存器. 编译 内核 需要 这个选项, 内核 切换浮点寄存器 的 执行环境 速度 非常缓慢. 如果 打开了 这个 开关选项 同时试图 浮点操作, 编译 将 失败.
-
防止 编译器 使用 索引地址模式 (indexing address mode). 这样 在 MACH 上 编译 MIG 生成的 代码 时, 可以 避免 一些 非常 晦涩的 问题.
-
在 标记定义 (label definition) 的 末尾 添加 一个 冒号 (用于 ELF 汇编器).
下面的 `-m' 选项 用于 Intel 80960 族 计算机:
- -m cpu-type
-
默认 机器 类型 为 cpu-type , 使 编译器 产生 对应的 指令, 地址模式 和 内存对齐. 默认的 cpu-type 是 kb; 其他 选择 有 ka, mc, ca, cf, sa, 和 sb.
- -msoft-float
- -mnumerics 开关选项 指出 处理器 不支持 浮点指令. -msoft-float 开关选项 指出 不应该 认为 机器 支持 浮点操作.
- -mno-leaf-procedures
-
企图 (或防止) 改变 叶过程 (leaf procedure), 使其 可被 bal 指令 以及 call 指令 调用. 对于 直接函数调用, 如果 bal 指令 能够 被 汇编器 或 连接器 替换, 这 可以 产生 更有效 的 代码, 但是 其他 情况下 产生 较低效 的 代码, 例如 通过 函数指针 调用 函数, 或 使用了 不支持 这种 优化 的 连接器.
- -mno-tail-call
-
执行 (或不执行) 更多的 尝试 (除过 编译器 那些 机器无关 部分), 优化进入 分支 的 尾递归 (tail-recursive) 调用. 你 可能 不需要 这个, 因为 检测 什么 地方 无效 没有 全部 完成. 默认 开关 是 -mno-tail-call.
- -mno-complex-addr
-
认为 (或 不认为) 在 当前的 i960 设备 上, 值得 使用 复合地址模式 (complex addressing mode). 复合地址模式 可能 不值得 用到 K 系列, 但是一定 值得 用在 C 系列. 目前 除了 CB 和 CC 处理器, 其他 处理器 上 -mcomplex-addr 是 默认选项.
- -mno-code-align
-
把 目标码 对齐到 8 字节 边界 上 (或者 不必), 这样 读取 会 快一些. 目前 只对 C 系列 默认 打开.
- -mic2.0-compat
- -mic3.0-compat
-
兼容 iC960 v2.0 或 v3.0.
- -mintel-asm
-
兼容 iC960 汇编器.
- -mno-strict-align
-
不允许 (或允许) 边界不对齐 的 访问.
-
使 结构对齐 (structure-alignment) 兼容 Intel 的 gcc 发行版本 1.3 (基于 gcc 1.37). 目前 这个选项 有点问题, 因为 #pragma align 1 总是 作 同样的 设定, 而且 无法 关掉.
下面的 `-m' 选项 用于 DEC Alpha 设备:
- -mno-soft-float
- -msoft-float
-
使用 (或 不使用) 硬件浮点指令 进行 浮点运算. 打开 -msoft-float 时, 将 使用 ` libgcc1.c' 中的 函数 执行 浮点运算. 除非 它们 被 仿真 浮点操作 的 例程 替换, 或者 类似, 它们 被 编译为 调用 仿真例程, 这些 例程 将发出 浮点操作. 如果 你 为 不带 浮点操作 的 Alpha 编译 程序, 你 必须 确保 建立了 这个 库, 以便 不调用 仿真例程.
注意, 不带 浮点操作 的 Alpha 也要求 拥有 浮点寄存器.
-mfp-reg
- -mno-fp-regs
-
生成 使用 (或 不使用) 浮点寄存器群 的 目标代码. -mno-fp-regs 包含有 -msoft-float 开关选项. 如果 不使用 浮点寄存器, 浮点操作数 就象 整数 一样 通过整数寄存器 传送, 浮点运算结果 放到 $0 而不是 $f0. 这是 非标准 调用, 因此 任何 带有 浮点 参数或返回值 的 函数, 如果 被 -mno-fp-regs 开关 编译过的 目标码 调用, 它 也必须 用这个 选项 编译.
这个选项 的 典型用法 是 建立 内核, 内核 不使用 任何 浮点寄存器, 因此 没必要 保存 和 恢复 这些 寄存器.
下面 附加的 选项 出现在 System V 第四版 中, 用于 兼容 这些 系统 中的其他 编译器:
- -G
-
在 SVr4 系统 中, gcc 出于 兼容 接受了 ` -G' 选项 (然后 传递给 连接器). 可是 我们 建议 使用 ` -symbolic' 或 ` -shared'选项, 而不在 gcc 命令行 上 出现 连接选项.
-
验证 编译器 用的 工具 的 版本, 输出到 .ident 汇编指令.
-
制止 输出端 的 .ident 指令 (默认选项).
-
对于 ` -l' 指定的 库文件, 只搜索 dirs. 你 可以 在 dirs 中 用 冒号 隔开 各个 目录项.
-
在 dir 目录 中 寻找 M4 预处理器. 汇编器 使用 这个 选项.
代码生成选项 (CODE GENERATION OPTION)
下面的 选项 和 平台 无关, 用于 控制 目标码生成 的 接口约定.
大部分 选项 以 `-f' 开始. 这些选项 拥有 确定 和 否定 两种 格式; `-ffoo' 的 否定格式 是 `-fno-foo'. 后面的 描述 将 只列举 其中 的 一个 格式 --- 非默认 的 格式. 你 可以 通过 添加或去掉 `no-' 推测出 另一个 格式.
- -fnonnull-objects
-
假设 通过 引用 (reference) 取得的 对象 不为 null (仅 C++).
一般说来, GNU C++ 对 通过 引用 取得的 对象 作 保守 假设. 例如, 编译器 一定会 检查 下似 代码 中的 a 不为 null:
obj &a = g (); a.f (2);
检查 类似 的 引用 需要 额外的 代码, 然而 对于 很多 程序 是 不必要的. 如果 你的 程序 不要求 这种检查, 你 可以 用 `-fnonnull-objects' 选项 忽略它.
-fpcc-struct-return
-
函数 返回 struct 和 union 值时, 采用 和 本地编译器 相同的 参数约定. 对于 较小的结构, 这种约定的 效率 偏低, 而且 很多 机器 上 不能 重入; 它的 优点 是 允许 GCC 编译的 目标码 和 PCC 编译 的 目标码 互相调用.
-
一有可能 就 通过 寄存器 返回 struct 和 union 函数值. 对于 较小的结构, 它 比 -fpcc-struct-return 更有效率.
如果 既没有 指定 -fpcc-struct-return , 也没有 指定 -freg-struct-return, GNU CC 默认使用 目标机 的 标准约定. 如果 没有 标准约定, GNU CC 默认采用 -fpcc-struct-return.
-fshort-enums
-
给 enum 类型 只分配 它 声明的 值域范围 的 字节数. 就是说, enum 类型 等于 大小足够 的 最小整数类型.
-
使 double 类型 的 大小 和 float 一样.
-
要求 编译结果 的 数据 和 非 const 变量 是 共享数据, 而不是 私有数据. 这种差别 仅在 某些 操作系统 上面 有意义, 那里的 共享数据 在 同一个程序 的 若干 进程 间 共享, 而 私有数据 在 每个 进程 内 都有 副件.
-
即使 未初始化 的 全局变量 也 分配在 目标文件 的 bss 段, 而不是 把 它们当做 普通块 (common block) 建立. 这样的 结果 是, 如果 在 两个 不同 的 编译结果 中 声明了 同一个 变量 (没使用 extern ), 连接 它们 时 会 产生 错误. 这个选项 可能 有用 的 唯一情况 是, 你 希望 确认 程序 能 在 其他系统 上 运行, 而 其他系统 总是 这么 做.
-
忽略 ` #ident' 指令.
-
不要 把 全局初始化部件 (如 C++ 的 构造子 和 解构子) 输出为 GNU 连接器使用 的 格式 (在 GNU 连接器 是 标准方法 的 系统 上). 当你 打算 使用 非 GNU 连接器 的 时候 可以用 这个选项, 非GNU连接器 也需要 collect2 程序 确保 系统连接器 放入 构造子 (constructor) 和 解构子 (destructor). (GNU CC 的 发布包 中 包含有 collect2 程序.) 对于 必须 使用 collect2 的 系统, 编译器驱动程序 gcc 自动 配置为 这么做.
-
不要 输出 .size 汇编指令, 或其他 类似指令, 当 某个函数 一分为二, 两部分 在 内存 中距离 很远 时 会 引起 问题. 当 编译 ` crtstuff.c' 时 需要 这个选项; 其他情况下 都不应该 使用.
-
输出 汇编代码 时 放些 额外的 注释信息. 这个选项 仅用于 确实 需要阅读 汇编输出 的 时候 (可能 调试 编译器 自己 的 时候).
-
使 编译器 认为 所有 通过 指针 访问 的 内存 是 易变内存 (volatile).
-
使 编译器 认为 所有的 外部和全局变量 是 易变内存.
-
如果 支持 这种 目标机, 编译器 就生成 位置无关目标码. 适用于 共享库 (shared library).
-
如果 支持 这种 目标机, 编译器 就输出 位置无关目标码. 适用于 动态连接 (dynamic linking), 即使 分支 需要 大范围 转移.
-
把 名为 reg 的 寄存器 按 固定寄存器 看待 (fixed register); 生成的 目标码不应该 引用 它 (除了 或许 用作 栈指针, 帧指针, 或其他 固定的角色).
reg 必须是 寄存器 的 名字. 寄存器 名字 取决于 机器, 用 机器描述宏文件 的 REGISTER_NAMES 宏 定义.
这个选项 没有 否定格式, 因为 它 列出 三路选择.
-fcall-used- reg
-
把 名为 reg 的 寄存器 按 可分配寄存器 看待, 不能 在 函数调用 间 使用. 可以 临时使用 或 当做 变量 使用, 生存期 不超过 一个 函数. 这样编译的 函数 无需 保存 和 恢复 reg 寄存器.
如果 在 可执行模块 中, 把 这个选项 说明的 寄存器 用作 固定角色 将会产生 灾难性结果, 如 栈指针 或 帧指针.
这个选项 没有 否定格式, 因为 它 列出 三路选择.
-fcall-saved- reg
-
把 名为 reg 的 寄存器 按 函数 保护 的 可分配寄存器 看待. 可以 临时使用 或 当做 变量使用, 它 甚至能 在 函数 间 生存. 这样编译的 函数 会 保存 和 恢复 使用中 的 reg 寄存器.
如果 在 可执行模块 中, 把 这个选项 说明的 寄存器 用作 固定角色 将会产生 灾难性结果, 如 栈指针 或 帧指针.
另一种 灾难 是 用 这个选项 说明的 寄存器 返回 函数值.
这个选项 没有 否定格式, 因为 它 列出 三路选择.
PRAGMAS
GNU C++ 支持 两条 `#pragma' 指令 使 同一个 头文件 有 两个用途: 对象类 的 接口定义, 对象类 完整的内容定义.
- #pragma interface
-
(仅对 C++) 在 定义 对象类 的 头文件 中, 使用 这个指令 可以 节省 大部分采用 该类 的 目标文件 的 大小. 一般说来, 某些信息 (内嵌成员函数 的 备份副件, 调试信息, 实现 虚函数 的 内部表格等) 的 本地副件 必须 保存在 包含 类定义 的 各个 目标文件 中. 使用 这个 pragma 指令 能够 避免 这样的 复制. 当 编译 中 引用 包含 ` #pragma interface' 指令 的 头文件 时, 就 不会 产生 这些 辅助信息 (除非 输入的 主文件 使用了 ` #pragma implementation'指令). 作为替代, 目标文件 将包含 可被 连接时 解析的 引用 (reference).
- #pragma implementation " objects .h"
-
(仅对 C++) 如果 要求 从 头文件 产生 完整的 输出 (并且 全局可见), 你 应该 在 主输入文件 中 使用 这条 pragma. 头文件 中 应该 依次 使用 ` #pragma interface' 指令. 在 implementation 文件 中 将 产生 全部 内嵌成员函数 的 备份, 调试信息, 实现 虚函数 的 内部表格等.
如果 `#pragma implementation' 不带 参数, 它 指的是 和 源文件 有 相同基本名 的 包含文件; 例如, `allclass.cc' 中, `#pragma implementation' 等于 `#pragma implementation allclass.h'. 如果 某个 implementation 文件 需要 从 多个 头文件 引入 代码, 就应该 使用 这个 字符串参数.
不可能 把 一个头文件 里面 的 内容 分割到 多个 implementation 文件 中.
文件 (FILE)
file.c C 源文件 file.h C 头文件 (预处理文件) file.i 预处理后 的 C 源文件 file.C C++ 源文件 file.cc C++ 源文件 file.cxx C++ 源文件 file.m Objective-C 源文件 file.s 汇编语言文件 file.o 目标文件 a.out 连接的输出文件 TMPDIR/cc* 临时文件 LIBDIR/cpp 预处理器 LIBDIR/cc1 C 编译器 LIBDIR/cc1plus C++ 编译器 LIBDIR/collect 某些机器需要的连接器前端(front end)程序 LIBDIR/libgcc.a GCC 子例程 (subroutine) 库 /lib/crt[01n].o 启动例程 (start-up) LIBDIR/ccrt0 C++ 的附加启动例程 /lib/libc.a 标准 C 库, 另见 intro (3) /usr/include #include 文件的标准目录 LIBDIR/include #include 文件的标准 gcc 目录 LIBDIR/g++-include #include 文件的附加 g++ 目录
LIBDIR 通常为 /usr/local/lib/machine/version.
TMPDIR 来自 环境变量 TMPDIR (如果 存在, 缺省为 /usr/tmp , 否则为 /tmp).