深入浅出asterisk(五):pbx.c代码分析

pbx.c主要实现了builtin applications，也就是内置的应用，比如最常见的Answer,Hangup, Background,Wait等等。

在/main/asterisk.c中有一段代码调用load_pbx()负责加载builtin applications。

02895    if (load_pbx()) {
   
   

02896       printf(term_quit());
   
   

02897       exit(1);
   
   

02898    }
   
   

这个load_pbx()函数就是实现在pbx.c中，它的主要任务是遍历全局数组builtins中每个application信息，调用ast_register_application()注册application的各自入口函数。

06046    /* Register builtin applications */
    
    

06047    for (x=0; x<sizeof(builtins) / sizeof(struct pbx_builtin); x++) {
   
   

06048       if (option_verbose)
   
   

06049          ast_verbose( VERBOSE_PREFIX_1 "[%s]/n", builtins[x].name);
   
   

06050       if (ast_register_application(builtins[x].name, builtins[x].execute, builtins[x].synopsis, builtins[x].description)) {
   
   

06051          ast_log(LOG_ERROR, "Unable to register builtin application '%s'/n", builtins[x].name);
   
   

06052          return -1;
   
   

06053       }
   
   

06054    }
   
   

比如Hangup应用的入口函数就是pbx_builtin_hangup()

00364    { "Hangup", pbx_builtin_hangup,
   
   

00365    "Hang up the calling channel",
   
   

00366    "  Hangup([causecode]): This application will hang up the calling channel./n"
    
    

00367    "If a causecode is given the channel's hangup cause will be set to the given/n"
    
    

00368    "value./n"
    
    

00369    },
   
   

 

 

下面我们分析一下pbx_builtin_hangup()函数，这个函数查看参数data调用ast_str2cause()获取挂断码，如果没有获取到，则设置chan->hangupcause为

AST_CAUSE_NORMAL_CLEARING，也就是0。

05448 /*!
    
    

05449  * /ingroup applications
    
    

05450  */
    
    

05451 static int pbx_builtin_hangup(struct ast_channel *chan, void *data)
   
   

05452 {
   
   

05453    if (!ast_strlen_zero(data)) {
   
   

05454       int cause;
   
   

05455       char *endptr;
   
   

05456 
   
   

05457       if ((cause = ast_str2cause(data)) > -1) {
   
   

05458          chan->hangupcause = cause;
   
   

05459          return -1;
   
   

05460       }
   
   

05461       
   
   

05462       cause = strtol((const char *) data, &endptr, 10);
   
   

05463       if (cause != 0 || (data != endptr)) {
   
   

05464          chan->hangupcause = cause;
   
   

05465          return -1;
   
   

05466       }
   
   

05467          
   
   

05468       ast_log(LOG_NOTICE, "Invalid cause given to Hangup(): /"%s/"/n", (char *) data);
   
   

05469    }
   
   

05470 
   
   

05471    if (!chan->hangupcause) {
   
   

05472       chan->hangupcause = AST_CAUSE_NORMAL_CLEARING;
   
   

05473    }
   
   

05474 
   
   

05475    return -1;
   
   

05476 }
   
   

看看pbx_exec()函数，这个函数是所有application被调用的入口处。它首先保存channel的两个变量，appl和data，分别表示正在调用的application名和参数。然后调用app->execute(c, data)进入真正的处理，完后恢复appl和data的值，有点像堆栈的管理

00507 /*
    
    

00508    /note This function is special. It saves the stack so that no matter
    
    

00509    how many times it is called, it returns to the same place */
    
    

00510 int pbx_exec(struct ast_channel *c,       /*!< Channel */
    
    

00511         struct ast_app *app,     /*!< Application */
    
    

00512         void *data)        /*!< Data for execution */
    
    

00513 {
   
   

00514    int res;
   
   

00515 
   
   

00516    const char *saved_c_appl;
   
   

00517    const char *saved_c_data;
   
   

00518 
   
   

00519    if (c->cdr &&  !ast_check_hangup(c))
   
   

00520       ast_cdr_setapp(c->cdr, app->name, data);
   
   

00521 
   
   

00522    /* save channel values */
    
    

00523    saved_c_appl= c->appl;
   
   

00524    saved_c_data= c->data;
   
   

00525 
   
   

  
  
   
   00526    c
  
  ->appl = app->name;
   
   

  
  
   
   00527    c
  
  ->data = data;
   
   

00528    /* XXX remember what to to when we have linked apps to modules */
    
    

00529    if (app->module) {
   
   

00530       /* XXX LOCAL_USER_ADD(app->module) */
    
    

00531    }
   
   

00532    res = app->execute(c, data);
   
   

00533    if (app->module) {
   
   

00534       /* XXX LOCAL_USER_REMOVE(app->module) */
    
    

00535    }
   
   

00536    /* restore channel values */
    
    

  
  
   
   00537    c
  
  ->appl = saved_c_appl;
   
   

  
  
   
   00538    c
  
  ->data = saved_c_data;
   
   

00539    return res;
   
   

00540 }