程序运行时，是怎么找到动态库的？
共 6538字，需浏览 14分钟
·
2021-03-26 07:47
作者：守望，Linux应用开发者，目前在公众号【编程珠玑】 分享Linux/C/C++/数据结构与算法/工具等原创技术文章和学习资源。
我们随便开发一个C/C++程序，都很大程度不可避免的需要用到动态库：
// 来源：公众号【编程珠玑】
#include <stdio.h>
int main()
{
printf("hello，编程珠玑\n");
return 0;
}
编译并查看使用到的动态库：
$ gcc -o main main.c
$ ldd main
linux-vdso.so.1 (0x00007ffdf8fdf000)
libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007f1f8535e000)
/lib64/ld-linux-x86-64.so.2 (0x00007f1f85951000)
从ldd命令的结果我们可以看到main程序依赖了哪些动态库，并且在哪个路径。那么你有没有想过，动态库的路径是怎么找到的，查找顺序又是怎样的呢？
准备动态库
在此之前如果你还没有对动态库有一个基本的了解的话，建议你阅读《浅谈静态库和动态库》或其他相关资料。为了说明后面的问题，这里我们先创建一个简单的动态库：
// test.c
//来源：公众号【编程珠玑】
#include <stdio.h>
#include "test.h"
#include "test1.h"
void test()
{
printf("I am test；hello，编程珠玑\n");
test1();
}
// test.h
void test();
//test1.c
#include <stdio.h>
#include "test1.h"
void test1()
{
printf("test1,needed by test\n");
}
// test1.h
void test1();
分别制作动态库libtest.so和libtest1.so，这在后面的示例中会用到：
$ gcc test1.c -fPIC -shared -o libtest1.so
$ gcc test.c -fPIC -shared -o libtest.so -L. -ltest1
这样你在当前目录下就会看到有一个libtest.so和libtest1.so文件生成了，其中litest.so依赖libtest.so
注意，由于libtest.so依赖libtest1.so，这里用-L指定了要链接的test1的路径，因此我们看到：
$ ldd libtest.so
linux-vdso.so.1 (0x00007ffd1bbca000)
libtest1.so => not found
libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007f9f1d0ae000)
/lib64/ld-linux-x86-64.so.2 (0x00007f9f1d6a1000)
从这里可以看出libtest是依赖libtest1库的，但是特别注意到，libtest1.so指向的是not found，这会有什么影响吗？我们后面就会看到。
链接时查找路径
我们都知道，在编译成可执行文件前，链接器链接动态库也是需要查找动态库路径的，否则怎么链接上指定的动态库呢？那么这个顺序又是怎样的呢？
首先会查找的会是编译时链接的路径。修改前面的main.c，让它调用libtest.so中的test函数：
// 来源：公众号【编程珠玑】
#include <stdio.h>
#include "test.h"
int main()
{
test(); // 调用libtest.so中的test函数
return 0;
}
编译链接：
$ gcc -o main main.c -I ./ -L./ -ltest -ltest1
完美编译过。除此之外，如果我们把libtest.so和libtest1.so都移到/usr/lib下面，我们发现，即便不用-L也能编译过了:
$ gcc -o main main.c -I ./ -ltest -ltest1
这里需要说明的是，我们通过-L./来指定搜索库的路径，由于libtest.so依赖libtest1.so，因此在编译链接时，也需要链接上test1。
小结
从上面的内容可以看到，在链接时，我们通过-L参数搜索要链接的库路径，但是这个路径信息不会写到ELF文件中，因此你会通过ldd命令看到not found，而通过-rpath可以指定链接时的搜索路径，这个信息会写入到ELF文件中，最终看到的结果是，由于libtest.so依赖libtest1.so，所以其他程序依赖libtest.so时，会自动从写入ELF的rpath中搜索它依赖的其他库，因此只需要链接libtest即可，例如：
在制作库libtest1.so时，加上-rpath-link选项：
$ gcc test.c -fPIC -shared -o libtest.so -L. -ltest1 -Wl,-rpath-link $(pwd)
在编译main的时候，就不需要特意指定链接libtest1.so
$ gcc -o main main.c -L ./ -ltest
只需要链接libtest.so，其依赖的libtest1.so也链接进来了。
当然了，如果-L指定的路径没有呢,它还会去查找其他地方，否则依赖的系统库怎么找到呢？总结大致顺序如下：
-L指定链接路径
对于依赖库中依赖的搜索顺序通过-rpath-link或-rpath选项查找（后面会提到）
gcc默认链接路径（gcc --print-search-dir | grep libraries 查看）
链接器配置的查找路径（ld -verbose | grep SEARCH_DIR查看）
针对具体的系统或链接器，可能有些差异，但是大致如此。
运行时查找路径
虽然前面编译成功了，但是我们运行看看，发现运行失败了。
$ ./main
./main: error while loading shared libraries: libtest.so: cannot open shared object file: No such file or directory
其实我们用ldd命令看一下也能看到：
linux-vdso.so.1 (0x00007ffcd566e000)
libtest.so => not found
libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007f356d1f6000)
/lib64/ld-linux-x86-64.so.2 (0x00007f356d7e9000)
LD_PRELOAD环境变量
这个环境变量在介绍《性能优化-使用高效内存分配器》中的时候，也有提到，用来做测试非常方便，同样的，这种方式也最好仅仅只是用于测试，因为它的优先级非常高，并且影响全局。使用也很简单：
$ export LD_PRELOAD=./libtest.so
$ ./main
为了避免影响后面的验证，这里取消设置该环境变量：
unset LD_PREALOD
查找rpath路径
上面的情况是找不到动态库，那么它首先会去rpath指定路径去查找，这需要在编译时指定：
$ gcc test.c -fPIC -shared -o libtest.so -L. -ltest1 -Wl,-rpath $(pwd)
$ gcc -o main main.c -L . -ltest -Wl,-rpath $(pwd)
$ ./main
I am test；hello，编程珠玑
test1,needed by test
也就是说，如果我们编译时指定了路径，就可以找到了，但是这些信息被写入到了ELF文件中。
LD_LIBRARY_PATH环境变量
另外也可以通过这个环境变量来设置要搜索库的路径。
$ gcc -o main main.c -L . -ltest
$ export LD_LIBRARY_PATH=./
$ ./main
这样运行也是没有问题的。
同样，为了避免对后面测试产生影响，取消设置该环境变量：
unset LD_LIBRARY_PATH
/etc/ld.so.conf中的路径
我的机器上这个文件的内容如下：
$ cat /etc/ld.so.conf
include /etc/ld.so.conf.d/*.conf
$ ls /etc/ld.so.conf.d/
fakeroot-x86_64-linux-gnu.conf libc.conf x86_64-linux-gnu.conf
所以它实际指的是/etc/ld.so.conf.d/目录下所有conf路径包含路径，打开其中一个libc.conf，它里面包含的路径为：
$ /usr/local/lib
既然如此，我们把前面的libtest.so复制到该目录下(可能需要sudo权限)：
$ sudo cp libtest.so /usr/local/lib
$ sudo ldconfig
$ ./main
I am test；hello，编程珠玑
test1,needed by test
注意，这里拷贝完成后，需要执行ldconfig，它会更新相应的共享库，以便可执行程序能够找到。实际上，执行完成后，你确实就能在/etc/ld.so.cache文件中找到：
$ grep -a libtest.so /etc/ld.so.cache
同样，为了影响后面测试，记得删除：
rm /usr/local/lib/libtest.so
实际上这里是先从/etc/ld.so.cache中的路径查找，然后再从ld.so.conf的路径中查找。后面我们可以通过命令看到。
/usr/lib，/lib/
当然了，如果以上路径都没有，最终还会在lib或/usr/lib下找，为了验证，我们将库拷贝到/lib目录下
$ cp libtest.so /lib
$ ./main
I am test；hello，编程珠玑
test1,needed by test
同样能正常运行。
小结
小结一下，动态库的搜索顺序如下：
LD_PRELOAD环境变量指定库路径
-rpath链接时指定路径
LD_LIBRARY_PATH环境变量设置路径
/etc/ld.so.conf配置文件指定路径
默认共享库路径，/usr/lib，lib
以上这些查找路径你很容易来验证它们的优先级，简单的做法就是这几个位置分别放置同名不同作用的库，来看看它到底先使用哪个路径下的库，可自行尝试。
LD_DEBUG
这个环境通常用来调试。例如，查看整个装载过程：
$ LD_DEBUG=files ./main
或者查看依赖的库的查找过程：
$ LD_DEBUG=libs ./main
3557: find library=libtest.so [0]; searching
3557: search cache=/etc/ld.so.cache
3557: trying file=/usr/local/lib/libtest.so
另外还可以显示符号的查找过程：
$ LD_DEBUG=symbols ./main
总结
了解动态库的搜索路径，可以在开发中很好的帮助你定位找不到库的问题，同时LD_DEBUG环境变量也能够很好的帮助你调试，例如查看库搜索的路径，显示符号的查找过程等等。
虽然程序运行能够有多种途径获取动态库路径，但是并不是每种方式都合适，有的方式甚至完全不该用，但这超出了本文的讨论范围了。