使用Backtrace函数打印调用栈 - Debug居家必备

glibc提供了backtrace这个库函数，可以用来打印call stack。比如我们可以在程序中注册常见的一些signal，比如SIGSEGMENT, SIGPIPE，然后在这些信号的回调函数中，利用backtrace打印出call stack，这样debug就非常的方便。 

backtrace的使用很简单，使用man手册中的Example代码即可，例如：

#include <execinfo.h>   
#include <stdio.h>
#include <string.h>
#include <stdlib.h>
#include <errno.h>

#define SIZE        100

void dump_stack()
{
    int btnum = 0;
    void *btbuf[SIZE];
    char **btstrings = NULL;
    int i;

    /* Get backtrace */
    btnum = backtrace(btbuf, SIZE);
    btstrings = backtrace_symbols(btbuf, btnum);
    if (btstrings == NULL) {
        printf("Backtrace failed: %d:%s\n", errno, strerror(errno));
    } else {
        printf("Backtraces, total %d items\n", btnum);
        for (i = 0; i < btnum; i++)
            printf("%s\n", btstrings[i]);

        free(btstrings);
    }
}

void start_working()
{
    printf("Start working...\n");
    dump_stack();
}

int main()
{
    printf("Start backtracing...\n");
    start_working();
    return 0;
}

 

首先用backtrace，最多生成100层的call stack。然后用backtrace_symbols将backtrace返回的一堆地址翻译成函数名称。backtrace的返回值是具体生成了多少层的call stack，填充的btbuf是一个void *的数组，里面每个element都是一个void *，其实就是一个地址。 

backtrace_symbols生成的字符串都是malloc出来的，但是不要最后一个一个的free，因为backtrace_symbols是根据backtrace给出的call stack层数，一次性的malloc出来一块内存来存放结果字符串的，所以，像上面代码一样，只需要在最后，free backtrace_symbols的返回指针就OK了。这一点backtrace的manual中也是特别提到的。

此外需要注意的是，使用backtrace来获取调用栈信息，在编译的时候需要加入：-rdynamic，这个option是传递给linker的，linker会将symbol放到.dydym table中，这样backtrace_symbols才能获取到地址对应的symbol。所以即使是使用了-g来编译程序，如果不使用-rdynamic的话，backtrace_symbols也找不到地址对应的symbol。这是backtrace系列函数的一个缺陷。不过有了地址也算是一个很大帮助了，毕竟可以使用gdb来找到对应的symbol。