Linux 指定动态库路径
众所周知, Linux 动态库的默认搜索路径是 /lib 和 /usr/lib 。动态库被创建后,一般都复制到这两个目录中。当程序执行时需要某动态库, 并且该动态库还未加载到内存中,则系统会自动到这两个默认搜索路径中去查找相应的动态库文件,然后加载该文件到内存中,这样程序就可以使用该动态库中的函 数,以及该动态库的其它资源了。在 Linux 中,动态库的搜索路径除了默认的搜索路径外,还可以通过以下三种方法来指定。
方法一:在配置文件 /etc/ld.so.conf 中指定动态库搜索路径。
可以通过编辑配置文件 /etc/ld.so.conf 来指定动态库的搜索路径,该文件中每行为一个动态库搜索路径。每次编辑完该文件后,都必须运行命令 ldconfig 使修改后的配置生效 。我们通过例 1 来说明该方法。
例 1 :
我们通过以下命令用源程序 pos_conf.c (见程序 1 )来创建动态库 libpos.so ,详细创建过程请参考文 [1] 。
# gcc -c pos_conf.c
# gcc -shared -fPCI -o libpos.so pos_conf.o
#
#include <stdio.h>
void pos()
{
printf("/root/test/conf/lib/n");
}
程序 1: pos_conf.c
接着通过以下命令编译 main.c (见程序 2 )生成目标程序 pos 。
# gcc -o pos main.c -L. -lpos
#
void pos();
int main()
{
pos();
return 0;
}
程序 2: main.c
然后把库文件移动到目录 /root/test/conf/lib 中。
# mkdir -p /root/test/conf/lib
# mv libpos.so /root/test/conf/lib
#
最后编辑配置文件 /etc/ld.so.conf ,在该文件中追加一行 "/root/test/conf/lib" 。
运行程序 pos 试试。
# ./pos
./pos: error while loading shared libraries: libpos.so: cannot open shared object file: No such file or directory
#
出错了,系统未找到动态库 libpos.so 。找找原因,原来在编辑完配置文件 /etc/ld.so.conf 后,没有运行命令 ldconfig,所以刚才的修改还未生效。我们运行 ldconfig 后再试试。
# ldconfig
# ./pos
/root/test/conf/lib
#
程序 pos 运行成功,并且打印出正确结果。
方法二:通过环境变量 LD_LIBRARY_PATH 指定动态库搜索路径。
通过设定环境变量 LD_LIBRARY_PATH 也可以指定动态库搜索路径。当通过该环境变量指定多个动态库搜索路径时,路径之间用冒号 " : " 分隔。下面通过例 2 来说明本方法。
例 2 :
我们通过以下命令用源程序 pos_env.c (见程序 3 )来创建动态库 libpos.so 。
# gcc -c pos_env.c
# gcc -shared -fPCI -o libpos.so pos_env.o
#
#include <stdio.h>
void pos()
{
printf("/root/test/env/lib/n");
}
程序 3: pos_env.c
测试用的可执行文件 pos 可以使用例 1 中的得到的目标程序 pos ,不需要再次编译。因为 pos_conf.c 中的函数 pos 和pos_env.c 中的函数 pos 函数原型一致,且动态库名相同,这就好比修改动态库 pos 后重新创建该库一样。这也是使用动态库的优点之一。
然后把动态库 libpos.so 移动到目录 /root/test/conf/lib 中。
# mkdir -p /root/test/env/lib
# mv libpos.so /root/test/env/lib
#
我们可以使用 export 来设置该环境变量,在设置该环境变量后所有的命令中,该环境变量都有效。
例如:
# export LD_LIBRARY_PATH=/root/test/env/lib
#
但本文为了举例方便,使用另一种设置环境变量的方法,既在命令前加环境变量设置,该环境变量只对该命令有效,当该命令执行完成后,该环境变量就无效了。如下述命令:
# LD_LIBRARY_PATH=/root/test/env/lib ./pos
/root/test/env/lib
#
程序 pos 运行成功,并且打印的结果是 "/root/test/env/lib" ,正是程序 pos_env.c 中的函数 pos 的运行结果。因此程序 pos 搜索到的动态库是 /root/test/env/lib/libpos.so 。
方法三:在编译目标代码时指定该程序的动态库搜索路径。
还可以在编译目标代码时指定程序的动态库搜索路径。 -Wl, 表示后面的参数将传给 link 程序 ld (因为 gcc 可能会自动调用 ld )。这里通过 gcc 的参数 "-Wl,-rpath," 指定(如例 3 所示)。当指定多个动态库搜索路径时,路径之间用冒号 " :" 分隔。
例 3 :
我们通过以下命令用源程序 pos.c (见程序 4 )来创建动态库 libpos.so 。
# gcc -c pos.c
# gcc -shared -fPCI -o libpos.so pos.o
#
#include <stdio.h>
void pos()
{
printf(".//n");
}
程序 4: pos.c
因为我们需要在编译目标代码时指定可执行文件的动态库搜索路径,所以需要用 gcc 命令重新编译源程序 main.c( 见程序 2)来生成可执行文件 pos 。
# gcc -o pos main.c -L. -lpos -Wl,-rpath,./
#
再运行程序 pos 试试。
# ./pos
./
#
程序 pos 运行成功,输出的结果正是 pos.c 中的函数 pos 的运行结果。因此程序 pos 搜索到的动态库是 ./libpos.so 。
example:
gcc -Wl,-rpath,/home/arc/test,-rpath,/lib/,-rpath,/usr/lib/,-rpath,/usr/local/lib test.c
以上介绍了三种指定动态库搜索路径的方法,加上默认的动态库搜索路径 /lib 和 /usr/lib ,共五种动态库的搜索路径,那么它们搜索的先后顺序是什么呢?
在介绍上述三种方法时,分别创建了动态库 ./libpos.so 、 /root/test/env/lib/libpos.so 和/root/test/conf/lib/libpos.so 。我们再用源程序 pos_lib.c (见程序 5 )来创建动态库 /lib/libpos.so ,用源程序pos_usrlib.c (见程序 6 )来创建动态库 /usr/lib/libpos.so 。
#include <stdio.h>
void pos()
{
printf("/lib/n");
}
程序 5: pos_lib.c
#include <stdio.h>
void pos()
{
printf("/usr/lib/n");
}
程序 6: pos_usrlib.c
这 样我们得到五个动态库 libpos.so ,这些动态库的名字相同,且都包含相同函数原型 的公用函数 pos 。但存储的位置不同和公用函数 pos 打印的结果不同。每个动态库中的公用函数 pos 都输出该动态库所存放的位置。这样我们可以通过执行例3 中的可执行文件 pos 得到的结果不同获知其搜索到了 哪个动态库,从而获得第 1 个动态库搜索顺序,然后删除该动态库,再执行程序 pos ,获得第 2 个动态库搜索路径,再删除第 2 个被搜索到的动态库,如此往复, 将可得到 Linux 搜索动态库的先后顺序。 程序 pos 执行的输出结果和搜索到的动态库的对应关系如表 1 所示:
程序 pos 输出结果 | 使用的动态库 | 对应的动态库搜索路径指定方式 |
./ | ./libpos.so | 编译目标代码时指定的动态库搜索路径 |
/root/test/env/lib | /root/test/env/lib/libpos.so | 环境变量 LD_LIBRARY_PATH 指定的动态库搜索路径 |
/root/test/conf/lib | /root/test/conf/lib/libpos.so | 配置文件 /etc/ld.so.conf 中指定的动态库搜索路径 |
/lib | /lib/libpos.so | 默认的动态库搜索路径 /lib |
/usr/lib | /usr/lib/libpos.so | 默认的动态库搜索路径 /usr/lib |
表 1: 程序 pos 输出结果和动态库的对应关系
创建各个动态库,并放置在相应的目录中。测试环境就准备好了。执行程序 pos ,并在该命令行中设置环境变量LD_LIBRARY_PATH 。
# LD_LIBRARY_PATH=/root/test/env/lib ./pos
./
#
根据程序 pos 的输出结果可知,最先搜索的是编译目标代码时指定的动态库搜索路径。然后我们把动态库 ./libpos.so 删除了,再运行上述命令试试。
# rm libpos.so
rm: remove regular file `libpos.so'? y
# LD_LIBRARY_PATH=/root/test/env/lib ./pos
/root/test/env/lib
#
根据程序 pos 的输出结果可知,第 2 个动态库搜索的路径是环境变量 LD_LIBRARY_PATH 指定的。我们再把/root/test/env/lib/libpos.so 删除,运行上述命令。
# rm /root/test/env/lib/libpos.so
rm: remove regular file `/root/test/env/lib/libpos.so'? y
# LD_LIBRARY_PATH=/root/test/env/lib ./pos
/root/test/conf/lib
#
第 3 个动态库的搜索路径是配置文件 /etc/ld.so.conf 指定的路径。删除动态库 /root/test/conf/lib/libpos.so 后再运行上述命令。
# rm /root/test/conf/lib/libpos.so
rm: remove regular file `/root/test/conf/lib/libpos.so'? y
# LD_LIBRARY_PATH=/root/test/env/lib ./pos
/lib
#
第 4 个动态库的搜索路径是默认搜索路径 /lib 。我们再删除动态库 /lib/libpos.so ,运行上述命令。
# rm /lib/libpos.so
rm: remove regular file `/lib/libpos.so'? y
# LD_LIBRARY_PATH=/root/test/env/lib ./pos
/usr/lib
#
最后的动态库搜索路径是默认搜索路径 /usr/lib 。
综合以上结果可知,动态库的搜索路径搜索的先后顺序是:
1. 编译目标代码时指定的动态库搜索路径;
2. 环境变量 LD_LIBRARY_PATH 指定的动态库搜索路径;
3. 配置文件 /etc/ld.so.conf 中指定的动态库搜索路径;
4. 默认的动态库搜索路径 /lib ;
5. 默认的动态库搜索路径 /usr/lib 。
在上述 1 、 2 、 3 指定动态库搜索路径时,都可指定多个动态库搜索路径,其搜索的先后顺序是按指定路径的先后顺序搜索的。对此本文不再举例说明,有兴趣的读者可以参照本文的方法验证。