dlopen（3） - Linux手册页

名称

dladdr，dlclose，dlerror，dlopen，dlsym，dlvsym - 动态链接加载器的编程接口

概要

#include < dlfcn.h >

void * dlopen（const char * filename ，int flag ）;

char * dlerror（void）;

void * dlsym（void * handle ，const char * symbol ）;

int dlclose（void * handle ）;

与-ldl链接。

描述

四个函数dlopen（），dlsym（），dlclose（），dlerror（）实现了动态链接加载器的接口。

dlerror获得（）

函数dlerror（）返回一个人类可读的字符串，描述自从上次调用dlerror（）以来dlopen（），dlsym（）或 dlclose（）发生的最新错误。如果从初始化或上次调用以来没有发生错误，它将返回NULL。

dlopen的（）

函数dlopen（）加载由以null结尾的字符串文件名命名的动态库文件，并为动态库返回一个不透明的“句柄”。如果文件名为NULL，则返回的句柄用于主程序。如果filename包含一个斜线（“/”），则它被解释为（相对或绝对）路径名。否则，动态链接器将按如下方式搜索库（有关更多详细信息，请参阅ld.so（8））：

Ø

（仅限ELF）如果调用程序的可执行文件包含DT_RPATH标记，并且不包含DT_RUNPATH标记，则搜索DT_RPATH标记中列出的目录。

Ø

如果在程序启动时，环境变量LD_LIBRARY_PATH被定义为包含冒号分隔的目录列表，则会搜索这些目录。（作为一个安全措施，这个变量在set-user-ID和set-group-ID程序中被忽略。）

Ø

（仅限ELF）如果调用程序的可执行文件包含DT_RUNPATH标记，则搜索该标记中列出的目录。

Ø

将检查缓存文件/etc/ld.so.cache（由ldconfig（8）维护）以查看它是否包含文件名条目。

Ø

搜索目录/ lib和/ usr / lib（按此顺序）。

如果库对其他共享库有依赖关系，那么它们也会由动态链接程序使用相同的规则自动加载。（这个过程可能会递归发生，如果这些库依次具有依赖性，依此类推。）

标志中必须包含以下两个值之一：

RTLD_LAZY执行延迟绑定。只有在执行引用它们的代码时才解析符号。如果符号从未被引用，那么它永远不会被解析。（懒惰绑定仅针对函数引用执行;对于变量的引用总是在加载该库时立即绑定。）RTLD_NOW如果指定了该值，或者环境变量LD_BIND_NOW设置为非空字符串，则在dlopen（）返回之前解析库中的所有未定义符号。如果无法完成，则返回错误。以下值中的零个或多个值也可以在标志中进行或运算：RTLD_GLOBAL由该库定义的符号将可用于随后加载的库的符号解析。RTLD_LOCAL这是RTLD_GLOBAL的反过来，如果既没有指定标志，也是默认值。此库中定义的符号不可用于解决随后加载的库中的引用。RTLD_NODELETE（自glibc 2.2以来）在dlclose（）期间不要卸载该库。因此，如果库稍后用dlopen（）重新加载，则库的静态变量不会重新初始化 。该标志在POSIX.1-2001中未被指定。RTLD_NOLOAD（自glibc 2.2以来）不要加载库。这可以用来测试库是否已经驻留（dlopen（）如果不是，则返回NULL，如果库驻留则返回库）。该标志也可用于提升已加载库的标志。例如，以前加载RTLD_LOCAL的库 可以使用RTLD_NOLOAD |重新打开 RTLD_GLOBAL。该标志在POSIX.1-2001中未被指定。RTLD_DEEPBIND（自glibc 2.3.4开始）将该库中符号的查找范围放在全局范围之前。这意味着一个独立的库将使用它自己的符号而不是全局符号，这些符号包含在已经加载的库中。该标志在POSIX.1-2001中未被指定。如果filename是一个NULL指针，那么返回的句柄就是主程序。当提供给dlsym（）时，该句柄将导致在主程序中搜索一个符号，然后在程序启动时加载所有共享库，然后使用dlopen（）加载标志为 RTLD_GLOBAL的所有共享库。

库中的外部引用通过使用该库的依赖项列表中的库以及之前使用RTLD_GLOBAL标志打开的其他库来解决 。如果可执行文件与标志“-rdynamic”（或同义词，“--export-dynamic”）链接，则可执行文件中的全局符号也将用于解析动态加载的库中的引用。

如果使用dlopen（）再次加载相同的库，则会返回相同的文件句柄。dl库维护库句柄的引用计数，因此动态库不会被释放，直到dlclose（）被调用多次，直到dlopen（）成功完成为止。在_init（）例程，如果存在的话，只调用一次。但随后使用RTLD_NOW调用可能会强制使用先前加载RTLD_LAZY的库的符号解析 。

如果dlopen（）因任何原因失败，则返回NULL。

对dlsym（）

函数dlsym（）采用由dlopen（）返回的动态库的“句柄” 和空终止的符号名称，并返回该符号加载到内存中的地址。如果未找到符号，则在指定库或dlopen（）加载该库时自动加载的任何 库中，dlsym（）返回NULL。（由dlsym（）执行的搜索首先通过这些库的依赖树宽度）。由于符号的值实际上可以是NULL（所以dlsym（）的NULL返回不需要指示错误），所以正确的方法测试错误是调用dlerror（）清除任何旧的错误条件，然后调用dlsym（），然后再次调用dlerror（），将其返回值保存到变量中，并检查此保存的值是否不为NULL。

有两个特殊的伪句柄RTLD_DEFAULT和RTLD_NEXT。前者将使用默认库搜索顺序查找所需符号的第一个匹配项。后者将在当前库之后的搜索顺序中查找下一个函数。这使得人们可以在另一个共享库中的函数中提供一个包装。

dlclose（）

函数dlclose（）递减动态库句柄句柄的引用计数。如果引用计数下降到零，并且没有其他加载的库使用它中的符号，则动态库将被卸载。

函数dlclose（）成功时返回0，错误时返回非零值。

过时的符号_init（）和_fini（）

链接器识别特殊符号_init和_fini。如果动态库导出名为_init（）的例程，那么在dlopen（）返回之前，该代码会在加载后执行。如果动态库导出名为_fini（）的例程，那么在库被卸载之前调用该例程。如果您需要避免链接到系统启动文件，可以使用gcc（1）-nostartfiles 命令行选项完成此操作。

不建议使用这些例程或gcc- nostartfiles或-nostdlib选项。它们的使用可能会导致不希望的行为，因为构造函数/析构函数将不会执行（除非采取特殊措施）。

相反，库应该使用__attribute __（（构造函数））和__attribute __（（析构函数））函数属性导出例程。有关这些信息，请参阅gcc信息页面。构造函数例程在dlopen（）返回之前执行，而析构函数例程在dlclose（）返回之前执行 。

Glibc扩展名：dladdr（）和dlvsym（）

Glibc增加了POSIX未描述的两个功能，其中包含原型

#define _GNU_SOURCE          / *请参阅feature_test_macros（7）* /
 #include < dlfcn.h >

int dladdr（void * addr ，Dl_info * info ）;

void * dlvsym（void * handle ，char * symbol ，char * version ）;
          / *请参阅feature_test_macros（7）* /
 #include < dlfcn.h >

int dladdr（void * addr ，Dl_info * info ）;

void * dlvsym（void * handle ，char * symbol ，char * version ）;

函数dladdr（）接受函数指针并尝试解析它所在的名称和文件。信息存储在Dl_info 结构中：

typedef struct {
    const char * dli_fname; / *共享对象的路径名
                               包含地址* /
    void * dli_fbase; / *共享对象的地址
                               已加载* /
    const char * dli_sname; / *地址最近的符号的名称
                               低于地址 * /
    void * dli_saddr; / *指定符号的确切地址
                               在dli_sname * /
} Dl_info;
    const char * dli_fname; / *共享对象的路径名
                               包含地址* /
    void * dli_fbase; / *共享对象的地址
                               已加载* /
    const char * dli_sname; / *地址最近的符号的名称
                               低于地址 * /
    void * dli_saddr; / *指定符号的确切地址
                               在dli_sname * /
} Dl_info;

如果找不到符号匹配addr，则将dli_sname和dli_saddr设置为NULL。

dladdr（）在错误时返回0，在成功时返回非零值。

函数dlvsym（），自2.1版以来由glibc提供，与dlsym（）相同，但将版本字符串作为附加参数。

符合

POSIX.1-2001介绍了dlclose（），dlerror（），dlopen（）和dlsym（）。

笔记

符号RTLD_DEFAULT和RTLD_NEXT被定义< dlfcn.h中 >仅当_GNU_SOURCE包括之前被定义。

由于glibc 2.2.3，atexit（3）可用于注册卸载库时自动调用的退出处理函数。

历史

dlopen接口标准来自SunOS。该系统也有dladdr（），但不包括dlvsym（）。

错误

有时候，你传递给dladdr（）的函数指针可能会让你感到惊讶。在某些体系结构（特别是i386和x86_64）中，即使用作参数的函数应来自动态链接库，dli_fname和 dli_fbase最终可能会指向您称为dladdr（）的对象。

问题在于函数指针在编译时仍然会被解析，但只是指向原始对象的plt（过程链接表）部分（在请求动态链接器解析该符号后调度该调用）。要解决这个问题，你可以尝试将代码编译为位置无关的：然后，编译器不能在编译时间准备好指针，今天的gcc（1）将生成代码，只是从得到的代码中加载最后的符号地址（全局偏移量表）在传递给dladdr（）之前的运行时间。

例

加载数学库，并打印2.0的余弦：

#include < stdio.h >
#include < stdlib.h >
#include < dlfcn.h >

INT
main（int argc，char ** argv）
{
    void * handle;
    双（*余弦）（双）;
    char *错误;

   handle = dlopen（“libm.so”，RTLD_LAZY）;
    if（！handle）{
        fprintf（stderr，“％s \ n”，dlerror（））;
        出口（EXIT_FAILURE）;
    }

   dlerror获得（）; / *清除任何现有的错误* /

   / *写入：cosine =（double（*）（double））dlsym（句柄，“cos”）;
       似乎更自然，但C99标准离开了
       从“void *”转换为未定义的函数指针。
       下面使用的任务是POSIX.1-2003（技术文档
       勘误1）解决方法; 请参阅
       POSIX规范的dlsym（）。* /

   *（void **）（＆cosine）= dlsym（句柄，“cos”）;

   如果（（error = dlerror（））！= NULL）{
        fprintf（stderr，“％s \ n”，错误）;
        出口（EXIT_FAILURE）;
    }

   printf（“％f \ n”，（* cosine）（2.0））;
    dlclose（手柄）;
    出口（EXIT_SUCCESS）;
}stdio.h >
#include < stdlib.h >
#include < dlfcn.h >

INT
main（int argc，char ** argv）
{
    void * handle;
    双（*余弦）（双）;
    char *错误;

   handle = dlopen（“libm.so”，RTLD_LAZY）;
    if（！handle）{
        fprintf（stderr，“％s \ n”，dlerror（））;
        出口（EXIT_FAILURE）;
    }

   dlerror获得（）; / *清除任何现有的错误* /

   / *写入：cosine =（double（*）（double））dlsym（句柄，“cos”）;
       似乎更自然，但C99标准离开了
       从“void *”转换为未定义的函数指针。
       下面使用的任务是POSIX.1-2003（技术文档
       勘误1）解决方法; 请参阅
       POSIX规范的dlsym（）。* /

   *（void **）（＆cosine）= dlsym（句柄，“cos”）;

   如果（（error = dlerror（））！= NULL）{
        fprintf（stderr，“％s \ n”，错误）;
        出口（EXIT_FAILURE）;
    }

   printf（“％f \ n”，（* cosine）（2.0））;
    dlclose（手柄）;
    出口（EXIT_SUCCESS）;
}

如果此程序位于名为“foo.c”的文件中，则可以使用以下命令构建程序：

gcc -rdynamic -o foo foo.c -ldl

导出_init（）和_fini（）的库需要按如下方式编译，使用bar.c作为示例名称：

gcc -shared -nostartfiles -o bar bar.c

也可以看看

ld（1）， ldd（1）， dl_iterate_phdr（3）， rtld-audit（7）， ld.so（8）， ldconfig（8）

ld.so信息页面，gcc信息页面，ld信息页面

 

 

 

以上内容  来自    https://linux.die.net/man/3/dlopen  翻译