用Gcc制作Library

Library 可分成三种, static 、 shared 与 dynamically loaded 。
1. Static libraries
Static 链接库用于静态链接,简单讲是把一堆 object 檔用 ar(archiver) 包装集合起来,文件名以 `.a' 结尾。优点是执行效能通常会比后两者快,而且因为是静态链接,所以不易发生执行时找不到 library 或版本错置而无法执行的问题。缺点则是档案较大,维护度较低;例如 library 如果发现 bug 需要更新,那么就必须重新连结执行档。
1.1 编译
编译方式很简单,先例用 `-c' 编出 object 檔,再用 ar 包起来即可。
____ hello.c ____
#include
void hello(){ printf("Hello "); }
____ world.c ____
#include
void world(){ printf("world."); }
____ mylib.h ____
void hello();
void world();
$ gcc -c hello.c world.c /* 编出 hello.o 与 world.o */
$ ar rcs libmylib.a hello.o world.o /* 包成 limylib.a */
这样就可以建出一个档名为 libmylib.a 的檔。输出的档名其实没有硬性规定,但如果想要配合 gcc 的 '-l' 参数来连结,一定要以 `lib' 开头,中间是你要的 library 名称,然后紧接着 `.a' 结尾。
1.2 使用
____ main.c ____
#include "mylib.h"
int main() {
hello();
world();
}
使用上就像与一般的 object 档连结没有差别。
$ gcc main.c libmylib.a
也可以配合 gcc 的 `-l' 参数使用
$ gcc main.c -L. -lmylib
`-Ldir' 参数用来指定要搜寻链接库的目录, `.' 表示搜寻现在所在的目录。通常默认会搜 /usr/lib 或 /lib 等目录。
`-llibrary' 参数用来指定要连结的链接库 , 'mylib' 表示要与 mylib 进行连结,他会搜寻 library 名称前加 `lib' 后接 `.a' 的档案来连结。
$ ./a.out
Hello world.

2. Shared libraries
Shared library 会在程序执行起始时才被自动加载。因为链接库与执行档是分离的,所以维护弹性较好。有两点要注意, shared library 是在程序起始时就要被加载,而不是执行中用到才加载,而且在连结阶段需要有该链接库才能进行连结。
首先有一些名词要弄懂, soname 、 real name 与 linker name 。
soname 用来表示是一个特定 library 的名称,像是 libmylib.so.1 。前面以 `lib' 开头,接着是该 library 的名称,然后是 `.so' ,接着
是版号,用来表名他的界面;如果接口改变时,就会增加版号来维护兼容度。
real name 是实际放有 library 程序的文件名,后面会再加上 minor 版号与
release 版号,像是 libmylib.so.1.0.0 。
一般来说,版号的改变规则是 ( 印象中在 APress-Difinitive Guide to GCC 中有提到,但目前手边没这本书 ) ,最后缀的 release 版号用于程序内容的修正,接口完全没有改变。中间的 minor 用于有新增加接口,但相旧接口没改变,所以与旧版本兼容。最前面的 version 版号用于原接口有移除或改变,与旧版不兼容时。
linker name 是用于连结时的名称,是不含版号的 soname ,如 : libmylib.so 。
通常 linker name 与 real name 是用 ln 指到对应的 real name ,用来提供弹性与维护性。
2.1 编译
shared library 的制作过程较复杂。
$ gcc -c -fPIC hello.c world.c
编译时要加上 -fPIC 用来产生 position-independent code 。也可以用 -fpic 参数。 ( 不太清楚差异,只知道 -fPIC 较通用于不同平台,但产生的 code 较大,而且编译速度较慢 ) 。
$ gcc -shared -Wl,-soname,libmylib.so.1 -o libmylib.so.1.0.0 \
hello.o world.o
-shared 表示要编译成 shared library
-Wl 用于参递参数给 linker ,因此 -soname 与 libmylib.so.1 会被传给 linker 处理。
-soname 用来指名 soname 为 limylib.so.1
library 会被输出成 libmylib.so.1.0.0 ( 也就是 real name)
若不指定 soname 的话,在编译结连后的执行档会以连时的 library 档名为 soname ,并载入他。否则是载入 soname 指定的 library 档案。
可以利用 objdump 来看 library 的 soname 。
$ objdump -p libmylib.so | grep SONAME
SONAME libmylib.so.1
若不指名 -soname 参数的话,则 library 不会有这个字段数据。
在编译后再用 ln 来建立 soname 与 linker name 两个档案。
$ ln -s libmylib.so.1.0.0 libmylib.so
$ ln -s libmylib.so.1.0.0 libmylib.so.1

2.2 使用
与使用 static library 同。
$ gcc main.c libmylib.so
以上直接指定与 libmylib.so 连结。
或用
$ gcc main.c -L. -lmylib
linker 会搜寻 libmylib.so 来进行连结。
如果目录下同时有 static 与 shared library 的话,会以 shared 为主。
使用 -static 参数可以避免使用 shared 连结。
$ gcc main.c -static -L. -lmylib
此时可以用 ldd 看编译出的执行档与 shared 链接库的相依性
$ldd a.out
linux-gate.so.1 => (0xffffe000)
libmylib.so.1 => not found
libc.so.6 => /lib/libc.so.6 (0xb7dd6000)
/lib/ld-linux.so.2 (0xb7f07000)
输出结果显示出该执行文件需要 libmylib.so.1 这个 shared library 。
会显示 not found 因为没指定该 library 所在的目录,所找不到该 library 。
因为编译时有指定 -soname 参数为 libmylib.so.1 的关系,所以该执行档会加载 libmylib.so.1 。否则以 libmylib.so 连结,执行档则会变成要求加载 libmylib.so
$ ./a.out
./a.out: error while loading shared libraries: libmylib.so.1:
cannot open shared object file: No such file or directory
因为找不到 libmylib.so.1 所以无法执行程序。
有几个方式可以处理。
a. 把 libmylib.so.1 安装到系统的 library 目录,如 /usr/lib 下
b. 设定 /etc/ld.so.conf ,加入一个新的 library 搜寻目录,并执行 ldconfig
更新快取
c. 设定 LD_LIBRARY_PATH 环境变量来搜寻 library
这个例子是加入当前目录来搜寻要载作的 library
$ LD_LIBRARY_PATH=. ./a.out
Hello world.
3. Dynamically loaded libraries
Dynamicaaly loaded libraries 才是像 windows 所用的 DLL ,在使用到
时才加载,编译连结时不需要相关的 library 。动态载入库常被用于像 plug-ins
的应用。
3.1 使用方式
动态加载是透过一套 dl function 来处理。
#include
void *dlopen(const char *filename, int flag);
开启加载 filename 指定的 library 。
void *dlsym(void *handle, const char *symbol);
取得 symbol 指定的 symbol name 在 library 被加载的内存地址。
int dlclose(void *handle);
关闭 dlopen 开启的 handle 。
char *dlerror(void);
传回最近所发生的错误讯息。
____ dltest.c ____
#include <stdio.h>
#include <stdlib.h>
#include <stddef.h>
#include <dlfcn.h>
int main() {
void *handle;
void (*f)();
char *error;
/* 开启之前所撰写的 libmylib.so 链接库 */
handle = dlopen("./libmylib.so", RTLD_LAZY);
if( !handle ) {
fputs( dlerror(), stderr);
exit(1);
}
/* 取得 hello function 的 address */
f = dlsym(handle, "hello");
if(( error=dlerror())!=NULL) {
fputs(error, stderr);
exit(1);
}
/* 呼叫该 function */
f();
dlclose(handle);
}
编译时要加上 -ldl 参数来与 dl library 连结
$ gcc dltest.c -ldl
结果会印出 Hello 字符串
$ ./a.out
Hello
关于 dl 的详细内容请参阅 man dlopen
--
参考数据 :
Creating a shared and static library with the gnu compiler [gcc]
http://www.adp-gmbh.ch/cpp/gcc/create_lib.html
Program Library HOWTO
http://tldp.org/HOWTO/Program-Library-HOWTO/index.html
APress - Definitive Guide to GCC
------------------------------------------------------------------------------------------------------------------
Makefile

GCC=gcc
CFLAGS=-Wall -fPIC
all: libmylib
libmylib:hello.o    world.o
    $(GCC) -shared -Wl,-soname,libmylib.so.1 -o libmylib.so.1.0.0 hello.o world.o
    ln -sf libmylib.so.1.0.0 libmylib.so
    ln -sf libmylib.so.1.0.0 libmylib.so.1
%.o:%.c
    $(GCC) -c $(CFLAGS) -o $@ $<
clean:
    rm -fr *.o
    rm -fr *.so*

作者: inolddays   发布时间: 2010-11-17