linux动态库编译和使用详细剖析
引言
重点讲述linux上使用gcc编译动态库的一些操作.并且对其深入的案例分析.
最后介绍一下动态库插件技术, 让代码向后兼容.关于linux上使用gcc基础编译,
预编译,编译,生成机械码最后链接输出可执行文件流程参照下面.
gcc编译流程 http://www.jb51.net/article/46407.htm
而本文重点是分析动态库相关的知识点. 首先看需要用到的测试素材
heoo.h
#ifndef _H_HEOO #define _H_HEOO /* * 测试接口,得到key内容 * : 返回key的字符串 */ extern const char* getkey(void); /* * 测试接口,得到value内容 * arg : 传入的参数 * : 返回得到的结果 */ extern void* getvalue(void* arg); #endif // !_H_HEOO
heoo-getkey.c
#include "heoo.h"
/*
* 测试接口,得到key内容
* : 返回key的字符串
*/
const char*
getkey(void) {
return "heoo-getkey.c getkey";
}
heoo-getvalue.c
#include "heoo.h"
#include <stdio.h>
/*
* 测试接口,得到value内容
* arg : 传入的参数
* : 返回得到的结果
*/
const void*
getvalue(void* arg) {
const char* key = "heoo-getvalue.c getvalue";
printf("%s - %s
", key, (void*)arg);
return key;
}
heoo.c
#include "heoo.h"
#include <stdio.h>
/*
* 测试接口,得到key内容
* : 返回key的字符串
*/
const char*
getkey(void) {
return "heoo.c getkey";
}
/*
* 测试接口,得到value内容
* arg : 传入的参数
* : 返回得到的结果
*/
const void*
getvalue(void* arg) {
const char* key = "heoo.c getvalue";
printf("%s - %s
", key, (char*)arg);
return key;
}
main.c
#include <stdio.h>
#include "heoo.h"
// 测试逻辑主函数
int main(int argc, char* argv[]) {
// 简单的打印数据
printf("getkey => %s
", getkey());
getvalue(NULL);
return 0;
}
到这里也许感觉有点臃肿, 但是理解为什么是必要的. 会让你对于动态库高度高上0.01毫米的.哈哈.
先让上面代码跑起来.
gcc -g -Wall -o main.out main.c heoo.c
测试结果如下
测试完成,那就开始静态库到动态库扩展之旅.
前言
从静态库说起来
首先参照下面编译语句
gcc -c -o heoo-getkey.o heoo-getkey.c gcc -c -o heoo-getvalue.o heoo-getvalue.c
对于静态库创建本质就是打包. 所以用linux上一个 ar创建静态库压缩命令.详细用法可以看
ar详细用法参照 http://blog.163.com/xychenbaihu@yeah/blog/static/132229655201121093917552/
那么我们开始制作静态库
ar rcs libheoo.a heoo-getvalue.o heoo-getkey.o
那么我们采用静态库执行编译上面main.c 函数
gcc -g -Wall -o main.out main.c -L. -lheoo
运行的截图如下
运行一切正常. 对于静态库编译 简单说明一下. ar 后面的 rcs表示 替换创建和添加索引. 具体的看上面的网址.
后面gcc中 -L表示查找库的目录, -l表示搜索的 libheoo库. 还有其它的-I表示查找头文件地址, -D表示添加全局宏.......
对于上面静态库编译还有一种方式如下
gcc -g -Wall -o main.out main.c libheoo.a
执行结果也是一样的.可以将 *.a 理解成多个 *.o合体.
好到这里前言就说完了.那我们开始说正题动态库了.
正文
动态库的构建和使用
动态库构建命名如下,仍然以heoo.c heoo.h 为例
gcc -shared -fPIC -o libheoo.so heoo.c
开始编译代码 先介绍一种最简单的有点类似上面静态库最后一种方式.
gcc -g -Wall -o main.out main.c ./libheoo.so
这里是显式编译. 结果如下
对于 上面编译 动态库的时候如果 直接使用 libheoo.so. 例如
gcc -g -Wall -o main.out main.c libheoo.so
如果没有配置动态库路径, 查找动态库路径会出问题. 这里就不复现了(因为我把环境调好了). 会面会给出解决办法.
下面说libheoo.so 标准的使用方式
gcc -g -Wall -o main.out main.c -L. -lheoo
运行结果如下
上面是个常见错误, 系统找不见动态库在那. 需要配置一下, 再编译参照如下
export LD_LIBRARY_PATH="$LD_LIBRARY_PATH;./" gcc -g -Wall -o main.out main.c -L. -lheoo
上面第一句话是在当前会话层. 添加库查找路径,包含当前文件目录.这个会话层关闭了就失效了. Linux上shell确实很重要. 现在执行结果
到这里动态库的也都完毕了. 一切正常.
一个奇巧淫技
问: gcc -l 链接一个库的时候,但是库中存在同名的静态库和动态库. 会链接到那个库?
通过上面的那么多测试应该知道是动态库吧,因为使用动态库会报错.使用静态库没有事.
那么问题来了, 我想使用静态库怎么办.
-static
上面gcc 选项可以帮助我们强制链接静态库!
动态库的显示使用
到这里基本上是重头戏了. 扯一点,这些知识点在window也一样知识环境变了,设置变了.链接编译显式加载都有的. 下面是重新操作的代码.
heooso.c
#include <stdio.h>
#include <dlfcn.h>
#define _STR_PATH "./libheoo.so"
// 显示调用动态库, 需要 -ldl 链接程序库
int main(int argc, char* argv[]) {
const char* (*getkey)(void);
const void* (*getvalue)(void* arg);
/*
* 对于dlopen 函数第二个参数
* RTLD_NOW：将共享库中的所有函数加载到内存
* RTLD_LAZY：会推后共享库中的函数的加载操作，直到调用dlsym()时方加载某函数
*/
void* handle = dlopen(_STR_PATH, RTLD_LAZY);
// 下面得到错误信息,是一种小心的变成方式,每次都检测一下错误是否存在
const char* err = dlerror();
if(!handle || err) {
fprintf(stderr, "dlopen " _STR_PATH " no open! err = %s
", err);
return -1;
}
getkey = dlsym(handle, "getkey");
if((err = dlerror())){
fprintf(stderr, "getkey err = %s
", err);
dlclose(handle);
return -2;
}
puts(getkey());
//这种显式调用dll代码,很不安全代码注入太简单了
getvalue = dlsym(handle, "getvalue");
if((err = dlerror())){
fprintf(stderr, "getvalue err = %s
", err);
dlclose(handle);
return -3;
}
puts(getvalue(NULL));
dlclose(handle);
return 0;
}
编译代码
gcc -g -Wall -o heooso.out heooso.c -ldl
测试结果截图如下
运行一切正常. 功能是实现了.但是大家千万别这么用.否则还是比较危险的.也是一种编程思路吧.后面
后记会写一个向后兼容的插件机制. 大家可以观摩一下. 方便更深入的了解Linux系统开发.算是一个简易的
Linux运用插件技术的小项目吧.
后记
错误是难免的,欢迎吐槽. 最后献上一个linux上如何通过动态库运行时加载插件的案例.麻雀虽小,五脏俱全.
Makefile
CC = gcc
DEBUG = -g -Wall
LIB = -ldl
RUNSO = $(CC) -fPIC -shared -o $@ $^
RUN = $(CC) $(DEBUG) -o $@ $^
#总的任务
all:libheoo.so libheootwo.so libheoothree.so main.out
#简单lib%.so生成
libheoo.so:heoo.c
$(RUNSO)
libheootwo.so:heootwo.c
$(RUNSO)
libheoothree.so:heoothree.c
$(RUNSO)
#生成的主要内容
main.out:main.c
$(RUN) $(LIB)
# 简单的清除操作 make clean
.PHONY:clean
clean:
rm -rf *.so *.s *.i *.o *.out *~ ; ls -hl
heoo.h
#ifndef _H_HEOO #define _H_HEOO /* * 测试接口,得到key内容 * : 返回key的字符串 */ extern const char* getkey(void); /* * 测试接口,得到value内容 * arg : 传入的参数 * : 返回得到的结果 */ extern const void* getvalue(void* arg); #endif // !_H_HEOO
heootwo.c
#include "heoo.h"
#include <stdio.h>
/*
* 测试接口,得到key内容
* : 返回key的字符串
*/
const char*
getkey(void) {
return "heootwo.c getkey";
}
/*
* 测试接口,得到value内容
* arg : 传入的参数
* : 返回得到的结果
*/
const void*
getvalue(void* arg) {
const char* key = "heootwo.c getvalue";
printf("%s - %s
", key, (char*)arg);
return key;
}
heoothree.c
#include "heoo.h"
#include <stdio.h>
/*
* 测试接口,得到key内容
* : 返回key的字符串
*/
const char*
getkey(void) {
return "heoothree.c getkey";
}
/*
* 测试接口,得到value内容
* arg : 传入的参数
* : 返回得到的结果
*/
const void*
getvalue(void* arg) {
const char* key = "heoothree.c getvalue";
printf("%s - %s
", key, (char*)arg);
return key;
}
main.c
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <stdbool.h>
#include <errno.h>
#include <unistd.h>
#include <dirent.h>
#include <dlfcn.h>
//塞入的句柄数
#define _INT_HND (3)
// 最多支持108个插件
#define _INT_LEN (108)
// 文件路径最大长度
#define _INT_BUF (512)
// 处理dll,并且将返回的数据保存在a[_INT_HND]中, 这个数组长度必须是
bool dll_add(void* a[], const char* dllpath);
// 处理指定目录得到结果塞入a中, nowpath为NULL表示当前目录
int dll_new(void* a[][_INT_HND], int len, const char* nowpath);
// 释放资源
void dll_del(void* a[][_INT_HND], int len);
/*
* 动态加载机制
*/
int main(int argc, char* argv[]) {
int idx, len, i;
void* a[_INT_LEN][_INT_HND];
// 当前目录下,处理结果
len = dll_new(a, _INT_LEN, NULL);
if(len == 0){
fprintf(stderr, "感谢使用,没有发现合法插件内容!
");
exit(1);
}
//数据展示
puts("------------------------------ 欢迎使用main插件 ----------------------------------");
for(i=0; i<len; ++i){
const char* (*getkey)(void) = a[i][1];
printf(" %d => %s
", i, getkey());
}
printf(" 请输入 待执行的 索引[0, %d)
", len);
if(scanf("%d", &idx)!=1 || idx<0 || idx >= len){
puts(" fake 错误的命令,程序退出中!");
goto __exit;
}
puts(" 执行结果如下:");
const void* (*getvalue)(void* arg) = a[idx][2];
puts(getvalue(NULL));
__exit:
puts("------------------------------ 谢谢使用main插件 ----------------------------------");
dll_del(a, len);
return 0;
}
// 处理dll,并且将返回的数据保存在a[_INT_HND]中, 这个数组长度必须是
bool
dll_add(void* a[], const char* dllpath) {
const char* (*getkey)(void);
const void* (*getvalue)(void* arg);
void* handle = dlopen(dllpath, RTLD_LAZY);
// 下面得到错误信息,是一种小心的变成方式,每次都检测一下错误是否存在
const char* err = dlerror();
if(!handle || err) return false;
getkey = dlsym(handle, "getkey");
if((err = dlerror())){
dlclose(handle);
return false;
}
//这种显式调用dll代码,很不安全代码注入太简单了
getvalue = dlsym(handle, "getvalue");
if((err = dlerror())){
dlclose(handle);
return false;
}
// 句柄, key, value, 协议订的
a[0] = handle;
a[1] = getkey;
a[2] = getvalue;
return true;
}
// 处理指定目录得到结果塞入a中, nowpath为NULL表示当前目录
int
dll_new(void* a[][_INT_HND], int len, const char* nowpath){
int j = 0, rt;
DIR* dir;
struct dirent* ptr;
char path[_INT_BUF];
// 设置默认目录
if(!nowpath || !*nowpath) nowpath = ".";
// 打开目录信息
if((dir = opendir(nowpath)) == NULL) {
fprintf(stderr, "opendir open %s, error:%s
", nowpath, strerror(errno));
exit(-1);
}
//挨个读取文件
while(j<len && (ptr=readdir(dir))){
//只处理文件,包含未知文件
if(DT_BLK == ptr->d_type || DT_UNKNOWN == ptr->d_type){
rt = snprintf(path, _INT_BUF, "%s/%s", nowpath, ptr->d_name);// 只有确实是 *.so 文件才去出去运行
if(rt>3&&rt < _INT_BUF&&path[rt-1]=='o'&&path[rt-2]=='s'&&path[rt-3]=='.') {
// 添加数据 dao数组 a中
if(dll_add(a[j], path))
++j;
}
}
}
closedir(dir);
return j;
}
// 释放资源
void
dll_del(void* a[][_INT_HND], int len) {
int i=-1;
while(++i < len)
dlclose(a[i][0]);
}
最后运行截图
到这里一个小demo就完工了. 关于Linux gcc上动态库插件开发,剖析完毕.O(∩_∩)O哈哈~