FreeSWITCH模块加载过程

一、模块接口 

FreeSWITCH的大部分功能是通过加载外部的模块来实现的。模块通过一个数据结构向外部暴露了自己的接口。该数据结构定义如下：

typedef struct switch_loadable_module_function_table {

       int switch_api_version;

       switch_module_load_t load;

       switch_module_shutdown_t shutdown;

       switch_module_runtime_t runtime;

       switch_module_flag_t flags;

} switch_loadable_module_function_table_t;

    模块被成功加载后，会搜索这个数据结构的变量，从其中获取到导出的函数。这个变量名由如下方式组成：

          模块名 + _module_interface

二、sofia模块

     以mod_sofia为例描述模块的加载过程。根据规则mod_sofia模块的接口变量名为：mod_sofia_module_interface。在动态加载mod_sofia.so库后，查找mod_sofia_module_interface变量，其中的load函数指针必须指向一个有效的函数，否则加载模块将失败。随后，调用load函数，对于mod_sofia模块来说，最终调用的是mod_sofia.c中的mod_sofia_load函数。

       在成功调用函数mod_sofia_load后，将获取到一个类型为switch_loadable_module_interface_t的变量module_interface，该数据类型定义如下：

struct switch_loadable_module_interface 

{

const char *module_name;

switch_endpoint_interface_t *endpoint_interface;

switch_timer_interface_t *timer_interface;

switch_dialplan_interface_t *dialplan_interface;

switch_codec_interface_t *codec_interface;

switch_application_interface_t *application_interface;

switch_chat_application_interface_t *chat_application_interface;

switch_api_interface_t *api_interface;

switch_json_api_interface_t *json_api_interface;

switch_file_interface_t *file_interface;

switch_speech_interface_t *speech_interface;

switch_directory_interface_t *directory_interface;

switch_chat_interface_t *chat_interface;

switch_say_interface_t *say_interface;

switch_asr_interface_t *asr_interface;

switch_management_interface_t *management_interface;

switch_limit_interface_t *limit_interface;

switch_thread_rwlock_t *rwlock;

int refs;

switch_memory_pool_t *pool;

};

    动态库mod_sofia.so加载成功后，会把最终的结果整理为一个结构，供上层使用，该数据结构定义如下：

struct switch_loadable_module {

char *key;

char *filename;

int perm;

switch_loadable_module_interface_t *module_interface;

switch_dso_lib_t lib;

switch_module_load_t switch_module_load;

switch_module_runtime_t switch_module_runtime;

switch_module_shutdown_t switch_module_shutdown;

switch_memory_pool_t *pool;

switch_status_t status;

switch_thread_t *thread;

switch_bool_t shutting_down;

};

      其中最重要的成员是来自变量mod_sofia_module_interface的三个函数switch_module_load、switch_module_runtime、switch_module_shutdown，以及通过load函数获取的接口module_interface。

       mod_sofia模块中只导出了mod_sofia_load、 mod_sofia_shutdown两个函数，switch_module_runtime未实现。在mod_sofia.c中，使用宏SWITCH_MODULE_DEFINITION定义了结构变量mod_sofia_module_interface供so文件导出