68594978736be45c13c9af46e1c706d8061ea5b7
[asterisk/asterisk.git] / res / res_config_sqlite.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 2006, Proformatique
5  *
6  * Written by Richard Braun <rbraun@proformatique.com>
7  *
8  * Based on res_sqlite3 by Anthony Minessale II,
9  * and res_config_mysql by Matthew Boehm
10  *
11  * See http://www.asterisk.org for more information about
12  * the Asterisk project. Please do not directly contact
13  * any of the maintainers of this project for assistance;
14  * the project provides a web site, mailing lists and IRC
15  * channels for your use.
16  *
17  * This program is free software, distributed under the terms of
18  * the GNU General Public License Version 2. See the LICENSE file
19  * at the top of the source tree.
20  */
21
22 /*!
23  * \page res_config_sqlite
24  *
25  * \section intro_sec Presentation
26  *
27  * res_config_sqlite is a module for the Asterisk Open Source PBX to
28  * support SQLite 2 databases. It can be used to fetch configuration
29  * from a database (static configuration files and/or using the Asterisk
30  * RealTime Architecture - ARA).  It can also be used to log CDR entries. 
31  * Note that Asterisk already comes with a module named cdr_sqlite.
32  * There are two reasons for including it in res_config_sqlite:
33  * the first is that rewriting it was a training to learn how to write a
34  * simple module for Asterisk, the other is to have the same database open for
35  * all kinds of operations, which improves reliability and performance.
36  *
37  * \section conf_sec Configuration
38  *
39  * The main configuration file is res_config_sqlite.conf.sample It must be readable or
40  * res_config_sqlite will fail to start. It is suggested to use the sample file
41  * in this package as a starting point. The file has only one section
42  * named <code>general</code>. Here are the supported parameters :
43  *
44  * <dl>
45  *      <dt><code>dbfile</code></dt>
46  *      <dd>The absolute path to the SQLite database (the file can be non existent,
47  *                      res_config_sqlite will create it if it has the appropriate rights)</dd>
48  *      <dt><code>config_table</code></dt>
49  *      <dd>The table used for static configuration</dd>
50  *      <dt><code>cdr_table</code></dt>
51  *      <dd>The table used to store CDR entries (if ommitted, CDR support is
52  *                      disabled)</dd>
53  * </dl>
54  *
55  * To use res_config_sqlite for static and/or RealTime configuration, refer to the
56  * Asterisk documentation. The file tables.sql can be used to create the
57  * needed tables.
58  *
59  * \section status_sec Driver status
60  *
61  * The CLI command <code>show sqlite status</code> returns status information
62  * about the running driver.
63  *
64  * \section credits_sec Credits
65  *
66  * res_config_sqlite was developed by Richard Braun at the Proformatique company.
67  */
68
69 /*!
70  * \file
71  * \brief res_config_sqlite module.
72  */
73
74 /*! \li \ref res_config_sqlite.c uses the configuration file \ref res_config_sqlite.conf
75  * \addtogroup configuration_file Configuration Files
76  */
77
78 /*! 
79  * \page res_config_sqlite.conf res_config_sqlite.conf
80  * \verbinclude res_config_sqlite.conf.sample
81  */
82
83 /*** MODULEINFO
84         <depend>sqlite</depend>
85         <support_level>extended</support_level>
86  ***/
87
88 #include "asterisk.h"
89
90 #include <sqlite.h>
91
92 #include "asterisk/logger.h"
93 #include "asterisk/app.h"
94 #include "asterisk/pbx.h"
95 #include "asterisk/cdr.h"
96 #include "asterisk/cli.h"
97 #include "asterisk/lock.h"
98 #include "asterisk/config.h"
99 #include "asterisk/module.h"
100 #include "asterisk/linkedlists.h"
101
102 #define MACRO_BEGIN     do {
103 #define MACRO_END       } while (0)
104
105 #define RES_CONFIG_SQLITE_NAME "res_config_sqlite"
106 #define RES_CONFIG_SQLITE_DRIVER "sqlite"
107 #define RES_CONFIG_SQLITE_DESCRIPTION "Resource Module for SQLite 2"
108 #define RES_CONFIG_SQLITE_CONF_FILE "res_config_sqlite.conf"
109
110 enum {
111         RES_CONFIG_SQLITE_CONFIG_ID,
112         RES_CONFIG_SQLITE_CONFIG_CAT_METRIC,
113         RES_CONFIG_SQLITE_CONFIG_VAR_METRIC,
114         RES_CONFIG_SQLITE_CONFIG_COMMENTED,
115         RES_CONFIG_SQLITE_CONFIG_FILENAME,
116         RES_CONFIG_SQLITE_CONFIG_CATEGORY,
117         RES_CONFIG_SQLITE_CONFIG_VAR_NAME,
118         RES_CONFIG_SQLITE_CONFIG_VAR_VAL,
119         RES_CONFIG_SQLITE_CONFIG_COLUMNS,
120 };
121
122 #define SET_VAR(config, to, from)                       \
123 MACRO_BEGIN                                             \
124         int __error;                                    \
125                                                         \
126         __error = set_var(&to, #to, from->value);       \
127                                                         \
128         if (__error) {                                  \
129                 ast_config_destroy(config);             \
130                 unload_config();                        \
131                 return 1;                               \
132         }                                               \
133 MACRO_END
134
135 AST_THREADSTORAGE(sql_buf);
136 AST_THREADSTORAGE(where_buf);
137
138 /*!
139  * Maximum number of loops before giving up executing a query. Calls to
140  * sqlite_xxx() functions which can return SQLITE_BUSY
141  * are enclosed by RES_CONFIG_SQLITE_BEGIN and RES_CONFIG_SQLITE_END, e.g.
142  * <pre>
143  * char *errormsg;
144  * int error;
145  *
146  * RES_CONFIG_SQLITE_BEGIN
147  *       error = sqlite_exec(db, query, NULL, NULL, &errormsg);
148  * RES_CONFIG_SQLITE_END(error)
149  *
150  * if (error)
151  *       ...;
152  * </pre>
153  */
154 #define RES_CONFIG_SQLITE_MAX_LOOPS 10
155
156 /*!
157  * Macro used before executing a query.
158  *
159  * \see RES_CONFIG_SQLITE_MAX_LOOPS.
160  */
161 #define RES_CONFIG_SQLITE_BEGIN                                         \
162 MACRO_BEGIN                                                             \
163         int __i;                                                        \
164                                                                         \
165         for (__i = 0; __i < RES_CONFIG_SQLITE_MAX_LOOPS; __i++) {
166
167 /*!
168  * Macro used after executing a query.
169  *
170  * \see RES_CONFIG_SQLITE_MAX_LOOPS.
171  */
172 #define RES_CONFIG_SQLITE_END(error)                                    \
173                 if (error != SQLITE_BUSY)       \
174                         break;                                          \
175                 usleep(1000);                                           \
176         }                                                               \
177 MACRO_END;
178
179 /*!
180  * Structure sent to the SQLite callback function for static configuration.
181  *
182  * \see add_cfg_entry()
183  */
184 struct cfg_entry_args {
185         struct ast_config *cfg;
186         struct ast_category *cat;
187         char *cat_name;
188         struct ast_flags flags;
189         const char *who_asked;
190 };
191
192 /*!
193  * Structure sent to the SQLite callback function for RealTime configuration.
194  *
195  * \see add_rt_cfg_entry()
196  */
197 struct rt_cfg_entry_args {
198         struct ast_variable *var;
199         struct ast_variable *last;
200 };
201
202 /*!
203  * Structure sent to the SQLite callback function for RealTime configuration
204  * (realtime_multi_handler()).
205  *
206  * \see add_rt_multi_cfg_entry()
207  */
208 struct rt_multi_cfg_entry_args {
209         struct ast_config *cfg;
210         char *initfield;
211 };
212
213 /*!
214  * \brief Allocate a variable.
215  * \param var the address of the variable to set (it will be allocated)
216  * \param name the name of the variable (for error handling)
217  * \param value the value to store in var
218  * \retval 0 on success
219  * \retval 1 if an allocation error occurred
220  */
221 static int set_var(char **var, const char *name, const char *value);
222
223 /*!
224  * \brief Load the configuration file.
225  * \see unload_config()
226  *
227  * This function sets dbfile, config_table, and cdr_table. It calls
228  * check_vars() before returning, and unload_config() if an error occurred.
229  *
230  * \retval 0 on success
231  * \retval 1 if an error occurred
232  */
233 static int load_config(void);
234
235 /*!
236  * \brief Free resources related to configuration.
237  * \see load_config()
238  */
239 static void unload_config(void);
240
241 /*!
242  * \brief Asterisk callback function for CDR support.
243  * \param cdr the CDR entry Asterisk sends us.
244  *
245  * Asterisk will call this function each time a CDR entry must be logged if
246  * CDR support is enabled.
247  *
248  * \retval 0 on success
249  * \retval 1 if an error occurred
250  */
251 static int cdr_handler(struct ast_cdr *cdr);
252
253 /*!
254  * \brief SQLite callback function for static configuration.
255  *
256  * This function is passed to the SQLite engine as a callback function to
257  * parse a row and store it in a struct ast_config object. It relies on
258  * resulting rows being sorted by category.
259  *
260  * \param arg a pointer to a struct cfg_entry_args object
261  * \param argc number of columns
262  * \param argv values in the row
263  * \param columnNames names and types of the columns
264  * \retval 0 on success
265  * \retval 1 if an error occurred
266  * \see cfg_entry_args
267  * \see sql_get_config_table
268  * \see config_handler()
269  */
270 static int add_cfg_entry(void *arg, int argc, char **argv, char **columnNames);
271
272 /*!
273  * \brief Asterisk callback function for static configuration.
274  *
275  * Asterisk will call this function when it loads its static configuration,
276  * which usually happens at startup and reload.
277  *
278  * \param database the database to use (ignored)
279  * \param table the table to use
280  * \param file the file to load from the database
281  * \param cfg the struct ast_config object to use when storing variables
282  * \param flags Optional flags.  Not used.
283  * \param suggested_incl suggest include.
284  * \param who_asked
285  * \retval cfg object
286  * \retval NULL if an error occurred
287  * \see add_cfg_entry()
288  */
289 static struct ast_config * config_handler(const char *database, const char *table, const char *file,
290         struct ast_config *cfg, struct ast_flags flags, const char *suggested_incl, const char *who_asked);
291
292 /*!
293  * \brief SQLite callback function for RealTime configuration.
294  *
295  * This function is passed to the SQLite engine as a callback function to
296  * parse a row and store it in a linked list of struct ast_variable objects.
297  *
298  * \param arg a pointer to a struct rt_cfg_entry_args object
299  * \param argc number of columns
300  * \param argv values in the row
301  * \param columnNames names and types of the columns
302  * \retval 0 on success.
303  * \retval 1 if an error occurred.
304  * \see rt_cfg_entry_args
305  * \see realtime_handler()
306  */
307 static int add_rt_cfg_entry(void *arg, int argc, char **argv,
308         char **columnNames);
309
310 /*!
311  * \brief Asterisk callback function for RealTime configuration.
312  *
313  * Asterisk will call this function each time it requires a variable
314  * through the RealTime architecture. ap is a list of parameters and
315  * values used to find a specific row, e.g one parameter "name" and
316  * one value "123" so that the SQL query becomes <code>SELECT * FROM
317  * table WHERE name = '123';</code>.
318  *
319  * \param database the database to use (ignored)
320  * \param table the table to use
321  * \param fields list of parameters and values to match
322  *
323  * \retval a linked list of struct ast_variable objects
324  * \retval NULL if an error occurred
325  * \see add_rt_cfg_entry()
326  */
327 static struct ast_variable * realtime_handler(const char *database,
328         const char *table, const struct ast_variable *fields);
329
330 /*!
331  * \brief SQLite callback function for RealTime configuration.
332  *
333  * This function performs the same actions as add_rt_cfg_entry() except
334  * that the rt_multi_cfg_entry_args structure is designed to store
335  * categories in addition to variables.
336  *
337  * \param arg a pointer to a struct rt_multi_cfg_entry_args object
338  * \param argc number of columns
339  * \param argv values in the row
340  * \param columnNames names and types of the columns
341  * \retval 0 on success.
342  * \retval 1 if an error occurred.
343  * \see rt_multi_cfg_entry_args
344  * \see realtime_multi_handler()
345  */
346 static int add_rt_multi_cfg_entry(void *arg, int argc, char **argv,
347         char **columnNames);
348
349 /*!
350  * \brief Asterisk callback function for RealTime configuration.
351  *
352  * This function performs the same actions as realtime_handler() except
353  * that it can store variables per category, and can return several
354  * categories.
355  *
356  * \param database the database to use (ignored)
357  * \param table the table to use
358  * \param fields list of parameters and values to match
359  * \retval a struct ast_config object storing categories and variables.
360  * \retval NULL if an error occurred.
361  *
362  * \see add_rt_multi_cfg_entry()
363  */
364 static struct ast_config * realtime_multi_handler(const char *database,
365         const char *table, const struct ast_variable *fields);
366
367 /*!
368  * \brief Asterisk callback function for RealTime configuration (variable
369  * update).
370  *
371  * Asterisk will call this function each time a variable has been modified
372  * internally and must be updated in the backend engine. keyfield and entity
373  * are used to find the row to update, e.g. <code>UPDATE table SET ... WHERE
374  * keyfield = 'entity';</code>. ap is a list of parameters and values with the
375  * same format as the other realtime functions.
376  *
377  * \param database the database to use (ignored)
378  * \param table the table to use
379  * \param keyfield the column of the matching cell
380  * \param entity the value of the matching cell
381  * \param fields list of parameters and new values to update in the database
382  * \retval the number of affected rows.
383  * \retval -1 if an error occurred.
384  */
385 static int realtime_update_handler(const char *database, const char *table,
386         const char *keyfield, const char *entity, const struct ast_variable *fields);
387 static int realtime_update2_handler(const char *database, const char *table,
388         const struct ast_variable *lookup_fields, const struct ast_variable *update_fields);
389
390 /*!
391  * \brief Asterisk callback function for RealTime configuration (variable
392  * create/store).
393  *
394  * Asterisk will call this function each time a variable has been created
395  * internally and must be stored in the backend engine.
396  * are used to find the row to update, e.g. ap is a list of parameters and
397  * values with the same format as the other realtime functions.
398  *
399  * \param database the database to use (ignored)
400  * \param table the table to use
401  * \param fields list of parameters and new values to insert into the database
402  * \retval the rowid of inserted row.
403  * \retval -1 if an error occurred.
404  */
405 static int realtime_store_handler(const char *database, const char *table,
406         const struct ast_variable *fields);
407
408 /*!
409  * \brief Asterisk callback function for RealTime configuration (destroys
410  * variable).
411  *
412  * Asterisk will call this function each time a variable has been destroyed
413  * internally and must be removed from the backend engine. keyfield and entity
414  * are used to find the row to delete, e.g. <code>DELETE FROM table WHERE
415  * keyfield = 'entity';</code>. ap is a list of parameters and values with the
416  * same format as the other realtime functions.
417  *
418  * \param database the database to use (ignored)
419  * \param table the table to use
420  * \param keyfield the column of the matching cell
421  * \param entity the value of the matching cell
422  * \param fields list of additional parameters for cell matching
423  * \retval the number of affected rows.
424  * \retval -1 if an error occurred.
425  */
426 static int realtime_destroy_handler(const char *database, const char *table,
427         const char *keyfield, const char *entity, const struct ast_variable *fields);
428
429 /*!
430  * \brief Asterisk callback function for the CLI status command.
431  *
432  * \param e CLI command
433  * \param cmd 
434  * \param a CLI argument list
435  * \return RESULT_SUCCESS
436  */
437 static char *handle_cli_show_sqlite_status(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a);
438 static char *handle_cli_sqlite_show_tables(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a);
439
440 static int realtime_require_handler(const char *database, const char *table, va_list ap);
441 static int realtime_unload_handler(const char *unused, const char *tablename);
442
443 /*! The SQLite database object. */
444 static sqlite *db;
445
446 /*! Set to 1 if CDR support is enabled. */
447 static int use_cdr;
448
449 /*! Set to 1 if the CDR callback function was registered. */
450 static int cdr_registered;
451
452 /*! Set to 1 if the CLI status command callback function was registered. */
453 static int cli_status_registered;
454
455 /*! The path of the database file. */
456 static char *dbfile;
457
458 /*! The name of the static configuration table. */
459 static char *config_table;
460
461 /*! The name of the table used to store CDR entries. */
462 static char *cdr_table;
463
464 /*!
465  * The structure specifying all callback functions used by Asterisk for static
466  * and RealTime configuration.
467  */
468 static struct ast_config_engine sqlite_engine =
469 {
470         .name = RES_CONFIG_SQLITE_DRIVER,
471         .load_func = config_handler,
472         .realtime_func = realtime_handler,
473         .realtime_multi_func = realtime_multi_handler,
474         .store_func = realtime_store_handler,
475         .destroy_func = realtime_destroy_handler,
476         .update_func = realtime_update_handler,
477         .update2_func = realtime_update2_handler,
478         .require_func = realtime_require_handler,
479         .unload_func = realtime_unload_handler,
480 };
481
482 /*!
483  * The mutex used to prevent simultaneous access to the SQLite database.
484  */
485 AST_MUTEX_DEFINE_STATIC(mutex);
486
487 /*!
488  * Structure containing details and callback functions for the CLI status
489  * command.
490  */
491 static struct ast_cli_entry cli_status[] = {
492         AST_CLI_DEFINE(handle_cli_show_sqlite_status, "Show status information about the SQLite 2 driver"),
493         AST_CLI_DEFINE(handle_cli_sqlite_show_tables, "Cached table information about the SQLite 2 driver"),
494 };
495
496 struct sqlite_cache_columns {
497         char *name;
498         char *type;
499         unsigned char isint;    /*!< By definition, only INTEGER PRIMARY KEY is an integer; everything else is a string. */
500         AST_RWLIST_ENTRY(sqlite_cache_columns) list;
501 };
502
503 struct sqlite_cache_tables {
504         char *name;
505         AST_RWLIST_HEAD(_columns, sqlite_cache_columns) columns;
506         AST_RWLIST_ENTRY(sqlite_cache_tables) list;
507 };
508
509 static AST_RWLIST_HEAD_STATIC(sqlite_tables, sqlite_cache_tables);
510
511 /*
512  * Taken from Asterisk 1.2 cdr_sqlite.so.
513  */
514
515 /*! SQL query format to create the CDR table if non existent. */
516 static char *sql_create_cdr_table =
517 "CREATE TABLE '%q' (\n"
518 "       id              INTEGER,\n"
519 "       clid            VARCHAR(80)     NOT NULL        DEFAULT '',\n"
520 "       src             VARCHAR(80)     NOT NULL        DEFAULT '',\n"
521 "       dst             VARCHAR(80)     NOT NULL        DEFAULT '',\n"
522 "       dcontext        VARCHAR(80)     NOT NULL        DEFAULT '',\n"
523 "       channel         VARCHAR(80)     NOT NULL        DEFAULT '',\n"
524 "       dstchannel      VARCHAR(80)     NOT NULL        DEFAULT '',\n"
525 "       lastapp         VARCHAR(80)     NOT NULL        DEFAULT '',\n"
526 "       lastdata        VARCHAR(80)     NOT NULL        DEFAULT '',\n"
527 "       start           DATETIME        NOT NULL        DEFAULT '0000-00-00 00:00:00',\n"
528 "       answer          DATETIME        NOT NULL        DEFAULT '0000-00-00 00:00:00',\n"
529 "       end             DATETIME        NOT NULL        DEFAULT '0000-00-00 00:00:00',\n"
530 "       duration        INT(11)         NOT NULL        DEFAULT 0,\n"
531 "       billsec         INT(11)         NOT NULL        DEFAULT 0,\n"
532 "       disposition     VARCHAR(45)     NOT NULL        DEFAULT '',\n"
533 "       amaflags        INT(11)         NOT NULL        DEFAULT 0,\n"
534 "       accountcode     VARCHAR(20)     NOT NULL        DEFAULT '',\n"
535 "       uniqueid        VARCHAR(32)     NOT NULL        DEFAULT '',\n"
536 "       userfield       VARCHAR(255)    NOT NULL        DEFAULT '',\n"
537 "       PRIMARY KEY     (id)\n"
538 ");";
539
540 /*!
541  * SQL query format to describe the table structure
542  */
543 #define sql_table_structure "SELECT sql FROM sqlite_master WHERE type='table' AND tbl_name='%s'"
544
545 /*!
546  * SQL query format to fetch the static configuration of a file.
547  * Rows must be sorted by category.
548  *
549  * \see add_cfg_entry()
550  */
551 #define sql_get_config_table \
552         "SELECT *" \
553         "       FROM '%q'" \
554         "       WHERE filename = '%q' AND commented = 0" \
555         "       ORDER BY cat_metric ASC, var_metric ASC;"
556
557 static void free_table(struct sqlite_cache_tables *tblptr)
558 {
559         struct sqlite_cache_columns *col;
560
561         /* Obtain a write lock to ensure there are no read locks outstanding */
562         AST_RWLIST_WRLOCK(&(tblptr->columns));
563         while ((col = AST_RWLIST_REMOVE_HEAD(&(tblptr->columns), list))) {
564                 ast_free(col);
565         }
566         AST_RWLIST_UNLOCK(&(tblptr->columns));
567         AST_RWLIST_HEAD_DESTROY(&(tblptr->columns));
568         ast_free(tblptr);
569 }
570
571 static int find_table_cb(void *vtblptr, int argc, char **argv, char **columnNames)
572 {
573         struct sqlite_cache_tables *tblptr = vtblptr;
574         char *sql = ast_strdupa(argv[0]), *start, *end, *type, *remainder;
575         int i;
576         AST_DECLARE_APP_ARGS(fie,
577                 AST_APP_ARG(ld)[100]; /* This means we support up to 100 columns per table */
578         );
579         struct sqlite_cache_columns *col;
580
581         /* This is really fun.  We get to parse an SQL statement to figure out
582          * what columns are in the table.
583          */
584         if ((start = strchr(sql, '(')) && (end = strrchr(sql, ')'))) {
585                 start++;
586                 *end = '\0';
587         } else {
588                 /* Abort */
589                 return -1;
590         }
591
592         AST_STANDARD_APP_ARGS(fie, start);
593         for (i = 0; i < fie.argc; i++) {
594                 fie.ld[i] = ast_skip_blanks(fie.ld[i]);
595                 ast_debug(5, "Found field: %s\n", fie.ld[i]);
596                 if (strncasecmp(fie.ld[i], "PRIMARY KEY", 11) == 0 && (start = strchr(fie.ld[i], '(')) && (end = strchr(fie.ld[i], ')'))) {
597                         *end = '\0';
598                         AST_RWLIST_TRAVERSE(&(tblptr->columns), col, list) {
599                                 if (strcasecmp(start + 1, col->name) == 0 && strcasestr(col->type, "INTEGER")) {
600                                         col->isint = 1;
601                                 }
602                         }
603                         continue;
604                 }
605                 /* type delimiter could be any space character */
606                 for (type = fie.ld[i]; *type > 32; type++);
607                 *type++ = '\0';
608                 type = ast_skip_blanks(type);
609                 for (remainder = type; *remainder > 32; remainder++);
610                 *remainder = '\0';
611                 if (!(col = ast_calloc(1, sizeof(*col) + strlen(fie.ld[i]) + strlen(type) + 2))) {
612                         return -1;
613                 }
614                 col->name = (char *)col + sizeof(*col);
615                 col->type = (char *)col + sizeof(*col) + strlen(fie.ld[i]) + 1;
616                 strcpy(col->name, fie.ld[i]); /* SAFE */
617                 strcpy(col->type, type); /* SAFE */
618                 if (strcasestr(col->type, "INTEGER") && strcasestr(col->type, "PRIMARY KEY")) {
619                         col->isint = 1;
620                 }
621                 AST_LIST_INSERT_TAIL(&(tblptr->columns), col, list);
622         }
623         return 0;
624 }
625
626 static struct sqlite_cache_tables *find_table(const char *tablename)
627 {
628         struct sqlite_cache_tables *tblptr;
629         int i, err;
630         char *sql, *errstr = NULL;
631
632         AST_RWLIST_RDLOCK(&sqlite_tables);
633
634         for (i = 0; i < 2; i++) {
635                 AST_RWLIST_TRAVERSE(&sqlite_tables, tblptr, list) {
636                         if (strcmp(tblptr->name, tablename) == 0) {
637                                 break;
638                         }
639                 }
640                 if (tblptr) {
641                         AST_RWLIST_RDLOCK(&(tblptr->columns));
642                         AST_RWLIST_UNLOCK(&sqlite_tables);
643                         return tblptr;
644                 }
645
646                 if (i == 0) {
647                         AST_RWLIST_UNLOCK(&sqlite_tables);
648                         AST_RWLIST_WRLOCK(&sqlite_tables);
649                 }
650         }
651
652         /* Table structure not cached; build the structure now */
653         if (ast_asprintf(&sql, sql_table_structure, tablename) < 0) {
654                 sql = NULL;
655         }
656         if (!(tblptr = ast_calloc(1, sizeof(*tblptr) + strlen(tablename) + 1))) {
657                 AST_RWLIST_UNLOCK(&sqlite_tables);
658                 ast_log(LOG_ERROR, "Memory error.  Cannot cache table '%s'\n", tablename);
659                 ast_free(sql);
660                 return NULL;
661         }
662         tblptr->name = (char *)tblptr + sizeof(*tblptr);
663         strcpy(tblptr->name, tablename); /* SAFE */
664         AST_RWLIST_HEAD_INIT(&(tblptr->columns));
665
666         ast_debug(1, "About to query table structure: %s\n", sql);
667
668         ast_mutex_lock(&mutex);
669         if ((err = sqlite_exec(db, sql, find_table_cb, tblptr, &errstr))) {
670                 ast_mutex_unlock(&mutex);
671                 ast_log(LOG_WARNING, "SQLite error %d: %s\n", err, errstr);
672                 ast_free(errstr);
673                 free_table(tblptr);
674                 AST_RWLIST_UNLOCK(&sqlite_tables);
675                 ast_free(sql);
676                 return NULL;
677         }
678         ast_mutex_unlock(&mutex);
679         ast_free(sql);
680
681         if (AST_LIST_EMPTY(&(tblptr->columns))) {
682                 free_table(tblptr);
683                 AST_RWLIST_UNLOCK(&sqlite_tables);
684                 return NULL;
685         }
686
687         AST_RWLIST_INSERT_TAIL(&sqlite_tables, tblptr, list);
688         AST_RWLIST_RDLOCK(&(tblptr->columns));
689         AST_RWLIST_UNLOCK(&sqlite_tables);
690         return tblptr;
691 }
692
693 #define release_table(a)        AST_RWLIST_UNLOCK(&((a)->columns))
694
695 static int set_var(char **var, const char *name, const char *value)
696 {
697         if (*var)
698                 ast_free(*var);
699
700         *var = ast_strdup(value);
701
702         if (!*var) {
703                 ast_log(LOG_WARNING, "Unable to allocate variable %s\n", name);
704                 return 1;
705         }
706
707         return 0;
708 }
709
710 static int check_vars(void)
711 {
712         if (!dbfile) {
713                 ast_log(LOG_ERROR, "Required parameter undefined: dbfile\n");
714                 return 1;
715         }
716
717         use_cdr = (cdr_table != NULL);
718
719         return 0;
720 }
721
722 static int load_config(void)
723 {
724         struct ast_config *config;
725         struct ast_variable *var;
726         int error;
727         struct ast_flags config_flags = { 0 };
728
729         config = ast_config_load(RES_CONFIG_SQLITE_CONF_FILE, config_flags);
730
731         if (config == CONFIG_STATUS_FILEMISSING || config == CONFIG_STATUS_FILEINVALID) {
732                 ast_log(LOG_ERROR, "Unable to load " RES_CONFIG_SQLITE_CONF_FILE "\n");
733                 return 1;
734         }
735
736         for (var = ast_variable_browse(config, "general"); var; var = var->next) {
737                 if (!strcasecmp(var->name, "dbfile"))
738                         SET_VAR(config, dbfile, var);
739                 else if (!strcasecmp(var->name, "config_table"))
740                         SET_VAR(config, config_table, var);
741                 else if (!strcasecmp(var->name, "cdr_table")) {
742                         SET_VAR(config, cdr_table, var);
743                 } else
744                         ast_log(LOG_WARNING, "Unknown parameter : %s\n", var->name);
745         }
746
747         ast_config_destroy(config);
748         error = check_vars();
749
750         if (error) {
751                 unload_config();
752                 return 1;
753         }
754
755         return 0;
756 }
757
758 static void unload_config(void)
759 {
760         struct sqlite_cache_tables *tbl;
761         ast_free(dbfile);
762         dbfile = NULL;
763         ast_free(config_table);
764         config_table = NULL;
765         ast_free(cdr_table);
766         cdr_table = NULL;
767         AST_RWLIST_WRLOCK(&sqlite_tables);
768         while ((tbl = AST_RWLIST_REMOVE_HEAD(&sqlite_tables, list))) {
769                 free_table(tbl);
770         }
771         AST_RWLIST_UNLOCK(&sqlite_tables);
772 }
773
774 static int cdr_handler(struct ast_cdr *cdr)
775 {
776         char *errormsg = NULL, *tmp, workspace[500];
777         int error, scannum;
778         struct sqlite_cache_tables *tbl = find_table(cdr_table);
779         struct sqlite_cache_columns *col;
780         struct ast_str *sql1 = ast_str_create(160), *sql2 = ast_str_create(16);
781         int first = 1;
782
783         if (!sql1 || !sql2) {
784                 ast_free(sql1);
785                 ast_free(sql2);
786                 return -1;
787         }
788
789         if (!tbl) {
790                 ast_log(LOG_WARNING, "No such table: %s\n", cdr_table);
791                 ast_free(sql1);
792                 ast_free(sql2);
793                 return -1;
794         }
795
796         ast_str_set(&sql1, 0, "INSERT INTO %s (", cdr_table);
797         ast_str_set(&sql2, 0, ") VALUES (");
798
799         AST_RWLIST_TRAVERSE(&(tbl->columns), col, list) {
800                 if (col->isint) {
801                         ast_cdr_format_var(cdr, col->name, &tmp, workspace, sizeof(workspace), 1);
802                         if (!tmp) {
803                                 continue;
804                         }
805                         if (sscanf(tmp, "%30d", &scannum) == 1) {
806                                 ast_str_append(&sql1, 0, "%s%s", first ? "" : ",", col->name);
807                                 ast_str_append(&sql2, 0, "%s%d", first ? "" : ",", scannum);
808                         }
809                 } else {
810                         ast_cdr_format_var(cdr, col->name, &tmp, workspace, sizeof(workspace), 0);
811                         if (!tmp) {
812                                 continue;
813                         }
814                         ast_str_append(&sql1, 0, "%s%s", first ? "" : ",", col->name);
815                         tmp = sqlite_mprintf("%Q", tmp);
816                         ast_str_append(&sql2, 0, "%s%s", first ? "" : ",", tmp);
817                         sqlite_freemem(tmp);
818                 }
819                 first = 0;
820         }
821         release_table(tbl);
822
823         ast_str_append(&sql1, 0, "%s)", ast_str_buffer(sql2));
824         ast_free(sql2);
825
826         ast_debug(1, "SQL query: %s\n", ast_str_buffer(sql1));
827
828         ast_mutex_lock(&mutex);
829
830         RES_CONFIG_SQLITE_BEGIN
831                 error = sqlite_exec(db, ast_str_buffer(sql1), NULL, NULL, &errormsg);
832         RES_CONFIG_SQLITE_END(error)
833
834         ast_mutex_unlock(&mutex);
835
836         ast_free(sql1);
837
838         if (error) {
839                 ast_log(LOG_ERROR, "%s\n", S_OR(errormsg, sqlite_error_string(error)));
840                 sqlite_freemem(errormsg);
841                 return 1;
842         }
843         sqlite_freemem(errormsg);
844
845         return 0;
846 }
847
848 static int add_cfg_entry(void *arg, int argc, char **argv, char **columnNames)
849 {
850         struct cfg_entry_args *args;
851         struct ast_variable *var;
852
853         if (argc != RES_CONFIG_SQLITE_CONFIG_COLUMNS) {
854                 ast_log(LOG_WARNING, "Corrupt table\n");
855                 return 1;
856         }
857
858         args = arg;
859
860         if (!strcmp(argv[RES_CONFIG_SQLITE_CONFIG_VAR_NAME], "#include")) {
861                 struct ast_config *cfg;
862                 char *val;
863
864                 val = argv[RES_CONFIG_SQLITE_CONFIG_VAR_VAL];
865                 cfg = ast_config_internal_load(val, args->cfg, args->flags, "", args->who_asked);
866
867                 if (!cfg) {
868                         ast_log(LOG_WARNING, "Unable to include %s\n", val);
869                         return 1;
870                 } else {
871                         args->cfg = cfg;
872                         return 0;
873                 }
874         }
875
876         if (!args->cat_name || strcmp(args->cat_name, argv[RES_CONFIG_SQLITE_CONFIG_CATEGORY])) {
877                 args->cat = ast_category_new(argv[RES_CONFIG_SQLITE_CONFIG_CATEGORY], "", 99999);
878
879                 if (!args->cat) {
880                         ast_log(LOG_WARNING, "Unable to allocate category\n");
881                         return 1;
882                 }
883
884                 ast_free(args->cat_name);
885                 args->cat_name = ast_strdup(argv[RES_CONFIG_SQLITE_CONFIG_CATEGORY]);
886
887                 if (!args->cat_name) {
888                         ast_category_destroy(args->cat);
889                         return 1;
890                 }
891
892                 ast_category_append(args->cfg, args->cat);
893         }
894
895         var = ast_variable_new(argv[RES_CONFIG_SQLITE_CONFIG_VAR_NAME], argv[RES_CONFIG_SQLITE_CONFIG_VAR_VAL], "");
896
897         if (!var) {
898                 ast_log(LOG_WARNING, "Unable to allocate variable\n");
899                 return 1;
900         }
901
902         ast_variable_append(args->cat, var);
903
904         return 0;
905 }
906
907 static struct ast_config *config_handler(const char *database,  const char *table, const char *file,
908         struct ast_config *cfg, struct ast_flags flags, const char *suggested_incl, const char *who_asked)
909 {
910         struct cfg_entry_args args;
911         char *query, *errormsg = NULL;
912         int error;
913
914         if (!config_table) {
915                 if (!table) {
916                         ast_log(LOG_ERROR, "Table name unspecified\n");
917                         return NULL;
918                 }
919         } else
920                 table = config_table;
921
922         query = sqlite_mprintf(sql_get_config_table, table, file);
923
924         if (!query) {
925                 ast_log(LOG_WARNING, "Unable to allocate SQL query\n");
926                 return NULL;
927         }
928
929         ast_debug(1, "SQL query: %s\n", query);
930         args.cfg = cfg;
931         args.cat = NULL;
932         args.cat_name = NULL;
933         args.flags = flags;
934         args.who_asked = who_asked;
935
936         ast_mutex_lock(&mutex);
937
938         RES_CONFIG_SQLITE_BEGIN
939                 error = sqlite_exec(db, query, add_cfg_entry, &args, &errormsg);
940         RES_CONFIG_SQLITE_END(error)
941
942         ast_mutex_unlock(&mutex);
943
944         ast_free(args.cat_name);
945         sqlite_freemem(query);
946
947         if (error) {
948                 ast_log(LOG_ERROR, "%s\n", S_OR(errormsg, sqlite_error_string(error)));
949                 sqlite_freemem(errormsg);
950                 return NULL;
951         }
952         sqlite_freemem(errormsg);
953
954         return cfg;
955 }
956
957 static int add_rt_cfg_entry(void *arg, int argc, char **argv, char **columnNames)
958 {
959         struct rt_cfg_entry_args *args;
960         struct ast_variable *var;
961         int i;
962
963         args = arg;
964
965         for (i = 0; i < argc; i++) {
966                 if (!argv[i])
967                         continue;
968
969                 if (!(var = ast_variable_new(columnNames[i], argv[i], "")))
970                         return 1;
971
972                 if (!args->var)
973                         args->var = var;
974
975                 if (!args->last)
976                         args->last = var;
977                 else {
978                         args->last->next = var;
979                         args->last = var;
980                 }
981         }
982
983         return 0;
984 }
985
986 static struct ast_variable * realtime_handler(const char *database, const char *table, const struct ast_variable *fields)
987 {
988         char *query, *errormsg = NULL, *op, *tmp_str;
989         struct rt_cfg_entry_args args;
990         const struct ast_variable *field = fields;
991         int error;
992
993         if (!table) {
994                 ast_log(LOG_WARNING, "Table name unspecified\n");
995                 return NULL;
996         }
997
998         if (!fields) {
999                 return NULL;
1000         }
1001
1002         op = (strchr(field->name, ' ') == NULL) ? " =" : "";
1003
1004 /* \cond DOXYGEN_CAN_PARSE_THIS */
1005 #undef QUERY
1006 #define QUERY "SELECT * FROM '%q' WHERE%s %q%s '%q'"
1007 /* \endcond */
1008
1009         query = sqlite_mprintf(QUERY, table, (config_table && !strcmp(config_table, table)) ? " commented = 0 AND" : "", field->name, op, field->value);
1010
1011         if (!query) {
1012                 ast_log(LOG_WARNING, "Unable to allocate SQL query\n");
1013                 return NULL;
1014         }
1015
1016         while ((field = field->next)) {
1017                 op = (strchr(field->name, ' ') == NULL) ? " =" : "";
1018                 tmp_str = sqlite_mprintf("%s AND %q%s '%q'", query, field->name, op, field->value);
1019                 sqlite_freemem(query);
1020
1021                 if (!tmp_str) {
1022                         ast_log(LOG_WARNING, "Unable to reallocate SQL query\n");
1023                         return NULL;
1024                 }
1025
1026                 query = tmp_str;
1027         }
1028
1029         tmp_str = sqlite_mprintf("%s LIMIT 1;", query);
1030         sqlite_freemem(query);
1031
1032         if (!tmp_str) {
1033                 ast_log(LOG_WARNING, "Unable to reallocate SQL query\n");
1034                 return NULL;
1035         }
1036
1037         query = tmp_str;
1038         ast_debug(1, "SQL query: %s\n", query);
1039         args.var = NULL;
1040         args.last = NULL;
1041
1042         ast_mutex_lock(&mutex);
1043
1044         RES_CONFIG_SQLITE_BEGIN
1045                 error = sqlite_exec(db, query, add_rt_cfg_entry, &args, &errormsg);
1046         RES_CONFIG_SQLITE_END(error)
1047
1048         ast_mutex_unlock(&mutex);
1049
1050         sqlite_freemem(query);
1051
1052         if (error) {
1053                 ast_log(LOG_WARNING, "%s\n", S_OR(errormsg, sqlite_error_string(error)));
1054                 sqlite_freemem(errormsg);
1055                 ast_variables_destroy(args.var);
1056                 return NULL;
1057         }
1058         sqlite_freemem(errormsg);
1059
1060         return args.var;
1061 }
1062
1063 static int add_rt_multi_cfg_entry(void *arg, int argc, char **argv, char **columnNames)
1064 {
1065         struct rt_multi_cfg_entry_args *args;
1066         struct ast_category *cat;
1067         struct ast_variable *var;
1068         char *cat_name;
1069         size_t i;
1070
1071         args = arg;
1072         cat_name = NULL;
1073
1074         /*
1075          * cat_name should always be set here, since initfield is forged from
1076          * params[0] in realtime_multi_handler(), which is a search parameter
1077          * of the SQL query.
1078          */
1079         for (i = 0; i < argc; i++) {
1080                 if (!strcmp(args->initfield, columnNames[i]))
1081                         cat_name = argv[i];
1082         }
1083
1084         if (!cat_name) {
1085                 ast_log(LOG_ERROR, "Bogus SQL results, cat_name is NULL !\n");
1086                 return 1;
1087         }
1088
1089         if (!(cat = ast_category_new(cat_name, "", 99999))) {
1090                 ast_log(LOG_WARNING, "Unable to allocate category\n");
1091                 return 1;
1092         }
1093
1094         ast_category_append(args->cfg, cat);
1095
1096         for (i = 0; i < argc; i++) {
1097                 if (!argv[i]) {
1098                         continue;
1099                 }
1100
1101                 if (!(var = ast_variable_new(columnNames[i], argv[i], ""))) {
1102                         ast_log(LOG_WARNING, "Unable to allocate variable\n");
1103                         return 1;
1104                 }
1105
1106                 ast_variable_append(cat, var);
1107         }
1108
1109         return 0;
1110 }
1111
1112 static struct ast_config *realtime_multi_handler(const char *database,
1113         const char *table, const struct ast_variable *fields)
1114 {
1115         char *query, *errormsg = NULL, *op, *tmp_str, *initfield;
1116         struct rt_multi_cfg_entry_args args;
1117         const struct ast_variable *field = fields;
1118         struct ast_config *cfg;
1119         int error;
1120
1121         if (!table) {
1122                 ast_log(LOG_WARNING, "Table name unspecified\n");
1123                 return NULL;
1124         }
1125
1126         if (!fields) {
1127                 return NULL;
1128         }
1129
1130         if (!(cfg = ast_config_new())) {
1131                 ast_log(LOG_WARNING, "Unable to allocate configuration structure\n");
1132                 return NULL;
1133         }
1134
1135         if (!(initfield = ast_strdup(field->name))) {
1136                 ast_config_destroy(cfg);
1137                 return NULL;
1138         }
1139
1140         tmp_str = strchr(initfield, ' ');
1141
1142         if (tmp_str)
1143                 *tmp_str = '\0';
1144
1145         op = (!strchr(field->name, ' ')) ? " =" : "";
1146
1147         /*
1148          * Asterisk sends us an already escaped string when searching for
1149          * "exten LIKE" (uh!). Handle it separately.
1150          */
1151         tmp_str = (!strcmp(field->value, "\\_%")) ? "_%" : (char *)field->value;
1152
1153 /* \cond DOXYGEN_CAN_PARSE_THIS */
1154 #undef QUERY
1155 #define QUERY "SELECT * FROM '%q' WHERE%s %q%s '%q'"
1156 /* \endcond */
1157
1158         if (!(query = sqlite_mprintf(QUERY, table, (config_table && !strcmp(config_table, table)) ? " commented = 0 AND" : "", field->name, op, tmp_str))) {
1159                 ast_log(LOG_WARNING, "Unable to allocate SQL query\n");
1160                 ast_config_destroy(cfg);
1161                 ast_free(initfield);
1162                 return NULL;
1163         }
1164
1165         while ((field = field->next)) {
1166                 op = (!strchr(field->name, ' ')) ? " =" : "";
1167                 tmp_str = sqlite_mprintf("%s AND %q%s '%q'", query, field->name, op, field->value);
1168                 sqlite_freemem(query);
1169
1170                 if (!tmp_str) {
1171                         ast_log(LOG_WARNING, "Unable to reallocate SQL query\n");
1172                         ast_config_destroy(cfg);
1173                         ast_free(initfield);
1174                         return NULL;
1175                 }
1176
1177                 query = tmp_str;
1178         }
1179
1180         if (!(tmp_str = sqlite_mprintf("%s ORDER BY %q;", query, initfield))) {
1181                 ast_log(LOG_WARNING, "Unable to reallocate SQL query\n");
1182                 sqlite_freemem(query);
1183                 ast_config_destroy(cfg);
1184                 ast_free(initfield);
1185                 return NULL;
1186         }
1187
1188         sqlite_freemem(query);
1189         query = tmp_str;
1190         ast_debug(1, "SQL query: %s\n", query);
1191         args.cfg = cfg;
1192         args.initfield = initfield;
1193
1194         ast_mutex_lock(&mutex);
1195
1196         RES_CONFIG_SQLITE_BEGIN
1197                 error = sqlite_exec(db, query, add_rt_multi_cfg_entry, &args, &errormsg);
1198         RES_CONFIG_SQLITE_END(error)
1199
1200         ast_mutex_unlock(&mutex);
1201
1202         sqlite_freemem(query);
1203         ast_free(initfield);
1204
1205         if (error) {
1206                 ast_log(LOG_WARNING, "%s\n", S_OR(errormsg, sqlite_error_string(error)));
1207                 sqlite_freemem(errormsg);
1208                 ast_config_destroy(cfg);
1209                 return NULL;
1210         }
1211         sqlite_freemem(errormsg);
1212
1213         return cfg;
1214 }
1215
1216 static int realtime_update_handler(const char *database, const char *table,
1217         const char *keyfield, const char *entity, const struct ast_variable *fields)
1218 {
1219         char *query, *errormsg = NULL, *tmp_str;
1220         const struct ast_variable *field = fields;
1221         int error, rows_num;
1222
1223         if (!table) {
1224                 ast_log(LOG_WARNING, "Table name unspecified\n");
1225                 return -1;
1226         }
1227
1228         if (!field) {
1229                 return -1;
1230         }
1231
1232 /* \cond DOXYGEN_CAN_PARSE_THIS */
1233 #undef QUERY
1234 #define QUERY "UPDATE '%q' SET %q = '%q'"
1235 /* \endcond */
1236
1237         if (!(query = sqlite_mprintf(QUERY, table, field->name, field->value))) {
1238                 ast_log(LOG_WARNING, "Unable to allocate SQL query\n");
1239                 return -1;
1240         }
1241
1242         while ((field = field->next)) {
1243                 tmp_str = sqlite_mprintf("%s, %q = '%q'", query, field->name, field->value);
1244                 sqlite_freemem(query);
1245
1246                 if (!tmp_str) {
1247                         ast_log(LOG_WARNING, "Unable to reallocate SQL query\n");
1248                         return -1;
1249                 }
1250
1251                 query = tmp_str;
1252         }
1253
1254         if (!(tmp_str = sqlite_mprintf("%s WHERE %q = '%q';", query, keyfield, entity))) {
1255                 ast_log(LOG_WARNING, "Unable to reallocate SQL query\n");
1256                 sqlite_freemem(query);
1257                 return -1;
1258         }
1259
1260         sqlite_freemem(query);
1261         query = tmp_str;
1262         ast_debug(1, "SQL query: %s\n", query);
1263
1264         ast_mutex_lock(&mutex);
1265
1266         RES_CONFIG_SQLITE_BEGIN
1267                 error = sqlite_exec(db, query, NULL, NULL, &errormsg);
1268         RES_CONFIG_SQLITE_END(error)
1269
1270         if (!error)
1271                 rows_num = sqlite_changes(db);
1272         else
1273                 rows_num = -1;
1274
1275         ast_mutex_unlock(&mutex);
1276
1277         sqlite_freemem(query);
1278
1279         if (error) {
1280                 ast_log(LOG_WARNING, "%s\n", S_OR(errormsg, sqlite_error_string(error)));
1281         }
1282         sqlite_freemem(errormsg);
1283
1284         return rows_num;
1285 }
1286
1287 static int realtime_update2_handler(const char *database, const char *table,
1288         const struct ast_variable *lookup_fields, const struct ast_variable *update_fields)
1289 {
1290         char *errormsg = NULL, *tmp1, *tmp2;
1291         int error, rows_num, first = 1;
1292         struct ast_str *sql = ast_str_thread_get(&sql_buf, 100);
1293         struct ast_str *where = ast_str_thread_get(&where_buf, 100);
1294         const struct ast_variable *field;
1295
1296         if (!table) {
1297                 ast_log(LOG_WARNING, "Table name unspecified\n");
1298                 return -1;
1299         }
1300
1301         if (!sql) {
1302                 return -1;
1303         }
1304
1305         ast_str_set(&sql, 0, "UPDATE %s SET", table);
1306         ast_str_set(&where, 0, " WHERE");
1307
1308         for (field = lookup_fields; field; field = field->next) {
1309                 ast_str_append(&where, 0, "%s %s = %s",
1310                         first ? "" : " AND",
1311                         tmp1 = sqlite_mprintf("%q", field->name),
1312                         tmp2 = sqlite_mprintf("%Q", field->value));
1313                 sqlite_freemem(tmp1);
1314                 sqlite_freemem(tmp2);
1315                 first = 0;
1316         }
1317
1318         if (first) {
1319                 ast_log(LOG_ERROR, "No criteria specified on update to '%s@%s'!\n", table, database);
1320                 return -1;
1321         }
1322
1323         first = 1;
1324         for (field = update_fields; field; field = field->next) {
1325                 ast_str_append(&sql, 0, "%s %s = %s",
1326                         first ? "" : ",",
1327                         tmp1 = sqlite_mprintf("%q", field->name),
1328                         tmp2 = sqlite_mprintf("%Q", field->value));
1329                 sqlite_freemem(tmp1);
1330                 sqlite_freemem(tmp2);
1331                 first = 0;
1332         }
1333
1334         ast_str_append(&sql, 0, " %s", ast_str_buffer(where));
1335         ast_debug(1, "SQL query: %s\n", ast_str_buffer(sql));
1336
1337         ast_mutex_lock(&mutex);
1338
1339         RES_CONFIG_SQLITE_BEGIN
1340                 error = sqlite_exec(db, ast_str_buffer(sql), NULL, NULL, &errormsg);
1341         RES_CONFIG_SQLITE_END(error)
1342
1343         if (!error) {
1344                 rows_num = sqlite_changes(db);
1345         } else {
1346                 rows_num = -1;
1347         }
1348
1349         ast_mutex_unlock(&mutex);
1350
1351         if (error) {
1352                 ast_log(LOG_WARNING, "%s\n", S_OR(errormsg, sqlite_error_string(error)));
1353         }
1354         sqlite_freemem(errormsg);
1355
1356         return rows_num;
1357 }
1358
1359 static int realtime_store_handler(const char *database, const char *table, const struct ast_variable *fields)
1360 {
1361         char *errormsg = NULL, *tmp_str, *tmp_keys = NULL, *tmp_keys2 = NULL, *tmp_vals = NULL, *tmp_vals2 = NULL;
1362         const struct ast_variable *field = fields;
1363         int error, rows_id;
1364
1365         if (!table) {
1366                 ast_log(LOG_WARNING, "Table name unspecified\n");
1367                 return -1;
1368         }
1369
1370         if (!fields) {
1371                 return -1;
1372         }
1373
1374 /* \cond DOXYGEN_CAN_PARSE_THIS */
1375 #undef QUERY
1376 #define QUERY "INSERT into '%q' (%s) VALUES (%s);"
1377 /* \endcond */
1378
1379         do {
1380                 if ( tmp_keys2 ) {
1381                         tmp_keys = sqlite_mprintf("%s, %q", tmp_keys2, field->name);
1382                         sqlite_freemem(tmp_keys2);
1383                 } else {
1384                         tmp_keys = sqlite_mprintf("%q", field->name);
1385                 }
1386                 if (!tmp_keys) {
1387                         ast_log(LOG_WARNING, "Unable to reallocate SQL query\n");
1388                         sqlite_freemem(tmp_vals);
1389                         return -1;
1390                 }
1391
1392                 if ( tmp_vals2 ) {
1393                         tmp_vals = sqlite_mprintf("%s, '%q'", tmp_vals2, field->value);
1394                         sqlite_freemem(tmp_vals2);
1395                 } else {
1396                         tmp_vals = sqlite_mprintf("'%q'", field->value);
1397                 }
1398                 if (!tmp_vals) {
1399                         ast_log(LOG_WARNING, "Unable to reallocate SQL query\n");
1400                         sqlite_freemem(tmp_keys);
1401                         return -1;
1402                 }
1403
1404
1405                 tmp_keys2 = tmp_keys;
1406                 tmp_vals2 = tmp_vals;
1407         } while ((field = field->next));
1408
1409         if (!(tmp_str = sqlite_mprintf(QUERY, table, tmp_keys, tmp_vals))) {
1410                 ast_log(LOG_WARNING, "Unable to reallocate SQL query\n");
1411                 sqlite_freemem(tmp_keys);
1412                 sqlite_freemem(tmp_vals);
1413                 return -1;
1414         }
1415
1416         sqlite_freemem(tmp_keys);
1417         sqlite_freemem(tmp_vals);
1418
1419         ast_debug(1, "SQL query: %s\n", tmp_str);
1420
1421         ast_mutex_lock(&mutex);
1422
1423         RES_CONFIG_SQLITE_BEGIN
1424                 error = sqlite_exec(db, tmp_str, NULL, NULL, &errormsg);
1425         RES_CONFIG_SQLITE_END(error)
1426
1427         if (!error) {
1428                 rows_id = sqlite_last_insert_rowid(db);
1429         } else {
1430                 rows_id = -1;
1431         }
1432
1433         ast_mutex_unlock(&mutex);
1434
1435         sqlite_freemem(tmp_str);
1436
1437         if (error) {
1438                 ast_log(LOG_WARNING, "%s\n", S_OR(errormsg, sqlite_error_string(error)));
1439         }
1440         sqlite_freemem(errormsg);
1441
1442         return rows_id;
1443 }
1444
1445 static int realtime_destroy_handler(const char *database, const char *table,
1446         const char *keyfield, const char *entity, const struct ast_variable *fields)
1447 {
1448         char *query, *errormsg = NULL, *tmp_str;
1449         const struct ast_variable *field;
1450         int error, rows_num;
1451
1452         if (!table) {
1453                 ast_log(LOG_WARNING, "Table name unspecified\n");
1454                 return -1;
1455         }
1456
1457 /* \cond DOXYGEN_CAN_PARSE_THIS */
1458 #undef QUERY
1459 #define QUERY "DELETE FROM '%q' WHERE"
1460 /* \endcond */
1461
1462         if (!(query = sqlite_mprintf(QUERY, table))) {
1463                 ast_log(LOG_WARNING, "Unable to allocate SQL query\n");
1464                 return -1;
1465         }
1466
1467         for (field = fields; field; field = field->next) {
1468                 tmp_str = sqlite_mprintf("%s %q = '%q' AND", query, field->name, field->value);
1469                 sqlite_freemem(query);
1470
1471                 if (!tmp_str) {
1472                         ast_log(LOG_WARNING, "Unable to reallocate SQL query\n");
1473                         return -1;
1474                 }
1475
1476                 query = tmp_str;
1477         }
1478
1479         if (!(tmp_str = sqlite_mprintf("%s %q = '%q';", query, keyfield, entity))) {
1480                 ast_log(LOG_WARNING, "Unable to reallocate SQL query\n");
1481                 sqlite_freemem(query);
1482                 return -1;
1483         }
1484         sqlite_freemem(query);
1485         query = tmp_str;
1486         ast_debug(1, "SQL query: %s\n", query);
1487
1488         ast_mutex_lock(&mutex);
1489
1490         RES_CONFIG_SQLITE_BEGIN
1491                 error = sqlite_exec(db, query, NULL, NULL, &errormsg);
1492         RES_CONFIG_SQLITE_END(error)
1493
1494         if (!error) {
1495                 rows_num = sqlite_changes(db);
1496         } else {
1497                 rows_num = -1;
1498         }
1499
1500         ast_mutex_unlock(&mutex);
1501
1502         sqlite_freemem(query);
1503
1504         if (error) {
1505                 ast_log(LOG_WARNING, "%s\n", S_OR(errormsg, sqlite_error_string(error)));
1506         }
1507         sqlite_freemem(errormsg);
1508
1509         return rows_num;
1510 }
1511
1512 static int realtime_require_handler(const char *unused, const char *tablename, va_list ap)
1513 {
1514         struct sqlite_cache_tables *tbl = find_table(tablename);
1515         struct sqlite_cache_columns *col;
1516         char *elm;
1517         int type, res = 0;
1518
1519         if (!tbl) {
1520                 return -1;
1521         }
1522
1523         while ((elm = va_arg(ap, char *))) {
1524                 type = va_arg(ap, require_type);
1525                 va_arg(ap, int);
1526                 /* Check if the field matches the criteria */
1527                 AST_RWLIST_TRAVERSE(&tbl->columns, col, list) {
1528                         if (strcmp(col->name, elm) == 0) {
1529                                 /* SQLite only has two types - the 32-bit integer field that
1530                                  * is the key column, and everything else (everything else
1531                                  * being a string).
1532                                  */
1533                                 if (col->isint && !ast_rq_is_int(type)) {
1534                                         ast_log(LOG_WARNING, "Realtime table %s: column '%s' is an integer field, but Asterisk requires that it not be!\n", tablename, col->name);
1535                                         res = -1;
1536                                 }
1537                                 break;
1538                         }
1539                 }
1540                 if (!col) {
1541                         ast_log(LOG_WARNING, "Realtime table %s requires column '%s', but that column does not exist!\n", tablename, elm);
1542                 }
1543         }
1544         AST_RWLIST_UNLOCK(&(tbl->columns));
1545         return res;
1546 }
1547
1548 static int realtime_unload_handler(const char *unused, const char *tablename)
1549 {
1550         struct sqlite_cache_tables *tbl;
1551         AST_RWLIST_WRLOCK(&sqlite_tables);
1552         AST_RWLIST_TRAVERSE_SAFE_BEGIN(&sqlite_tables, tbl, list) {
1553                 if (!strcasecmp(tbl->name, tablename)) {
1554                         AST_RWLIST_REMOVE_CURRENT(list);
1555                         free_table(tbl);
1556                 }
1557         }
1558         AST_RWLIST_TRAVERSE_SAFE_END
1559         AST_RWLIST_UNLOCK(&sqlite_tables);
1560         return 0;
1561 }
1562
1563 static char *handle_cli_show_sqlite_status(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
1564 {
1565         switch (cmd) {
1566         case CLI_INIT:
1567                 e->command = "sqlite show status";
1568                 e->usage =
1569                         "Usage: sqlite show status\n"
1570                         "       Show status information about the SQLite 2 driver\n";
1571                 return NULL;
1572         case CLI_GENERATE:
1573                 return NULL;
1574         }
1575
1576         if (a->argc != 3)
1577                 return CLI_SHOWUSAGE;
1578
1579         ast_cli(a->fd, "SQLite database path: %s\n", dbfile);
1580         ast_cli(a->fd, "config_table: ");
1581
1582         if (!config_table)
1583                 ast_cli(a->fd, "unspecified, must be present in extconfig.conf\n");
1584         else
1585                 ast_cli(a->fd, "%s\n", config_table);
1586
1587         ast_cli(a->fd, "cdr_table: ");
1588
1589         if (!cdr_table)
1590                 ast_cli(a->fd, "unspecified, CDR support disabled\n");
1591         else
1592                 ast_cli(a->fd, "%s\n", cdr_table);
1593
1594         return CLI_SUCCESS;
1595 }
1596
1597 static char *handle_cli_sqlite_show_tables(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
1598 {
1599         struct sqlite_cache_tables *tbl;
1600         struct sqlite_cache_columns *col;
1601         int found = 0;
1602
1603         switch (cmd) {
1604         case CLI_INIT:
1605                 e->command = "sqlite show tables";
1606                 e->usage =
1607                         "Usage: sqlite show tables\n"
1608                         "       Show table information about the SQLite 2 driver\n";
1609                 return NULL;
1610         case CLI_GENERATE:
1611                 return NULL;
1612         }
1613
1614         if (a->argc != 3)
1615                 return CLI_SHOWUSAGE;
1616
1617         AST_RWLIST_RDLOCK(&sqlite_tables);
1618         AST_RWLIST_TRAVERSE(&sqlite_tables, tbl, list) {
1619                 found++;
1620                 ast_cli(a->fd, "Table %s:\n", tbl->name);
1621                 AST_RWLIST_TRAVERSE(&(tbl->columns), col, list) {
1622                         fprintf(stderr, "%s\n", col->name);
1623                         ast_cli(a->fd, "  %20.20s  %-30.30s\n", col->name, col->type);
1624                 }
1625         }
1626         AST_RWLIST_UNLOCK(&sqlite_tables);
1627
1628         if (!found) {
1629                 ast_cli(a->fd, "No tables currently in cache\n");
1630         }
1631
1632         return CLI_SUCCESS;
1633 }
1634
1635 static int unload_module(void)
1636 {
1637         if (cdr_registered && ast_cdr_unregister(RES_CONFIG_SQLITE_NAME)) {
1638                 return -1;
1639         }
1640
1641         if (cli_status_registered) {
1642                 ast_cli_unregister_multiple(cli_status, ARRAY_LEN(cli_status));
1643         }
1644
1645         ast_config_engine_deregister(&sqlite_engine);
1646
1647         if (db)
1648                 sqlite_close(db);
1649
1650         unload_config();
1651
1652         return 0;
1653 }
1654
1655 /*!
1656  * \brief Load the module
1657  *
1658  * Module loading including tests for configuration or dependencies.
1659  * This function can return AST_MODULE_LOAD_FAILURE, AST_MODULE_LOAD_DECLINE,
1660  * or AST_MODULE_LOAD_SUCCESS. If a dependency or environment variable fails
1661  * tests return AST_MODULE_LOAD_FAILURE. If the module can not load the 
1662  * configuration file or other non-critical problem return 
1663  * AST_MODULE_LOAD_DECLINE. On success return AST_MODULE_LOAD_SUCCESS.
1664  */
1665 static int load_module(void)
1666 {
1667         char *errormsg = NULL;
1668         int error;
1669
1670         db = NULL;
1671         cdr_registered = 0;
1672         cli_status_registered = 0;
1673         dbfile = NULL;
1674         config_table = NULL;
1675         cdr_table = NULL;
1676         error = load_config();
1677
1678         if (error)
1679                 return AST_MODULE_LOAD_DECLINE;
1680
1681         if (!(db = sqlite_open(dbfile, 0660, &errormsg))) {
1682                 ast_log(LOG_ERROR, "%s\n", S_OR(errormsg, sqlite_error_string(error)));
1683                 sqlite_freemem(errormsg);
1684                 unload_module();
1685                 return 1;
1686         }
1687
1688         sqlite_freemem(errormsg);
1689         errormsg = NULL;
1690         ast_config_engine_register(&sqlite_engine);
1691
1692         if (use_cdr) {
1693                 char *query;
1694
1695 /* \cond DOXYGEN_CAN_PARSE_THIS */
1696 #undef QUERY
1697 #define QUERY "SELECT COUNT(id) FROM %Q;"
1698 /* \endcond */
1699
1700                 query = sqlite_mprintf(QUERY, cdr_table);
1701
1702                 if (!query) {
1703                         ast_log(LOG_ERROR, "Unable to allocate SQL query\n");
1704                         unload_module();
1705                         return 1;
1706                 }
1707
1708                 ast_debug(1, "SQL query: %s\n", query);
1709
1710                 RES_CONFIG_SQLITE_BEGIN
1711                         error = sqlite_exec(db, query, NULL, NULL, &errormsg);
1712                 RES_CONFIG_SQLITE_END(error)
1713
1714                 sqlite_freemem(query);
1715
1716                 if (error) {
1717                         /*
1718                          * Unexpected error.
1719                          */
1720                         if (error != SQLITE_ERROR) {
1721                                 ast_log(LOG_ERROR, "%s\n", S_OR(errormsg, sqlite_error_string(error)));
1722                                 sqlite_freemem(errormsg);
1723                                 unload_module();
1724                                 return 1;
1725                         }
1726
1727                         sqlite_freemem(errormsg);
1728                         errormsg = NULL;
1729                         query = sqlite_mprintf(sql_create_cdr_table, cdr_table);
1730
1731                         if (!query) {
1732                                 ast_log(LOG_ERROR, "Unable to allocate SQL query\n");
1733                                 unload_module();
1734                                 return 1;
1735                         }
1736
1737                         ast_debug(1, "SQL query: %s\n", query);
1738
1739                         RES_CONFIG_SQLITE_BEGIN
1740                                 error = sqlite_exec(db, query, NULL, NULL, &errormsg);
1741                         RES_CONFIG_SQLITE_END(error)
1742
1743                         sqlite_freemem(query);
1744
1745                         if (error) {
1746                                 ast_log(LOG_ERROR, "%s\n", S_OR(errormsg, sqlite_error_string(error)));
1747                                 sqlite_freemem(errormsg);
1748                                 unload_module();
1749                                 return 1;
1750                         }
1751                 }
1752                 sqlite_freemem(errormsg);
1753                 errormsg = NULL;
1754
1755                 error = ast_cdr_register(RES_CONFIG_SQLITE_NAME, RES_CONFIG_SQLITE_DESCRIPTION, cdr_handler);
1756
1757                 if (error) {
1758                         unload_module();
1759                         return 1;
1760                 }
1761
1762                 cdr_registered = 1;
1763         }
1764
1765         error = ast_cli_register_multiple(cli_status, ARRAY_LEN(cli_status));
1766
1767         if (error) {
1768                 unload_module();
1769                 return 1;
1770         }
1771
1772         cli_status_registered = 1;
1773
1774         return 0;
1775 }
1776
1777 AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_LOAD_ORDER, "Realtime SQLite configuration",
1778         .support_level = AST_MODULE_SUPPORT_EXTENDED,
1779         .load = load_module,
1780         .unload = unload_module,
1781         .load_pri = AST_MODPRI_REALTIME_DRIVER,
1782 );