在使用gcc编译代码时，有时候由于种种原因，必需要使用一个函数名，而该函数名又在必需依赖的库中进行了定义，一般有如下两种情况，也对应了不同的解决办法：

• 如果该函数在库中被修饰为弱函数，我们可以直接定义一个参数和返回值都相同的函数，重写该函数即可，这种情况不会报重复定义的错误（比如fputc、_write函数等）。
• 如果该函数不是弱函数，则需要使用-Wl,--wrap参数编译，并定义一个包装函数，来达到这一目的。

网上对包含函数的解释如下:

对symbol使用包装函数(wrapper function)，任何对symbol未定义的引用(undefined reference)会被解析成__wrap_symbol，而任何对__real_symbol未定义的引用会被解析成symbol。即当一个名为symbol符号使用wrap功能时，工程中任何用到symbol符号的地方实际使用的是__wrap_symbol符号，任何用到__real_symbol的地方实际使用的是真正的symbol。注意：当__wrap_symbol是使用C++实现时，一定要加上extern “C”，否则将会出现”undefined reference to __wrap_symbol”。

为了更清楚的展示包装函数的用法，下面直接通过代码示例来测试使用:
test.c

#include <stdio.h>

int test()
{
  printf("==>Run %s Fuction:%s\n",__FILE__,__FUNCTION__);
}

main.c

#include <stdio.h>

int __wrap_test()
{
   printf("==>Run %s Fuction:%s\n",__FILE__,__FUNCTION__);
}

int main()
{
   test();
   __real_test();
}

编译代码:

gcc test.c main.c -Wl,--wrap,test -o test

运行结果:

• 从运行结果可以清楚得知，当使用了-Wl,--wrap,xxx或-Wl,--wrap=xxx参数后, 原本调用test函数的地方实际调用的是__wrap_test函数，而调用__real_test函数时，实际上是调用的test函数。

如下为我在适配内存管理函数，采用包装函数时使用的的编译参数，在此做个备忘：

"-Wl,--wrap,_free_r",
"-Wl,--wrap,_malloc_usable_size_r",
"-Wl,--wrap,_malloc_r",
"-Wl,--wrap,_memalign_r",
"-Wl,--wrap,_realloc_r",
"-Wl,--wrap,_calloc_r",