GNU编译器学习 --> 如何链接外部库【Linking with external libraries】

库也就是我们常说的library，一个库是若干个已经编译过的目标文件(.obj)的集合，它可以被链接到程序里。那么我们最常见的使用就是，我们在编程时会调用一些函数，这些函数别人已经写好了，它就放在库里面。比如c的数学库里的sqrt开根号函数，这个函数在libm.a里。

库通常存放在专门的档文件里，以".a"为文件后缀，也即linux下的静态库。使用gnu的归档命令ar就可以从目标文件(.obj)构建档文件。链接工具linker会在编译时解决函数引用问题。本文将只介绍静态库。需要使用共享库的动态链接可期待我接下来的文章。

在linux下，一般的系统库都放在"/usr/lib"和"/lib"下。例如，在类unix系统下，c的数学库一般存放在"/usr/lib/libm.a"。而相应的函数原型声明则在"/usr/include/math.h"给出。c的标准库则存在"/usr/lib/libc.a'，这里面有ansi/iso c标准中指定的函数，比如"printf"，这个库默认被所有c程序自动链接。

 

接下来给一个例程，在这个例程(calc.c)里，需要调用数学库(libm.a)中的一个函数sqrt。

#include <math.h>
#include <stdio.h>

int
main (void)
{
  double x = sqrt (2.0);
  printf ("the square root of 2.0 is %f\n", x);
  return 0;
}

 

当我们尝试创建一个可执行文件时，compiler在链接阶段发出error。

$ gcc -wall calc.c -o calc
/tmp/ccbr6ojm.o: in function `main':
/tmp/ccbr6ojm.o(.text+0x19): undefined reference 
  to `sqrt'

这个问题产生的原因是链接时无法解析sqrt函数(这个calc.c里并没有对sqrt函数的定义，默认链接的库libc.a里也找不到相关解析。而真正定义声明了这个函数的外部库libm.a没有被链接到，所以不能从这个库里找)。顺便说一下，报错里提到的这个“/tmp/ccbr60jm.o”是一个用于链接进程的临时目标文件。那么应该如何解决这个问题呢？

 

我们需要想办法提供"libm.a"这个库给编译器。一个很容易想到但是十分笨拙的方法就是在编译命令里显式地提到这个库：

$ gcc -wall calc.c /usr/lib/libm.a -o calc

"ilbm.a"这个库包含了所有数学公式的目标文件，例如sin,cos,exp,log以及sqrt。链接器linker会去搜索这个库去找包含sqrt这个函数的目标文件。

一旦找到了那个目标文件，刚才的代码就可以顺利地生成完整的可执行文件：

$ ./calc
the square root of 2.0 is 1.414214

生成的这个可执行文件将会含括main函数的机器码和sqrt函数的机器码(从libm.a中拷贝相应的目标文件)。也就是运行的时候已经不需要libm.a了。

但是我们不会希望每次都要在编译的命令里放辣么长的path吧。因此gcc编译器提供了短的选项命令符"-l" 一遍链接时触及你想要的库。下面的命令可以替换之前的编译命令。

$ gcc - wall calc.c -lm -o calc

使用编译器选项 -lname 可以让编译器尝试链接  "libname.a"(一般来说这个库必须处于标准库目录)里的目标文件。至于其他目录里的库文件如何链接(使用编译器选项指明环境变量)请期待后续文章。所以一般大型的项目将会用到很多-l 选项去链接各种能够各样的库：数学库、图形库还有网络库等等。

 

 

 

 

 

 

参考资源：

1　　gcc入门

2　　an introduction to gcc - for the gnu compilers gcc and g++

3　　linux下的tar压缩解压缩命令详解

4