OS X 下动态库的引用
foo.c
#include <stdio.h> void foo(void) { printf("foo.\n"); }
main.c
#include <stdio.h> extern void foo(void); int main(void) { foo(); printf("main.\n"); return 0; }
编译执行
$ gcc -dynamiclib foo.c -o libfoo.dylib
(-dynamiclib 表示将foo.c编译成一个动态库,
-o libfoo.dylib 用于指定生成的动态库的名称)
$ gcc main.c -L. -lfoo -o main
(-L. 指定当前目录为链接时动态库的查找目录,
-lfoo 指定要链接的动态库为libfoo.dylib,
-o main 指定生成的可执行文件名称为main)
$ ./main
foo.
main.
(在当前目录下执行main,注意要加上 ./)
两种引用
动态库的引用分为链接时引用与运行时引用两种情况。
-L. -lfoo 表示在链接时引用当前目录下的libfoo.dylib,
如果我们把libfoo.dylib移到上一层目录:
$ mv libfoo.dylib ..
这时再次链接:
$ gcc main.c -L. -lfoo -o main
ld: library not found for -lfoo
clang: error: linker command failed with exit code 1 (use -v to see invocation)
会提示出错,再将动态库移回:
$ mv ../libfoo.dylib .
再次链接:
$ gcc main.c -L. -lfoo -o main
执行成功。
在执行上述链接过程时,编译器顺便将动态库libfoo.dylib的install_name记录到了main程序中,
用来在运行时查找并引用该动态库,
查看动态库libfoo.dylib的install_name,运行:
$ otool -D libfoo.dylib
libfoo.dylib:
libfoo.dylib
显示出libfoo.dylib的install_name是libfoo.dylib,
查看一下main程序中记录的install_name是否与此一致:
$ otool -L main
main:
libfoo.dylib (compatibility version 0.0.0, current version 0.0.0)
/usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 1213.0.0)
第一条就是动态库libfoo.dylib对应的install_name,显然两者是一致的,main程序在运行时会根据记录的这些install_name在文件系统中查找所依赖的动态库。
关于install_name
(注意:只有动态库才有install_name,应用程序如果引用了某一个动态库,则会在链接时记录该动态库的install_name。)
在链接时,是可以为动态库指定一个install_name的:
$ gcc -dynamiclib foo.c -install_name aaa -o libfoo.dylib
将该动态库的install_name指定为aaa了,如不放心,可以查看一下:
$ otool -D libfoo.dylib
libfoo.dylib:
aaa
确实为aaa。(注意:如不指定,则会有一个缺省值,如libfoo.dylib)
重新编译main程序:
$ gcc main.c -L. -lfoo -o main
查看一下main程序中记录的install_name:
$ otool -L main
main:
aaa (compatibility version 0.0.0, current version 0.0.0)
/usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 1213.0.0)
果然是aaa。这时再次运行main程序:
$ ./main
dyld: Library not loaded: aaa
Referenced from: /private/tmp/dylib/./main
Reason: image not found
Trace/BPT trap: 5
出错了,提示找不到动态库aaa,这是因为main程序把aaa当成一个路径,而当前路径下确实没有叫aaa的动态库,
我们可以把libfoo.dylib改名为aaa:
$ mv libfoo.dylib aaa
再次运行:
$ ./main
foo.
main.
正常。
install_name_tool
顾名思义,install_name_tool就是用来操作install_name的工具,
它既可以改变动态库自身的install_name,也可以改变应用程序中记录的所引用动态库的install_name。
首先将动态库名称由aaa改为bbb:
$ mv aaa bbb
查看一下动态库的install_name:
$ otool -D bbb
bbb:
aaa
还是之前指定的aaa。
现在我们利用install_name_tool把动态库的install_name也改为bbb:
$ install_name_tool -id bbb bbb
(前一个bbb表示我们指定的install_name,后一个bbb表示动态库文件名)
查看一下修改之后的结果:
$ otool -D bbb
bbb:
bbb
果然改成了bbb。
这时再查看一下main程序中记录的install_name:
$ otool -L main
main:
aaa (compatibility version 0.0.0, current version 0.0.0)
/usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 1213.0.0)
还是之前的aaa,显然如果这时运行main程序还是会失败,因为当前路径下没有叫aaa的动态库文件,
下面我们就将main程序中记录的aaa改为bbb:
$ install_name_tool -change aaa bbb main
(aaa是旧的名称,bbb是新的名称,main表示要操作的文件名称)
查看一下结果:
$ otool -L main
main:
bbb (compatibility version 0.0.0, current version 0.0.0)
/usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 1213.0.0)
修改成功,这时再运行一下main程序:
$ ./main
foo.
main.
运行成功。
现在动态库bbb是和main程序在同一个目录,如果把bbb移到/tmp目录:
$ mv bbb /tmp
我们只需要将main程序中记录的bbb改为/tmp/bbb:
$ install_name_tool -change bbb /tmp/bbb main
查看一下结果:
$ otool -L main
main:
/tmp/bbb (compatibility version 0.0.0, current version 0.0.0)
/usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 1213.0.0)
这样也是可以运行的:
$ ./main
foo.
main.
相对路径也是可以的,现在把tmp目录下的bbb移到当前路径下的temp目录:
$ mkdir temp
$ mv /tmp/bbb temp/
我们只需要将main程序中记录的/tmp/bbb改为./temp/bbb:
$ install_name_tool -change /tmp/bbb ./temp/bbb main
查看一下结果:
$ otool -L main
main:
./temp/bbb (compatibility version 0.0.0, current version 0.0.0)
/usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 1213.0.0)
这样也是可以运行的:
$ ./main
foo.
main.
@executable_path/
@loader_path/
@rpath/
这三个path是用来表示路径的变量,它们可以用于install_name中,如:
@executable_path/../Frameworks/libAAA.dylib
@loader_path/libBBB.dylib
@rpath/libCCC.dylib
(注意:在使用这三个变量时,后面的“/”不能少。)
@executable_path/
.
├── Frameworks
│ ├── bar.c
│ └── foo.c
└── MacOS
└── main.c
MacOS/main.c
#include <stdio.h>
extern void foo(void);
extern void bar(void);
int main(void)
{
foo();
bar();
printf("main.\n");
return 0;
}
Frameworks/foo.c
#include <stdio.h>
void foo(void)
{
printf("foo.\n");
}
Frameworks/bar.c
#include <stdio.h>
void bar(void)
{
printf("bar.\n");
}
先把foo.c和bar.c做成动态库:
$ gcc foo.c -dynamiclib -install_name @executable_path/../Frameworks/libfoo.dylib -o libfoo.dylib
$ gcc bar.c -dynamiclib -install_name @executable_path/../Frameworks/libbar.dylib -o libbar.dylib
然后利用两个动态库编译main.c:
$ gcc main.c -L../Frameworks -lfoo -lbar -o main
查看一下main程序引用的动态库:
$ otool -L main
main:
@executable_path/../Frameworks/libfoo.dylib (compatibility version 0.0.0, current version 0.0.0)
@executable_path/../Frameworks/libbar.dylib (compatibility version 0.0.0, current version 0.0.0)
/usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 1213.0.0)
@executable_path/在运行时会替换成当前程序(也就是main程序)所在路径,
我们之前做的动态库文件libfoo.dylib、libbar.dylib正好存在于Frameworks目录下,所以该程序可以运行:
$ ./main
foo.
bar.
main.
@loader_path/
.
├── A
│ ├── B
│ │ └── bar.c
│ └── foo.c
└── main.c
main.c
#include <stdio.h>
extern void foo(void);
int main(void)
{
foo();
printf("main.\n");
return 0;
}
A/foo.c
#include <stdio.h>
extern void bar(void);
void foo(void)
{
bar();
printf("foo.\n");
}
A/B/bar.c
#include <stdio.h>
void bar(void)
{
printf("bar.\n");
}
先将bar.c编译成动态库:
$ gcc bar.c -dynamiclib -install_name @loader_path/B/libbar.dylib -o libbar.dylib
再将foo.c编译成动态库(用到了libbar.dylib):
$ gcc foo.c -dynamiclib -LB -lbar -install_name @executable_path/A/libfoo.dylib -o libfoo.dylib
最后再编译main程序(用到了libfoo.dylib):
$ gcc main.c -LA -lfoo -o main
执行:
$ ./main
bar.
foo.
main.
main程序依赖于libfoo.dylib,@executable_path/就是main程序的执行路径,
所以libfoo.dylib的install_name设置为@executable_path/A/libfoo.dylib正合适。
libfoo.dylib依赖于libbar.dylib,@loader_path/就是libfoo.dylib的加载路径,
所以libbar.dylib的install_name设置为@loader_path/B/libbar.dylib正合适。
(如果用@executable_path/,则可设置为@executable_path/A/B/libbar.dylib)
@rpath/
一个应用程序只有一个@executable_path/,可能有多个@loader_path/。
@executable_path/表示应用程序执行时路径,@loader_path/表示动态库(包括应用程序)加载时路径,
程序执行时,这两个路径由系统赋值。然而@rpath/则是由用户随意赋值,比前者更为灵活。
.
├── A
├── B
├── C
├── foo.c
└── main.c
main.c
#include <stdio.h>
extern void foo(void);
int main(void)
{
foo();
printf("main.\n");
return 0;
}
foo.c
#include <stdio.h>
void foo(void)
{
printf("foo.\n");
}
首先编译动态库,把@rpath/加入到install_name中:
$ gcc foo.c -dynamiclib -install_name @rpath/libfoo.dylib -o libfoo.dylib
然后编译应用程序,并添加自定义rpath
$ gcc main.c -L. -lfoo -Wl,-rpath,@loader_path/A/ -Wl,-rpath,@loader_path/B/ -Wl,-rpath,@loader_path/C/ -o main
我们可以用命令查看一下这三个rpath:
$ otool -l main | grep path
name @rpath/libfoo.dylib (offset 24)
path @loader_path/A/ (offset 12)
path @loader_path/B/ (offset 12)
path @loader_path/C/ (offset 12)
第一行name表示main程序记录的动态库的install_name,后面三个path组成了rpath列表,
运行时@rpath/就被依次替换成了@loader_path/A/ 、@loader_path/B/ 、 @loader_path/C/,
@loader_path/又最终被替换成了动态库(或应用程序)的加载路径。
将libfoo.dylib分别移动到A、B、C三个目录,测试main程序是否可以正常运行:
$ mv libfoo.dylib A/
$ ./main
foo.
main.
$ mv A/libfoo.dylib B/
$ ./main
foo.
main.
$ mv B/libfoo.dylib C/
$ ./main
foo.
main.
Edit By MaHua