Thu Feb 5 16:25:46 2009

Asterisk developer's documentation


config.c

Go to the documentation of this file.
00001 /*
00002  * Asterisk -- An open source telephony toolkit.
00003  *
00004  * Copyright (C) 1999 - 2005, Digium, Inc.
00005  *
00006  * Mark Spencer <markster@digium.com>
00007  *
00008  * See http://www.asterisk.org for more information about
00009  * the Asterisk project. Please do not directly contact
00010  * any of the maintainers of this project for assistance;
00011  * the project provides a web site, mailing lists and IRC
00012  * channels for your use.
00013  *
00014  * This program is free software, distributed under the terms of
00015  * the GNU General Public License Version 2. See the LICENSE file
00016  * at the top of the source tree.
00017  */
00018 
00019 /*! \file
00020  *
00021  * \brief Configuration File Parser
00022  *
00023  * \author Mark Spencer <markster@digium.com>
00024  *
00025  * Includes the Asterisk Realtime API - ARA
00026  * See doc/realtime.txt and doc/extconfig.txt
00027  */
00028 
00029 #include "asterisk.h"
00030 
00031 ASTERISK_FILE_VERSION(__FILE__, "$Revision: 139769 $")
00032 
00033 #include <stdio.h>
00034 #include <unistd.h>
00035 #include <stdlib.h>
00036 #include <string.h>
00037 #include <errno.h>
00038 #include <time.h>
00039 #include <sys/stat.h>
00040 #define AST_INCLUDE_GLOB 1
00041 #ifdef AST_INCLUDE_GLOB
00042 #if defined(__Darwin__) || defined(__CYGWIN__)
00043 #define GLOB_ABORTED GLOB_ABEND
00044 #endif
00045 # include <glob.h>
00046 #endif
00047 
00048 #include "asterisk/config.h"
00049 #include "asterisk/cli.h"
00050 #include "asterisk/lock.h"
00051 #include "asterisk/options.h"
00052 #include "asterisk/logger.h"
00053 #include "asterisk/utils.h"
00054 #include "asterisk/channel.h"
00055 #include "asterisk/app.h"
00056 
00057 #define MAX_NESTED_COMMENTS 128
00058 #define COMMENT_START ";--"
00059 #define COMMENT_END "--;"
00060 #define COMMENT_META ';'
00061 #define COMMENT_TAG '-'
00062 
00063 static char *extconfig_conf = "extconfig.conf";
00064 
00065 
00066 /*! \brief Structure to keep comments for rewriting configuration files */
00067 struct ast_comment {
00068    struct ast_comment *next;
00069    char cmt[0];
00070 };
00071 
00072 #define CB_INCR 250
00073 
00074 static void CB_INIT(char **comment_buffer, int *comment_buffer_size, char **lline_buffer, int *lline_buffer_size)
00075 {
00076    if (!(*comment_buffer)) {
00077       *comment_buffer = ast_malloc(CB_INCR);
00078       if (!(*comment_buffer))
00079          return;
00080       (*comment_buffer)[0] = 0;
00081       *comment_buffer_size = CB_INCR;
00082       *lline_buffer = ast_malloc(CB_INCR);
00083       if (!(*lline_buffer))
00084          return;
00085       (*lline_buffer)[0] = 0;
00086       *lline_buffer_size = CB_INCR;
00087    } else {
00088       (*comment_buffer)[0] = 0;
00089       (*lline_buffer)[0] = 0;
00090    }
00091 }
00092 
00093 static void  CB_ADD(char **comment_buffer, int *comment_buffer_size, char *str)
00094 {
00095    int rem = *comment_buffer_size - strlen(*comment_buffer) - 1;
00096    int siz = strlen(str);
00097    if (rem < siz+1) {
00098       *comment_buffer = ast_realloc(*comment_buffer, *comment_buffer_size + CB_INCR + siz + 1);
00099       if (!(*comment_buffer))
00100          return;
00101       *comment_buffer_size += CB_INCR+siz+1;
00102    }
00103    strcat(*comment_buffer,str);
00104 }
00105 
00106 static void  CB_ADD_LEN(char **comment_buffer, int *comment_buffer_size, char *str, int len)
00107 {
00108    int cbl = strlen(*comment_buffer) + 1;
00109    int rem = *comment_buffer_size - cbl;
00110    if (rem < len+1) {
00111       *comment_buffer = ast_realloc(*comment_buffer, *comment_buffer_size + CB_INCR + len + 1);
00112       if (!(*comment_buffer))
00113          return;
00114       *comment_buffer_size += CB_INCR+len+1;
00115    }
00116    strncat(*comment_buffer,str,len);
00117    (*comment_buffer)[cbl+len-1] = 0;
00118 }
00119 
00120 static void  LLB_ADD(char **lline_buffer, int *lline_buffer_size, char *str)
00121 {
00122    int rem = *lline_buffer_size - strlen(*lline_buffer) - 1;
00123    int siz = strlen(str);
00124    if (rem < siz+1) {
00125       *lline_buffer = ast_realloc(*lline_buffer, *lline_buffer_size + CB_INCR + siz + 1);
00126       if (!(*lline_buffer)) 
00127          return;
00128       *lline_buffer_size += CB_INCR + siz + 1;
00129    }
00130    strcat(*lline_buffer,str);
00131 }
00132 
00133 static void CB_RESET(char **comment_buffer, char **lline_buffer)  
00134 { 
00135    (*comment_buffer)[0] = 0; 
00136    (*lline_buffer)[0] = 0;
00137 }
00138 
00139 
00140 static struct ast_comment *ALLOC_COMMENT(const char *buffer)
00141 { 
00142    struct ast_comment *x = ast_calloc(1,sizeof(struct ast_comment)+strlen(buffer)+1);
00143    strcpy(x->cmt, buffer);
00144    return x;
00145 }
00146 
00147 
00148 static struct ast_config_map {
00149    struct ast_config_map *next;
00150    char *name;
00151    char *driver;
00152    char *database;
00153    char *table;
00154    char stuff[0];
00155 } *config_maps = NULL;
00156 
00157 AST_MUTEX_DEFINE_STATIC(config_lock);
00158 static struct ast_config_engine *config_engine_list;
00159 
00160 #define MAX_INCLUDE_LEVEL 10
00161 
00162 struct ast_category_template_instance {
00163    char name[80]; /* redundant? */
00164    const struct ast_category *inst;
00165    AST_LIST_ENTRY(ast_category_template_instance) next;
00166 };
00167 
00168 struct ast_category {
00169    char name[80];
00170    int ignored;         /*!< do not let user of the config see this category */
00171    int include_level;   
00172    AST_LIST_HEAD_NOLOCK(template_instance_list, ast_category_template_instance) template_instances;
00173    struct ast_comment *precomments;
00174    struct ast_comment *sameline;
00175    struct ast_variable *root;
00176    struct ast_variable *last;
00177    struct ast_category *next;
00178 };
00179 
00180 struct ast_config {
00181    struct ast_category *root;
00182    struct ast_category *last;
00183    struct ast_category *current;
00184    struct ast_category *last_browse;      /*!< used to cache the last category supplied via category_browse */
00185    int include_level;
00186    int max_include_level;
00187 };
00188 
00189 struct ast_variable *ast_variable_new(const char *name, const char *value) 
00190 {
00191    struct ast_variable *variable;
00192    int name_len = strlen(name) + 1; 
00193 
00194    if ((variable = ast_calloc(1, name_len + strlen(value) + 1 + sizeof(*variable)))) {
00195       variable->name = variable->stuff;
00196       variable->value = variable->stuff + name_len;      
00197       strcpy(variable->name,name);
00198       strcpy(variable->value,value);
00199    }
00200 
00201    return variable;
00202 }
00203 
00204 void ast_variable_append(struct ast_category *category, struct ast_variable *variable)
00205 {
00206    if (!variable)
00207       return;
00208    if (category->last)
00209       category->last->next = variable;
00210    else
00211       category->root = variable;
00212    category->last = variable;
00213    while (category->last->next)
00214       category->last = category->last->next;
00215 }
00216 
00217 void ast_variables_destroy(struct ast_variable *v)
00218 {
00219    struct ast_variable *vn;
00220 
00221    while(v) {
00222       vn = v;
00223       v = v->next;
00224       free(vn);
00225    }
00226 }
00227 
00228 struct ast_variable *ast_variable_browse(const struct ast_config *config, const char *category)
00229 {
00230    struct ast_category *cat = NULL;
00231 
00232    if (category && config->last_browse && (config->last_browse->name == category))
00233       cat = config->last_browse;
00234    else
00235       cat = ast_category_get(config, category);
00236 
00237    return (cat) ? cat->root : NULL;
00238 }
00239 
00240 const char *ast_config_option(struct ast_config *cfg, const char *cat, const char *var)
00241 {
00242    const char *tmp;
00243    tmp = ast_variable_retrieve(cfg, cat, var);
00244    if (!tmp)
00245       tmp = ast_variable_retrieve(cfg, "general", var);
00246    return tmp;
00247 }
00248 
00249 
00250 struct ast_variable *ast_variable_next(struct ast_config *config, char *category,struct ast_variable *prev)
00251 {
00252    struct ast_variable *v = NULL;
00253    v = ast_variable_browse(config, category);
00254    if(v) {
00255      if(prev) {
00256       while (v) {
00257         if (v == prev)
00258          return v->next;
00259         v=v->next;
00260       }
00261      } else {
00262       return v;
00263      }
00264    }
00265    return NULL;
00266 }
00267 
00268 
00269 const char *ast_variable_retrieve(const struct ast_config *config, const char *category, const char *variable)
00270 {
00271    struct ast_variable *v;
00272 
00273    if (category) {
00274       for (v = ast_variable_browse(config, category); v; v = v->next) {
00275          if (!strcasecmp(variable, v->name))
00276             return v->value;
00277       }
00278    } else {
00279       struct ast_category *cat;
00280 
00281       for (cat = config->root; cat; cat = cat->next)
00282          for (v = cat->root; v; v = v->next)
00283             if (!strcasecmp(variable, v->name))
00284                return v->value;
00285    }
00286 
00287    return NULL;
00288 }
00289 
00290 static struct ast_variable *variable_clone(const struct ast_variable *old)
00291 {
00292    struct ast_variable *new = ast_variable_new(old->name, old->value);
00293 
00294    if (new) {
00295       new->lineno = old->lineno;
00296       new->object = old->object;
00297       new->blanklines = old->blanklines;
00298       /* TODO: clone comments? */
00299    }
00300 
00301    return new;
00302 }
00303  
00304 static void move_variables(struct ast_category *old, struct ast_category *new)
00305 {
00306    struct ast_variable *var = old->root;
00307    old->root = NULL;
00308 #if 1
00309    /* we can just move the entire list in a single op */
00310    ast_variable_append(new, var);
00311 #else
00312    while (var) {
00313       struct ast_variable *next = var->next;
00314       var->next = NULL;
00315       ast_variable_append(new, var);
00316       var = next;
00317    }
00318 #endif
00319 }
00320 
00321 struct ast_category *ast_category_new(const char *name) 
00322 {
00323    struct ast_category *category;
00324 
00325    if ((category = ast_calloc(1, sizeof(*category))))
00326       ast_copy_string(category->name, name, sizeof(category->name));
00327    return category;
00328 }
00329 
00330 static struct ast_category *category_get(const struct ast_config *config, const char *category_name, int ignored)
00331 {
00332    struct ast_category *cat;
00333 
00334    /* try exact match first, then case-insensitive match */
00335    for (cat = config->root; cat; cat = cat->next) {
00336       if (cat->name == category_name && (ignored || !cat->ignored))
00337          return cat;
00338    }
00339 
00340    for (cat = config->root; cat; cat = cat->next) {
00341       if (!strcasecmp(cat->name, category_name) && (ignored || !cat->ignored))
00342          return cat;
00343    }
00344 
00345    return NULL;
00346 }
00347 
00348 struct ast_category *ast_category_get(const struct ast_config *config, const char *category_name)
00349 {
00350    return category_get(config, category_name, 0);
00351 }
00352 
00353 int ast_category_exist(const struct ast_config *config, const char *category_name)
00354 {
00355    return !!ast_category_get(config, category_name);
00356 }
00357 
00358 void ast_category_append(struct ast_config *config, struct ast_category *category)
00359 {
00360    if (config->last)
00361       config->last->next = category;
00362    else
00363       config->root = category;
00364    category->include_level = config->include_level;
00365    config->last = category;
00366    config->current = category;
00367 }
00368 
00369 static void ast_destroy_comments(struct ast_category *cat)
00370 {
00371    struct ast_comment *n, *p;
00372    for (p=cat->precomments; p; p=n) {
00373       n = p->next;
00374       free(p);
00375    }
00376    for (p=cat->sameline; p; p=n) {
00377       n = p->next;
00378       free(p);
00379    }
00380    cat->precomments = NULL;
00381    cat->sameline = NULL;
00382 }
00383 
00384 static void ast_destroy_template_list(struct ast_category *cat)
00385 {
00386    struct ast_category_template_instance *x;
00387    AST_LIST_TRAVERSE_SAFE_BEGIN(&cat->template_instances, x, next) {
00388       AST_LIST_REMOVE_CURRENT(&cat->template_instances, next);
00389       free(x);
00390    }
00391    AST_LIST_TRAVERSE_SAFE_END;
00392 }
00393 
00394 void ast_category_destroy(struct ast_category *cat)
00395 {
00396    ast_variables_destroy(cat->root);
00397    ast_destroy_comments(cat);
00398    ast_destroy_template_list(cat);
00399    free(cat);
00400 }
00401 
00402 static struct ast_category *next_available_category(struct ast_category *cat)
00403 {
00404    for (; cat && cat->ignored; cat = cat->next);
00405 
00406    return cat;
00407 }
00408 
00409 struct ast_variable *ast_category_root(struct ast_config *config, char *cat)
00410 {
00411    struct ast_category *category = ast_category_get(config, cat);
00412    if (category)
00413       return category->root;
00414    return NULL;
00415 }
00416 
00417 char *ast_category_browse(struct ast_config *config, const char *prev)
00418 {  
00419    struct ast_category *cat = NULL;
00420 
00421    if (prev && config->last_browse && (config->last_browse->name == prev))
00422       cat = config->last_browse->next;
00423    else if (!prev && config->root)
00424       cat = config->root;
00425    else if (prev) {
00426       for (cat = config->root; cat; cat = cat->next) {
00427          if (cat->name == prev) {
00428             cat = cat->next;
00429             break;
00430          }
00431       }
00432       if (!cat) {
00433          for (cat = config->root; cat; cat = cat->next) {
00434             if (!strcasecmp(cat->name, prev)) {
00435                cat = cat->next;
00436                break;
00437             }
00438          }
00439       }
00440    }
00441    
00442    if (cat)
00443       cat = next_available_category(cat);
00444 
00445    config->last_browse = cat;
00446    return (cat) ? cat->name : NULL;
00447 }
00448 
00449 struct ast_variable *ast_category_detach_variables(struct ast_category *cat)
00450 {
00451    struct ast_variable *v;
00452 
00453    v = cat->root;
00454    cat->root = NULL;
00455    cat->last = NULL;
00456 
00457    return v;
00458 }
00459 
00460 void ast_category_rename(struct ast_category *cat, const char *name)
00461 {
00462    ast_copy_string(cat->name, name, sizeof(cat->name));
00463 }
00464 
00465 static void inherit_category(struct ast_category *new, const struct ast_category *base)
00466 {
00467    struct ast_variable *var;
00468    struct ast_category_template_instance *x = ast_calloc(1,sizeof(struct ast_category_template_instance));
00469    strcpy(x->name, base->name);
00470    x->inst = base;
00471    AST_LIST_INSERT_TAIL(&new->template_instances, x, next);
00472    for (var = base->root; var; var = var->next)
00473       ast_variable_append(new, variable_clone(var));
00474 }
00475 
00476 struct ast_config *ast_config_new(void) 
00477 {
00478    struct ast_config *config;
00479 
00480    if ((config = ast_calloc(1, sizeof(*config))))
00481       config->max_include_level = MAX_INCLUDE_LEVEL;
00482    return config;
00483 }
00484 
00485 int ast_variable_delete(struct ast_category *category, char *variable, char *match)
00486 {
00487    struct ast_variable *cur, *prev=NULL, *curn;
00488    int res = -1;
00489    cur = category->root;
00490    while (cur) {
00491       if (cur->name == variable) {
00492          if (prev) {
00493             prev->next = cur->next;
00494             if (cur == category->last)
00495                category->last = prev;
00496          } else {
00497             category->root = cur->next;
00498             if (cur == category->last)
00499                category->last = NULL;
00500          }
00501          cur->next = NULL;
00502          ast_variables_destroy(cur);
00503          return 0;
00504       }
00505       prev = cur;
00506       cur = cur->next;
00507    }
00508 
00509    prev = NULL;
00510    cur = category->root;
00511    while (cur) {
00512       curn = cur->next;
00513       if (!strcasecmp(cur->name, variable) && (ast_strlen_zero(match) || !strcasecmp(cur->value, match))) {
00514          if (prev) {
00515             prev->next = cur->next;
00516             if (cur == category->last)
00517                category->last = prev;
00518          } else {
00519             category->root = cur->next;
00520             if (cur == category->last)
00521                category->last = NULL;
00522          }
00523          cur->next = NULL;
00524          ast_variables_destroy(cur);
00525          res = 0;
00526       } else
00527          prev = cur;
00528 
00529       cur = curn;
00530    }
00531    return res;
00532 }
00533 
00534 int ast_variable_update(struct ast_category *category, const char *variable, 
00535    const char *value, const char *match, unsigned int object)
00536 {
00537    struct ast_variable *cur, *prev=NULL, *newer;
00538 
00539    if (!(newer = ast_variable_new(variable, value)))
00540       return -1;
00541    
00542    newer->object = object;
00543 
00544    for (cur = category->root; cur; prev = cur, cur = cur->next) {
00545       if (strcasecmp(cur->name, variable) ||
00546          (!ast_strlen_zero(match) && strcasecmp(cur->value, match)))
00547          continue;
00548 
00549       newer->next = cur->next;
00550       newer->object = cur->object || object;
00551       if (prev)
00552          prev->next = newer;
00553       else
00554          category->root = newer;
00555       if (category->last == cur)
00556          category->last = newer;
00557 
00558       cur->next = NULL;
00559       ast_variables_destroy(cur);
00560 
00561       return 0;
00562    }
00563 
00564    if (prev)
00565       prev->next = newer;
00566    else
00567       category->root = newer;
00568 
00569    return 0;
00570 }
00571 
00572 int ast_category_delete(struct ast_config *cfg, char *category)
00573 {
00574    struct ast_category *prev=NULL, *cat;
00575    cat = cfg->root;
00576    while(cat) {
00577       if (cat->name == category) {
00578          if (prev) {
00579             prev->next = cat->next;
00580             if (cat == cfg->last)
00581                cfg->last = prev;
00582          } else {
00583             cfg->root = cat->next;
00584             if (cat == cfg->last)
00585                cfg->last = NULL;
00586          }
00587          ast_category_destroy(cat);
00588          return 0;
00589       }
00590       prev = cat;
00591       cat = cat->next;
00592    }
00593 
00594    prev = NULL;
00595    cat = cfg->root;
00596    while(cat) {
00597       if (!strcasecmp(cat->name, category)) {
00598          if (prev) {
00599             prev->next = cat->next;
00600             if (cat == cfg->last)
00601                cfg->last = prev;
00602          } else {
00603             cfg->root = cat->next;
00604             if (cat == cfg->last)
00605                cfg->last = NULL;
00606          }
00607          ast_category_destroy(cat);
00608          return 0;
00609       }
00610       prev = cat;
00611       cat = cat->next;
00612    }
00613    return -1;
00614 }
00615 
00616 void ast_config_destroy(struct ast_config *cfg)
00617 {
00618    struct ast_category *cat, *catn;
00619 
00620    if (!cfg)
00621       return;
00622 
00623    cat = cfg->root;
00624    while(cat) {
00625       catn = cat;
00626       cat = cat->next;
00627       ast_category_destroy(catn);
00628    }
00629    free(cfg);
00630 }
00631 
00632 struct ast_category *ast_config_get_current_category(const struct ast_config *cfg)
00633 {
00634    return cfg->current;
00635 }
00636 
00637 void ast_config_set_current_category(struct ast_config *cfg, const struct ast_category *cat)
00638 {
00639    /* cast below is just to silence compiler warning about dropping "const" */
00640    cfg->current = (struct ast_category *) cat;
00641 }
00642 
00643 static int process_text_line(struct ast_config *cfg, struct ast_category **cat, char *buf, int lineno, const char *configfile, int withcomments,
00644             char **comment_buffer, int *comment_buffer_size, char **lline_buffer, int *lline_buffer_size)
00645 {
00646    char *c;
00647    char *cur = buf;
00648    struct ast_variable *v;
00649    char cmd[512], exec_file[512];
00650    int object, do_exec, do_include;
00651 
00652    /* Actually parse the entry */
00653    if (cur[0] == '[') {
00654       struct ast_category *newcat = NULL;
00655       char *catname;
00656 
00657       /* A category header */
00658       c = strchr(cur, ']');
00659       if (!c) {
00660          ast_log(LOG_WARNING, "parse error: no closing ']', line %d of %s\n", lineno, configfile);
00661          return -1;
00662       }
00663       *c++ = '\0';
00664       cur++;
00665       if (*c++ != '(')
00666          c = NULL;
00667       catname = cur;
00668       if (!(*cat = newcat = ast_category_new(catname))) {
00669          return -1;
00670       }
00671       /* add comments */
00672       if (withcomments && *comment_buffer && (*comment_buffer)[0] ) {
00673          newcat->precomments = ALLOC_COMMENT(*comment_buffer);
00674       }
00675       if (withcomments && *lline_buffer && (*lline_buffer)[0] ) {
00676          newcat->sameline = ALLOC_COMMENT(*lline_buffer);
00677       }
00678       if( withcomments )
00679          CB_RESET(comment_buffer, lline_buffer);
00680       
00681       /* If there are options or categories to inherit from, process them now */
00682       if (c) {
00683          if (!(cur = strchr(c, ')'))) {
00684             ast_log(LOG_WARNING, "parse error: no closing ')', line %d of %s\n", lineno, configfile);
00685             return -1;
00686          }
00687          *cur = '\0';
00688          while ((cur = strsep(&c, ","))) {
00689             if (!strcasecmp(cur, "!")) {
00690                (*cat)->ignored = 1;
00691             } else if (!strcasecmp(cur, "+")) {
00692                *cat = category_get(cfg, catname, 1);
00693                if (!(*cat)) {
00694                   if (newcat)
00695                      ast_category_destroy(newcat);
00696                   ast_log(LOG_WARNING, "Category addition requested, but category '%s' does not exist, line %d of %s\n", catname, lineno, configfile);
00697                   return -1;
00698                }
00699                if (newcat) {
00700                   move_variables(newcat, *cat);
00701                   ast_category_destroy(newcat);
00702                   newcat = NULL;
00703                }
00704             } else {
00705                struct ast_category *base;
00706             
00707                base = category_get(cfg, cur, 1);
00708                if (!base) {
00709                   ast_log(LOG_WARNING, "Inheritance requested, but category '%s' does not exist, line %d of %s\n", cur, lineno, configfile);
00710                   return -1;
00711                }
00712                inherit_category(*cat, base);
00713             }
00714          }
00715       }
00716       if (newcat)
00717          ast_category_append(cfg, *cat);
00718    } else if (cur[0] == '#') {
00719       /* A directive */
00720       cur++;
00721       c = cur;
00722       while(*c && (*c > 32)) c++;
00723       if (*c) {
00724          *c = '\0';
00725          /* Find real argument */
00726          c = ast_skip_blanks(c + 1);
00727          if (!(*c))
00728             c = NULL;
00729       } else 
00730          c = NULL;
00731       do_include = !strcasecmp(cur, "include");
00732       if(!do_include)
00733          do_exec = !strcasecmp(cur, "exec");
00734       else
00735          do_exec = 0;
00736       if (do_exec && !ast_opt_exec_includes) {
00737          ast_log(LOG_WARNING, "Cannot perform #exec unless execincludes option is enabled in asterisk.conf (options section)!\n");
00738          do_exec = 0;
00739       }
00740       if (do_include || do_exec) {
00741          if (c) {
00742             /* Strip off leading and trailing "'s and <>'s */
00743             while((*c == '<') || (*c == '>') || (*c == '\"')) c++;
00744             /* Get rid of leading mess */
00745             cur = c;
00746             while (!ast_strlen_zero(cur)) {
00747                c = cur + strlen(cur) - 1;
00748                if ((*c == '>') || (*c == '<') || (*c == '\"'))
00749                   *c = '\0';
00750                else
00751                   break;
00752             }
00753             /* #exec </path/to/executable>
00754                We create a tmp file, then we #include it, then we delete it. */
00755             if (do_exec) { 
00756                snprintf(exec_file, sizeof(exec_file), "/var/tmp/exec.%d.%ld", (int)time(NULL), (long)pthread_self());
00757                snprintf(cmd, sizeof(cmd), "%s > %s 2>&1", cur, exec_file);
00758                ast_safe_system(cmd);
00759                cur = exec_file;
00760             } else
00761                exec_file[0] = '\0';
00762             /* A #include */
00763             do_include = ast_config_internal_load(cur, cfg, withcomments) ? 1 : 0;
00764             if(!ast_strlen_zero(exec_file))
00765                unlink(exec_file);
00766             if (!do_include) {
00767                ast_log(LOG_ERROR, "*********************************************************\n");
00768                ast_log(LOG_ERROR, "*********** YOU SHOULD REALLY READ THIS ERROR ***********\n");
00769                ast_log(LOG_ERROR, "Future versions of Asterisk will treat a #include of a "
00770                                   "file that does not exist as an error, and will fail to "
00771                                   "load that configuration file.  Please ensure that the "
00772                                   "file '%s' exists, even if it is empty.\n", cur);
00773                ast_log(LOG_ERROR, "*********** YOU SHOULD REALLY READ THIS ERROR ***********\n");
00774                ast_log(LOG_ERROR, "*********************************************************\n");
00775                return 0;
00776             }
00777 
00778          } else {
00779             ast_log(LOG_WARNING, "Directive '#%s' needs an argument (%s) at line %d of %s\n", 
00780                   do_exec ? "exec" : "include",
00781                   do_exec ? "/path/to/executable" : "filename",
00782                   lineno,
00783                   configfile);
00784          }
00785       }
00786       else 
00787          ast_log(LOG_WARNING, "Unknown directive '#%s' at line %d of %s\n", cur, lineno, configfile);
00788    } else {
00789       /* Just a line (variable = value) */
00790       if (!(*cat)) {
00791          ast_log(LOG_WARNING,
00792             "parse error: No category context for line %d of %s\n", lineno, configfile);
00793          return -1;
00794       }
00795       c = strchr(cur, '=');
00796       if (c) {
00797          *c = 0;
00798          c++;
00799          /* Ignore > in => */
00800          if (*c== '>') {
00801             object = 1;
00802             c++;
00803          } else
00804             object = 0;
00805          if ((v = ast_variable_new(ast_strip(cur), ast_strip(c)))) {
00806             v->lineno = lineno;
00807             v->object = object;
00808             /* Put and reset comments */
00809             v->blanklines = 0;
00810             ast_variable_append(*cat, v);
00811             /* add comments */
00812             if (withcomments && *comment_buffer && (*comment_buffer)[0] ) {
00813                v->precomments = ALLOC_COMMENT(*comment_buffer);
00814             }
00815             if (withcomments && *lline_buffer && (*lline_buffer)[0] ) {
00816                v->sameline = ALLOC_COMMENT(*lline_buffer);
00817             }
00818             if( withcomments )
00819                CB_RESET(comment_buffer, lline_buffer);
00820             
00821          } else {
00822             return -1;
00823          }
00824       } else {
00825          ast_log(LOG_WARNING, "No '=' (equal sign) in line %d of %s\n", lineno, configfile);
00826       }
00827    }
00828    return 0;
00829 }
00830 
00831 static struct ast_config *config_text_file_load(const char *database, const char *table, const char *filename, struct ast_config *cfg, int withcomments)
00832 {
00833    char fn[256];
00834 #if defined(LOW_MEMORY)
00835    char buf[512];
00836 #else
00837    char buf[8192];
00838 #endif
00839    char *new_buf, *comment_p, *process_buf;
00840    FILE *f;
00841    int lineno=0;
00842    int comment = 0, nest[MAX_NESTED_COMMENTS];
00843    struct ast_category *cat = NULL;
00844    int count = 0;
00845    struct stat statbuf;
00846    /*! Growable string buffer */
00847    char *comment_buffer=0;   /*!< this will be a comment collector.*/
00848    int   comment_buffer_size=0;  /*!< the amount of storage so far alloc'd for the comment_buffer */
00849 
00850    char *lline_buffer=0;    /*!< A buffer for stuff behind the ; */
00851    int  lline_buffer_size=0;
00852 
00853    
00854    cat = ast_config_get_current_category(cfg);
00855 
00856    if (filename[0] == '/') {
00857       ast_copy_string(fn, filename, sizeof(fn));
00858    } else {
00859       snprintf(fn, sizeof(fn), "%s/%s", (char *)ast_config_AST_CONFIG_DIR, filename);
00860    }
00861 
00862    if (withcomments) {
00863       CB_INIT(&comment_buffer, &comment_buffer_size, &lline_buffer, &lline_buffer_size);
00864       if (!lline_buffer || !comment_buffer) {
00865          ast_log(LOG_ERROR, "Failed to initialize the comment buffer!\n");
00866          return NULL;
00867       }
00868    }
00869 #ifdef AST_INCLUDE_GLOB
00870    {
00871       int glob_ret;
00872       glob_t globbuf;
00873       globbuf.gl_offs = 0; /* initialize it to silence gcc */
00874 #ifdef SOLARIS
00875       glob_ret = glob(fn, GLOB_NOCHECK, NULL, &globbuf);
00876 #else
00877       glob_ret = glob(fn, GLOB_NOMAGIC|GLOB_BRACE, NULL, &globbuf);
00878 #endif
00879       if (glob_ret == GLOB_NOSPACE)
00880          ast_log(LOG_WARNING,
00881             "Glob Expansion of pattern '%s' failed: Not enough memory\n", fn);
00882       else if (glob_ret  == GLOB_ABORTED)
00883          ast_log(LOG_WARNING,
00884             "Glob Expansion of pattern '%s' failed: Read error\n", fn);
00885       else  {
00886          /* loop over expanded files */
00887          int i;
00888          for (i=0; i<globbuf.gl_pathc; i++) {
00889             ast_copy_string(fn, globbuf.gl_pathv[i], sizeof(fn));
00890 #endif
00891    do {
00892       if (stat(fn, &statbuf))
00893          continue;
00894 
00895       if (!S_ISREG(statbuf.st_mode)) {
00896          ast_log(LOG_WARNING, "'%s' is not a regular file, ignoring\n", fn);
00897          continue;
00898       }
00899       if (option_verbose > 1) {
00900          ast_verbose(VERBOSE_PREFIX_2 "Parsing '%s': ", fn);
00901          fflush(stdout);
00902       }
00903       if (!(f = fopen(fn, "r"))) {
00904          if (option_debug)
00905             ast_log(LOG_DEBUG, "No file to parse: %s\n", fn);
00906          if (option_verbose > 1)
00907             ast_verbose( "Not found (%s)\n", strerror(errno));
00908          continue;
00909       }
00910       count++;
00911       if (option_debug)
00912          ast_log(LOG_DEBUG, "Parsing %s\n", fn);
00913       if (option_verbose > 1)
00914          ast_verbose("Found\n");
00915       while(!feof(f)) {
00916          lineno++;
00917          if (fgets(buf, sizeof(buf), f)) {
00918             if ( withcomments ) {
00919                CB_ADD(&comment_buffer, &comment_buffer_size, lline_buffer);       /* add the current lline buffer to the comment buffer */
00920                lline_buffer[0] = 0;        /* erase the lline buffer */
00921             }
00922             
00923             new_buf = buf;
00924             if (comment) 
00925                process_buf = NULL;
00926             else
00927                process_buf = buf;
00928             
00929             while ((comment_p = strchr(new_buf, COMMENT_META))) {
00930                if ((comment_p > new_buf) && (*(comment_p-1) == '\\')) {
00931                   /* Escaped semicolons aren't comments. */
00932                   new_buf = comment_p + 1;
00933                } else if(comment_p[1] == COMMENT_TAG && comment_p[2] == COMMENT_TAG && (comment_p[3] != '-')) {
00934                   /* Meta-Comment start detected ";--" */
00935                   if (comment < MAX_NESTED_COMMENTS) {
00936                      *comment_p = '\0';
00937                      new_buf = comment_p + 3;
00938                      comment++;
00939                      nest[comment-1] = lineno;
00940                   } else {
00941                      ast_log(LOG_ERROR, "Maximum nest limit of %d reached.\n", MAX_NESTED_COMMENTS);
00942                   }
00943                } else if ((comment_p >= new_buf + 2) &&
00944                      (*(comment_p - 1) == COMMENT_TAG) &&
00945                      (*(comment_p - 2) == COMMENT_TAG)) {
00946                   /* Meta-Comment end detected */
00947                   comment--;
00948                   new_buf = comment_p + 1;
00949                   if (!comment) {
00950                      /* Back to non-comment now */
00951                      if (process_buf) {
00952                         /* Actually have to move what's left over the top, then continue */
00953                         char *oldptr;
00954                         oldptr = process_buf + strlen(process_buf);
00955                         if ( withcomments ) {
00956                            CB_ADD(&comment_buffer, &comment_buffer_size, ";");
00957                            CB_ADD_LEN(&comment_buffer, &comment_buffer_size, oldptr+1, new_buf-oldptr-1);
00958                         }
00959                         
00960                         memmove(oldptr, new_buf, strlen(new_buf) + 1);
00961                         new_buf = oldptr;
00962                      } else
00963                         process_buf = new_buf;
00964                   }
00965                } else {
00966                   if (!comment) {
00967                      /* If ; is found, and we are not nested in a comment, 
00968                         we immediately stop all comment processing */
00969                      if ( withcomments ) {
00970                         LLB_ADD(&lline_buffer, &lline_buffer_size, comment_p);
00971                      }
00972                      *comment_p = '\0'; 
00973                      new_buf = comment_p;
00974                   } else
00975                      new_buf = comment_p + 1;
00976                }
00977             }
00978             if( withcomments && comment && !process_buf )
00979             {
00980                CB_ADD(&comment_buffer, &comment_buffer_size, buf);  /* the whole line is a comment, store it */
00981             }
00982             
00983             if (process_buf) {
00984                char *buf = ast_strip(process_buf);
00985                if (!ast_strlen_zero(buf)) {
00986                   if (process_text_line(cfg, &cat, buf, lineno, fn, withcomments, &comment_buffer, &comment_buffer_size, &lline_buffer, &lline_buffer_size)) {
00987                      cfg = NULL;
00988                      break;
00989                   }
00990                }
00991             }
00992          }
00993       }
00994       fclose(f);     
00995    } while(0);
00996    if (comment) {
00997       ast_log(LOG_WARNING,"Unterminated comment detected beginning on line %d\n", nest[comment - 1]);
00998    }
00999 #ifdef AST_INCLUDE_GLOB
01000                if (!cfg)
01001                   break;
01002             }
01003             globfree(&globbuf);
01004          }
01005       }
01006 #endif
01007 
01008    if (cfg && cfg->include_level == 1 && withcomments && comment_buffer) {
01009       free(comment_buffer);
01010       free(lline_buffer);
01011       comment_buffer = NULL;
01012       lline_buffer = NULL;
01013       comment_buffer_size = 0;
01014       lline_buffer_size = 0;
01015    }
01016    
01017    if (count == 0)
01018       return NULL;
01019 
01020    return cfg;
01021 }
01022 
01023 int config_text_file_save(const char *configfile, const struct ast_config *cfg, const char *generator)
01024 {
01025    FILE *f = NULL;
01026    int fd = -1;
01027    char fn[256], fntmp[256];
01028    char date[256]="";
01029    time_t t;
01030    struct ast_variable *var;
01031    struct ast_category *cat;
01032    struct ast_comment *cmt;
01033    struct stat s;
01034    int blanklines = 0;
01035    int stat_result = 0;
01036 
01037    if (configfile[0] == '/') {
01038       snprintf(fntmp, sizeof(fntmp), "%s.XXXXXX", configfile);
01039       ast_copy_string(fn, configfile, sizeof(fn));
01040    } else {
01041       snprintf(fntmp, sizeof(fntmp), "%s/%s.XXXXXX", ast_config_AST_CONFIG_DIR, configfile);
01042       snprintf(fn, sizeof(fn), "%s/%s", ast_config_AST_CONFIG_DIR, configfile);
01043    }
01044    time(&t);
01045    ast_copy_string(date, ctime(&t), sizeof(date));
01046    if ((fd = mkstemp(fntmp)) > 0 && (f = fdopen(fd, "w")) != NULL) {
01047       if (option_verbose > 1)
01048          ast_verbose(VERBOSE_PREFIX_2 "Saving '%s': ", fn);
01049       fprintf(f, ";!\n");
01050       fprintf(f, ";! Automatically generated configuration file\n");
01051       if (strcmp(configfile, fn))
01052          fprintf(f, ";! Filename: %s (%s)\n", configfile, fn);
01053       else
01054          fprintf(f, ";! Filename: %s\n", configfile);
01055       fprintf(f, ";! Generator: %s\n", generator);
01056       fprintf(f, ";! Creation Date: %s", date);
01057       fprintf(f, ";!\n");
01058       cat = cfg->root;
01059       while(cat) {
01060          /* Dump section with any appropriate comment */
01061          for (cmt = cat->precomments; cmt; cmt=cmt->next)
01062          {
01063             if (cmt->cmt[0] != ';' || cmt->cmt[1] != '!')
01064                fprintf(f,"%s", cmt->cmt);
01065          }
01066          if (!cat->precomments)
01067             fprintf(f,"\n");
01068          fprintf(f, "[%s]", cat->name);
01069          if (cat->ignored || !AST_LIST_EMPTY(&cat->template_instances)) {
01070             fprintf(f, "(");
01071             if (cat->ignored) {
01072                fprintf(f, "!");
01073             }
01074             if (cat->ignored && !AST_LIST_EMPTY(&cat->template_instances)) {
01075                fprintf(f, ",");
01076             }
01077             if (!AST_LIST_EMPTY(&cat->template_instances)) {
01078                struct ast_category_template_instance *x;
01079                AST_LIST_TRAVERSE(&cat->template_instances, x, next) {
01080                   fprintf(f,"%s",x->name);
01081                   if (x != AST_LIST_LAST(&cat->template_instances))
01082                      fprintf(f,",");
01083                }
01084             }
01085             fprintf(f, ")");
01086          }
01087          for(cmt = cat->sameline; cmt; cmt=cmt->next)
01088          {
01089             fprintf(f,"%s", cmt->cmt);
01090          }
01091          if (!cat->sameline)
01092             fprintf(f,"\n");
01093          var = cat->root;
01094          while(var) {
01095             struct ast_category_template_instance *x;
01096             struct ast_variable *v2;
01097             int found = 0;
01098             AST_LIST_TRAVERSE(&cat->template_instances, x, next) {
01099                
01100                for (v2 = x->inst->root; v2; v2 = v2->next) {
01101                   if (!strcasecmp(var->name, v2->name))
01102                      break;
01103                }
01104                if (v2 && v2->value && !strcmp(v2->value, var->value)) {
01105                   found = 1;
01106                   break;
01107                }
01108             }
01109             if (found) {
01110                var = var->next;
01111                continue;
01112             }
01113             for (cmt = var->precomments; cmt; cmt=cmt->next)
01114             {
01115                if (cmt->cmt[0] != ';' || cmt->cmt[1] != '!')
01116                   fprintf(f,"%s", cmt->cmt);
01117             }
01118             if (var->sameline) 
01119                fprintf(f, "%s %s %s  %s", var->name, (var->object ? "=>" : "="), var->value, var->sameline->cmt);
01120             else  
01121                fprintf(f, "%s %s %s\n", var->name, (var->object ? "=>" : "="), var->value);
01122             if (var->blanklines) {
01123                blanklines = var->blanklines;
01124                while (blanklines--)
01125                   fprintf(f, "\n");
01126             }
01127                
01128             var = var->next;
01129          }
01130 #if 0
01131          /* Put an empty line */
01132          fprintf(f, "\n");
01133 #endif
01134          cat = cat->next;
01135       }
01136       if ((option_verbose > 1) && !option_debug)
01137          ast_verbose("Saved\n");
01138    } else {
01139       if (option_debug)
01140          ast_log(LOG_DEBUG, "Unable to open for writing: %s (%s)\n", fn, strerror(errno));
01141       if (option_verbose > 1)
01142          ast_verbose(VERBOSE_PREFIX_2 "Unable to write %s (%s)", fn, strerror(errno));
01143       if (fd > -1)
01144          close(fd);
01145       return -1;
01146    }
01147    if (!(stat_result = stat(fn, &s))) {
01148       fchmod(fd, s.st_mode);
01149    }
01150    fclose(f);
01151    if ((!stat_result && unlink(fn)) || link(fntmp, fn)) {
01152       if (option_debug)
01153          ast_log(LOG_DEBUG, "Unable to open for writing: %s (%s)\n", fn, strerror(errno));
01154       if (option_verbose > 1)
01155          ast_verbose(VERBOSE_PREFIX_2 "Unable to write %s (%s)", fn, strerror(errno));
01156       unlink(fntmp);
01157       return -1;
01158    }
01159    unlink(fntmp);
01160    return 0;
01161 }
01162 
01163 static void clear_config_maps(void) 
01164 {
01165    struct ast_config_map *map;
01166 
01167    ast_mutex_lock(&config_lock);
01168 
01169    while (config_maps) {
01170       map = config_maps;
01171       config_maps = config_maps->next;
01172       free(map);
01173    }
01174       
01175    ast_mutex_unlock(&config_lock);
01176 }
01177 
01178 static int append_mapping(char *name, char *driver, char *database, char *table)
01179 {
01180    struct ast_config_map *map;
01181    int length;
01182 
01183    length = sizeof(*map);
01184    length += strlen(name) + 1;
01185    length += strlen(driver) + 1;
01186    length += strlen(database) + 1;
01187    if (table)
01188       length += strlen(table) + 1;
01189 
01190    if (!(map = ast_calloc(1, length)))
01191       return -1;
01192 
01193    map->name = map->stuff;
01194    strcpy(map->name, name);
01195    map->driver = map->name + strlen(map->name) + 1;
01196    strcpy(map->driver, driver);
01197    map->database = map->driver + strlen(map->driver) + 1;
01198    strcpy(map->database, database);
01199    if (table) {
01200       map->table = map->database + strlen(map->database) + 1;
01201       strcpy(map->table, table);
01202    }
01203    map->next = config_maps;
01204 
01205    if (option_verbose > 1)
01206       ast_verbose(VERBOSE_PREFIX_2 "Binding %s to %s/%s/%s\n",
01207              map->name, map->driver, map->database, map->table ? map->table : map->name);
01208 
01209    config_maps = map;
01210    return 0;
01211 }
01212 
01213 int read_config_maps(void) 
01214 {
01215    struct ast_config *config, *configtmp;
01216    struct ast_variable *v;
01217    char *driver, *table, *database, *stringp, *tmp;
01218 
01219    clear_config_maps();
01220 
01221    configtmp = ast_config_new();
01222    configtmp->max_include_level = 1;
01223    config = ast_config_internal_load(extconfig_conf, configtmp, 0);
01224    if (!config) {
01225       ast_config_destroy(configtmp);
01226       return 0;
01227    }
01228 
01229    for (v = ast_variable_browse(config, "settings"); v; v = v->next) {
01230       stringp = v->value;
01231       driver = strsep(&stringp, ",");
01232 
01233       if ((tmp = strchr(stringp, '\"')))
01234          stringp = tmp;
01235 
01236       /* check if the database text starts with a double quote */
01237       if (*stringp == '"') {
01238          stringp++;
01239          database = strsep(&stringp, "\"");
01240          strsep(&stringp, ",");
01241       } else {
01242          /* apparently this text has no quotes */
01243          database = strsep(&stringp, ",");
01244       }
01245 
01246       table = strsep(&stringp, ",");
01247 
01248       if (!strcmp(v->name, extconfig_conf)) {
01249          ast_log(LOG_WARNING, "Cannot bind '%s'!\n", extconfig_conf);
01250          continue;
01251       }
01252 
01253       if (!strcmp(v->name, "asterisk.conf")) {
01254          ast_log(LOG_WARNING, "Cannot bind 'asterisk.conf'!\n");
01255          continue;
01256       }
01257 
01258       if (!strcmp(v->name, "logger.conf")) {
01259          ast_log(LOG_WARNING, "Cannot bind 'logger.conf'!\n");
01260          continue;
01261       }
01262 
01263       if (!driver || !database)
01264          continue;
01265       if (!strcasecmp(v->name, "sipfriends")) {
01266          ast_log(LOG_WARNING, "The 'sipfriends' table is obsolete, update your config to use sipusers and sippeers, though they can point to the same table.\n");
01267          append_mapping("sipusers", driver, database, table ? table : "sipfriends");
01268          append_mapping("sippeers", driver, database, table ? table : "sipfriends");
01269       } else if (!strcasecmp(v->name, "iaxfriends")) {
01270          ast_log(LOG_WARNING, "The 'iaxfriends' table is obsolete, update your config to use iaxusers and iaxpeers, though they can point to the same table.\n");
01271          append_mapping("iaxusers", driver, database, table ? table : "iaxfriends");
01272          append_mapping("iaxpeers", driver, database, table ? table : "iaxfriends");
01273       } else 
01274          append_mapping(v->name, driver, database, table);
01275    }
01276       
01277    ast_config_destroy(config);
01278    return 0;
01279 }
01280 
01281 int ast_config_engine_register(struct ast_config_engine *new) 
01282 {
01283    struct ast_config_engine *ptr;
01284 
01285    ast_mutex_lock(&config_lock);
01286 
01287    if (!config_engine_list) {
01288       config_engine_list = new;
01289    } else {
01290       for (ptr = config_engine_list; ptr->next; ptr=ptr->next);
01291       ptr->next = new;
01292    }
01293 
01294    ast_mutex_unlock(&config_lock);
01295    ast_log(LOG_NOTICE,"Registered Config Engine %s\n", new->name);
01296 
01297    return 1;
01298 }
01299 
01300 int ast_config_engine_deregister(struct ast_config_engine *del) 
01301 {
01302    struct ast_config_engine *ptr, *last=NULL;
01303 
01304    ast_mutex_lock(&config_lock);
01305 
01306    for (ptr = config_engine_list; ptr; ptr=ptr->next) {
01307       if (ptr == del) {
01308          if (last)
01309             last->next = ptr->next;
01310          else
01311             config_engine_list = ptr->next;
01312          break;
01313       }
01314       last = ptr;
01315    }
01316 
01317    ast_mutex_unlock(&config_lock);
01318 
01319    return 0;
01320 }
01321 
01322 /*! \brief Find realtime engine for realtime family */
01323 static struct ast_config_engine *find_engine(const char *family, char *database, int dbsiz, char *table, int tabsiz) 
01324 {
01325    struct ast_config_engine *eng, *ret = NULL;
01326    struct ast_config_map *map;
01327 
01328    ast_mutex_lock(&config_lock);
01329 
01330    for (map = config_maps; map; map = map->next) {
01331       if (!strcasecmp(family, map->name)) {
01332          if (database)
01333             ast_copy_string(database, map->database, dbsiz);
01334          if (table)
01335             ast_copy_string(table, map->table ? map->table : family, tabsiz);
01336          break;
01337       }
01338    }
01339 
01340    /* Check if the required driver (engine) exist */
01341    if (map) {
01342       for (eng = config_engine_list; !ret && eng; eng = eng->next) {
01343          if (!strcasecmp(eng->name, map->driver))
01344             ret = eng;
01345       }
01346    }
01347 
01348    ast_mutex_unlock(&config_lock);
01349    
01350    /* if we found a mapping, but the engine is not available, then issue a warning */
01351    if (map && !ret)
01352       ast_log(LOG_WARNING, "Realtime mapping for '%s' found to engine '%s', but the engine is not available\n", map->name, map->driver);
01353 
01354    return ret;
01355 }
01356 
01357 static struct ast_config_engine text_file_engine = {
01358    .name = "text",
01359    .load_func = config_text_file_load,
01360 };
01361 
01362 struct ast_config *ast_config_internal_load(const char *filename, struct ast_config *cfg, int withcomments)
01363 {
01364    char db[256];
01365    char table[256];
01366    struct ast_config_engine *loader = &text_file_engine;
01367    struct ast_config *result; 
01368 
01369    /* The config file itself bumps include_level by 1 */
01370    if (cfg->max_include_level > 0 && cfg->include_level == cfg->max_include_level + 1) {
01371       ast_log(LOG_WARNING, "Maximum Include level (%d) exceeded\n", cfg->max_include_level);
01372       return NULL;
01373    }
01374 
01375    cfg->include_level++;
01376 
01377    if (strcmp(filename, extconfig_conf) && strcmp(filename, "asterisk.conf") && config_engine_list) {
01378       struct ast_config_engine *eng;
01379 
01380       eng = find_engine(filename, db, sizeof(db), table, sizeof(table));
01381 
01382 
01383       if (eng && eng->load_func) {
01384          loader = eng;
01385       } else {
01386          eng = find_engine("global", db, sizeof(db), table, sizeof(table));
01387          if (eng && eng->load_func)
01388             loader = eng;
01389       }
01390    }
01391 
01392    result = loader->load_func(db, table, filename, cfg, withcomments);
01393 
01394    if (result)
01395       result->include_level--;
01396    else
01397       cfg->include_level--;
01398 
01399    return result;
01400 }
01401 
01402 struct ast_config *ast_config_load(const char *filename)
01403 {
01404    struct ast_config *cfg;
01405    struct ast_config *result;
01406 
01407    cfg = ast_config_new();
01408    if (!cfg)
01409       return NULL;
01410 
01411    result = ast_config_internal_load(filename, cfg, 0);
01412    if (!result)
01413       ast_config_destroy(cfg);
01414 
01415    return result;
01416 }
01417 
01418 struct ast_config *ast_config_load_with_comments(const char *filename)
01419 {
01420    struct ast_config *cfg;
01421    struct ast_config *result;
01422 
01423    cfg = ast_config_new();
01424    if (!cfg)
01425       return NULL;
01426 
01427    result = ast_config_internal_load(filename, cfg, 1);
01428    if (!result)
01429       ast_config_destroy(cfg);
01430 
01431    return result;
01432 }
01433 
01434 struct ast_variable *ast_load_realtime(const char *family, ...)
01435 {
01436    struct ast_config_engine *eng;
01437    char db[256]="";
01438    char table[256]="";
01439    struct ast_variable *res=NULL;
01440    va_list ap;
01441 
01442    va_start(ap, family);
01443    eng = find_engine(family, db, sizeof(db), table, sizeof(table));
01444    if (eng && eng->realtime_func) 
01445       res = eng->realtime_func(db, table, ap);
01446    va_end(ap);
01447 
01448    return res;
01449 }
01450 
01451 /*! \brief Check if realtime engine is configured for family */
01452 int ast_check_realtime(const char *family)
01453 {
01454    struct ast_config_engine *eng;
01455 
01456    eng = find_engine(family, NULL, 0, NULL, 0);
01457    if (eng)
01458       return 1;
01459    return 0;
01460 
01461 }
01462 
01463 /*! \brief Check if there's any realtime engines loaded */
01464 int ast_realtime_enabled(void)
01465 {
01466    return config_maps ? 1 : 0;
01467 }
01468 
01469 struct ast_config *ast_load_realtime_multientry(const char *family, ...)
01470 {
01471    struct ast_config_engine *eng;
01472    char db[256]="";
01473    char table[256]="";
01474    struct ast_config *res=NULL;
01475    va_list ap;
01476 
01477    va_start(ap, family);
01478    eng = find_engine(family, db, sizeof(db), table, sizeof(table));
01479    if (eng && eng->realtime_multi_func) 
01480       res = eng->realtime_multi_func(db, table, ap);
01481    va_end(ap);
01482 
01483    return res;
01484 }
01485 
01486 int ast_update_realtime(const char *family, const char *keyfield, const char *lookup, ...)
01487 {
01488    struct ast_config_engine *eng;
01489    int res = -1;
01490    char db[256]="";
01491    char table[256]="";
01492    va_list ap;
01493 
01494    va_start(ap, lookup);
01495    eng = find_engine(family, db, sizeof(db), table, sizeof(table));
01496    if (eng && eng->update_func) 
01497       res = eng->update_func(db, table, keyfield, lookup, ap);
01498    va_end(ap);
01499 
01500    return res;
01501 }
01502 
01503 static int config_command(int fd, int argc, char **argv) 
01504 {
01505    struct ast_config_engine *eng;
01506    struct ast_config_map *map;
01507    
01508    ast_mutex_lock(&config_lock);
01509 
01510    ast_cli(fd, "\n\n");
01511    for (eng = config_engine_list; eng; eng = eng->next) {
01512       ast_cli(fd, "\nConfig Engine: %s\n", eng->name);
01513       for (map = config_maps; map; map = map->next)
01514          if (!strcasecmp(map->driver, eng->name)) {
01515             ast_cli(fd, "===> %s (db=%s, table=%s)\n", map->name, map->database,
01516                map->table ? map->table : map->name);
01517          }
01518    }
01519    ast_cli(fd,"\n\n");
01520    
01521    ast_mutex_unlock(&config_lock);
01522 
01523    return 0;
01524 }
01525 
01526 static char show_config_help[] =
01527    "Usage: core show config mappings\n"
01528    "  Shows the filenames to config engines.\n";
01529 
01530 static struct ast_cli_entry cli_show_config_mappings_deprecated = {
01531    { "show", "config", "mappings", NULL },
01532    config_command, NULL,
01533    NULL };
01534 
01535 static struct ast_cli_entry cli_config[] = {
01536    { { "core", "show", "config", "mappings", NULL },
01537    config_command, "Display config mappings (file names to config engines)",
01538    show_config_help, NULL, &cli_show_config_mappings_deprecated },
01539 };
01540 
01541 int register_config_cli() 
01542 {
01543    ast_cli_register_multiple(cli_config, sizeof(cli_config) / sizeof(struct ast_cli_entry));
01544    return 0;
01545 }

Generated on Thu Feb 5 16:25:46 2009 for Asterisk - the Open Source PBX by  doxygen 1.4.7