学步园

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

所示：

表
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

指定动态库搜索路径时，都可指定多个动态库搜索路径，其搜索的先后顺序是按指定路径的先后顺序搜索的。对此本文不再举例说明，有兴趣的读者可以参照本文的方法验证。

===

关键字: linux操作系统的头文件和库文件搜索路径