CMake和静态库顺序

时间:2021-08-16 19:30:03

目录

目录 1

前言 1

方法 1

1:链接静态库的顺序问题 2

2:再议GCC编译时的静态库依赖次顺问题 3

3gcc链接参数--whole-archive的作用 4

4:让有些“-l”链接静态库,而另一些链接共享库? 6

5:相关博文 6

 

前言

C/C++程序的许多同学被静态库的依赖折腾,因为默认情况下要求被依赖的库放在依赖它的库后面,当一个程序或共享库依赖的静态库较多时,可能会陷入解决链接问题的坑中。如果对静态库不熟悉,需要结构nm等工具来解决顺序问题。

但也可以偷懒,不关心静态库的顺序问题,ld为此提供了start-groupend-group两个选项,让包含在这两者间的静态库顺序可以随意。

方法

CMake为例,假设程序x依赖三个静态库:libX1.alibX2.alibX3.a,而libX2.a又依赖libX1.alibX3.a依赖libX2.alibX1.a,正常情况下的CMakeLists.txt格式如下:

add_executable(

    x

    x.cpp

)

target_link_libraries(

    x

    libX1.a

    libX2.a

    libX3.a

)

 

上面的写法libX1.alibX2.alibX3.a的顺序不能变,只能按上面的先后顺序。如果去掉顺序的烦恼和痛苦,可以采用如下的写法:

target_link_libraries(

    x

    -Wl,--start-group

    libX1.a

    libX3.a

    libX2.a

    -Wl,--end-group

)

target_link_libraries(

    x

    -Wl,--start-group

    libX3.a

    libX2.a

    libX1.a

    -Wl,--end-group

)

都可以,完全不用关心顺序。

 

前面说了start-groupend-groupld的选项,是链接选项,不是gcc/g++的编译选项,直接命令行或其它编译方式也可以使用,比如命令行方式:

g++ -g -o x x.cpp -Wl,--start-group libX2.a libX1.a libX3.a -Wl,--end-group

1:链接静态库的顺序问题 

在链接静态库时,如果多个静态库之间存在依赖关系,则有依赖关系的静态库之间存在顺序问题,这个在使用静态库时需要注意,否则会报符号找不到问题。举例,libb.a依赖于是liba.a,而可执行文件test只直接依赖于libb.a,则链接选项应当为“-b -a”,而不是“-a -b”,否则会报liba.a中的某些符号找不到

gcc -c a.c

ar cr liba.a a.o

gcc -c b.c

ar cr libb.a b.o

 

虽然libb.a使用到了liba.o中的一些函数,但并不会将它们的定义包含进来,所以在链接test时需要指定这两个库

另外,在编译libb.a时是不指定liba.a,因为编译一个静态库不会使用到链接选项,而只需要指定需要依赖的头文件路径即可。

 

-Wl的使用

-Wl表示后面的参数传递给链接器,其中l是linker的意思。

链接时指定共享库的搜索路径(类似于设置LD_LIBRARY_PATH):

-Wl,-rpath=/usr/local/abc:/data/abc

以上也可以分开写:

-Wl,-rpath=/usr/local/abc -Wl,-rpath=/data/abc

部分库链接它的静态库,部分库链接它的共享库:

-Wl,-static -lb -Wl,-call_shared -la -lz

指定链接器:

-Wl,-dynamic-linker /lib/ld-linux.so.2 -e _so_start

指定导出的符号:

-Wl,--export-dynamic,--version-script,exports.lds

exports.lds的格式可以为:

{

global:

foo;

};

指定共享库的soname:

-Wl,--export-dynamic,--version-script,exports.lds,-soname=libqhttpd.so

-rpath 增加共享库搜索路径

--retain-symbols-file表示不丢弃未定义的符号和需要重定位的符号

--export-dynamic 创建一个动态连接的可执行程序时, 把所有的符号加到动态符号表中

附2:再议GCC编译时的静态库依赖次顺问题

假设有如三个源代码文件:

$ cat a.cpp

void a()

{

}

 

$ cat b.cpp

extern void a();

void b()

{

    a(); // 调用a.cpp中的a()

}

 

$ cat x.cpp

extern void b();

int main()

{

    b(); // 调用b.cpp中的b()

    return 0;

}

 

对应的Makefile文件:

all: x

 

liba.a: a.o

libb.a: b.o

x: x.o liba.a libb.a # 问题出在这儿

    g++ -g -o $@ $^

 

a.o: a.cpp

    g++ -g -c $^

b.o: b.cpp

    g++ -g -c $^

x.o: x.cpp

    g++ -g -c $^

 

clean:

    rm -f a.o b.o x.o x

 

使用上面的Makefile编译,将会遇到如下所示的“undefined reference”问题:

g++ -g -c x.cpp

g++ -g -c a.cpp

g++ -g -c b.cpp

g++ -g -o x x.o liba.a libb.a # 改成“g++ -g -o x x.o libb.a liba.a”即可解决

libb.a(b.o): In function `b()':

/data/jayyi/gongyi/activities/phonebook/b.cpp:2: undefined reference to `a()'

collect2: ld returned 1 exit status

make: *** [x] Error 1

 

这个问题的原因是b.cpp依赖a.cppgcc要求(实际是ld要求)libb.a须放在liba.a前面,即需要改成:g++ -g -o x x.o libb.a liba.a,也就是被依赖的库需要放在后头。

这是最常规的解决办法,除此之外,只需要加入--start-group和--end-group两个链接参数,即可保持被依赖的库放在前头,也就是改成如下即可:g++ -g -o $@ -Wl,--start-group $^ -Wl,--end-group。

这里的“-Wl,”表示后面跟着的参数是传递给链接器ld的,gcc不关心具体是啥。“--start-group”表示范围的开始;“--end-group”表示范围的结束,是可选的。位于“--end-group”之后的仍然要求被依赖的库放在后头。

附3gcc链接参数--whole-archive的作用

// a.h

extern void foo();

 

 

// a.cpp

#include <stdio.h>

 

void foo()

{

    printf("foo\n");

}

 

// x.cpp

#include "a.h"

 

int main()

{

        foo();

        return 0;

}

 

// Makefile

all: x

 

x: x.cpp liba.so

g++ -g -o $@ $^

 

liba.so: liba.a

g++ -g -fPIC -shared -o $@ $^

#g++ -g -fPIC -shared -o $@ -Wl,--whole-archive $^ -Wl,-no-whole-archive

 

liba.a: a.o

ar cru $@ $^

 

a.o: a.cpp

g++ -g -c $^

 

clean:

rm -f x a.o liba.a liba.so

 

$ make

g++ -g -c a.cpp

ar cru liba.a a.o

g++ -g -fPIC -shared -o liba.so liba.a

#g++ -g -fPIC -shared -o liba.so -Wl,--whole-archive liba.a -Wl,-no-whole-archive

g++ -g -o x x.cpp liba.so

/tmp/cc6UYIAF.o: In function `main':

/data/ld/x.cpp:5: undefined reference to `foo()'

collect2: ld returned 1 exit status

make: *** [x] Error 1

 

默认情况下,对于未使用到的符号(函数是一种符号),链接器不会将它们链接进共享库和可执行程序。

这个时候,可以启用链接参数“--whole-archive”来告诉链接器,将后面库中所有符号都链接进来,参数“-no-whole-archive”则是重置,以避免后面库的所有符号被链接进来。

 

// Makefile

all: x

 

x: x.cpp liba.so

g++ -g -o $@ $^

 

liba.so: liba.a

g++ -g -fPIC -shared -o $@ -Wl,--whole-archive $^ -Wl,-no-whole-archive

 

liba.a: a.o

ar cru $@ $^

 

a.o: a.cpp

g++ -g -c $^

 

clean:

rm -f x a.o liba.a liba.so

附4:如何让有些“-l”链接静态库,而另一些链接共享库?

用“-Wl,-Bstatic”指定链接静态库,使用“-Wl,-Bdynamic”指定链接共享库,使用示例:

-Wl,-Bstatic -lmysqlclient_r -lssl -lcrypto -Wl,-Bdynamic -lrt -Wl,-Bdynamic -pthread -Wl,-Bstatic -lgtest

 

"-Wl"表示是传递给链接器ld的参数,而不是编译器gcc/g++的参数。

5:相关博文

1) 链接静态库的顺序问题

https://blog.csdn.net/Aquester/article/details/7780640

2) 再议GCC编译时的静态库依赖顺序问题

https://blog.csdn.net/Aquester/article/details/48547685

3) 如何让有些“-l”链接静态库,而另一些链接共享库?

http://blog.chinaunix.net/uid-20682147-id-5096676.html

4) 小心两个共享库共用同一个静态库

http://blog.chinaunix.net/uid-20682147-id-3760647.html

5) C/C++常见gcc编译链接错误解决方法

http://blog.chinaunix.net/uid-20682147-id-5037113.html

6) CMake使用技巧集

http://control.blog.chinaunix.net/uid-20682147-id-5284633.html

7) libtool的工作原理

https://blog.csdn.net/aquester/article/details/23339825

8) 全局变量相互依赖和初始化顺序的解决办法

https://blog.csdn.net/aquester/article/details/7780844

9) 对于glogShutdownGoogleLogging后不能再次InitGoogleLogging问题的解决办法

http://blog.chinaunix.net/uid-20682147-id-3449454.html

 

// 如果不想依赖:
// libc.so, libgcc_s.so, librt.so, libpthread.so, libdl.so, libz.so, librt.so, libstdc++.so等,
// 链接时可指定如下选项(加到命令行最后即可,有些环境还可加上“-static-libstdc++”):
// -Wl,-Bstatic -static-libgcc -lrt -lz -pthread -ldl
// 遇到如下警告,可以忽略:
// warning: Using 'dlopen' in statically linked applications
// warning: Using 'getpwuid_r' in statically linked applications
// warning: Using 'getaddrinfo' in statically linked applications
//
// 检查静态链接效果:
// > ldd -r mooon_ssh
// not a dynamic executable
//
// 但如果是下列错误,则不能采用静态链接(需安装c++标准库的静态库):
// cannot find -lstdc++
//
// 下列错误,可能是因为“/usr/bin/ld: cannot find -lstdc++”:
// the use of `mktemp' is dangerous, better use `mkstemp'
//
// libstdc++.a可能所在位置(编译器版本要和库版本保持相同,否则可能不兼容):
// /usr/lib/gcc/i586-suse-linux/4.1.2/libstdc++.a
// /usr/lib/gcc/x86_64-redhat-linux/4.8.2/32/libstdc++.a
// /usr/lib/gcc/x86_64-redhat-linux/4.4.7/libstdc++.a
// /usr/lib/gcc/x86_64-redhat-linux/4.4.7/32/libstdc++.a
//
// libc.a可能所在位置:
// /usr/lib/libc.a
// /usr/lib64/libc.a
// /usr/lib/x86_64-redhat-linux6E/lib64/libc.a