route.h

   1 /*****************************************************************************\
   2 **                                                                           **
   3 ** PBX4Linux                                                                 **
   4 **                                                                           **
   5 **---------------------------------------------------------------------------**
   6 ** Copyright: Andreas Eversberg                                              **
   7 **                                                                           **
   8 ** match header file                                                         **
   9 **                                                                           **
  10 \*****************************************************************************/
  11
  12
  13 /* memory structure of rulesets */
  14
  15 enum { /* value types */
  16         VALUE_TYPE_NULL,
  17         VALUE_TYPE_INTEGER,
  18         VALUE_TYPE_INTEGER_RANGE,
  19         VALUE_TYPE_STRING,
  20         VALUE_TYPE_STRING_RANGE,
  21 };
  22
  23 enum { /* how to parse text file during startup */
  24         COND_TYPE_NULL,
  25         COND_TYPE_INTEGER,
  26         COND_TYPE_TIME,
  27         COND_TYPE_MDAY,
  28         COND_TYPE_MONTH,
  29         COND_TYPE_WDAY,
  30         COND_TYPE_YEAR,
  31         COND_TYPE_STRING,
  32         COND_TYPE_IP,
  33         COND_TYPE_CAPABILITY,
  34         COND_TYPE_BMODE,
  35         COND_TYPE_IFATTR,
  36 };
  37
  38 enum { /* what to check during runtime */
  39         MATCH_EXTERN,
  40         MATCH_INTERN,
  41         MATCH_PORT,
  42         MATCH_INTERFACE,
  43         MATCH_CALLERID,
  44         MATCH_EXTENSION,
  45         MATCH_DIALING,
  46         MATCH_ENBLOCK,
  47         MATCH_OVERLAP,
  48         MATCH_ANONYMOUS,
  49         MATCH_VISIBLE,
  50         MATCH_UNKNOWN,
  51         MATCH_AVAILABLE,
  52         MATCH_FAKE,
  53         MATCH_REAL,
  54         MATCH_REDIRECTED,
  55         MATCH_DIRECT,
  56         MATCH_REDIRID,
  57         MATCH_TIME,
  58         MATCH_MDAY,
  59         MATCH_MONTH,
  60         MATCH_YEAR,
  61         MATCH_WDAY,
  62         MATCH_CAPABILITY,
  63         MATCH_INFOLAYER1,
  64         MATCH_HLC,
  65         MATCH_FILE,
  66         MATCH_EXECUTE,
  67         MATCH_DEFAULT,
  68         MATCH_TIMEOUT,
  69         MATCH_FREE,
  70         MATCH_NOTFREE,
  71         MATCH_DOWN,
  72         MATCH_UP,
  73         MATCH_BUSY,
  74         MATCH_IDLE,
  75 };
  76
  77 enum { /* how to parse text file during startup */
  78         PARAM_TYPE_NULL,
  79         PARAM_TYPE_INTEGER,
  80         PARAM_TYPE_STRING,
  81         PARAM_TYPE_YESNO,
  82         PARAM_TYPE_CAPABILITY,
  83         PARAM_TYPE_BMODE,
  84         PARAM_TYPE_DIVERSION,
  85         PARAM_TYPE_DESTIN,
  86         PARAM_TYPE_PORTS,
  87         PARAM_TYPE_TYPE,
  88         PARAM_TYPE_CALLERIDTYPE,
  89 };
  90
  91 /* parameter ID bits */
  92 #define PARAM_PROCEEDING        1LL
  93 #define PARAM_ALERTING          (1LL<<1)
  94 #define PARAM_CONNECT           (1LL<<2)
  95 #define PARAM_EXTENSION         (1LL<<3)
  96 #define PARAM_EXTENSIONS        (1LL<<4)
  97 #define PARAM_PREFIX            (1LL<<5)
  98 #define PARAM_CAPA              (1LL<<6)
  99 #define PARAM_BMODE             (1LL<<7)
 100 #define PARAM_INFO1             (1LL<<8)
 101 #define PARAM_HLC               (1LL<<9)
 102 #define PARAM_EXTHLC            (1LL<<10)
 103 #define PARAM_PRESENT           (1LL<<11)
 104 #define PARAM_DIVERSION         (1LL<<12)
 105 #define PARAM_DEST              (1LL<<13)
 106 #define PARAM_SELECT            (1LL<<14)
 107 #define PARAM_DELAY             (1LL<<15)
 108 #define PARAM_LIMIT             (1LL<<16)
 109 #define PARAM_HOST              (1LL<<17)
 110 #define PARAM_PORT              (1LL<<18)
 111 #define PARAM_INTERFACES        (1LL<<19)
 112 #define PARAM_ADDRESS           (1LL<<20)
 113 #define PARAM_SAMPLE            (1LL<<21)
 114 #define PARAM_ANNOUNCEMENT      (1LL<<22)
 115 #define PARAM_RULESET           (1LL<<23)
 116 #define PARAM_CAUSE             (1LL<<24)
 117 #define PARAM_LOCATION          (1LL<<25)
 118 #define PARAM_DISPLAY           (1LL<<26)
 119 #define PARAM_PORTS             (1LL<<27)
 120 #define PARAM_TPRESET           (1LL<<28)
 121 #define PARAM_FILE              (1LL<<29)
 122 #define PARAM_CONTENT           (1LL<<30)
 123 #define PARAM_APPEND            (1LL<<31)
 124 #define PARAM_EXECUTE           (1LL<<32)
 125 #define PARAM_PARAM             (1LL<<33)
 126 #define PARAM_TYPE              (1LL<<34)
 127 #define PARAM_COMPLETE          (1LL<<35)
 128 #define PARAM_CALLERID          (1LL<<36)
 129 #define PARAM_CALLERIDTYPE      (1LL<<37)
 130 #define PARAM_CALLTO            (1LL<<38)
 131 #define PARAM_ROOM              (1LL<<39)
 132 #define PARAM_TIMEOUT           (1LL<<40)
 133 #define PARAM_NOPASSWORD        (1LL<<41)
 134 #define PARAM_STRIP             (1LL<<42)
 135
 136
 137 /* action index
 138  * NOTE: The given index is the actual entry number of action_defs[], so add/remove both lists!!!
 139  */
 140 #define ACTION_EXTERNAL         0
 141 #define ACTION_INTERNAL         1
 142 #define ACTION_OUTDIAL          2
 143 #define ACTION_CHAN             3
 144 #define ACTION_VBOX_RECORD      4
 145 #define ACTION_PARTYLINE        5
 146 #define ACTION_LOGIN            6
 147 #define ACTION_CALLERID         7
 148 #define ACTION_CALLERIDNEXT     8
 149 #define ACTION_FORWARD          9
 150 #define ACTION_REDIAL           10
 151 #define ACTION_REPLY            11
 152 #define ACTION_POWERDIAL        12
 153 #define ACTION_CALLBACK         13
 154 #define ACTION_ABBREV           14
 155 #define ACTION_TEST             15
 156 #define ACTION_PLAY             16
 157 #define ACTION_VBOX_PLAY        17
 158 #define ACTION_CALCULATOR       18
 159 #define ACTION_TIMER            19
 160 #define ACTION_GOTO             20
 161 #define ACTION_MENU             21
 162 #define ACTION_DISCONNECT       22
 163 #define ACTION_HELP             23
 164 #define ACTION_DEFLECT          24
 165 #define ACTION_SETFORWARD       25
 166 #define ACTION_EXECUTE          26
 167 #define ACTION_FILE             27
 168 #define ACTION_PICK             28
 169 #define ACTION_PASSWORD         29
 170 #define ACTION_PASSWORD_WRITE   30
 171 #define ACTION_NOTHING          31
 172 #define ACTION_EFI              32
 173
 174 struct route_cond { /* an item */
 175         struct route_cond       *next;                  /* next entry */
 176         int                     index;                  /* index of cond_defs */
 177         int                     match;                  /* what is matching (MATCH_*) */
 178         int                     value_type;             /* type of value (VALUE_TYPE_*) */
 179         int                     value_extension;        /* will it be extended? */
 180         int                     integer_value;          /* first integer */
 181         int                     integer_value_to;       /* second integer */
 182         char                    *string_value;          /* first string */
 183         char                    *string_value_to;       /* second string */
 184         int                     comp_string;            /* compare value of strings */
 185 };
 186
 187 struct route_param { /* a parameter */
 188         struct route_param      *next;                  /* next item */
 189         int                     index;                  /* index of param_defs */
 190         unsigned long long      id;                     /* what is it (PARAM_*) */
 191         int                     value_type;             /* type of value (VALUE_TYPE_*) */
 192         int                     value_extension;        /* will it be extended? */
 193         int                     integer_value;          /* integer value */
 194         char                    *string_value;          /* string value */
 195 };
 196
 197 struct route_action { /* an action has a list of parameters */
 198         struct route_action     *next;                  /* next item */
 199         struct route_param      *param_first;           /* link to parameter list */
 200         int                     index;                  /* index of action_defs */
 201         int                     timeout;                /* timeout value for action (0 = no timeout) */
 202         int                     line;                   /* line parsed from */
 203 };
 204
 205 struct route_rule { /* a rule has a list of items and actions */
 206         struct route_rule       *next;                  /* next item */
 207         char                    file[128];              /* filename */
 208         int                     line;                   /* line parsed from */
 209         struct route_cond       *cond_first;            /* link to condition list */
 210         struct route_action     *action_first;          /* link to action list */
 211 };
 212
 213 struct route_ruleset { /* the ruleset is a list of rules */
 214         struct route_ruleset    *next;                  /* next item */
 215         char                    file[128];              /* filename */
 216         int                     line;                   /* line parsed from */
 217         char                    name[64];               /* name of rule */
 218         struct route_rule       *rule_first;            /* linke to rule list */
 219 };
 220
 221 struct cond_defs { /* defintion of all conditions */
 222         char                    *name;                  /* item's name */
 223         int                     match;                  /* what to check */
 224         int                     type;                   /* type of value (COND_TYPE) */
 225         char                    *doc;                   /* syntax */
 226         char                    *help;                  /* short help */
 227 };
 228
 229 struct param_defs { /* definition of all options */
 230         unsigned long long      id;                     /* ID of parameter (just for checking) */
 231         char                    *name;                  /* name of parameter */
 232         int                     type;                   /* type of value (PARAM_TYPE_*) */
 233         char                    *doc;                   /* syntax */
 234         char                    *help;                  /* quick help */
 235 };
 236
 237 struct action_defs { /* definition of all actions */
 238         int                     id;                     /* ID of parameter (just for checking) */
 239         char                    *name;
 240         void                    (EndpointAppPBX::*init_func)(void);
 241         void                    (EndpointAppPBX::*dialing_func)(void);
 242         void                    (EndpointAppPBX::*hangup_func)(void);
 243         unsigned long long       params;
 244         char                    *help;
 245 };
 246
 247
 248
 249 extern struct cond_defs         cond_defs[];
 250 extern struct param_defs        param_defs[];
 251 extern struct action_defs       action_defs[];
 252 extern struct route_ruleset     *ruleset_first;
 253 extern struct route_ruleset     *ruleset_main;
 254 extern struct route_action      action_external;
 255 extern struct route_action      action_internal;
 256 extern struct route_action      action_chan;
 257 extern struct route_action      action_vbox;
 258 extern struct route_action      action_partyline;
 259 extern struct route_action      action_password;
 260 extern struct route_action      action_password_write;
 261 extern struct route_action      action_disconnect;
 262
 263 /* functions */
 264
 265 void doc_rules(const char *action);
 266 void ruleset_free(struct route_ruleset *ruleset_start);
 267 void ruleset_debug(struct route_ruleset *ruleset_start);
 268 extern char ruleset_error[256];
 269 struct route_ruleset *ruleset_parse(void);
 270 struct route_ruleset *getrulesetbyname(char *name);
 271