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 #ifdef PBX
 115 #define PARAM_ANNOUNCEMENT      (1LL<<22)
 116 #endif
 117 #define PARAM_RULESET           (1LL<<23)
 118 #define PARAM_CAUSE             (1LL<<24)
 119 #define PARAM_LOCATION          (1LL<<25)
 120 #define PARAM_DISPLAY           (1LL<<26)
 121 #define PARAM_PORTS             (1LL<<27)
 122 #define PARAM_TPRESET           (1LL<<28)
 123 #define PARAM_FILE              (1LL<<29)
 124 #define PARAM_CONTENT           (1LL<<30)
 125 #define PARAM_APPEND            (1LL<<31)
 126 #define PARAM_EXECUTE           (1LL<<32)
 127 #define PARAM_PARAM             (1LL<<33)
 128 #define PARAM_TYPE              (1LL<<34)
 129 #define PARAM_COMPLETE          (1LL<<35)
 130 #define PARAM_CALLERID          (1LL<<36)
 131 #define PARAM_CALLERIDTYPE      (1LL<<37)
 132 #define PARAM_CALLTO            (1LL<<38)
 133 #define PARAM_ROOM              (1LL<<39)
 134 #define PARAM_TIMEOUT           (1LL<<40)
 135 #ifdef PBX
 136 #define PARAM_NOPASSWORD        (1LL<<41)
 137 #endif
 138
 139
 140 /* action index
 141  * NOTE: The given index is the actual entry number of action_defs[], so add/remove both lists!!!
 142  */
 143 #define ACTION_EXTERNAL         0
 144 #define ACTION_INTERNAL         1
 145 #define ACTION_OUTDIAL          2
 146 #define ACTION_CHAN             3
 147 #define ACTION_VBOX_RECORD      4
 148 #define ACTION_PARTYLINE        5
 149 #define ACTION_LOGIN            6
 150 #define ACTION_CALLERID         7
 151 #define ACTION_CALLERIDNEXT     8
 152 #define ACTION_FORWARD          9
 153 #define ACTION_REDIAL           10
 154 #define ACTION_REPLY            11
 155 #define ACTION_POWERDIAL        12
 156 #define ACTION_CALLBACK         13
 157 #define ACTION_ABBREV           14
 158 #define ACTION_TEST             15
 159 #define ACTION_PLAY             16
 160 #define ACTION_VBOX_PLAY        17
 161 #define ACTION_CALCULATOR       18
 162 #define ACTION_TIMER            19
 163 #define ACTION_GOTO             20
 164 #define ACTION_MENU             21
 165 #define ACTION_DISCONNECT       22
 166 #define ACTION_HELP             23
 167 #define ACTION_DEFLECT          24
 168 #define ACTION_SETFORWARD       25
 169 #define ACTION_EXECUTE          26
 170 #define ACTION_FILE             27
 171 #define ACTION_PICK             28
 172 #define ACTION_PASSWORD         29
 173 #define ACTION_PASSWORD_WRITE   30
 174 #define ACTION_NOTHING          31
 175 #define ACTION_EFI              32
 176
 177 struct route_cond { /* an item */
 178         struct route_cond       *next;                  /* next entry */
 179         int                     index;                  /* index of cond_defs */
 180         int                     match;                  /* what is matching (MATCH_*) */
 181         int                     value_type;             /* type of value (VALUE_TYPE_*) */
 182         int                     value_extension;        /* will it be extended? */
 183         int                     integer_value;          /* first integer */
 184         int                     integer_value_to;       /* second integer */
 185         char                    *string_value;          /* first string */
 186         char                    *string_value_to;       /* second string */
 187         int                     comp_string;            /* compare value of strings */
 188 };
 189
 190 struct route_param { /* a parameter */
 191         struct route_param      *next;                  /* next item */
 192         int                     index;                  /* index of param_defs */
 193         unsigned long long      id;                     /* what is it (PARAM_*) */
 194         int                     value_type;             /* type of value (VALUE_TYPE_*) */
 195         int                     value_extension;        /* will it be extended? */
 196         int                     integer_value;          /* integer value */
 197         char                    *string_value;          /* string value */
 198 };
 199
 200 struct route_action { /* an action has a list of parameters */
 201         struct route_action     *next;                  /* next item */
 202         struct route_param      *param_first;           /* link to parameter list */
 203         int                     index;                  /* index of action_defs */
 204         int                     timeout;                /* timeout value for action (0 = no timeout) */
 205         int                     line;                   /* line parsed from */
 206 };
 207
 208 struct route_rule { /* a rule has a list of items and actions */
 209         struct route_rule       *next;                  /* next item */
 210         char                    file[128];              /* filename */
 211         int                     line;                   /* line parsed from */
 212         struct route_cond       *cond_first;            /* link to condition list */
 213         struct route_action     *action_first;          /* link to action list */
 214 };
 215
 216 struct route_ruleset { /* the ruleset is a list of rules */
 217         struct route_ruleset    *next;                  /* next item */
 218         char                    file[128];              /* filename */
 219         int                     line;                   /* line parsed from */
 220         char                    name[64];               /* name of rule */
 221         struct route_rule       *rule_first;            /* linke to rule list */
 222 };
 223
 224 struct cond_defs { /* defintion of all conditions */
 225         char                    *name;                  /* item's name */
 226         int                     match;                  /* what to check */
 227         int                     type;                   /* type of value (COND_TYPE) */
 228         char                    *doc;                   /* syntax */
 229         char                    *help;                  /* short help */
 230 };
 231
 232 struct param_defs { /* definition of all options */
 233         unsigned long long      id;                     /* ID of parameter (just for checking) */
 234         char                    *name;                  /* name of parameter */
 235         int                     type;                   /* type of value (PARAM_TYPE_*) */
 236         char                    *doc;                   /* syntax */
 237         char                    *help;                  /* quick help */
 238 };
 239
 240 struct action_defs { /* definition of all actions */
 241         int                     id;                     /* ID of parameter (just for checking) */
 242         char                    *name;
 243         void                    (EndpointAppPBX::*init_func)(void);
 244         void                    (EndpointAppPBX::*dialing_func)(void);
 245         void                    (EndpointAppPBX::*hangup_func)(void);
 246         unsigned long long       params;
 247         char                    *help;
 248 };
 249
 250
 251
 252 extern struct cond_defs         cond_defs[];
 253 extern struct param_defs        param_defs[];
 254 extern struct action_defs       action_defs[];
 255 extern struct route_ruleset     *ruleset_first;
 256 extern struct route_ruleset     *ruleset_main;
 257 extern struct route_action      action_external;
 258 extern struct route_action      action_internal;
 259 extern struct route_action      action_chan;
 260 extern struct route_action      action_vbox;
 261 extern struct route_action      action_partyline;
 262 extern struct route_action      action_password;
 263 extern struct route_action      action_password_write;
 264 extern struct route_action      action_disconnect;
 265
 266 /* functions */
 267
 268 void doc_rules(const char *action);
 269 void ruleset_free(struct route_ruleset *ruleset_start);
 270 void ruleset_debug(struct route_ruleset *ruleset_start);
 271 extern char ruleset_error[256];
 272 struct route_ruleset *ruleset_parse(void);
 273 struct route_ruleset *getrulesetbyname(char *name);
 274