JavaScript is required to for searching.
跳过导航链接
退出打印视图
Oracle Solaris 11.1 链接程序和库指南     Oracle Solaris 11.1 Information Library (简体中文)
为本文档评分
search filter icon
search icon

文档信息

前言

第 1 部分使用链接编辑器和运行时链接程序

1.  Oracle Solaris 链接编辑器介绍

2.  链接编辑器

3.  运行时链接程序

共享目标文件依赖项

查找共享目标文件依赖项

运行时链接程序搜索的目录

配置缺省搜索路径

动态字符串标记

重定位处理

重定位符号查找

缺省符号查找

运行时插入

执行重定位的时间

重定位错误

装入其他目标文件

延迟装入动态依赖项

提供 dlopen() 的替代项

初始化和终止例程

初始化和终止顺序

安全性

运行时链接编程接口

装入其他目标文件

重定位处理

符号查找

获取新符号

测试功能

使用插入

调试帮助

调试功能

调试器模块

4.  共享目标文件

第 2 部分快速参考

5.  链接编辑器快速参考

第 3 部分高级主题

6.  直接绑定

7.  生成目标文件以优化系统性能

8.  Mapfile

9.  接口和版本控制

10.  使用动态字符串标记建立依赖性

11.  可扩展性机制

第 4 部分ELF 应用程序二进制接口

12.  目标文件格式

13.  程序装入和动态链接

14.  线程局部存储

第 5 部分附录

A.  链接程序和库的更新及新增功能

B.  System V 发行版 4(版本 1)Mapfile

索引

请告诉我们如何提高我们的文档:
过于简略
不易阅读或难以理解
重要信息缺失
错误的内容
需要翻译的版本
其他
Your rating has been updated
感谢您的反馈!

您的反馈将非常有助于我们提供更好的文档。 您是否愿意参与我们的内容改进并提供进一步的意见?

运行时链接编程接口

在应用程序的链接编辑期间指定的依赖项,由运行时链接程序在进程初始化过程中处理。除了此机制以外,应用程序还可在执行期间通过绑定到其他目标文件来扩展其地址空间。应用程序将有效地使用处理应用程序标准依赖项所用的相同运行时链接程序服务。

延迟目标文件绑定有以下几个优点。

应用程序可使用下列典型方案来访问其他共享目标文件。

运行时链接程序的服务将在头文件 dlfcn.h 中进行定义,并且通过共享目标文件 libc.so.1 使该服务可用于应用程序。在以下示例中,文件 main.c 可以引用任何 dlopen(3C) 系列例程,并且应用程序 prog 可在运行时绑定到这些例程。

$ cc -o prog main.c

注 - 在以前的 Oracle Solaris OS 发行版中,共享目标文件 libdl.so.1 提供了动态链接接口。libdl.so.1 仍然可用于支持所有现有依赖项。但是,libdl.so.1 提供的动态链接接口现在可从 libc.so.1 获取。不再需要使用 -ldl 进行链接。


装入其他目标文件

使用 dlopen(3C),可将其他目标文件添加到运行的进程的地址空间。此函数将路径名和绑定模式作为参数,并向应用程序返回一个句柄。通过 dlsym(3C),可使用此句柄来查找供应用程序使用的符号。

如果将路径名指定为简单文件名(名称中没有 '/'),则运行时链接程序将使用一组规则来生成相应的路径名。包含 '/' 的路径名均按原样使用。

这些搜索路径规则与用于查找所有初始依赖项的规则完全相同。请参见运行时链接程序搜索的目录。例如,文件 main.c 包含以下代码片段。

#include        <stdio.h>
#include        <dlfcn.h>
 
int main(int argc, char **argv)
{
        void *handle;
        .....
 
        if ((handle = dlopen("foo.so.1", RTLD_LAZY)) == NULL) {
                (void) printf("dlopen: %s\n", dlerror());
                return (1);
        }
        .....

要查找共享目标文件 foo.so.1,运行时链接程序应使用进程初始化时存在的 LD_LIBRARY_PATH 定义。接下来,使用链接编辑 prog 过程中指定的运行路径。最后,使用缺省位置 /lib/usr/lib(对于 32 位目标文件)或 /lib/64/usr/lib/64(对于 64 位目标文件)。

如果将路径名指定为:

        if ((handle = dlopen("./foo.so.1", RTLD_LAZY)) == NULL) {

则运行时链接程序只会在进程的当前工作目录中搜索该文件。


注 - 应该通过版本化文件名来引用使用 dlopen(3C) 指定的任何共享目标文件。有关版本化的更多信息,请参见协调版本化文件名


如果无法找到需要的目标文件,dlopen(3C) 将返回 NULL 句柄。在此情况下,可使用 dlerror(3C) 来显示失败的真正原因。例如:

$ cc -o prog main.c
$ prog
dlopen: ld.so.1: prog: fatal: foo.so.1: open failed: No such \
    file or directory

如果 dlopen(3C) 添加的目标文件依赖于其他目标文件,则也会将这些目标文件引入进程的地址空间中。此进程将一直继续,直到装入指定目标文件的所有依赖项。此依赖项树称为

如果 dlopen(3C) 指定的目标文件或其任何依赖项已经是进程映像的一部分,则不会进一步处理这些目标文件,而是向应用程序返回一个有效句柄。此机制可避免多次装入同一目标文件,并且使应用程序可以获取指向自身的句柄。例如,前面的示例 main.c 可以包含以下 dlopen() 调用。

        if ((handle = dlopen(0, RTLD_LAZY)) == NULL) {

通过指定了 RTLD_GLOBAL 标志的 dlopen(3C),可使用从该 dlopen(3C) 返回的句柄在应用程序本身、进程初始化时装入的任何依赖项或添加到进程地址空间的所有目标文件中查找符号。

重定位处理

在找到并装入所有目标文件后,运行时链接程序必须处理每个目标文件并执行所有必需的重定位。另外,还必须以同一方式重定位使用 dlopen(3C) 引入进程地址空间中的所有目标文件。

对于简单应用程序,此过程很简单。但是,对于使用较复杂的应用程序(包含涉及多个目标文件的 dlopen(3C) 调用,且可能包含公共依赖项)的用户,则此过程可能相当重要。

可以根据重定位发生的时间对其进行分类。运行时链接程序的缺省行为是在初始化时处理所有即时引用重定位,以及在进程执行期间处理所有延迟引用(此机制通常称为延迟绑定)。

当模式定义为 RTLD_LAZY 时,此相同的机制可应用于任何使用 dlopen(3C) 添加的目标文件。替代方法是要求在添加目标文件时立即执行目标文件的所有重定位。您可以使用 RTLD_NOW 模式,也可以使用链接编辑器的 -z now 选项在生成目标文件时将此要求记录在目标文件中。此重定位要求将传播至要打开的目标文件的所有依赖项。

重定位还可分为非符号重定位和符号重定位。本节的余下部分将讨论有关符号重定位的问题(无论这些重定位何时进行),并重点介绍符号查找的某些细节信息。

符号查找

如果 dlopen(3C) 获取的目标文件引用全局符号,则运行时链接程序必须从构成进程的目标文件池中查找此符号。如果缺少直接绑定,则会将缺省符号搜索模型应用于通过 dlopen() 获取的目标文件。但是,dlopen() 模式以及构成进程的目标文件的属性允许使用替代的符号搜索模型。

需要直接绑定的目标文件将直接在关联的依赖项中搜索符号(尽管要维护后面介绍的所有属性)。请参见第 6 章


注 - 指定了 STV_SINGLETON 可见性的符号使用缺省符号搜索绑定,无论 dlopen(3C) 属性如何都是如此。请参见表 12-21


缺省情况下,使用 dlopen(3C) 获取的目标文件将被指定 world 符号搜索作用域和 local 符号可见性。缺省符号查找模型一节将使用此缺省模型说明典型的目标文件组交互。定义全局目标文件隔离组目标文件分层结构节介绍使用 dlopen(3C) 模式和文件属性扩展缺省符号查找模型的示例。

缺省符号查找模型

对于通过基本 dlopen(3C) 添加的每个目标文件,运行时链接程序将首先在动态可执行文件中查找符号。之后,运行时链接程序在进程初始化期间提供的每个目标文件中查找。如果找不到该符号,运行时链接程序将继续搜索。接下来,运行时链接程序会在通过 dlopen(3C) 获取的目标文件及其依赖项中查找。

使用缺省符号查找模型时,可以转换到延迟装入环境。如果在当前装入的目标文件中找不到某符号,则会处理所有暂挂的延迟装入目标文件,以尝试查找该符号。此装入是对尚未完整定义其依赖项的目标文件的补偿。但是,该补偿可能会破坏延迟装入的优点。

在以下示例中,动态可执行文件 prog 和共享目标文件 B.so.1 具有下列依赖项。

$ ldd prog
        A.so.1 =>        ./A.so.1
$ ldd B.so.1
        C.so.1 =>        ./C.so.1

如果 prog 通过 dlopen(3C) 获取共享目标文件 B.so.1,则会首先在 prog 中查找重定位共享目标文件 B.so.1C.so.1 所需的任何符号,然后依次在 A.so.1B.so.1C.so.1 中进行查找。在此简单示例中,将通过 dlopen(3C) 获取的共享目标文件视作已在对应用程序的原始链接编辑结束时将它们添加进来。例如,可以采用图解方式表示前面列表中引用的目标文件,如下图所示。

图 3-1 单个 dlopen() 请求

image:单个 dlopen() 请求。

通过 dlopen(3C) 获取的目标文件(显示为阴影块)所需的任何符号查找,将从动态可执行文件 prog 继续执行一直到最后一个共享目标文件 C.so.1

此符号查找是按装入目标文件时为目标文件指定的属性建立的。请记住,已为动态可执行文件及随其装入的所有依赖项指定了全局符号可见性,并且为新目标文件指定了全局符号搜索作用域。因此,新目标文件能够在原始目标文件中查找符号。新目标文件也会构成一个唯一的组,其中每个目标文件都具有局部符号可见性。因此,该组中的每个目标文件都可在其他组成员中查找符号。

这些新目标文件不会影响应用程序或其初始依赖项所需的正常符号查找。例如,如果 A.so.1 要求在执行了前面的 dlopen(3C) 后进行函数重定位,则运行时链接程序对重定位符号的正常搜索是首先在 prog 中查找,然后在 A.so.1 中查找。运行时链接程序不会继续在 B.so.1C.so.1 中查找。

此符号查找同样是按装入目标文件时为目标文件指定的属性建立的。对于动态可执行文件及随其装入的所有依赖项,都指定全局符号搜索作用域。此作用域不允许它们在仅提供局部符号可见性的新目标文件中查找符号。

这些符号搜索和符号可见性属性用于维护目标文件之间的关联。这些关联基于它们引入进程地址空间的情况以及目标文件之间的依赖项关系。将与给定 dlopen(3C) 关联的目标文件指定给唯一的组,可以确保仅允许与同一 dlopen(3C) 关联的目标文件在目标文件本身及其关联的依赖项中查找符号。

定义目标文件之间的关联的概念在多次执行 dlopen(3C) 的应用程序中更为清晰。例如,假定共享目标文件 D.so.1 具有以下依赖项:

$ ldd D.so.1
        E.so.1 =>         ./E.so.1

并且 prog 应用程序使用 dlopen(3C) 装入此共享目标文件及共享目标文件 B.so.1。下图说明了目标文件之间的符号查找关系。

图 3-2 多个 dlopen() 请求

image:多个 dlopen() 请求。

假定 B.so.1D.so.1 都包含符号 foo 的定义,C.so.1E.so.1 都包含需要此符号的重定位。由于目标文件与唯一的组关联,因此 C.so.1 绑定到 B.so.1 中的定义,而 E.so.1 绑定到 D.so.1 中的定义。此机制用于为通过多次调用 dlopen(3C) 获取的目标文件提供最直观的绑定。

在到现在为止已介绍的情况中使用目标文件时,执行每个 dlopen(3C) 的顺序对生成的符号绑定没有影响。但是,如果目标文件具有公共依赖项,则生成的绑定可能会受到进行 dlopen(3C) 调用的顺序的影响。

在以下示例中,共享目标文件 O.so.1P.so.1 具有相同的公共依赖项。

$ ldd O.so.1
        Z.so.1 =>        ./Z.so.1
$ ldd P.so.1
        Z.so.1 =>        ./Z.so.1

在此示例中,prog 应用程序将对其中每个共享目标文件执行 dlopen(3C)。由于共享目标文件 Z.so.1O.so.1P.so.1 的公共依赖项,因此将为与两次 dlopen(3C) 调用关联的两个组指定 Z.so.1。此关系如下图所示。

图 3-3 具有公共依赖项的多个 dlopen() 请求

image:具有公共依赖项的多个 dlopen() 请求。

Z.so.1 可同时供 O.so.1P.so.1 用于查找符号。更重要的是,就 dlopen(3C) 排序而言,Z.so.1 还可用于同时在 O.so.1P.so.1 中查找符号。

因此,如果 O.so.1P.so.1 同时包含符号 foo 的定义(这是 Z.so.1 重定位所需的),则进行的实际绑定不可预测,因为它会受到 dlopen(3C) 调用的顺序的影响。如果符号l foo 的功能在定义它的两个共享目标文件间不同,则在 Z.so.1 中执行代码的整体结果可能会因应用程序的 dlopen(3C) 排序而异。

定义全局目标文件

通过使用 RTLD_GLOBAL 标志扩充模式参数,可将为通过 dlopen(3C) 获取的目标文件缺省指定的局部符号可见性提升为全局可见性。在此模式下,具有全局符号搜索作用域的任何其他目标文件可使用通过 dlopen(3C) 获取的所有目标文件来查找符号。

此外,通过 dlopen(3C) 获取的、带有 RTLD_GLOBAL 标志的任何目标文件都可供使用 dlopen() 及值为 0 的路径名的符号查找使用。


注 - 如果某个组成员定义了局部符号可见性,并且被另一个定义了全局符号可见性的组引用,则该目标文件的可见性将变为局部和全局可见性的串联。即使以后删除该全局组引用,也会保留此属性提升。


隔离组

通过使用 RTLD_GROUP 标志扩充模式参数,可将为通过 dlopen(3C) 获取的目标文件缺省指定的全局符号搜索作用域缩小为组。在此模式下,仅允许通过 dlopen(3C) 获取的所有目标文件在其各自的组中查找符号。

使用链接编辑器的 -B group 选项,可在生成目标文件时为其指定组符号搜索作用域。


注 - 如果某个组成员定义了组搜索要求,并且被另一个定义了全局搜索要求的组引用,则该目标文件的搜索要求将变为组和全局搜索的串联。即使以后删除该全局组引用,也会保留此属性提升。


目标文件分层结构

如果初始目标文件是从 dlopen(3C) 获取的,并且使用 dlopen() 打开第二个目标文件,则这两个目标文件都会被指定给一个唯一的组。这种情况可以防止一个目标文件在另一个目标文件中查找符号。

在某些实现中,初始目标文件必须导出符号以便重定位第二个目标文件。通过以下两种机制之一,可以满足此要求:

如果初始目标文件是第二个目标文件的显式依赖项,则会将该初始目标文件指定给第二个目标文件所在的组。因此,初始目标文件可以为第二个目标文件的重定位提供符号。

如果许多目标文件可使用 dlopen(3C) 打开第二个目标文件,并且每个初始目标文件必须导出相同符号以满足第二个目标文件重定位的需要,则不能对第二个目标文件指定显式依赖项。在此情况下,可使用 RTLD_PARENT 标志扩充第二个目标文件的 dlopen(3C) 模式。此标志将导致第二个目标文件所在的组以显式依赖项的方式传播至初始目标文件。

这两种方法之间有一点区别。如果指定显式依赖项,则依赖项本身将成为第二个目标文件的 dlopen(3C) 依赖项树的一部分,从而可用于使用 dlsym(3C) 的符号查找。如果使用 RTLD_PARENT 获取第二个目标文件,则使用 dlsym(3C) 的符号查找不能使用初始目标文件。

如果第二个目标文件是通过 dlopen(3C) 从具有全局符号可见性的初始目标文件获取的,则 RTLD_PARENT 模式既是冗余的,也是无害的。从应用程序或应用程序的依赖项之一调用 dlopen(3C) 时,通常会发生这种情况。

获取新符号

进程可以使用 dlsym(3C) 获取特定符号的地址。此函数采用句柄符号名称,并将符号地址返回给调用者。该句柄通过以下方式指示符号搜索:

在以下可能很常见的示例中,应用程序首先会将其他目标文件添加到其地址空间。然后,应用程序会使用 dlsym(3C) 来查找函数或数据符号。接下来,应用程序将使用这些符号来调用这些新目标文件中提供的服务。文件 main.c 包含以下代码:

#include    <stdio.h>
#include    <dlfcn.h>
 
int main()
{
        void *handle;
        int  *dptr, (*fptr)();
 
        if ((handle = dlopen("foo.so.1", RTLD_LAZY)) == NULL) {
                (void) printf("dlopen: %s\n", dlerror());
                return (1);
        }
 
        if (((fptr = (int (*)())dlsym(handle, "foo")) == NULL) ||
            ((dptr = (int *)dlsym(handle, "bar")) == NULL)) {
                (void) printf("dlsym: %s\n", dlerror());
                return (1);
        }
 
        return ((*fptr)(*dptr));
}

首先会在文件 foo.so.1 中搜索符号 foobar,然后在与此文件关联的所有依赖项中搜索。然后,使用 return() 语句中的单个参数 bar 来调用函数 foo

使用前面的文件 main.c 生成的应用程序 prog 包含下列依赖项。

$ ldd prog
        libc.so.1 =>     /lib/libc.so.1

如果在 dlopen(3C) 中指定的文件名的值为 0,则会首先在 prog 中搜索符号 foobar,然后在 /lib/libc.so.1 中搜索。

该句柄指示启动符号搜索所在根。搜索机制将从此根开始采用重定位符号查找中所述的模型。

如果无法找到需要的符号,dlsym(3C) 将返回 NULL 值。在此情况下,可使用 dlerror(3C) 来指示失败的真正原因。在以下示例中,应用程序 prog 无法找到符号 bar

$ prog
dlsym: ld.so.1: main: fatal: bar: can't find symbol

测试功能

使用特殊句柄 RTLD_DEFAULTRTLD_PROBE,应用程序可以测试是否存在其他符号。

RTLD_DEFAULT 句柄采用运行时链接程序所用的同一规则来解析调用目标文件中的任何符号引用。请参见缺省符号查找模型。应注意该模型的两个方面。

RTLD_PROBE 采用与 RTLD_DEFAULT 类似的模型,但是与标有 RTLD_DEFAULT 的模型在两个方面有所不同。RTLD_PROBE 只能绑定到显式符号定义,而不能绑定到可执行文件中的任何过程链接表项。此外,RTLD_PROBE 不会启动一个全面的延迟装入回退。RTLD_PROBE 是用来检测现有进程中符号是否存在的最合适的标志。

RTLD_DEFAULTRTLD_PROBE 都可以启动显式延迟装入。目标文件可以引用函数,且该引用可以通过一个延迟可装入依赖项建立。调用该函数之前,可以使用 RTLD_DEFAULTRTLD_PROBE 测试函数是否存在。由于目标文件会引用函数,因此首先要尝试装入关联的延迟依赖项。随后遵循 RTLD_DEFAULTRTLD_PROBE 的规则以绑定到函数。在下面的示例中,RTLD_PROBE 调用用于触发延迟装入,以及在存在依赖项时绑定到装入的依赖项。

void foo()
{
    if (dlsym(RTLD_PROBE, "foo1")) {
        foo1(arg1);
        foo2(arg2);
        ....
}

要为功能性测试提供一个强大而灵活的模型,关联的延迟依赖项应显式标记为推迟。请参见提供 dlopen() 的替代项。该标记还在运行时提供更改推迟依赖项的方式。

RTLD_DEFAULTRTLD_PROBE 的使用为未定义的弱引用的使用提供了一个更强大的替代方案,如弱符号中所述。

使用插入

使用特殊句柄 RTLD_NEXT,应用程序可在符号作用域内查找下一个符号。例如,如果应用程序 prog 包含以下代码片段:

        if ((fptr = (int (*)())dlsym(RTLD_NEXT, "foo")) == NULL) {
                (void) printf("dlsym: %s\n", dlerror());
                return (1);
        }
 
        return ((*fptr)());

则会在与 prog 关联的共享目标文件(在此情况下为 /lib/libc.so.1)中搜索 foo。如果此代码片段包含在 图 3-1 中显示的示例的文件 B.so.1 中,则仅会在 C.so.1 中搜索 foo

使用 RTLD_NEXT 提供了使用符号插入的方法。例如,可通过前面的目标文件插入目标文件中的函数,然后扩充原始函数的处理。例如,在共享目标文件 malloc.so.1 中放置以下代码片段。

#include    <sys/types.h>
#include    <dlfcn.h>
#include    <stdio.h>
 
void *
malloc(size_t size)
{
        static void *(*fptr)() = 0;
        char        buffer[50];
 
        if (fptr == 0) {
                fptr = (void *(*)())dlsym(RTLD_NEXT, "malloc");
                if (fptr == NULL) {
                        (void) printf("dlopen: %s\n", dlerror());
                        return (NULL);
                }
        }
 
        (void) sprintf(buffer, "malloc: %#x bytes\n", size);
        (void) write(1, buffer, strlen(buffer));
        return ((*fptr)(size));
}

malloc.so.1 可插入到 malloc(3C) 通常所在的系统库 /lib/libc.so.1 之前。现在,在调用原始函数以完成分配之前,插入对 malloc() 的调用:

$ cc -o malloc.so.1 -G -K pic malloc.c
$ cc -o prog file1.o file2.o ..... -R. malloc.so.1
$ prog
malloc: 0x32 bytes
malloc: 0x14 bytes
..........

或者,可使用以下命令实现相同插入:

$ cc -o malloc.so.1 -G -K pic malloc.c
$ cc -o prog main.c
$ LD_PRELOAD=./malloc.so.1 prog
malloc: 0x32 bytes
malloc: 0x14 bytes
..........

注 - 使用任何插入方法的用户在处理任何可能的递归时都必须小心。前面的示例使用 sprintf(3C),而不是直接使用 printf(3C) 来格式化诊断消息,以避免由于 printf(3C) 可能使用 malloc(3C) 而导致产生递归。


在动态可执行文件或预装入的目标文件中使用 RTLD_NEXT,可提供可预测的插入方法。在一般目标文件依赖项中使用此方法时应该十分小心,因为目标文件的实际装入顺序有时无法预测。