1 .\" Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 1999 Free Software Foundation
2 .\" See section COPYING for conditions for redistribution
3 .TH ld 1 "17 August 1992" "cygnus support" "GNU Development Tools"
11 ld \- GNU linker (连接器)
30 .RB "[\|" \-Bstatic "\|]"
31 .RB "[\|" \-Bdynamic "\|]"
32 .RB "[\|" \-Bsymbolic "\|]"
36 .RB "[\|" \-\-cref "\|]"
37 .RB "[\|" \-d | \-dc | \-dp\c
40 .RB "[\|" "\-defsym\ "\c
45 .RB "[\|" \-\-demangle "\|]"
46 .RB "[\|" \-\-no\-demangle "\|]"
50 .RB "[\|" \-embedded\-relocs "\|]"
52 .RB "[\|" \-export\-dynamic "\|]"
56 .RB "[\|" "\-\-auxiliary\ "\c
62 .RB "[\|" "\-\-filter\ "\c
65 .RB "[\|" "\-format\ "\c
75 .RB "[\|" "\-soname\ "\c
78 .RB "[\|" \-\-help "\|]"
93 .RB "[\|" \-n | \-N "\|]"
94 .RB "[\|" \-noinhibit-exec "\|]"
95 .RB "[\|" \-no\-keep\-memory "\|]"
96 .RB "[\|" \-no\-warn\-mismatch "\|]"
100 .RB "[\|" "\-oformat\ "\c
106 .RB "[\|" \-relax "\|]"
107 .RB "[\|" \-r | \-Ur "\|]"
108 .RB "[\|" "\-rpath\ "\c
111 .RB "[\|" "\-rpath\-link\ "\c
116 .RB "[\|" \-shared "\|]"
117 .RB "[\|" \-sort\-common "\|]"
118 .RB "[\|" "\-split\-by\-reloc\ "\c
121 .RB "[\|" \-split\-by\-file "\|]"
125 .RB "[\|" "\-Ttext\ "\c
128 .RB "[\|" "\-Tdata\ "\c
131 .RB "[\|" "\-Tbss\ "\c
140 .RB "[\|" \-\-verbose "\|]"
141 .RB "[\|" \-\-version "\|]"
142 .RB "[\|" \-warn\-common "\|]"
143 .RB "[\|" \-warn\-constructors "\|]"
144 .RB "[\|" \-warn\-multiple\-gp "\|]"
145 .RB "[\|" \-warn\-once "\|]"
146 .RB "[\|" \-warn\-section\-align "\|]"
147 .RB "[\|" \-\-whole\-archive "\|]"
148 .RB "[\|" \-\-no\-whole\-archive "\|]"
149 .RB "[\|" "\-\-wrap\ "\c
156 .SH "描述 (DESCRIPTION)"
159 \& 合并 一组 目标文件(object) 和 库文件(archive), 重定位 数据部分,
160 构建 符号引用(symbol reference). 一般说来, 编译 生成 可执行文件 的
167 \& 可以读取 用 连接器命令语言(Linker Command Language) 编写的 脚本文件,
168 它 能够 对 连接过程 提供 精确 和 全面 的 控制.
169 本 手册页 不讨论 命令语言; 可参看 `\|\c
176 \&, 里面有 命令语言 的 细节 和 其他 GNU linker 的 内容.
180 \& 使用 通用BFD库 操作 目标文件, \c
182 \& 能够 以 多种格式 读入, 连接 和 输出 目标文件 \(em\&例如 COFF 或 \c
184 \&, 能够 把 不同的格式 连接 在一起, 产生 各种 有效 的 目标文件.
187 \|' 可以 列出 各种 体系结构 支持 的 格式 列表; 另见
190 GNU linker 不仅 灵活 强大, 还能够 比 其他 linker 提供 更多 的 诊断信息.
191 很多 linker 只要 碰上 一个错误 就 立刻停止 执行; 而
194 \& 一有可能 仍然 继续执行, 这样 容易 定位出 其他错误
195 (某些情况下, 尽管出了错, 仍然 生成 输出文件).
199 \& 期望 实现 更广泛 的 适用范围, 尽可能 兼容 其他 linker.
200 通过 命令行 和 环境变量, 用户 可以 用 ld 执行 多种 操作.
203 过于丰富的 命令行选项 使人 感到 压抑, 好在 实际使用 中, 多数情况下
204 只需要 掌握 其中 一小部分. 例如, 在 一个 标准的, 提供 相应支持 的 Unix
207 \& 连接 标准的 Unix 目标文件. 如果要 连接 \c
212 $\ ld\ \-o\ output\ /lib/crt0.o\ hello.o\ \-lc
219 \& 的 文件 , 其中 连接了 文件 \c
230 \& 的 命令行选项 可以 任意顺序 出现, 甚至 重复出现. 多数 情况 下,
231 如果 用 不同的 参数 重复 同一种 选项, ld 不会 出现 更多的变化, 也不会
232 覆盖 以前的 参数. (指 命令行 中 左边的参数)
234 例外情况 \(em\& 某些选项 有 反复使用 的 需要 \(em\& 如
254 待连接的 目标文件 列表, 即 总览中的 \c
257 可以 放在 命令行选项 的 前面, 后面, 或者 混杂其中; 但是 不能 把 \c
259 \& 放置于 某个 选项开关 和 它的参数 中间.
261 一般说来 linker 要求 至少 输入 一个 目标文件, 但是 可以 用 \c
266 \& 输入 其他格式 的 二进制文件, 或者 用 命令语言 编写的 脚本文件. 如果 \c
268 \& 指定 二进制格式 的 输入文件, linker 就不能 产生 输出文件, 而是 显示
273 选项的参数 必须 出现在 代表 选项 的 字母 后面, 可以有 空白符, 也可以 没有.
276 .BI "-A" "architecture"
279 \& 中, 这个 选项 仅适用于 Intel 960 体系系列. 在 \c
283 \& 参数 是 960 系列 的 成员 识别名称 之一, 由 两个字母 组成;
284 这个选项 指出 期望的 输出目标, 对 输入文件 的 不兼容指令 作出 警告.
285 它 能够 改变 linker 对 库文件 的 搜索策略, 以便于 支持 体系相关库, 方法是
286 把 体系识别名称 添加在 待搜索 的 文件名 尾部.
294 \|', linker 将 搜索 (根据 内置的路径 和 \c
296 \& 指定的路径) 以下 名称 的 库文件
309 前两项 是 常规做法; 后两项 源于 `\|\c
315 \& 可能 对 其他 体系结构 提供 类似功能.
319 \& 选项, 只要 该 体系 允许 和 目标体系 相连, 其选项 使 ld 在 搜索 \c
321 指定的库 中, 增加 和 体系结构名称 对应的库.
324 .BI "\-b " "input-format"
325 指定 输入目标文件 的 二进制格式, 目标文件 在 命令行 上 给出, 放在
326 这个选项 的 后面. 一般 不需要 指定 这个选项, \c
328 \& 的 缺省输入格式 配置为 各个机器 上 最常用 的 格式. \c
330 \& 是 字符串, BFD 库 支持的 格式 名称. 选项 \c
338 连接 某些 不寻常的 二进制文件 时 需要 这个选项. 或者 使用 \c
340 \& 选项 强调 格式切换 (连接 不同格式 的 目标文件),
341 比如说, 在 每组 特定格式 的 目标文件 前面 使用 \c
349 \& 用于 指定 缺省格式. 也可以 在 脚本文件 中 用 \c
355 禁止 连接 共享库. 这个选项 只在 支持 共享库 的 平台 上 有意义.
359 连接 动态库. 这个选项 只在 支持 共享库 的 平台 上 有意义, 一般说来 它
364 当 创建 共享库 的 时候, 只要 有可能, 在 共享库 内 编联(bind reference)
365 全局符号 和 定义(definition). 一般说来, 允许 连接了 某个 共享库 的 程序
366 覆盖 共享库内 的 定义. 这个选项 只在 支持 共享库 的 ELF 平台 上 有意义.
369 .BI "\-c " "commandfile"
375 \& 中 读取 连接 命令. 这些 命令 彻底的 覆盖 \c
377 \& 的 缺省 连接 格式 (而不是 添加); \c
379 \& 必须 详尽的 描述 目标格式 的 所有细节.
381 你 也可以 在 命令行 上 直接嵌入 连接命令, 把 脚本 嵌在 大括弧 `\|\c
389 输出 交叉引用表(cross reference). 如果 创建了 连接映像(linker map) 文件,
390 交叉引用表 就 输出到 映像文件 中, 否则 送往 标准输出.
398 这 三个选项 是 一回事, 为了 兼容 其他 linker 而 同时提供.
403 \&), 它们 能为 公共符号(common symbol) 分配 空间. 脚本命令
405 .B FORCE_COMMON_ALLOCATION\c
409 .BI "-defsym " "symbol" "\fR = \fP" expression
410 在 输出文件 中 创建 一个 全局符号, 它 含有 \c
412 \& 给出的 绝对地址. 可以 在 命令行 使用 多个 这样的 选项. 这个 \c
414 \& 只能 使用 有限的 数学形式: 十六进制常数, 已经存在 的 符号名字.
419 \& 加减 十六进制常数 或 符号. 如果 需要 更复杂的 表达式, 考虑 使用
426 这些选项 控制 是否在 出错信息 和 其他信息 中, 输出 可读的(demangle)
427 符号名称. 如果 使用了 demangle 选项, linker 尽量使 符号名称 容易理解:
428 去掉 领头的 下划线 (如果 被 目标文件格式 采用); 把 C++ 难懂的 符号名称
429 (symbol name) 转换成 可读的 名称. 缺省情况下 linker 输出 可读的 符号名称,
431 .B COLLECT_NO_DEMANGLE .
438 \& 标识符 作为 程序 执行 的 开始端, 而不是 缺省入口. 关于 缺省入口 和 其他
446 .B \-embedded\-relocs
447 这个选项 仅用于 连接 MIPS上 嵌入的 PIC 代码, GNU 的 编译器 和 汇编器 用
449 选项 能够 生成 这种代码. 它使 linker 创建 一张 表格, 用于 在 运行的时候,
450 重定位 任何 被 静态初始化 为 指针值 的 数据. 详见 testsuite/ld-empic 的 代码.
456 当 创建 ELF 文件 时, 把 所有 符号 加入 动态符号表.
457 一般说来, 动态符号表 只包含 动态目标库(dynamic object) 需要的 符号. 用
464 .BI "--auxiliary " "name"
465 创建 ELF 共享目标库 时, 把 内部的 DT_AUXILIARY 字段 设置为
467 它 告诉 动态linker, 把 该 共享目标库 的 符号表 用做 共享目标
474 .BI "--filter " "name"
475 创建 ELF 共享目标库 时, 把 内部的 DT_FILTER 字段 设置为
477 它 告诉 动态linker, 把 该 共享目标库 的 符号表 用做 共享目标
482 .BI "\-format " "input\-format"
495 把 使用 GP 寄存器 优化的 目标(文件) 大小 限制为
497 用于 MIPS ECOFF, 对 其他 目标文件格式 无效.
502 .BI "-soname " "name"
503 创建 ELF 共享目标库 时, 把 内部的 DT_SONAME 字段 设置为 name.
504 如果 某个 可执行文件 连接了 含有 DT_SONAME 字段 的 共享目标库,
505 当 该程序 运行 时, 动态 linker 试图 根据 DT_SONAME 字段 调入 共享的
506 目标库, 而 不使用 提供给 linker 的 文件名.
510 在 标准输出 显示 命令行选项 的 摘要, 然后 结束. 这个选项 和
512 选项 使用了 两个 短横线, 不是 一个, 目的是 兼容 其他 GNU 程序.
513 只用 一个 短横线 的 选项 是为了 兼容 其他 linker.
517 执行 增量连接(incremental link), 等同于 \c
523 在 连接文件 列表 中 增加 归档库文件 \c
525 \&. 可以 多次 使用 这个选项. 凡指定 一项 \c
529 \& 就会 在 路径列表 中 增加 一项 对 \c
536 .BI "\-L" "searchdir"
541 \& 在 这个 列表 中 搜索 归档库. 可以 多次 使用 这个选项.
547 \& 使用的 模拟模式(emulation) 及其 配置.
554 在 标准输出 显示 连接映像 \(em\& 有关 \c
556 \& 把 符号 映射到 何处 的 诊断信息, 以及 全局公共存储器 的 分配 信息.
559 .BI "\-Map " "mapfile"\c
564 \& 把 符号 映射到 何处 的 诊断信息, 以及 全局公共存储器 的 分配 信息.
567 .BI "\-m " "emulation"\c
574 选项 列出 有效的 模拟项. 这个选项 覆盖 编译 进去 的 缺省项.
582 \& 节(section). 如果 输出格式 支持 Unix 风格的 幻数(magic number),
589 \&\|' 选项 时, linker 不做 数据段 的 页对齐(page-align).
593 设置 正文段 为 只读, 如果 有可能, \c
599 一般说来, 如果 连接的 时候 发生 错误, linker 不会 产生 输出文件.
600 使用了 这个 标志选项, 只要 不出 致命差错, 仍能够 产生 输出文件.
603 .B \-no\-keep\-memory
604 linker 通常 牺牲 内存, 优化 速度, 它 把 输入文件 的 符号表 缓冲在 内存中.
605 这个选项 使 linker 必要时 重复读取 符号表, 以便 优化 内存使用. 连接 大型
606 可执行文件 的 时候, linker 有可能 内存 不够, 此时 可以 试试 这个选项.
609 .B \-no\-warn\-mismatch
610 一般情况下, 如果 试图 连接 某些 不匹配 的 输入文件, 比如说, 按 不同
611 处理器 编译 的, 或者 具有 不同的 字节顺序(endianness), linker 就会 报错.
612 这个选项 告诉 linker 默许 这种 错误. 要 小心使用 这个选项, 除非 你
613 正在做 某些 特殊 操作, 而且 能够 确定 不需要 linker 报错.
620 \& 生成的 程序名; 如果 没有 使用 这个选项, 缺省名字 是 `\|\c
628 生成 优化的 输出文件. 这个选项 占用 比较多 的 时间, 因此 仅 常用于
632 \& 是 数值参数. 任何 大于零 的 参数 意味着 要求 优化.
635 .BI "\-oformat " "output\-format"
636 指定 输出目标文件 的 二进制格式. 一般 不需要 指定 这个选项, \c
638 \& 的 缺省 输出格式 配置为 各个机器 上 最常用 的 格式. \c
640 \& 是 一个 字符串, BFD 库 支持的 格式 名称. 脚本命令
642 也可以 指定 输出格式, 但是 这个选项 能够 覆盖 掉 它.
645 .BI "\-R " "filename"
648 \& 中 读取 符号名称 及其 地址, 但是 不做 重定位, 不传送到 输出端.
649 它 可以 使 输出文件 符号引用 其他程序中 定义的 绝对地址.
653 这个选项 的 效果 取决于 机器, 目前 只支持 H8/300.
655 在 某些 平台 上 可以 使用 这个选项 做 全局优化, 它 让 linker 解决 程序中
656 的 地址处理, 例如 在 输出目标文件 中 缓和(relax) 地址模式 以及 合成
665 生成 可重定位 输出 \(em\& 就是说, 生成的 输出文件 能够 依次 成为 \c
670 \&. 它 有 一个 副效应, 在 支持 标准 Unix 幻数(magic number) 的 环境 中,
671 这个选项 把 输出文件 的 幻数 设置成 \c
673 \&. 如果 没有 指定 这个选项, linker 生成 绝对定位 的 文件.
676 \& 解析 出 对 构造子(constructor) 的 引用(reference); 不妨 改用 \c
685 .B \-rpath\ \fIdirectory
686 增加 一条 对 运行时(runtime)库 的 搜索路径. 这个选项 用于 连接 ELF 可执行
689 选项 的 参数 被 合并, 然后 一起 传递 给 运行时 linker, 运行时 linker 在
690 运行 的 时候 使用 这些 路径 寻找 共享目标库.
692 也可以 用来 定位 共享目标库 引用的 共享目标库; 参见 对
694 选项 的 叙述. 如果 连接 ELF 可执行文件 时 没有 指定
698 的 内容 \(em\& 只要 这个 环境变量 存在.
701 选项 能够 用在 SunOS 上, 缺省状况下, linker 可以 根据 给出的
703 选项 形成 运行时 搜索路径. 如果 使用了
709 选项. 这一点 有利于 使用 gcc, 在 NFS 文件系统 上, gcc 可能 产生 许多
714 .B \-rpath\-link\ \fIdirectory
715 使用 ELF 或 SunOS 的 时候, 某些 共享库 可能 需要 其他 共享库.
720 如果 linker 遇到 这样的 依赖情况, 当 它 执行 非共享, 不可重定位 的 连接
721 时, linker 将 自动 寻找 所需的 共享库, 如果 它们 没有 被 显明 包含, 就
722 把 它们 包含到 连接 中. 在 这种情况下,
726 能够 指定 一批 目录, 目录 用 冒号 隔开. 也可以 用 这些 目录名 作为 参数,
729 如果 没有 找到 需要的 共享库, linker 产生 一个 警告, 但是 继续 连接.
733 去掉 输出文件 中的 调试符号信息 (但不是 所有符号).
741 创建 一个 共享库. 目前 只支持 ELF 和 SunOS 平台 (在 SunOS 上, 这个选项 不是
744 选项, 而且 存在 不确定 的 符号, linker 将 自动 创建 共享库).
749 通常 把 全局公共符号 放到 适当的 输出节, 按照 大小 排序.
750 首先是 单字节符号, 然后是 双字节, 接下来是 四字节, 随后是 其他的.
751 它的 目的是 防止 符号间 因为 排布限制 出现 间隙.
755 .B \-split\-by\-reloc\ \fIcount
756 在 输出文件 中 创建 附加节(extra section), 使得 输出文件 中,
759 个 重定位项. 它 用于 产生 大型 可重定位 COFF 目标文件, 可以 插入到
760 某些 实时内核 中; 因为 COFF 不能 在 单一节内 存放 65535 以上的 重定位项.
761 注意, 有些 目标文件格式 不支持 任意 分节, 此时 这个选项 将会 操作 失败.
762 此外, linker 不能够 分割 输入节, 然后 重新分配, 因此 如果 某个 输入节 包含
764 以上的 重定位项, 相应的 输出节 将 包含 同样多的 重定位项.
769 .B \-split\-by\-reloc ,
770 但是 它为 每个 输入文件 建立一个 新的 输出节.
773 .BI "\-Tbss " "org"\c
775 .BI "\-Tdata " "org"\c
777 .BI "\-Ttext " "org"\c
780 \& 作为 输出文件 的 段 起始地址 \(em\& 特别是 \(em\& \c
792 .BI "\-T " "commandfile"
803 \& 处理 输入文件 的 时候 显示 文件名.
809 \& 作为 未定义(undefined) 的 符号 送入 输出文件.
810 这样做 可以, 例如, 促使 linker 从 标准库 连接 某个 附加的模块.
817 对于 除 C++ 以外的 任何 程序, 这个选项 等同于
820 \&: 生成 可重定位 的 输出 \(em\& 就是说, 能够 依次 输入 \c
822 \& 的 输出文件. 连接 C++ 程序 的 时候, \c
825 \& 解析 对 构造子(constructor) 的 引用(reference), 这一点 和 \c
833 的 版本号, 列出 支持的 模拟项(emulation). 显示 哪些 输入文件 能够 打开,
853 当 公共符号 和 其他 公共符号 合并 时, 或者 和 某个 符号定义 合并 时,
854 linker 就发出 警告. Unix 系统的 linker 允许 这种 有些 草率 的 做法, 其他
855 操作系统 则 不行. 这个选项 帮助你 在 合并 全局符号 的 时候 发现 潜在问题.
858 .B \-warn\-constructors
859 如果 使用了 全局构造子(global constructor), linker 就发出 警告.
860 它 只对 某些 目标文件结构 有用, 对于 如 COFF 或 ELF, 此 linker 不能够
864 .B \-warn\-multiple\-gp
865 如果 输出文件 需要 多个 全局指针值, linker 就发出 警告. 这个选项 只能
870 对 每个 未定义符号 只 警告 一次, 而不是 每次 引用 这个符号 都 警告.
873 .B \-warn\-section\-align
874 如果 某个 输出节(section) 的 地址 因为 边界对齐 而 发生 改变,
875 linker 就发出 警告. 典型情况下 由 输入节 设置 边界, 只有 不做 明确指定
876 的 时候 地址 才会 改变; 就是说, SECTIONS 命令 没有 指出 该节 的 开始地址.
879 .B \-\-whole\-archive
881 .B \-\-whole\-archive
882 选项 提到的 每个 归档库, 连接时 连入 归档库 的 全部 目标文件, 而不是
883 在 归档库 中 搜索 所需的 目标文件. 一般用于 把 归档库文件 转变成 共享库文件,
887 .B \-\-no\-whole\-archive
889 .B \-\-whole\-archive
893 .BI "--wrap " "symbol"
896 使用 包装函数(wrapper function). 任何 对
898 未定义 的 引用 (undefined reference) 将 解析为
899 .BI "__wrap_" "symbol".
901 .BI "__real_" "symbol"
907 删除 全部 临时的 局部符号. 大多数 目的文件 中, 这些 局部符号 的 名字 用 `\|\c
917 .SH "环境 (ENVIRONMENT)"
932 \& 决定了 输入文件 的 目标格式, 其值 应为 BFD的 名称之一. 如果 没有 \c
936 \& 就使用 主机的 本地格式. 如果 \c
940 \&, BFD 通过 检查 输入文件 的 二进制格式 判断 输入格式;
941 这个方法 通常 有效, 但 隐含 歧义, 这是因为 没有 办法 保证 标志 目标文件格式
943 不过, 各个系统 配置 BFD 的 时候, 会把 系统 约定的格式 放在 搜索列表 的
944 前面, 因此 能够 按照 约定 消除 歧义.
952 .RB "`\|" ld "\|' 和 `\|" binutils "\|'"
959 , Steve Chamberlain and Roland Pesch;
961 The GNU Binary Utilities\c
965 Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 1998 Free Software Foundation, Inc.
967 Permission is granted to make and distribute verbatim copies of
968 this manual provided the copyright notice and this permission notice
969 are preserved on all copies.
971 Permission is granted to copy and distribute modified versions of this
972 manual under the conditions for verbatim copying, provided that the
973 entire resulting derived work is distributed under the terms of a
974 permission notice identical to this one.
976 Permission is granted to copy and distribute translations of this
977 manual into another language, under the above conditions for modified
978 versions, except that this permission notice may be included in
979 translations approved by the Free Software Foundation instead of in
980 the original English.
984 .B 徐明 <xuming@users.sourceforge.net>
988 .SH "《中国Linux论坛man手册页翻译计划》"
989 .BI http://cmpp.linuxforum.net