freeswitch插件式模块接口实现方式

概述

freeswitch的外围模块是插件式的，可以动态的加载和卸载，使用起来非常的灵活和方便。

如果我们自己来设计一个开源的代码框架，相信这种插件式的模块结构是非常适合多人合作的模式。

本文对fs的模块加载接口进行一些分析和讨论，作为借鉴。

环境

centos：CentOS  release 7.0 (Final)或以上版本

freeswitch：v1.8.7

GCC：4.8.5

模块接口

freeswitch新增mod_task模块的介绍，见之前的文章。

在mod_task模块实现中，有3个最基本的宏定义。分别对应模块的加载，卸载和定义。

SWITCH_MODULE_LOAD_FUNCTION(mod_task_load);

SWITCH_MODULE_SHUTDOWN_FUNCTION(mod_task_shutdown);

SWITCH_MODULE_DEFINITION(mod_task, mod_task_load, mod_task_shutdown, NULL);

宏定义展开后

switch_status_t mod_task_load (switch_loadable_module_interface_t **module_interface, switch_memory_pool_t *pool);

switch_status_t mod_task_shutdown (void);

static const char modname[] =  mod_task ;

switch_loadable_module_function_table_t mod_task_module_interface = {

5,

mod_task_load,

mod_task_shutdown,

NULL,

0

};

使用nm命令查看mod_task模块符号表

[root@localhost mod]# nm -s mod_task.so

00000000002020c8 B __bss_start

U bzero@@GLIBC_2.2.5

00000000002020c8 b completed.6355

w __cxa_finalize@@GLIBC_2.2.5

0000000000000b10 t deregister_tm_clones

0000000000000b80 t __do_global_dtors_aux

0000000000201cd0 t __do_global_dtors_aux_fini_array_entry

0000000000201ce0 d __dso_handle

0000000000201ce8 d _DYNAMIC

00000000002020c8 D _edata

00000000002020d0 B _end

0000000000001060 T _fini

0000000000000bc0 t frame_dummy

0000000000201cc8 t __frame_dummy_init_array_entry

00000000000014c0 r __FRAME_END__

U free@@GLIBC_2.2.5

00000000000012c0 r __func__.18215

0000000000001300 r __func__.18222

00000000000012e0 r __func__.18230

00000000000012d2 r __func__.18237

00000000000012a0 r __func__.18245

0000000000202000 d _GLOBAL_OFFSET_TABLE_

w __gmon_start__

000000000000132c r __GNU_EH_FRAME_HDR

00000000000009f8 T _init

w _ITM_deregisterTMCloneTable

w _ITM_registerTMCloneTable

0000000000201cd8 d __JCR_END__

0000000000201cd8 d __JCR_LIST__

w _Jv_RegisterClasses

0000000000001323 r modname

0000000000000c40 t mod_task_load

00000000002020a0 D mod_task_module_interface

0000000000000c00 t mod_task_shutdown

0000000000000b40 t register_tm_clones

U __strdup@@GLIBC_2.2.5

U switch_channel_export_variable_var_check

U switch_console_set_complete

U switch_core_session_get_channel

U switch_event_bind

U switch_event_get_header_idx

U switch_loadable_module_create_interface

U switch_loadable_module_create_module_interface

U switch_log_printf

U switch_separate_string

0000000000000d80 t task_api_function

0000000000000ee0 t task_app_function

0000000000000f70 t task_event_channel_hangup_complete

0000000000001010 t task_event_handler

00000000002020c8 d __TMC_END__

模块加载

freeswitch启动过程中，会根据配置文件“/usr/local/freeswitch/conf/autoload_configs/modules.conf.xml”的内容，顺序加载所有模块。

对某一个模块的加载过程参考“src\switch_loadable_module.c”文件中的“switch_loadable_module_load_file”函数。

函数中主要使用了“dlopen”，“dlsym”等系统接口，来打开“mod_task.so”动态库文件和查找到”mod_task_module_interface”结构数据。

再调用”mod_task_module_interface->load”函数（指向“mod_task_load”），初始化mod_task模块。

模块卸载

模块卸载的流程参考”src\switch_loadable_module.c”文件中的“do_shutdown”函数。

在全局数据中查找到mod_task模块结构体，调用“module->switch_module_shutdown”函数（指向“mod_task_shutdown”），清理模块，回收资源。

总结

freeswitch使用了系统的动态库管理接口，来动态的加载和卸载外围模块，灵活方便。

空空如常

求真得真