AIX命令参考大全，卷 3，i - m

ld 命令

用途

链接对象代码。

语法

ld [ -DNumber ] [ -eLabel ] [ -G ] [ -HNumber ] [ -K ] [ -m] [ -M ] [ -oName ] [ -r ] [ -s ] [ -SNumber ] [ -TNumber ] [ -u Name ] ... [ -v ] [ -z ] [ -ZString ] ... [ -bOption ] ... [ -LDirectory ] ... { -fFileID ... -lName ... InputFile ... }

描述

ld命令，也称为链接编辑程序或绑定程序，组合对象代码、归档文件并导入文件到一个输出对象代码，同时解析外部引用。生成可运行的可执行对象代码。此外，如果指定的 ld命令没有 -s标记，可以把输出文件作为 InputFile 参数调用另一个 ld命令。缺省情况下， ld命令创建并输出到 a.out 文件里。

ld 命令可以不必再次列出所有输入对象代码就重新链接程序。例如，如果更改了一个大程序的对象代码，可以通过列出新对象代码和旧程序，以及该程序所需的所有共享库来重新链接程序。请参阅 示例。

ld命令以命令行指定的顺序链接输入文件。如果不止一次指定文件，仅处理第一次出现的文件。必须至少指定一个输入文件，带有 -bI（大写字母 i），-bimport，-bkeepfile，-f 或 -l（小写字母 L）标记或作为一个InputFile 参数。（-bI、-bimport或-bkeepfile 标记是与 I、import 或 keepfile 选项一起使用的 -b 标记。）

当生成在操作系统下运行的的程序时，可以使用 cc 命令链接文件。因为 cc 命令用公共选项和必备支持库调用 ld 命令，所以可以不在命令行中指定。（从 /etc/xlC.cfg 或 /etc/vac.cfb 配置文件中读取信息。）

链接方式

ld命令可以和 64 位对象和程序一样链接 32 位对象和程序，但是 32 位和 64 位对象不能链接在一起。要指定链接方式，可以使用 OBJECT_MODE 环境变量，或 -b32 或 -b64选项。

归档文件

归档文件是复合对象，它通常包含共享文件和对象代码，其中包括了共享对象。如果归档文件包含另一个归档文件或不能识别类型的成员，ld命令发出一个警告并忽略不能识别的成员。如果包含于归档文件中的对象代码 XCOFF 头里有 F_LOADONLY 位集，ld 命令忽略成员。这个位通常被用来指明在归档文件中共享对象的老版本允许装入和运行现有的应用程序。新应用程序与共享对象的新版本，既归档的另一个成员，进行链接。

共享对象

共享对象，通常通过 ld命令的其它调用创建，是 XCOFF 头里有 F_SHROBJ 位集的对象代码。共享对象定义了在运行时解析的外部符号。如果指定了-bnso 或 -bnoautoimp 选项，ld 命令作为普通对象代码处理共享对象，如果文件被移除，则链接失败。

通常，如果确实引用了共享对象中的符号，作为输入的共享对象仅列在输出文件的装入程序部分。当使用运行时链接程序，即使在无引用的符号时也可以要求列出共享对象。当使用 -brtl 选项时，所有列在不是归档成员的命令行中的共享对象列在输出文件中。当程序运行时，系统装入程序装入所有这样的共享对象，并且运行时链接程序可以使用所有共享对象导出的符号。除非归档里的导入文件启动了自动装入，否则作为归档成员的共享对象不能自动地装入。启用自动装入，请参阅 导入和导出文件格式（-bI: 和 -bE: 标志）。

导入和导出文件

导入文件是标识运行时要解析的外部符号的 ASCII 文件。导入文件标识定义已导入的符号的共享对象。系统在运行时装入程序查找和解析符号。如果导入文件的首行以 # 开始! （#，感叹号），可以指定命令行中文件作为普通的 InputFile。否则，必须使用 -bI 或 -bimport 选项指定导入文件。

导出文件是识别其它要导入的可执行对象可用的外部符号的 ASCII 文件。导出文件格式与导入文件格式一样。

库

库是名称以.a，也可能是以 .so 结束的文件。要指定库，可以指定一个完整或相对路径，或以 -lName形式使用 -l（小写字母 L）标记。 最后格式指明了在多个目录下搜索libName.a 文件，或以动态方式搜索 libName.so 文件。搜索目录包含以-L标记指定的目录和标准库目录 /usr/lib 和 /lib。

处理

ld命令以相同方式处理所有输入文件，不管是不是归档。它包含所有对象的符号表，并废弃重复现有符号的符号定义。不象 ld 命令的其它版本，不必排列归档文件的顺序，因此引用在定义之前。甚至，不必在命令行中不止一次地列出归档文件。

ld 命令标记的顺序不影响如何处理，除非标记和输入对象代码、库和导入文件一起使用。标记是：-L、-f、-l（小写字母 L）、-bkeepfile 和 -bI（大写字母）。标记以下列顺序处理：

1. -L标记添加目录到搜索目录列表来定位由-l（小写字母 L）标记指定的库。按指定的顺序搜索目录。所有 -L 标记处理在处理任意-l 标记之前进行。
2. ld 命令处理 InputFile参数，以指定顺序由-f标记指定的文件和由 -l（小写字母 L）标记指定的库。
3. 在处理所有其它对象代码和库之后，ld 命令处理由 -bI（大写字母 i）标记指定的导入文件。如果在处理对象代码之前必须处理该文件，可以不用 -bI 参数指定一个导入文件作为输入文件。这种情况下，导入文件的第一行必须以 #!（#，感叹号）符号开始，导入文件和其它输入文件按第 2 步描述的处理。
4. -bkeepfile 选项命名一个 ld命令不在其上执行垃圾收集的输入文件。如果已制定的输入文件作为一个 InputFile 参数指定或列在由 -f 标记指定的文件里，-bkeepfile 选项不影响文件处理的顺序。否则，文件和其它输入文件一起按第 2 步描述的顺序处理。

由 ld 命令生成的输出文件有执行许可集，如果不指定 -r 标记或 -bnox选项或在链接时报告错误。如果出现任何严重错误或输出文件指定为输入文件时出现错误，不会覆盖现有的输出文件。

符号

ld 命令使用下列预定义符号提供特殊地址位置并且可以以 C 语法声明为 extern char name[ ]。符号名是：

使用符号的唯一方式是取用它的地址。如果输入文件重新定义了任何符号，可能产生不可预知的结果。附加的预定义符号，_ptrgl，被编译程序用来实现使用函数指针的调用。

垃圾收集

缺省情况下，当生成输出文件时 ld 命令执行垃圾收集，删除不被引用的控制部分（CSECT）。

CSECT 是不可分的代码或数据单元。如果包含有关于其它 CSECT 中符号的重定位项（RLD），此 CSECT 将引用其它 CSECT。引用的 CSECT 导致它引用的所有 CSECT 也被引用。此外，如果包含已导出的符号、用-u 标记指定的符号或用 -e 标记指明为入口点的符号，则引用 CSECT。

如果输出文件中需要符号但没有引用符号，可以导出符号，用-u 标记指定符号或抑制垃圾收集。要抑制垃圾信息收集，使用 -r 标记或 -bnogc 选项。抑制单独对象代码的垃圾收集，使用 -bkeepfile 选项或 -bgcbypass 选项。甚至当抑制垃圾信息收集时，将删除未引用的内部符号。

忽略和不支持的标记

为了能和其它版本的ld 命令兼容，一些标记能识别但被忽略掉。标记产生声明忽略标记和它的操作数的消息。忽略的标记没有进一步的处理不会导致 ld命令停止。忽略下列标记：

-ANumber         -bnostrcmpct     -n
-bfilelist       -bstrcmpct       -N
-bfl             -BNumber         -Q
-bforceimp       -d               -RNumber
-bi              -i               -VNumber
-binsert         -j[Key:]Number   -x
-bnoforceimp     -kKey:Path       -YNumber

ld 命令中不支持的标记将导致错误消息。在诊断完所有不支持的的标记后，没有进一步处理 ld命令将停止。

标记

除了参数 -- 仅适用于下一个操作数，不适用于命令行的其余操作数之外，ld 命令符合 XPG 实用程序语法准则。例如，在命令行里：

ld -- -s -v

-s 看作文件名，-v 看作标记。-v 看作文件名，指定：

ld -- -s -- -v 

绑定程序

ld 命令验证命令行参数和调用绑定程序（缺省情况下是 /usr/ccs/bin/bind文件），传递绑定程序子命令的生成列表。绑定程序实际上与文件相链接。 尽管绑定程序通常由 ld命令调用，但能直接启动绑定程序。在这种情况下，绑定程序从标准输入中读取命令。

两个选项影响绑定程序的调用。binder 指定调用哪一个绑定程序，nobind 选项防止ld 命令调用绑定程序。其它绑定程序选项影响生成的绑定程序子命令。

如果 ld 命令在选项或命令行参数中没有检测到任何错误，将调用绑定程序。 以命令行的格式调用绑定程序：

bind [quiet_opt] [loadmap_opt]

quiet_opt 的缺省值是 quiet，loadmap_opt 缺省值是空串，所以缺省命令行是：

/usr/ccs/bin/bind quiet

选项（-bOptions）

对于 -b 标记的 Options 变量，下列值是可能的。在 -b 标记后用一个空格将超过一个的选项分开列出。

1. 在绑定程序选项的下列列表里，用单词 or 分开的两个选项名称名称是同义的。
2. FileID表示路径名称。可以使用相对的或完整的路径名。
3. 对于在参数之前的不能重复的选项，可以使用空参数取消选项。也就是说，仅指定选项和冒号。
4. 如果选项冲突，最后一个选项优先。

-2,147,483,640 to -2,147,000,000
-1,999,999,999 to -1,000,000,000
-1,999,999,999 to -1,000,000,000
   -99,999,999 to -50,000,000
             0
    50,000,000 to 99,999,999
 1,000,000,000 to 1,999,999,999
 2,147,000,000 to 2,147,483,640

# autoload 
#! （foo.o） 

-bautoload:<archive_name>(foo.o)

运行时链接

缺省情况下，链接时绑定共享对象里的符号引用。即，输出模块将导入模块与在特定共享对象里的定义关联在一起。在装入时，即使其它共享对象导出相同的符号，也使用在指定的共享对象里的定义。

促使程序使用运行时链接程序，允许运行时重新绑定一些符号。创建使用运行时链接程序的程序，用 -brtl 选项链接程序。共享模块的链接方式影响符号的重新绑定。

通过使用 -G 标志构建支持运行时链接的共享对象。只要没有被移除就可以通过用 rtl_enable 命令重链接共享对象来完全启用现有共享对象的运行时链接。

导入和导出文件格式（-bI: 和 -bE: 标志）

导入或导出文件内的每一行必须在可选的关键字或可选的的地址前列出一个单一的符号。关键字是 svc、svc32、svc3264、svc64、syscall、syscall32、syscall3264、syscall64、symbolic、nosymbolic、nosymbolic-、list、cm、bss和 weak。仅使用 weak 关键字与其它关键字连接。

在导入文件里，可以指定符号后的地址将 CSECT 数据映射到共享内存段并且取消使用汇编程序的必要性。也可以使用 cm、bss 或 weak 中的一个关键字指定导入符号的存储类。当使用 autoexp 选项时，导入符号的存储类影响自动导出的符号。如果在导入文件中指定了任意其它关键字，将忽略此关键字。

在导出的文件中，在名称后可以使用 svc 或 syscall 关键字表示这是一个系统调用。当链接内核扩展时这是必须的。可以使用 symbolic、nosymbolic, 或 nosymbolic- 关键字将属性和导出的符号关联在一起。关于更多信息，请参阅 已导出符号的属性。尽管不会作为导出文件被标记，但可以使用 list 关键字使符号列在输出文件的装入程序部分。这可以用于要在运行时处理一些符号的应用程序。系统装入程序或运行时链接程序不处理列出的符号。在导出文件里忽略符号地址和关键字cm 和 bss。可以使用 weak 关键字指定 weak 符号绑定，也可以和其它属性一起使用。

ld 命令按下列准则处理导入和导出文件。

• 忽略空白行。
• 以 *（星号）开始的行是注释，可以忽略。

• 以 # （#，空白）开始的行提供操作数给 setopt 绑定程序子命令（-bdbg:Option）。例如，当从文件读取包含# verbose 的行时，会导致绑定程序列出每个符号。当处理文件时，选项设置是活动的。可以用 # 32、# 64、# no32 和 # no64 选项指定列出的来指定是否应该为 32 位链接、64 位链接或同时两者使用所列出的符号。

  32 位和 64 位导入文件选项

  32	当在 32-bit 方式下链接时，在导入或导出文件里使用此选项指定应该处理的后继符号，但在 64-bit 方式下链接时，忽略此选项。如果没有指定 32 或 64 选项，在 32- 和 64-bit 方式下都处理所有的符号。
  64	当在 64 位方式下链接时，在导入或导出文件里使用此选项指定应该处理的后继符号，但在 32 位方式下链接时，忽略此选项。如果没有指定 32 或 64 选项，在 32- 和 64-bit 方式下都处理所有的符号。
  no32 或 no64	重设先前的 32 或 64。在 32 位和 64 位方式下处理后继符号。

• 当处理导入文件时，以#!（#，感叹号） 开始的行提供与后继导入符号有关的共享库名称。此行可以不止一次的出现并且适用于后继符号直到读到以 #!开始的下一行。此文件名信息放在 XCOFF 对象代码的装入程序部分。系统装入程序用于在执行期间定位适当的对象代码。如果导入文件名是 ipath／ifile（imember），则基于导入文件名和导入文件 #! 行的内容确定放在装入程序部分的导入文件名。如下：

  #!	（在 #!后空白）使用空路径、空文件、空数字。通过系统装入程序作为延期导入处理。
  #! ()	使用 ipath、ifile和 imember。如果导入文件作为命令行中 InputFile 参数指定，可以使用此行。在这种情况下，文件必须以#!开头。如果被其它 #!行改变，可以使用此行恢复缺省。
  #! path/file (member)	使用指定路径、文件和成员。
  #! path／file	使用指定路径和文件以及空成员。
  #! file	使用空路径、指定的文件和空成员。运行时，搜索目录列表查找共享对象。
  #!（member）	使用 ipath、ifile和指定的成员。运行时，搜索目录列表查找共享对象。
  #! file（member）	使用空路径以及指定的文件和成员。运行时，搜索目录列表查找共享对象。
  #! .	（单个点）此名称参照主可执行文件。当创建从不同名称的多个主程序导入符号的共享对象时使用此文件。主程序必须导出有其它模块导入的符号，否则装入失败。与或不与运行时链接程序一起都可以使用此导入文件名称。
  #! ..	（两个点）通过运行时链接程序使用此名称列出要解析的符号。使用此文件名创建通过程序利用运行时链接程序使用的共享对象。如果使用从 ..中，在程序里不与 rtllib 选项链接，导入符号的模块，符号将是不确定的并且这些符号的引用产生未定义的行为。

当使用-brtl 选项时，自动装入归档成员，如下创建导入文件。如果 shr.so 是归档里的共享对象，创建一个导入文件：

# autoload
#! （shr.so）

如果适当的话，可以在附加行列出附加成员名称。不必列出导入文件里的符号名称，因为从 shr.so 导入的符号将从 shr.so 自己中读取。

关于创建共享库的更多信息，请参阅在 AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs 中的『如何创建共享库』。关于装入和绑定的更多信息，请参阅 load 子例程 AIX 5L Version 5.2 Technical Reference: Base Operating System and Extensions Volume 1。

已导出符号的属性

当使用运行时链接时，如果导出符号带有正确属性，那么仅能重新绑定同一模块的符号引用。不能重新绑定带有 symbolic 属性的符号引用。不能重新绑定带有nosymbolic 属性的符号引用。如果符号是变量，不能重新绑定带有nosymbolic- 属性的符号引用。对于函数符号，可以重新绑定使用函数指针的调用，而不能重新绑定直接的函数。nosymbolic- 属性是缺省值并且为和操作系统的先前版本兼容而提供，但不推荐这种用法。

如果没有使用运行时链接程序，避免 使用nosymbolic 属性，因为将通过使用全局链接代码的函数描述符直接进行模块内函数调用。否则，对于与不使用运行时链接程序的程序一起使用的模块导出的符号属性无效。

可以指定导出文件里列出的符号的显式导出属性。大多数没有显式属性的符号以缺省的导出属性导出，缺省的导出属性由 symbolic、nosymbolic或 nosymbolic- 选项指定。

weak 导出属性将装入程序部分里的关联符号映射类型标记为 L_WEAK。

导入符号仅有 weak 导出属性。如果从其它模块中导入符号，符号的所有引用将被重新绑定。然而，在固定地址导入符号，所有符号绑定到固定地址，并且不能被运行时链接程序重新绑定。系统装入程序必须解析延迟的导入。运行时链接程序从来不解析或重新绑定到延迟导入的引用。

对于导出非导入的符号，使用下列规则。

• 如果符号有 list 属性，将在装入程序部分符号表中列出，但不在符号表条目里设置 L_EXPORT 标志。运行时链接程序忽略这样的符号。
• 如果符号以显式属性导出，使用显式属性。
• 如果符号是 BSS 符号，以nosymbolic 属性导出。
• 否则，符号以全局属性导出，全局属性由 symbolic、nosymbolic 或 nosymbolic- 选项指定。缺省全局属性是 nosymbolic-。

地址映射

ld 命令生成地址映射，列出输出对象代码里的符号布局。如果使用 map（或 R）选项，在地址序列里每个部分的字符前首先列出未解析的符号和导入符号。如果使用 calls（或 C）选项，列出的每个符号在从此符号到其它符号的引用之前。如果使用xref（或 X）选项，列出的每个符号在从其它符号到此符号的引用列表之前。如果使用 smap、scalls 或 sxref 选项，地址映射包含分别与 map、calls 或 xref 选项列出的相互对应的相同信息，但以字母顺序列出符号。

带有存储类 C_HIDEXT 的内部符号与包围符号名的字符 < 和 >（尖括号）一起打印。带有存储类 C_EXT 的外部符号名不与尖括号一起打印，带有存储类 C_WEAKEXT 的外部符号与包围符号名的字符 { 和 } 一起打印。

列出的关于每个符号的信息包括：

• 符号是否是导入的、导出的或入口点的指示。使用 *（星号）标志入口点，使用 I 标记导入的符号，使用 E 标记导出的符号。
• 地址（除导入符号以外）
• 长度和对齐（对于 CSECT 和 BSS 符号）
• 存储映射类
• 符号类型
• 符号数（用作区分同名的符号）
• 符号名称
• 输入文件信息

存储映射类和符号类型定义在 /usr/include/syms.h 文件里。在地址映射里，仅显示最后两个字符，除了存储类 XMC_TC0 如 T0 显示的那样。

输入文件信息取决于输入文件类型。对于对象代码，列出从 C_FILE 符号表条目中获得的源文件名。如果对象来自归档文件，对象代码按以下格式列出：

ArchiveFileName[ObjectName]

共享对象名列在 { } (括弧) 之间。如果共享对象通过导入文件定义，那么导入文件名列在共享对象名之前。

导入符号有 ER 符号类型，但有关联的文件输入信息。未定义的符号与 ER 的符号类型列在一起，但除了符号数的所有其它列都为空。

-T 和 -D 标记（或 pT 或 pD 选项）影响地址映射里打印的地址。对于机器级调试，选择地址是有用的，这样符号就可以与它们在运行时具有的相同地址一同列出。对于不使用专有装入共享对象的 32 位程序，可以通过指定 -bpT:0x10000000 和 -bpD:0x20000000 选项选择正确地址。这些选项缺省情况下定义在/etc/xlC.cfg 或 /etc/vac.cfg 文件里。

环境变量

以下环境变量影响 ld 命令执行：

示例

1. 要链接多个对象文件并生成要在操作系统下运行的 a.out 文件，请输入：

   ld /usr/lib/crt0.o pgm.o subs1.o subs2.o -lc

   -lc（小写字母 L）链接libc.a 库。完成这的简单方式是使用 cc 命令（编译器）按如下所示链接文件：

   cc  pgm.o  subs1.o  subs2.o

2. 要指定输出文件名称，请输入：

   cc  -o pgm  pgm.o  subs1.o  subs2.o

   在文件 pgm 里创建输出。

3. 只要更改了对象文件 subs1.o，要重新链接 pgm，请输入：

   cc -o pgm subs1.o pgm

   起初来自对象代码 pgm.o 和 subs2.o的 CSECT 从文件 pgm中读出。如果程序由多个输入文件构成但仅有少数文件同时更改时此技术可以加速处理。

4. 要用库子例程链接，请输入：

   cc  pgm.o  subs1.o  subs2.o  mylib.a  -ltools

   这会链接对象模块 pgm.o、subs1.o 和 subs2.o，来自 mylib.a 归档的子例程和来自由 -l（小写字母 L）标志指定的库中的子例程。（这指 /usr/lib/libtools.a 文件）。

5. 要生成共享对象，请输入：

   ld -o shrsub.o subs1.o subs2.o -bE:shrsub.exp -bM:SRE -lc

   这链接对象代码 subs1.o、subs2.o和来自库 libc.a 中用 -lc 标志指定的子例程。导出指定在文件 shrsub.exp里的符号并且存储链接的共享对象在文件 shrsub.o 里。-bM:SRE 在链接共享对象里设置共享对象标记。

6. 要使用先前生成的共享对象 shrsub.o 链接，请输入：

   cc -o pgm pgm.o shrsub.o -L '.'

   这用 shrsub.o导出的符号链接对象代码pgm.o。链接的输出存储在对象代码 pgm 中。 -L '.' 添加当前目录到系统装入程序用于定位 shrsub.o 共享对象的库搜索路径。运行时，仅在从包含 shrsub.o 文件实例的目录运行或发现 shrsub.o 文件在 /usr/lib 标准库目录中时，装入该程序。允许从任何地方运行程序，使用选项 -L `pwd`。

   可以使用 dump 命令参阅由系统装入程序搜索的目录列表。

7. 要使用 libc.a 库作为非共享库链接程序，请输入：

   cc -o pgm pgm.o -bnso -bI:/lib/syscalls.exp

   以必需的支持库来链接 pgm.o 并且命名输出文件 pgm。对于 cc 命令，libc.a 库是必须的支持库和通常是作为共享库编辑到用户程序的链接。此例中，-bnso 选项指示 ld 命令用libc.a 库作为非共享库链接，-bI:/lib/syscalls.exp 指示 ld 命令导入实际上包含在内核或 /usr/lib/boot/unix 文件中的系统调用函数。无论何时用 -bnso 选项链接，在共享对象中导入且导出（既，通过）的任意符号必须先显式导入，正如此例中由 -bI:/lib/syscalls.exp 选项所操作的。

   注:
   当任意时间非共享链接 /usr/lib/libc.a 时，必须使用 -bI:/lib/syscalls.exp 标志。无论何时安装操作系统的更新发行版，应用程序也不得不再次链接。任意静态链接的应用程序不是可以从任意修正或发行版级别移植到其它修正或发行版级别上的二进制文件。

文件

相关信息

ar 命令、as 命令、nm 命令、dump 命令、rtl_enable 命令、strip 命令。

a.out 文件格式。

glob 子例程、load 子例程、loadbind 子例程、loadquery 子例程、unload 子例程。

『如何创建共享库』AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs。

『大程序支持概述』AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs。

『共享库和迟缓装入』 AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs。

『共享库概述』AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs。

『XCOFF（a.out）文件格式 』AIX 5L Version 5.2 Files Reference。