/bin/ld cannot find -lxxx 报错及解决方案

今天编译软件的时候,遇到如下报错:

1
2
/bin/ld: cannot find -lsqlite3
collect2: error: ld returned 1 exit status
后来在网上查找到是与gcc的-L和-l选项有关,故搬运记录于此。

-l和-L参数

gcc编译代码时,-l 参数用来指定程序要链接的库,-l参数紧接着就是库名。那么库名跟真正的库文件名有什么关系呢?就拿数学库来说,他的库名是m,他的库文件名是libm.so,很容易看出,把库文件名的头lib和尾.so去掉就是库名了。

若需要使用第三方库 libtest.so,那么只要把libtest.so拷贝到/usr/lib里,编译时加上-ltest参数,就能用上libtest.so库了(当然要用libtest.so库里的函数,我们还需要与libtest.so配套的头文件)。

放在/lib和/usr/lib和/usr/local/lib里的库直接用-l参数就能链接了,但如果库文件没放在这三个目录里,而是放在其他目录里,这时我们只用-l参数的话,链接就会出错,出错信息大概是:“/usr/bin/ld: cannot find -lxxx”,也就是链接程序ld在那3个目录里找不到libxxx.so,这时另外一个参数-L就派上用场了,比如常用的X11的库,它在/usr/X11R6/lib目录下,我们编译时就要用-L/usr/X11R6/lib -lX11参数,-L参数跟着的是库文件所在的目录名。再比如我们把libtest.so放在/aaa/bbb/ccc目录下,那链接参数就是-L/aaa/bbb/ccc -ltest。

另外,大部分libxxxx.so只是一个链接,以RH9为例,比如libm.so它链接到/lib/libm.so.x,/lib/libm.so.6又链接到/lib/libm-2.3.2.so,如果没有这样的链接,还是会出错,因为ld只会找libxxxx.so,所以如果你要用到xxxx库,而只有libxxxx.so.x或者libxxxx-x.x.x.so,做一个软链接就可以了ln -s libxxxx-x.x.x.so libxxxx.so。

手工来写链接参数总是很麻烦的,还好很多库开发包提供了生成链接参数的程序,名字一般叫xxxx-config,一般放在/usr/bin目录下,比如gtk1.2的链接参数生成程序是gtk-config,执行gtk-config --libs就能得到以下输出"-L/usr/lib -L/usr/X11R6/lib -lgtk -lgdk -rdynamic -lgmodule -lglib -ldl -lXi -lXext -lX11 -lm",这就是编译一个gtk1.2程序所需的gtk链接参数,xxx-config除了--libs参数外还有一个参数是--cflags用来生成头文件包含目录的,也就是-I参数,在下面我们将会讲到。你可以试试执行gtk-config --libs --cflags,看看输出结果。

现在的问题就是怎样用这些输出结果了,最笨的方法就是复制粘贴或者照抄,聪明的办法是在编译命令行里加入这个选项:

1
2
3
4
5
6
7
`xxxx-config --libs --cflags` 

比如编译一个gtk程序:

gcc gtktest.c `gtk-config --libs --cflags`

注意`不是单引号,而是1键左边那个键。

-include和-I参数

-include用来包含头文件,但一般情况下包含头文件都在源码里用#include xxxxxx实现,所以-include参数很少用。-I参数是用来指定头文件目录,/usr/include目录一般是不用指定的,gcc知道去那里找,但是如果头文件不在/usr/include里我们就要用-I参数指定了,比如头文件放在/myinclude目录里,那编译命令行就要加上-I/myinclude参数了,如果不加你会得到一个"xxxx.h: No such file or directory"的错误。-I参数可以用相对路径,比如头文件在当前目录,可以用-I.来指定。

相关环境变量

当然,也可以通过环境变量来指定库文件(.so)和头文件(.h)的路径,比如BOOST库对应的环境变量:

1
2
3
4
export BOOSTHOME=/app/boost-1.77.0
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$BOOSTHOME/lib
export LIBRARY_PATH=$LIBRARY_PATH:$BOOSTHOME/lib
export CPLUS_INCLUDE_PATH=$CPLUS_INCLUDE_PATH:$BOOSTHOME/include

C++ 2011 报错

有时会遇到如下报错#error This file requires compiler and library support for the ISO C++ 2011 standard. This support is currently experimental, and must be enabled with the -std=c++11 or -std=gnu++11 compiler options. 只需要在编译程序之前运行CXX="g++ -std=c++11"即可。

ldd 命令

当服务器上多台电脑使用不同的操作系统时,有时会遇到找不到对应版本的库文件的问题。此时,需要使用ldd命令查找出缺失的库文件名称,然后可以利用locate命令搜索所需库文件的位置,再通过软链接将相应版本的库文件链接到合适的位置。

ldd命令用于判断某个可执行的二进制含有什么动态函式库。eg:

1
2
3
ldd /bin/ls  

strings /lib64/libc.so.6 | grep GLIBC

locate命令其实是“find -name”的另一种写法,但是要比后者快得多,原因在于它不搜索具体目录,而是搜索一个数据库(/var/lib/locatedb)。这个数据库中含有本地所有文件信息。Linux系统自动创建这个数据库,并且每天自动更新一次,所以使用locate命令查不到最新变动过的文件。为了避免这种情况,可以在使用locate之前,先使用updatedb命令,手动更新数据库。


Source: - gcc -l参数和-L参数