Linux 动态库 soname 实践

已于 2022-11-01 16:13:01 修改
阅读量1.5k 收藏 1
点赞数
文章标签： linux
于 2022-10-06 13:12:05 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/KgdYsg/article/details/127179484
版权

xredis

因为项目中使用到了 xredis (C++开发的redis客户端，是对hiredis的C++封装)，在 makefile 中发现使用到了 -Wl,-soname 这个语法，之前没怎么了解过，特此记录

makefile 节选如下：

XREDIS_MAJOR=1
XREDIS_MINOR=10.1

# Fallback to gcc when $CC is not in $PATH.
CC:=g++
OPTIMIZATION?=-O3
WARNINGS=-Wall -W -Wwrite-strings
DEBUG?= -g -ggdb
REAL_CFLAGS=$(OPTIMIZATION) -fPIC $(CFLAGS) $(WARNINGS) $(DEBUG) $(ARCH)
REAL_LDFLAGS=$(LDFLAGS) $(ARCH)

DYLIBSUFFIX=so
STLIBSUFFIX=a
DYLIB_MINOR_NAME=$(LIBNAME).$(DYLIBSUFFIX).$(XREDIS_MAJOR).$(XREDIS_MINOR)
DYLIB_MAJOR_NAME=$(LIBNAME).$(DYLIBSUFFIX).$(XREDIS_MAJOR)
DYLIBNAME=$(LIBNAME).$(DYLIBSUFFIX)
DYLIB_MAKE_CMD=$(CC) -shared -Wl,-soname,$(DYLIB_MINOR_NAME) -o $(DYLIBNAME) $(LDFLAGS)
STLIBNAME=$(LIBNAME).$(STLIBSUFFIX)
STLIB_MAKE_CMD=ar rcs $(STLIBNAME)

尝试 make 一下

[root@localhost xredis-1.10.1]# make
g++ -O3 -fPIC  -Wall -W -Wwrite-strings -g -ggdb  -c src/xRedisClient.cpp -o src/xRedisClient.o
g++ -O3 -fPIC  -Wall -W -Wwrite-strings -g -ggdb  -c src/xRedisClient_keys.cpp -o src/xRedisClient_keys.o
g++ -O3 -fPIC  -Wall -W -Wwrite-strings -g -ggdb  -c src/xRedisClient_sets.cpp -o src/xRedisClient_sets.o
g++ -O3 -fPIC  -Wall -W -Wwrite-strings -g -ggdb  -c src/xRedisClient_strings.cpp -o src/xRedisClient_strings.o
g++ -O3 -fPIC  -Wall -W -Wwrite-strings -g -ggdb  -c src/xRedisClient_connection.cpp -o src/xRedisClient_connection.o
g++ -O3 -fPIC  -Wall -W -Wwrite-strings -g -ggdb  -c src/xRedisClient_hashs.cpp -o src/xRedisClient_hashs.o
g++ -O3 -fPIC  -Wall -W -Wwrite-strings -g -ggdb  -c src/xRedisClient_lists.cpp -o src/xRedisClient_lists.o
g++ -O3 -fPIC  -Wall -W -Wwrite-strings -g -ggdb  -c src/xRedisClient_sortedsets.cpp -o src/xRedisClient_sortedsets.o
g++ -O3 -fPIC  -Wall -W -Wwrite-strings -g -ggdb  -c src/xRedisPool.cpp -o src/xRedisPool.o
g++ -O3 -fPIC  -Wall -W -Wwrite-strings -g -ggdb  -c src/xRedisFunc.cpp -o src/xRedisFunc.o
g++ -shared -Wl,-soname,libxredis.so.1.10.1 -o libxredis.so  src/xRedisClient.o src/xRedisClient_keys.o src/xRedisClient_sets.o src/xRedisClient_strings.o src/xRedisClient_connection.o src/xRedisClient_hashs.o src/xRedisClient_lists.o src/xRedisClient_sortedsets.o src/xRedisPool.o src/xRedisFunc.o
ar rcs libxredis.a src/xRedisClient.o src/xRedisClient_keys.o src/xRedisClient_sets.o src/xRedisClient_strings.o src/xRedisClient_connection.o src/xRedisClient_hashs.o src/xRedisClient_lists.o src/xRedisClient_sortedsets.o src/xRedisPool.o src/xRedisFunc.o

关键信息为

g++ -shared -Wl,-soname,libxredis.so.1.10.1 -o libxredis.so

这里编译生成的对象是 libxredis.so 这个动态库，其 soname 为 libxredis.so.1.10.1

可以看看编译后生成的产物：

# 有一个 libxredis.a 静态库和一个 libxredis.so 动态库
[root@localhost xredis-1.10.1]# ll libxredis.*
-rw-r--r--. 1 root root 3405976 Oct  5 17:40 libxredis.a
-rwxr-xr-x. 1 root root 1319008 Oct  5 17:40 libxredis.so

可以使用 readelf 命令查看动态库的 soname

# 为了简洁些，使用了 grep 作过滤
[root@localhost xredis-1.10.1]# readelf -d libxredis.so  | grep soname
 0x000000000000000e (SONAME)             Library soname: [libxredis.so.1.10.1]

soname

soname 是 Short for shared object name 的缩写，直译就是共享库(动态库)的缩写。

-Wl,-soname -Wl 告诉编译器将后面的参数传递到连接器。而 -soname 指定了共享库的 soname。

那 soname 是怎么怎么产生作用的呢？

使用 ldd 命令或者 readelf 都可以查看应用程序依赖的动态库

# 为了简洁些，使用了 grep 作过滤
[root@localhost lib]# ldd /usr/xxx/bin/yyy | grep xredis
	libxredis.so.1.10.1 => /usr/xxx/lib/libxredis.so.1.10.1 (0x00007f2c4ea68000)
# 在 ldd 命令打印的结果中，“=>”左边的表示该程序需要连接的共享库之 so 名称，右边表示由 Linux 的共享库系统找到的对应的共享库在文件系统中的具体位置。

# 为了简洁些，使用了 grep 作过滤
[root@localhost lib]# readelf -d /usr/xxx/bin/yyy | grep xredis
 0x0000000000000001 (NEEDED)             Shared library: [libxredis.so.1.10.1]

可以看到 yyy 这个模块是依赖于 libxredis.so.1.10.1 这个动态库，但是还记得我们编译生成的产物么？我们编译生成的可是 libxredis.so 这个库啊~

# 将编译生成的 libxredis.so 放到 /home/wuxt/lib 下
[root@localhost lib]# pwd
/home/wuxt/lib
[root@localhost lib]# ls
libxredis.so

# 将 /home/wuxt/lib 加入动态库查找路径
[root@localhost lib]# cat /etc/ld.so.conf
include ld.so.conf.d/*.conf
/home/wuxt/lib

执行 ldconfig 命令，将动态库加入缓存中

[root@localhost lib]# ldconfig -v
/home/wuxt/lib:
	libxredis.so.1.10.1 -> libxredis.so (changed)

我们发现这里做了个软链接

[root@localhost lib]# ll
total 1292
-rwxr-xr-x. 1 root root 1319008 Oct  5 18:00 libxredis.so
lrwxrwxrwx. 1 root root      12 Oct  5 19:35 libxredis.so.1.10.1 -> libxredis.so

将动态库的 soname 指向动态库本身，这样当 yyy 模块需要依赖 libxredis.so.1.10 时，就会找到具体的 libxredis.so 这个库。

问题

但我认为这个 xredis 的 makefile 编写有问题，回到 xredis 的编译

g++ -shared -Wl,-soname,libxredis.so.1.10.1 -o libxredis.so

soname 应该是 libxredis.so.1 或者是 libxredis.so，生成的对象是带完整版本的 libxredis.so.1.10.1，这样当 xredis 升级至 1.10.2 时，还是由 libxredis.so.1 或者是 libxredis.so 指向 libxredis.so.1.10.2。

举例几个常用的库的 soname

cJSON

cJSON

看下 makefile 编写

# 节选 cjson 的 makefile
LIBVERSION = 1.7.15
CJSON_SOVERSION = 1
UTILS_SOVERSION = 1

CJSON_SO_LDFLAG=-Wl,-soname=$(CJSON_LIBNAME).so.$(CJSON_SOVERSION)
UTILS_SO_LDFLAG=-Wl,-soname=$(UTILS_LIBNAME).so.$(UTILS_SOVERSION)

编译 cJSON

[root@localhost cJSON]# ll libcjson.so*
lrwxrwxrwx. 1 root root    13 Oct  5 21:10 libcjson.so -> libcjson.so.1
lrwxrwxrwx. 1 root root    18 Oct  5 21:10 libcjson.so.1 -> libcjson.so.1.7.15
-rwxr-xr-x. 1 root root 46731 Oct  5 21:10 libcjson.so.1.7.15

查看 libcjson.so.1.7.15 的 soname

[root@localhost cJSON]# readelf -d libcjson.so.1.7.15 | grep soname
 0x000000000000000e (SONAME)             Library soname: [libcjson.so.1]

系统自带的库：

libz.zo

[root@localhost lib]# ll libz.so*
lrwxrwxrwx. 1 root root     13 Jan 19  2021 libz.so -> libz.so.1.2.7
lrwxrwxrwx. 1 root root     13 Jan 19  2021 libz.so.1 -> libz.so.1.2.7
-rwxr-xr-x. 1 root root 109093 Sep 27  2020 libz.so.1.2.7
[root@localhost lib]# 
[root@localhost lib]# readelf -d libz.so.1.2.7 | grep soname
 0x000000000000000e (SONAME)             Library soname: [libz.so.1]

libc.so 不过这个有点奇怪，libc-2.17.so 的 soname 是 libc.so.6?

[root@localhost lib64]# ll libc.so*
-rw-r--r--. 1 root root 253 Jan 19  2015 libc.so
lrwxrwxrwx. 1 root root  12 May 19  2017 libc.so.6 -> libc-2.17.so
[root@localhost lib64]# 
[root@localhost lib64]# readelf -d libc-2.17.so | grep soname
 0x000000000000000e (SONAME)             Library soname: [libc.so.6]
[root@localhost lib64]#

总结

Linux 系统的这种动态库管理方式值得我们在实际项目的动态库管理中使用，既保证了动态库的升级，又能得到方便地使用。

Linux 的动态库的命名格式是 libbar.so.x.y.z，最后一个 z 版本的变动一定是兼容的。y 版本升级一般向前兼容。所以这个 y 和 z 不能写死。x 版本变动一般是不兼容升级。所以使用 soname 是最为合理的。

参考：
linux下动态库中的soname

linux下动态库soname简介

Linux动态库soname的使用

Linux下动态链接库文件的realname、soname和linkname

KgdYsg
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
Linux C++ 多版本库依赖问题
08-04
Linux的动态库版本管理通常采用SONAME（Shared Object Name），这是一个包含库主版本、次版本和修订版本的标识符，例如`libfoo.so.1.2.3`。在编译库时，编译器会创建一个软链接`libfoo.so`指向当前版本的库，而`...
linux动态链接库的开发实例
06-23
在Linux系统中，动态链接库（Dynamic Linking Library，通常以`.so`为后缀）是一种重要的编程资源，它允许多个程序共享同一份代码，从而节省内存并方便代码维护。本教程将通过一个实例深入探讨Linux下C/C++语言如何...
linux下动态库soname简介
guotianqing的博客
06-30 7675
linux动态库 Linux 支持两种类型的库，每一种库都有各自的优缺点。 静态库包含在编译时静态绑定到一个程序的函数。动态库则不同，它是在加载应用程序时被加载的，而且它与应用程序是在运行时绑定的。 静态库较适宜于较小的应用程序，因为它们只需要最小限度的函数。 而对于需要多个库的应用程序来说，则适合使用共享库，因为它们可以减少应用程序对内存（包括运行时中的磁盘占用和内存占用）的占用。 这是因为多...
【GCC】参数选项笔记|-Wl,-soname|include宏定义和易错地方
bandaoyu的note
03-29 1838
-Wl,-soname （原文：https://blog.csdn.net/gohome520/article/details/7259450） -Wl选项告诉编译器将后面的参数传递给链接器。 -soname则指定了动态库的soname(短名，Short for shared object name) -Wl 表示后面的参数也就是-soname,libhello.so.1直接传给连接器ld进行处理。每一个库都有一个soname，当连接器发现程序库（如：libhello_v1.so）中有soname
C/C++：GCC/G++ -Wl,-soname 链接选项作用
热门推荐
test1280
07-22 1万+
C/C++：GCC/G++ -Wl,-soname 链接选项作用 -Wl 在 GCC/G++ 中是为了将后面的 option 传递给 链接器。 Code： mymath.h： #ifndef _MYMATH_H #define _MYMATH_H int add(int, int); int sub(int, int); int mul(int, int); int div(int,...
linux 动态库构造函数,LINUX动态库文件 soname realname linkname 详解
weixin_29056781的博客
05-03 527
先明白动态库文件的3个名字soname ：通过gcc/g++ -soname,libtest2.so.1 设置他是程序中连接文件的时候找的文件，本身为一个连接，他包含大版本，如果任何小版本的变化，直接替换到realname，然后ln -s 建立同样的soname 到新的realname文件即可，不需要重新编译程序。realname：是动态库文件的真实的名字及-o libtest2.so.1.1 ...
介绍-soname
ty的专栏
12-18 550
介绍linux的soname技术，该技术用于解决动态库多版本共存及程序版本依赖的问题。
libsrc.rar_linux 动态库
09-19
在实践中，了解如何管理和使用动态库对于Linux开发者来说是至关重要的，因为很多开源软件和系统服务都依赖于动态库来实现功能。 在解压`libsrc`后，你将找到用于演示动态库创建和使用的示例代码、Makefile和其他...
Visual C 编制的Windows动态库移植到Linux.pdf
09-07
【Visual C++ 编制的Windows动态库移植到Linux】专题介绍 动态链接库（DLL）在Windows和Linux操作系统中都是实现代码复用的重要手段，但两者之间存在格式和调用方式的差异，使得直接移植变得复杂。这篇文章主要探讨...
liunx动态链接库例子源代码
11-28
通过学习和实践这些示例，你可以更深入地理解Linux动态链接库的工作机制和使用方法。 此外，了解`ldd`命令用于检查程序的动态链接依赖，`nm`命令查看库中的符号信息，以及`objdump`查看编译后的二进制文件详情，...
Linux系统下动态连接库的创建和使用.pdf
09-07
3. **连接生成动态连接库**：接下来，使用`gcc`连接目标文件，添加`-shared`选项指定创建动态库，并通过`-Wl,-soname`选项设置库的名称。例如： ``` gcc myfun.o -o libmyfun.so -shared -Wl,-soname,libmyfun.so ...
linux下生成so文件并且调用so文件的方法
05-31
在Linux环境下，生成和调用共享库（SO文件，即Shared Object）是常见的软件开发实践。SO文件允许多个程序共享同一段代码，节省内存并提高系统效率。下面将详细介绍如何生成SO文件以及如何在应用程序中调用它们。 一...
Linux下的函数符号冲突问题示例Demo.zip
09-30
3. **使用版本号（Versioning）**：在Linux下，可以通过SONAME（Shared Object Name）为库指定版本，每个版本的库可以有自己的符号表。这样，主程序可以选择链接到特定版本的库，避免冲突。 4. **链接顺序（Linking...
ldd3-examples-3.x-master_ldd3-examples-3.x_
10-01
"ldd3-examples-3.x-master" 是一套基于《Linkers and Loaders》一书（通常简称为ldd3）的实践教程，主要针对Linux动态链接器的使用和理解提供了丰富的实例。这个压缩包包含了"ldd3-examples-3.x"版本的相关代码和...
libtool&automake小例子
11-18
- 动态库和静态库的切换：开发者可以方便地在开发阶段使用动态库进行快速测试，而在发布时生成静态库。 2. Automake是一个Makefile.am生成器，它是GNU Build System的一部分，用于自动化源码树的Makefile配置。...
linux下修改库的SONAME(gcc&cmake)
shaonanxin的博客
10-29 1641
linux下生成的动态库的SONAME默认同库的名称一致。 如库libtest.1.2.so; 通过readelf -d libtest.1.2.so可以查看到其SONAME为：libtest.1.2.so 通过gcc设置参数:-Wl,-soname,libtest.so可以对其SONAME进行修改。 gcc编译示例： gcc -fPIC -shared -Wl,-soname,libtest.so -o libtest.1.so ./test.cpp camke示例： project(t
动态库 soname
z1026544682的专栏
07-22 489
编译了一个动态库，生成了好几个文件，有libname.so,libname.so.x, libxx.so.x.y,libxx.so.x.y.z，都有什么区别？ Linux中命名系统中共享库的规则 libname.so.x.y（或libname.so.x.y.z,最后一个版本号可不要）这种是真正的库文件，libname.so 和 libname.so.x一般是指向libname.so.x.y的软链接。 链接libname.so.x是的作用是为了动态库升级方便，一般在编译真正的库libname.s..
动态库文件（.so文件）的realname，soname和linkname 介绍和使用说明
Tourior的博客
11-24 1092
动态库文件（.so文件）的realname，soname和linkname 介绍和使用说明 介绍 动态库文件（.so文件）的realname，soname和linkname 介绍 编译时设置soname 和 realname 参考makefile 设置soname readelf 查看动态库soname readelf -d libxxx.so readelf功能介绍 ...
C动态裤soname查看及修改
chenchuanhai04的博客
06-25 489
可以修改通过修改soname来让我们的引用更方便
linux动态库静态库面试题
最新发布
03-30
1. 什么是静态库？什么是动态库？ - 静态库是在编译时被链接到可执行文件中的库，它包含了所有的函数和数据，因此可执行文件较大，但运行时不需要加载额外的库文件。 - 动态库是在程序运行时被加载的库，它包含了多个可执行文件可以共享的函数和数据，因此可执行文件较小，但需要在运行时加载额外的库文件。 2. 静态库和动态库的优缺点是什么？ - 静态库的优点是可靠性高，因为所有的代码都被编译到可执行文件中，不需要额外的库文件。缺点是可执行文件较大，占用磁盘空间较大，且无法在运行时更新库文件。 - 动态库的优点是可执行文件较小，因为共享库文件可以被多个可执行文件共享。缺点是依赖性高，因为需要在运行时加载库文件，如果缺少或版本不匹配会导致程序无法运行。 3. 动态库的加载过程是怎样的？ - 当程序需要访问动态库中的函数或数据时，操作系统会检查可执行文件的依赖关系，加载动态库文件到内存中，并在符号表中查找相应的函数或数据。 - 如果找到了相应的函数或数据，程序就可以调用库函数或访问库数据。如果没有找到，操作系统会抛出未定义符号的错误。 4. 如何编译静态库和动态库？ - 编译静态库可以使用命令"ar"和"ranlib"，例如： ``` gcc -c file1.c file2.c ar rcs libmylib.a file1.o file2.o ``` - 编译动态库可以使用命令"gcc"和"-shared"选项，例如： ``` gcc -c -fpic file1.c file2.c gcc -shared -o libmylib.so file1.o file2.o ``` 5. 如何使用静态库和动态库？ - 使用静态库可以在编译时链接库文件，例如： ``` gcc -o myprog main.c -L/path/to/lib -lmylib ``` - 使用动态库可以在程序运行时加载库文件，例如： ``` LD_LIBRARY_PATH=/path/to/lib ./myprog ``` 6. 如何避免动态库版本不匹配的问题？ - 在编译动态库时，可以使用版本号来标识不同的库版本，例如： ``` gcc -shared -Wl,-soname,libmylib.so.1 -o libmylib.so.1.0.0 file1.o file2.o ``` - 在程序中调用库函数时，可以使用版本号来指定库版本，例如： ``` dlopen("libmylib.so.1", RTLD_NOW); ``` 这样可以确保程序使用正确的库版本，并避免版本不匹配的问题。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值