CMake中INSTALL_RPATH与BUILD_RPATH问题

1. RPATH和RUNPATH区别

RPATH和RUNPATH都可以用来在运行时搜索动态库,下面用一个简单的例子说明二者的区别。
example:一个小工程中,有1个头文件和3个源文件。

头文件sub.h中的内容如下:

#ifndef TESTRPATH_SUB_H
#define TESTRPATH_SUB_H

void f1(void);
void f2(void);
#endif

源文件a.c中的内容如下:

#include "sub.h"
void f1(void) {
}

源文件b.c中的内容如下:

#include "sub.h"
void f2(void) {
    f1();
}

源文件main.c中的内容如下:

#include "sub.h"
int main(void) {
    f2();
}

测试:

  1. 在Ubuntu16.04 + gcc5.4中编译,命令及结果如下:
madengyun@intellif-B250-HD3:~/TestRpath$ gcc a.c -fPIC -shared -o liba.so
madengyun@intellif-B250-HD3:~/TestRpath$ gcc b.c -fPIC -shared -L$PWD -la -o libb.so
madengyun@intellif-B250-HD3:~/TestRpath$ gcc main.c -L$PWD -Wl,-rpath,$PWD -lb
madengyun@intellif-B250-HD3:~/TestRpath$ ldd a.out
    linux-vdso.so.1 =>  (0x00007ffe00568000)
    libb.so => /home/madengyun/TestRpath/libb.so (0x00007f8baa94c000)
    libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007f8baa582000)
    liba.so => /home/madengyun/TestRpath/liba.so (0x00007f8baa380000)
  1. 在Ubuntu18.10 + gcc5.4中编译,命令及结果如下:
mdy@mdy-pc:~/TestRpath$ gcc a.c -fPIC -shared -o liba.so
mdy@mdy-pc:~/TestRpath$ gcc b.c -fPIC -shared -L$PWD -la -o libb.so
mdy@mdy-pc:~/TestRpath$ gcc main.c -L$PWD -Wl,-rpath,$PWD -lb
mdy@mdy-pc:~/TestRpath$ ldd a.out
    linux-vdso.so.1 (0x00007fff635a1000)
    libb.so => /home/mdy/TestRpath/libb.so (0x00007f59d326f000)
    libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007f59d2e7e000)
    /lib64/ld-linux-x86-64.so.2 (0x00007f59d3673000)
    liba.so => not found

在Ubuntu18.10中编译生成的app,ldd显示找不到liba.so。
但其实liba.so和libb.so在同一目录下,ldd可以找到libb.so,却找不到liba.so。

用readelf -d分析两种环境下生成的app:
可以看出Ubuntu16.10中生成的是RPATH,而Ubuntu18.10中生成的是RUNPATH。

775086963e9c41b7a708069114887c7c.png

简单地说,在搜索app的间接依赖库时,RPATH起作用,但RUNPATH不起作用。
在使用RUNPATH的情况下,很可能还要再配合LD_LIBRARY_PATH一块使用。

所以:最好使用RPATH,这样就不用依赖LD_LIBRARY_PATH了
但是,如何控制生成RPATH还是RUNPATH?

链接时使用–enable-new-dtags可以固定生成RUNPATH,使用–disable-new-dtags可以固定生成RPATH。

set_target_properties(XXX  LINK_FLAGS "-Wl,--disable-new-dtags")

2. CMake build之后消除RPATH

CMake对于RPATH的管理也非常人性化:

  • 官方说法是当动态库的编译也和执行档在同级目录下的时候,CMake会自动给执行档加入适当的RPATH
  • 具体可以通过readelf -d executable来查看相关的RPATH路径(target_add_library就会增加RPATH到TARGET上)。
    所以有的时候用QMake编译之后还得手动加一把LD_LIBRARY_PATH,而用CMake编译之后,直接执行执行档就可以了。

CMake搜索库的顺序如下:

RPATH: 写在elf文件中
LD_LIBRARY_PATH:环境变量
RUNPATH:写在elf文件中
ldconfig的缓存:配置/etc/ld.conf*可改变
默认的/lib, /usr/lib

CMake在默认情况下是会给你的exe加入相关RPATH的,这个时候可能会有不想要相关RPATH的需求,仔细查阅寻找之后发现,CMake里面维护了3个比较重要的RPATH变量,即:

  • CMAKE_SKIP_RPATH
  • CMAKE_SKIP_BUILD_RPATH
  • CMKAE_INSTALL_RPATH
set(CMAKE_SKIP_RPATH TRUE)
set(CMAKE_SKIP_BUILD_RPATH TRUE)
set(CMAKE_SKIP_INSTALL_RPATH TRUE)

构建期间和安装期间不允许CMake给你加入相关RPATH, 想要追加RPATH, 只需要对这三个变量设置成FALSE。 不过,默认CMake在帮你编译之后,如果你使用了相关动态库,它会在相应的exec文件中增加你相关生成动态库的路径,这样当你每次去执行的时候你不需要每次都LD_LIBRARY_PATH就可以正常运行。

可以看到,当前myexe中的RPATH字段有一个Library rpath,其中指定了你生成相应动态库target的目标路径
readelf -d myexe

或者
来查看当前executable已经寻找到了哪些动态库。
ldd -r myexe

因为目前的RPATH都是写的绝对路径
所以移动相关shared_lib库的路径,这个时候你再去运行myexe,你就会发现它已经找不到相关的动态库了。

2.1 make install下CMake是如何处理RPATH的?

CMake为了方便用户的安装,默认在make install之后会自动remove删除掉相关的RPATH,这个时候你再去查看exe的RPATH,已经发现没有这个字段了。
因此,当每次make install之后,我们进入到安装路径下执行相关exe的时候,就会发现此时的exe已经找不到相关的库路径了,因为它的RPATH已经被CMake给去除了。

2.2 如何让CMake能够在install的过程中写入相关RPATH,并且该RPATH不能使当初build的时候的RPATH呢?

答案就是CMAKE_INSTALL_RPATH这个全局变量和INSTALL_RPATH这个target属性。
CMake在安装的过程会有一个和configure一样的安装路径,CMAKE_INSTALL_PREFIX(configure下是–prefix,当然也可以用shell下的全局变量DESTDIR);
这个时候它会把你的安装文件安装到你prefix下的相对路径下,因此当我们希望在make install的时候,比如当前的share_lib在lib目录下,我们希望安装之后的RPATH可以自动找到它,我们就可以这么写:

set(CMAKE_INSTALL_RPATH ${CMAKE_INSTALL_PREFIX}/lib)

# 需要注意的是,这个变量是全局变量,意味着你所有的target的RPATH都会在install的时候被写成这个(包括myexe和不需要RPATH的share_lib)
set_target_properties(${PROJECT_NAME} PROPERTIES 
      BUILD_WITH_INSTALL_RPATH TRUE
      INSTALL_RPATH "${CMAKE_INSTALL_PREFIX}/lib" 
)

这样就可以保证只针对当前的target进行make install的时候RPATH的写入了

2.3 如何让RPATH寻找相对路径

set_target_properties(target PROPERTIES
    BUILD_WITH_INSTALL_RPATH TRUE
    INSTALL_RPATH "$ORIGIN/../lib:/path/to/lib"
)

在GCC中有个变量可以获得程序当前路径,即:$ORIGIN
当希望使用相对位置寻找.so文件,就需要利用$ORIGIN设置RPATH
多个路径之间使用冒号“:”隔开

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,457评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,837评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,696评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,183评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,057评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,105评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,520评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,211评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,482评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,574评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,353评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,213评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,576评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,897评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,174评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,489评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,683评论 2 335

推荐阅读更多精彩内容