freeswitch 新通话启动过程梳理
概述
freeswitch是一款开源的VOIP软交换平台，功能强大。
在使用fs进行呼叫业务的过程中，我们最常见到的日志就是呼叫通道的启动信息，日志如下
2022-03-03 14:14:30.028832 [NOTICE] switch_channel.c:1133 New Channel sofia/internal/1001@192.168.0.152 [d70acc45-294c-4787-8dce-ff46d2cd96a1]
这行日志表示一个新的通话channel初始化完成。
如果我们希望知道channel是如何初始化和启动的，该如何去梳理代码流程呢，有以下几种方式。
1， 查看源码。但是fs的源码比较复杂，调用层次多，第三方库也多。
2， 打印跟踪日志。常规操作，最常见也最简单的方式。
3， 堆栈打印。使用系统库函数打印堆栈来查看调用流程。
今天我们介绍第3种方式，通过堆栈来查看channel的初始化流程。
环境
centos：CentOS release 7.0 (Final)或以上版本
freeswitch：v1.8.7
GCC：4.8.5
代码修改
修改src\switch_channel.c文件，代码如下，其中print_stack函数用来打印函数堆栈信息。对于backtrace的介绍在网上有很多，这里就不详细说明了。
#include <execinfo.h>
static void print_stack()
{
void *stacktrace[99];
char **symbols;
int size;
int i;
size = backtrace(stacktrace, 99);
symbols = backtrace_symbols(stacktrace, size);
if (!symbols) {
return;
}
for (i = 0; i < size; i++) {
switch_log_printf(SWITCH_CHANNEL_LOG, SWITCH_LOG_NOTICE, "STACK: %s\n", symbols[i]);
}
free(symbols);
}
SWITCH_DECLARE(switch_status_t) switch_channel_set_name(switch_channel_t *channel, const char *name)
{
const char *old = NULL;
switch_assert(channel != NULL);
if (!zstr(channel->name)) {
old = channel->name;
}
channel->name = NULL;
if (name) {
char *uuid = switch_core_session_get_uuid(channel->session);
channel->name = switch_core_session_strdup(channel->session, name);
switch_channel_set_variable(channel, SWITCH_CHANNEL_NAME_VARIABLE, name);
if (old) {
switch_log_printf(SWITCH_CHANNEL_CHANNEL_LOG(channel), SWITCH_LOG_NOTICE, "Rename Channel %s->%s [%s]\n", old, name, uuid);
} else {
switch_log_printf(SWITCH_CHANNEL_CHANNEL_LOG(channel), SWITCH_LOG_NOTICE, "New Channel %s [%s]\n", name, uuid);
print_stack();
}
}
return SWITCH_STATUS_SUCCESS;
}
对freeswitch的代码重新编译安装，并启动fs进程。
呼叫测试
1001号码通过SIP注册到FS服务器，并发起INVITE呼叫，呼叫不需要通过，仅仅关注主叫方A路的通道初始化过程。
------------------------------------------------------------------------
INVITE sip:1002@192.168.0.152 SIP/2.0
Via: SIP/2.0/UDP 10.9.0.70:25969;branch=z9hG4bK-d87543-010e715d272bcd27-1--d87543-;rport
Max-Forwards: 70
Contact: <sip:1001@10.9.0.70:25969>
To: "1002"<sip:1002@192.168.0.152>
From: "1001"<sip:1001@192.168.0.152>;tag=9b6ae45a
Call-ID: NDJjYzY2NDMwZmQ1ZWE5YmY3ZjE3MWNiNGIwNmQ5YWQ.
CSeq: 1 INVITE
Allow: INVITE, ACK, CANCEL, OPTIONS, BYE, REFER, NOTIFY, MESSAGE, SUBSCRIBE, INFO
Content-Type: application/sdp
User-Agent: eyeBeam release 1004p stamp 31962
Content-Length: 478
v=0
o=- 2 2 IN IP4 10.9.0.70
s=CounterPath eyeBeam 1.5
c=IN IP4 10.9.0.70
t=0 0
m=audio 41980 RTP/AVP 0 98 18 101
a=alt:1 4 : 2cib73mX anCjScUO 10.9.0.70 41980
a=fmtp:18 annexb=no
a=fmtp:101 0-15
a=rtpmap:98 iLBC/8000
a=rtpmap:101 telephone-event/8000
a=sendrecv
a=x-rtp-session-id:F73CAA782C7D401EBE0ACC803E495B81
------------------------------------------------------------------------
switch_channel.c:1133 New Channel sofia/internal/1001@192.168.0.152 [d70acc45-294c-4787-8dce-ff46d2cd96a1]
switch_channel.c:1112 STACK: /usr/local/freeswitch/lib/libfreeswitch.so.1(+0x5f14d) [0x7fc46acb314d]
switch_channel.c:1112 STACK: /usr/local/freeswitch/lib/libfreeswitch.so.1(switch_channel_set_name+0x129) [0x7fc46acb9b59]
switch_channel.c:1112 STACK: /usr/local/freeswitch/mod/mod_sofia.so(+0x89a7c) [0x7fc4612bea7c]
switch_channel.c:1112 STACK: /usr/local/freeswitch/mod/mod_sofia.so(+0x8a25e) [0x7fc4612bf25e]
switch_channel.c:1112 STACK: /usr/local/freeswitch/mod/mod_sofia.so(+0x5c3b7) [0x7fc4612913b7]
switch_channel.c:1112 STACK: /usr/local/freeswitch/mod/mod_sofia.so(+0x11dfc1) [0x7fc461352fc1]
switch_channel.c:1112 STACK: /usr/local/freeswitch/mod/mod_sofia.so(+0x151e52) [0x7fc461386e52]
switch_channel.c:1112 STACK: /usr/local/freeswitch/mod/mod_sofia.so(+0x1524a1) [0x7fc4613874a1]
switch_channel.c:1112 STACK: /usr/local/freeswitch/mod/mod_sofia.so(+0x61ea4) [0x7fc461296ea4]
switch_channel.c:1112 STACK: /usr/local/freeswitch/lib/libfreeswitch.so.1(+0x35bbd0) [0x7fc46afafbd0]
switch_channel.c:1112 STACK: /lib64/libpthread.so.0(+0x7ea5) [0x7fc468893ea5]
switch_channel.c:1112 STACK: /lib64/libc.so.6(clone+0x6d) [0x7fc467ee7b0d]
在上面的日志打印中，我们可以看到“STACK”的打印，就是函数调用堆栈的信息。
但是打印信息中，我们只能看到模块的名字和地址信息，看不到具体的函数名。
比如，在mod_sofia.so模块中，就有7次调用，无法看到函数名。
在尝试了对gcc编译参数增加“-ggdb”和“-rdynamic”之后，函数名的问题仍然无法解决。
后面通过“addr2line”工具，间接的查找到函数名。
函数名查看
通过“addr2line”工具，使用模块名和偏移地址，查找函数名。
addr2line 0x5f14d -e /usr/local/freeswitch/lib/libfreeswitch.so.1 -f
print_stack
/root/zr/freeswitch-1.8.7/src/switch_channel.c:1107
switch_channel.c:1112 STACK: /usr/local/freeswitch/lib/libfreeswitch.so.1(switch_channel_set_name+0x129) [0x7fc46acb9b59]
addr2line 0x89a7c -e /usr/local/freeswitch/mod/mod_sofia.so -f
sofia_glue_set_name
/root/zr/freeswitch-1.8.7/src/mod/endpoints/mod_sofia/sofia_glue.c:70
addr2line 0x8a25e -e /usr/local/freeswitch/mod/mod_sofia.so -f
sofia_glue_attach_private
/root/zr/freeswitch-1.8.7/src/mod/endpoints/mod_sofia/sofia_glue.c:208
addr2line 0x5c3b7 -e /usr/local/freeswitch/mod/mod_sofia.so -f
sofia_event_callback
/root/zr/freeswitch-1.8.7/src/mod/endpoints/mod_sofia/sofia.c:2578
addr2line 0x11dfc1 -e /usr/local/freeswitch/mod/mod_sofia.so -f
su_msg_is_non_null
/root/zr/freeswitch-1.8.7/libs/sofia-sip/libsofia-sip-ua/nua/../../libsofia-sip-ua/su/sofia-sip/su_wait.h:565 (discriminator 5)
addr2line 0x151e52 -e /usr/local/freeswitch/mod/mod_sofia.so -f
su_base_port_execute_msgs
/root/zr/freeswitch-1.8.7/libs/sofia-sip/libsofia-sip-ua/su/su_base_port.c:283
addr2line 0x1524a1 -e /usr/local/freeswitch/mod/mod_sofia.so -f
su_base_port_step
/root/zr/freeswitch-1.8.7/libs/sofia-sip/libsofia-sip-ua/su/su_base_port.c:473
addr2line 0x61ea4 -e /usr/local/freeswitch/mod/mod_sofia.so -f
sofia_profile_thread_run
/root/zr/freeswitch-1.8.7/src/mod/endpoints/mod_sofia/sofia.c:3392
addr2line 0x35bbd0 -e /usr/local/freeswitch/lib/libfreeswitch.so.1 -f
dummy_worker
/root/zr/freeswitch-1.8.7/libs/apr/threadproc/unix/thread.c:152
addr2line 0x7ea5 -e /lib64/libpthread.so.0 -f
start_thread
pthread_create.c:?
channel初始化流程
从上面可以看出一通新的呼叫channel的初始化过程如下。
sofia_profile_thread_run->su_base_port_step->su_base_port_execute_msgs->su_msg_is_non_null->sofia_event_callback->sofia_glue_attach_private->sofia_glue_set_name->switch_channel_set_name
sofia_profile_thread_run，mod_sofia模块，启动profile端口监听。
su_base_port_step，sofia_sip库，端口收到消息。
su_base_port_execute_msgs，sofia_sip库，分发消息。
sofia_event_callback，mod_sofia模块，sip消息回调函数。
sofia_glue_attach_private，mod_sofia模块，初始化session和channel的参数设置。
sofia_glue_set_name，mod_sofia模块，设置channel名称。
switch_channel_set_name，freeswitch核心，设置channel名称。
到底为止，我们就回到了文章最开始的地方，日志打印“New Channel”的地方。
总结
我们使用了系统库函数backtrace和工具addr2line，得到了函数调用的流程。
在fs这种复杂的代码架构中，单纯使用backtrace无法解决全部问题。
查看代码流程多了一种不同的方式，对于工作中解决问题有帮助。
空空如常
求真得真
