Sat Aug 6 00:39:57 2011

Asterisk developer's documentation


iax2-provision.h File Reference

IAX2 Provisioning protocol. More...

#include "iax2-parser.h"

Go to the source code of this file.

Defines

#define PROV_FLAG_DEBUG   (1 << 3)
#define PROV_FLAG_DIS_CALLERID   (1 << 4)
#define PROV_FLAG_DIS_CALLWAIT   (1 << 5)
#define PROV_FLAG_DIS_CIDCW   (1 << 6)
#define PROV_FLAG_DIS_THREEWAY   (1 << 7)
#define PROV_FLAG_HEARTBEAT   (1 << 2)
#define PROV_FLAG_REGISTER   (1 << 0)
#define PROV_FLAG_SECURE   (1 << 1)
#define PROV_IE_AESKEY   14
#define PROV_IE_ALTSERVER   19
#define PROV_IE_FLAGS   12
#define PROV_IE_FORMAT   13
#define PROV_IE_GATEWAY   4
#define PROV_IE_IPADDR   2
#define PROV_IE_LANG   10
#define PROV_IE_NEWAESKEY   17
#define PROV_IE_PASS   7
#define PROV_IE_PORTNO   5
#define PROV_IE_PROVVER   18
#define PROV_IE_SERVERIP   15
#define PROV_IE_SERVERPASS   9
#define PROV_IE_SERVERPORT   16
#define PROV_IE_SERVERUSER   8
#define PROV_IE_SUBNET   3
#define PROV_IE_TOS   11
#define PROV_IE_USEDHCP   1
#define PROV_IE_USER   6

Functions

char * iax_prov_complete_template (const char *line, const char *word, int pos, int state)
char * iax_provflags2str (char *buf, int buflen, unsigned int flags)
int iax_provision_build (struct iax_ie_data *provdata, unsigned int *signature, const char *template, int force)
int iax_provision_reload (void)
int iax_provision_unload (void)
int iax_provision_version (unsigned int *signature, const char *template, int force)


Detailed Description

IAX2 Provisioning protocol.

Definition in file iax2-provision.h.


Define Documentation

#define PROV_FLAG_DEBUG   (1 << 3)

Definition at line 41 of file iax2-provision.h.

#define PROV_FLAG_DIS_CALLERID   (1 << 4)

Definition at line 43 of file iax2-provision.h.

#define PROV_FLAG_DIS_CALLWAIT   (1 << 5)

Definition at line 44 of file iax2-provision.h.

#define PROV_FLAG_DIS_CIDCW   (1 << 6)

Definition at line 45 of file iax2-provision.h.

#define PROV_FLAG_DIS_THREEWAY   (1 << 7)

Definition at line 46 of file iax2-provision.h.

#define PROV_FLAG_HEARTBEAT   (1 << 2)

Definition at line 40 of file iax2-provision.h.

#define PROV_FLAG_REGISTER   (1 << 0)

Definition at line 38 of file iax2-provision.h.

#define PROV_FLAG_SECURE   (1 << 1)

Definition at line 39 of file iax2-provision.h.

#define PROV_IE_AESKEY   14

Definition at line 31 of file iax2-provision.h.

#define PROV_IE_ALTSERVER   19

Definition at line 36 of file iax2-provision.h.

Referenced by iax_provision_build().

#define PROV_IE_FLAGS   12

Definition at line 29 of file iax2-provision.h.

Referenced by iax_provision_build().

#define PROV_IE_FORMAT   13

Definition at line 30 of file iax2-provision.h.

Referenced by iax_provision_build().

#define PROV_IE_GATEWAY   4

Definition at line 21 of file iax2-provision.h.

#define PROV_IE_IPADDR   2

Definition at line 19 of file iax2-provision.h.

#define PROV_IE_LANG   10

Definition at line 27 of file iax2-provision.h.

Referenced by iax_provision_build().

#define PROV_IE_NEWAESKEY   17

Definition at line 34 of file iax2-provision.h.

#define PROV_IE_PASS   7

Definition at line 24 of file iax2-provision.h.

Referenced by iax_provision_build().

#define PROV_IE_PORTNO   5

Definition at line 22 of file iax2-provision.h.

Referenced by iax_provision_build().

#define PROV_IE_PROVVER   18

Definition at line 35 of file iax2-provision.h.

Referenced by iax_provision_build().

#define PROV_IE_SERVERIP   15

Definition at line 32 of file iax2-provision.h.

Referenced by iax_provision_build().

#define PROV_IE_SERVERPASS   9

Definition at line 26 of file iax2-provision.h.

#define PROV_IE_SERVERPORT   16

Definition at line 33 of file iax2-provision.h.

Referenced by iax_provision_build().

#define PROV_IE_SERVERUSER   8

Definition at line 25 of file iax2-provision.h.

#define PROV_IE_SUBNET   3

Definition at line 20 of file iax2-provision.h.

#define PROV_IE_TOS   11

Definition at line 28 of file iax2-provision.h.

Referenced by iax_provision_build().

#define PROV_IE_USEDHCP   1

Definition at line 18 of file iax2-provision.h.

#define PROV_IE_USER   6

Definition at line 23 of file iax2-provision.h.

Referenced by iax_provision_build().


Function Documentation

char* iax_prov_complete_template ( const char *  line,
const char *  word,
int  pos,
int  state 
)

Definition at line 162 of file iax2-provision.c.

References ast_mutex_lock(), iax_template::name, iax_template::next, provlock, strdup, and templates.

Referenced by iax2_prov_complete_template_3rd().

00163 {
00164    struct iax_template *c;
00165    int which=0;
00166    char *ret = NULL;
00167    int wordlen = strlen(word);
00168 
00169    ast_mutex_lock(&provlock);
00170    for (c = templates; c; c = c->next) {
00171       if (!strncasecmp(word, c->name, wordlen) && ++which > state) {
00172          ret = strdup(c->name);
00173          break;
00174       }
00175    }
00176    ast_mutex_unlock(&provlock);
00177    
00178    return ret;
00179 }

char* iax_provflags2str ( char *  buf,
int  buflen,
unsigned int  flags 
)

Definition at line 91 of file iax2-provision.c.

References ast_strlen_zero(), iax_flags, and name.

Referenced by dump_prov_flags(), and iax_show_provisioning().

00092 {
00093    int x;
00094 
00095    if (!buf || buflen < 1)
00096       return NULL;
00097    
00098    buf[0] = '\0';
00099 
00100    for (x = 0; x < sizeof(iax_flags) / sizeof(iax_flags[0]); x++) {
00101       if (flags & iax_flags[x].value){
00102          strncat(buf, iax_flags[x].name, buflen - strlen(buf) - 1);
00103          strncat(buf, ",", buflen - strlen(buf) - 1);
00104       }
00105    }
00106 
00107    if (!ast_strlen_zero(buf)) 
00108       buf[strlen(buf) - 1] = '\0';
00109    else
00110       strncpy(buf, "none", buflen - 1);
00111 
00112    return buf;
00113 }

int iax_provision_build ( struct iax_ie_data provdata,
unsigned int *  signature,
const char *  template,
int  force 
)

Definition at line 191 of file iax2-provision.c.

References iax_template::altserver, ast_db_put(), ast_mutex_lock(), ast_mutex_unlock(), iax_template::flags, iax_template::format, iax_ie_append_byte(), iax_ie_append_int(), iax_ie_append_short(), iax_ie_append_str(), iax_template_find(), iax_template::lang, iax_template::pass, iax_template::port, PROV_IE_ALTSERVER, PROV_IE_FLAGS, PROV_IE_FORMAT, PROV_IE_LANG, PROV_IE_PASS, PROV_IE_PORTNO, PROV_IE_PROVVER, PROV_IE_SERVERIP, PROV_IE_SERVERPORT, PROV_IE_TOS, PROV_IE_USER, prov_ver_calc(), provlock, iax_template::server, iax_template::serverport, iax_template::tos, and iax_template::user.

Referenced by iax2_provision(), and iax_provision_version().

00192 {
00193    struct iax_template *cur;
00194    unsigned int sig;
00195    char tmp[40];
00196    memset(provdata, 0, sizeof(*provdata));
00197    ast_mutex_lock(&provlock);
00198    cur = iax_template_find(template, 1);
00199    /* If no match, try searching for '*' */
00200    if (!cur)
00201       cur = iax_template_find("*", 1);
00202    if (cur) {
00203       /* found it -- add information elements as appropriate */
00204       if (force || strlen(cur->user))
00205          iax_ie_append_str(provdata, PROV_IE_USER, cur->user);
00206       if (force || strlen(cur->pass))
00207          iax_ie_append_str(provdata, PROV_IE_PASS, cur->pass);
00208       if (force || strlen(cur->lang))
00209          iax_ie_append_str(provdata, PROV_IE_LANG, cur->lang);
00210       if (force || cur->port)
00211          iax_ie_append_short(provdata, PROV_IE_PORTNO, cur->port);
00212       if (force || cur->server)
00213          iax_ie_append_int(provdata, PROV_IE_SERVERIP, cur->server);
00214       if (force || cur->serverport)
00215          iax_ie_append_short(provdata, PROV_IE_SERVERPORT, cur->serverport);
00216       if (force || cur->altserver)
00217          iax_ie_append_int(provdata, PROV_IE_ALTSERVER, cur->altserver);
00218       if (force || cur->flags)
00219          iax_ie_append_int(provdata, PROV_IE_FLAGS, cur->flags);
00220       if (force || cur->format)
00221          iax_ie_append_int(provdata, PROV_IE_FORMAT, cur->format);
00222       if (force || cur->tos)
00223          iax_ie_append_byte(provdata, PROV_IE_TOS, cur->tos);
00224       
00225       /* Calculate checksum of message so far */
00226       sig = prov_ver_calc(provdata);
00227       if (signature)
00228          *signature = sig;
00229       /* Store signature */
00230       iax_ie_append_int(provdata, PROV_IE_PROVVER, sig);
00231       /* Cache signature for later verification so we need not recalculate all this */
00232       snprintf(tmp, sizeof(tmp), "v0x%08x", sig);
00233       ast_db_put("iax/provisioning/cache", template, tmp);
00234    } else
00235       ast_db_put("iax/provisioning/cache", template, "u");
00236    ast_mutex_unlock(&provlock);
00237    return cur ? 0 : -1;
00238 }

int iax_provision_reload ( void   ) 

Definition at line 489 of file iax2-provision.c.

References ast_category_browse(), ast_config_destroy(), ast_config_load(), ast_db_deltree(), ast_log(), ast_mutex_lock(), ast_mutex_unlock(), ast_verbose(), iax_template::dead, free, iax_process_template(), iax_provision_init(), LOG_NOTICE, iax_template::next, option_verbose, provinit, provlock, templates, and VERBOSE_PREFIX_3.

Referenced by load_module(), and reload_config().

00490 {
00491    struct ast_config *cfg;
00492    struct iax_template *cur, *prev, *next;
00493    char *cat;
00494    int found = 0;
00495    if (!provinit)
00496       iax_provision_init();
00497    /* Mark all as dead.  No need for locking */
00498    cur = templates;
00499    while(cur) {
00500       cur->dead = 1;
00501       cur = cur->next;
00502    }
00503    cfg = ast_config_load("iaxprov.conf");
00504    if (cfg) {
00505       /* Load as appropriate */
00506       cat = ast_category_browse(cfg, NULL);
00507       while(cat) {
00508          if (strcasecmp(cat, "general")) {
00509             iax_process_template(cfg, cat, found ? "default" : NULL);
00510             found++;
00511             if (option_verbose > 2)
00512                ast_verbose(VERBOSE_PREFIX_3 "Loaded provisioning template '%s'\n", cat);
00513          }
00514          cat = ast_category_browse(cfg, cat);
00515       }
00516       ast_config_destroy(cfg);
00517    } else
00518       ast_log(LOG_NOTICE, "No IAX provisioning configuration found, IAX provisioning disabled.\n");
00519    ast_mutex_lock(&provlock);
00520    /* Drop dead entries while locked */
00521    prev = NULL;
00522    cur = templates;
00523    while(cur) {
00524       next = cur->next;
00525       if (cur->dead) {
00526          if (prev)
00527             prev->next = next;
00528          else
00529             templates = next;
00530          free(cur);
00531       } else 
00532          prev = cur;
00533       cur = next;
00534    }
00535    ast_mutex_unlock(&provlock);
00536    /* Purge cached signature DB entries */
00537    ast_db_deltree("iax/provisioning/cache", NULL);
00538    return 0;
00539    
00540 }

int iax_provision_unload ( void   ) 

Definition at line 482 of file iax2-provision.c.

References ast_cli_unregister_multiple(), cli_iax2_provision, and provinit.

Referenced by __unload_module().

00483 {
00484    provinit = 0;
00485    ast_cli_unregister_multiple(cli_iax2_provision, sizeof(cli_iax2_provision) / sizeof(struct ast_cli_entry));
00486    return 0;
00487 }

int iax_provision_version ( unsigned int *  signature,
const char *  template,
int  force 
)

Definition at line 240 of file iax2-provision.c.

References ast_db_get(), ast_log(), ast_mutex_lock(), ast_mutex_unlock(), iax_provision_build(), LOG_DEBUG, option_debug, and provlock.

Referenced by check_provisioning().

00241 {
00242    char tmp[80] = "";
00243    struct iax_ie_data ied;
00244    int ret=0;
00245    memset(&ied, 0, sizeof(ied));
00246 
00247    ast_mutex_lock(&provlock);
00248    ast_db_get("iax/provisioning/cache", template, tmp, sizeof(tmp));
00249    if (sscanf(tmp, "v%30x", version) != 1) {
00250       if (strcmp(tmp, "u")) {
00251          ret = iax_provision_build(&ied, version, template, force);
00252          if (ret)
00253             ast_log(LOG_DEBUG, "Unable to create provisioning packet for '%s'\n", template);
00254       } else
00255          ret = -1;
00256    } else if (option_debug)
00257       ast_log(LOG_DEBUG, "Retrieved cached version '%s' = '%08x'\n", tmp, *version);
00258    ast_mutex_unlock(&provlock);
00259    return ret;
00260 }


Generated on Sat Aug 6 00:39:57 2011 for Asterisk - the Open Source PBX by  doxygen 1.4.7