我爱编程

FreeSWITCH模块加载过程

2018-04-16  本文已影响0人  火星凯撒

一、模块接口 

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文件导出

上一篇下一篇

猜你喜欢

热点阅读