gcc编译参数参数--no-whole-archive及--whole-archive

原文地址：http://hi.baidu.com/buptwinnie/blog/item/589aae5e8ea1ab5efaf2c00e.html

先构造三个C文件://a.c
void afunc() { printf("inside a afunc()/n"); }
void samefunc() { printf("in samefunc of a.c/n"); }
  //b.c
void bfunc() { printf("inside a bfunc()/n"); }
void samefunc() { printf("in samefunc of b.c/n"); }   //test.c
extern void afunc();
extern void bfunc();
void testfunc() 
{
    afunc();
    bfunc();
}

先用以下的命令来生成test.o, a.sa, b.sa文件:
gcc a.c -c -o a.o
ar -q a.o a.sa
gcc b.c -c -o b.o
ar -q b.o b.sa
gcc test.c -c -o test.o

gcc -shared -Wl,--no-whole-archive a.sa b.sa -Wl,--no-whole-archive -o m.so上面的命令运行通过, 但生成的文件中是不包含afunc, bfunc, samefunc的,不可用

gcc -shared test.o -Wl,--no-whole-archive a.sa b.sa -Wl,--no-whole-archive -o m.so上面的命令运行失败, 错误如下:
b.sa(b.o): In function `samefunc':
b.c:(.text+0x14): multiple definition of `samefunc'
a.sa(a.o):a.c:(.text+0x14): first defined here
collect2: ld returned 1 exit status 

gcc -shared -Wl,--no-whole-archive a.sa b.sa -Wl,--no-whole-archive test.o -o m.so上面的命令运行通过,与再上面的命令相比,只是调换了test.o在命令行中的位置
但生成的文件中是不包含afunc, bfunc, samefunc的,不可用 

如果以以下方式修改test.c
//test.c
#include
#include
extern void afunc();
extern void bfunc();
void testfunc()
{
    afunc();
    //bfunc();   <---------------just comment following line
}

gcc -shared test.o -Wl,--no-whole-archive a.sa b.sa -Wl,--no-whole-archive -o m.so
链接成功,生成的m.so也是可用的,原因是: 当test.c中不使用bfunc时，也就不再加载b.sa(虽然b.sa是在命令行中的), 也就不会出现与a.sa中存在二个同名的samefunc函数了 

当改成使用-Wl,--whole-archive后，只有当a.sa与b.sa中没有同名的函数时以下命令才可通过:
gcc -shared test.o -Wl,--whole-archive a.sa b.sa -Wl,--no-whole-archive -o m.so此m.so可以使用 

总结：
1)当使用--whole-archive时，其会把所有的--whole-archive之后的.sa中的所有函数全部加入到生成的文件中来，这样的情况下，如果有同名函数，则链接就不会通过;
2)当使用--no-whole-archieve时，则此后的所有文件中的所有函数都不会加到生成的文件中,但下面的第3点情况例外;
3)如果命令行中有.o文件，如test.o, 并且.o文件后面有.sa文件，则会把.o文件中用到的函数的.sa文件加入到生成的结果文件中来(即使.sa前有--no-whole-archieve);所以这和.o及.sa的顺序有关系。

注：
--whole-archive, --no-whole-archive是ld的命令，gcc并不认识，所以要加-Wl，换成如下命令也是一样的：
ld -shared test.o --whole-archive a.sa b.sa --no-whole-archive -o m.so