kamailio/modules/prefix_route

1. prefix_route Module

Alfred E. Heggestad

   Telio Telecom

   Copyright © 2007 Alfred E. Heggestad

   Copyright © 2008 Telio Telecom AS
     __________________________________________________________________

   1.1. Overview
   1.2. Parameters

        1.2.1. db_url (string)
        1.2.2. db_table (string)

   1.3. Functions

        1.3.1. prefix_route()

   1.4. RPC Commands

        1.4.1. prefix_route.reload
        1.4.2. prefix_route.dump

   1.5. Database Structure

1.1. Overview

   The prefix_route module does routing based on a set of prefixes from
   the database. The prefix rule-set is loaded from the database into a
   binary tree in memory, either on startup or when issuing the
   "prefix_route.reload" RPC command. When calling the "prefix_route()"
   function from the ser.cfg configuration script, it will try to match
   the user part of the request URI with the best matching route. If a
   route is found, it will be used for further processing. If not found
   normal processing will continue.

   Development was sponsored by Telio Telecom.

1.2. Parameters

1.2.1. db_url (string)

   This is URL of the database to be used.

   Default value is "mysql://ser@localhost/ser"

   Example 1. Setting db_url parameter
...
modparam("prefix_route", "db_url", "mysql://ser:pass@db_host/ser")
...

1.2.2. db_table (string)

   The name of table where to read prefix route set.

   Default value is "prefix_route".

   Example 2. Setting db_table parameter
...
modparam("prefix_route", "db_table", "new_prefix_route")
...

1.3. Functions

1.3.1. prefix_route()

   This function tries to find a route from the user part of the request
   URI. If a route is found, it will be used for further processing.
   Otherwise the function will return false.

   Example 3. prefix_route() usage
...
  if (!prefix_route()) {
      xlog("L_ERR", "prefix_route(): no matching routes\n");
  }
...

1.4. RPC Commands

1.4.1. prefix_route.reload

   Reload prefix route tree from the database. Validation is done and the
   prefix route tree will only be reloaded if there are no errors.

1.4.2. prefix_route.dump

   Dump the current prefix route tree.

1.5. Database Structure

   A prefix route set consists of three fields:
     * prefix - varchar(64) - Prefix rule
     * route - varchar(64) - Route name
     * comment - varchar(64) - Free-form comment

   Example 4. Sample data
...
   +--------+-------+---------------+
   | prefix | route | comment       |
   +--------+-------+---------------+
   | 46     | SE    | Sweden        |
   | 47     | NO    | Norway        |
   | 479    | NOMOB | Norway mobile |
   | 49     | DE    | Deutschland   |
   | 39     | IT    | Italy         |
   +--------+-------+---------------+
...