Merged revisions 332830 via svnmerge from
[asterisk/asterisk.git] / res / res_config_pgsql.c
1 /*
2  * Asterisk -- A telephony toolkit for Linux.
3  *
4  * Copyright (C) 1999-2010, Digium, Inc.
5  *
6  * Manuel Guesdon <mguesdon@oxymium.net> - PostgreSQL RealTime Driver Author/Adaptor
7  * Mark Spencer <markster@digium.com>  - Asterisk Author
8  * Matthew Boehm <mboehm@cytelcom.com> - MySQL RealTime Driver Author
9  *
10  * res_config_pgsql.c <PostgreSQL plugin for RealTime configuration engine>
11  *
12  * v1.0   - (07-11-05) - Initial version based on res_config_mysql v2.0
13  */
14
15 /*! \file
16  *
17  * \brief PostgreSQL plugin for Asterisk RealTime Architecture
18  *
19  * \author Mark Spencer <markster@digium.com>
20  * \author Manuel Guesdon <mguesdon@oxymium.net> - PostgreSQL RealTime Driver Author/Adaptor
21  *
22  * \extref PostgreSQL http://www.postgresql.org
23  */
24
25 /*** MODULEINFO
26         <depend>pgsql</depend>
27         <support_level>extended</support_level>
28  ***/
29
30 #include "asterisk.h"
31
32 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
33
34 #include <libpq-fe.h>                   /* PostgreSQL */
35
36 #include "asterisk/file.h"
37 #include "asterisk/channel.h"
38 #include "asterisk/pbx.h"
39 #include "asterisk/config.h"
40 #include "asterisk/module.h"
41 #include "asterisk/lock.h"
42 #include "asterisk/utils.h"
43 #include "asterisk/cli.h"
44
45 AST_MUTEX_DEFINE_STATIC(pgsql_lock);
46 AST_THREADSTORAGE(sql_buf);
47 AST_THREADSTORAGE(findtable_buf);
48 AST_THREADSTORAGE(where_buf);
49 AST_THREADSTORAGE(escapebuf_buf);
50 AST_THREADSTORAGE(semibuf_buf);
51
52 #define RES_CONFIG_PGSQL_CONF "res_pgsql.conf"
53
54 static PGconn *pgsqlConn = NULL;
55 static int version;
56 #define has_schema_support      (version > 70300 ? 1 : 0)
57
58 #define MAX_DB_OPTION_SIZE 64
59
60 struct columns {
61         char *name;
62         char *type;
63         int len;
64         unsigned int notnull:1;
65         unsigned int hasdefault:1;
66         AST_LIST_ENTRY(columns) list;
67 };
68
69 struct tables {
70         ast_rwlock_t lock;
71         AST_LIST_HEAD_NOLOCK(psql_columns, columns) columns;
72         AST_LIST_ENTRY(tables) list;
73         char name[0];
74 };
75
76 static AST_LIST_HEAD_STATIC(psql_tables, tables);
77
78 static char dbhost[MAX_DB_OPTION_SIZE] = "";
79 static char dbuser[MAX_DB_OPTION_SIZE] = "";
80 static char dbpass[MAX_DB_OPTION_SIZE] = "";
81 static char dbname[MAX_DB_OPTION_SIZE] = "";
82 static char dbsock[MAX_DB_OPTION_SIZE] = "";
83 static int dbport = 5432;
84 static time_t connect_time = 0;
85
86 static int parse_config(int reload);
87 static int pgsql_reconnect(const char *database);
88 static char *handle_cli_realtime_pgsql_status(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a);
89 static char *handle_cli_realtime_pgsql_cache(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a);
90
91 static enum { RQ_WARN, RQ_CREATECLOSE, RQ_CREATECHAR } requirements;
92
93 static struct ast_cli_entry cli_realtime[] = {
94         AST_CLI_DEFINE(handle_cli_realtime_pgsql_status, "Shows connection information for the PostgreSQL RealTime driver"),
95         AST_CLI_DEFINE(handle_cli_realtime_pgsql_cache, "Shows cached tables within the PostgreSQL realtime driver"),
96 };
97
98 #define ESCAPE_STRING(buffer, stringname) \
99         do { \
100                 int len = strlen(stringname); \
101                 struct ast_str *semi = ast_str_thread_get(&semibuf_buf, len * 3 + 1); \
102                 const char *chunk = stringname; \
103                 ast_str_reset(semi); \
104                 for (; *chunk; chunk++) { \
105                         if (strchr(";^", *chunk)) { \
106                                 ast_str_append(&semi, 0, "^%02hhX", *chunk); \
107                         } else { \
108                                 ast_str_append(&semi, 0, "%c", *chunk); \
109                         } \
110                 } \
111                 if (ast_str_strlen(semi) > (ast_str_size(buffer) - 1) / 2) { \
112                         ast_str_make_space(&buffer, ast_str_strlen(semi) * 2 + 1); \
113                 } \
114                 PQescapeStringConn(pgsqlConn, ast_str_buffer(buffer), ast_str_buffer(semi), ast_str_size(buffer), &pgresult); \
115         } while (0)
116
117 static void destroy_table(struct tables *table)
118 {
119         struct columns *column;
120         ast_rwlock_wrlock(&table->lock);
121         while ((column = AST_LIST_REMOVE_HEAD(&table->columns, list))) {
122                 ast_free(column);
123         }
124         ast_rwlock_unlock(&table->lock);
125         ast_rwlock_destroy(&table->lock);
126         ast_free(table);
127 }
128
129 /*! \brief Helper function for pgsql_exec.  For running querys, use pgsql_exec()
130  *
131  *  Connect if not currently connected.  Run the given query.
132  *
133  *  \param database   database name we are connected to (used for error logging)
134  *  \param tablename  table  name we are connected to (used for error logging)
135  *  \param sql        sql query string to execute
136  *  \param result     pointer for where to store the result handle
137  *
138  *  \return -1 on fatal query error
139  *  \return -2 on query failure that resulted in disconnection
140  *  \return 0 on success
141  *
142  *  \example see pgsql_exec for full example
143  */
144 static int _pgsql_exec(const char *database, const char *tablename, const char *sql, PGresult **result)
145 {
146         ExecStatusType result_status;
147
148         if (!pgsqlConn) {
149                 ast_debug(1, "PostgreSQL connection not defined, connecting\n");
150
151                 if (pgsql_reconnect(database) != 1) {
152                         ast_log(LOG_NOTICE, "reconnect failed\n");
153                         *result = NULL;
154                         return -1;
155                 }
156
157                 ast_debug(1, "PostgreSQL connection successful\n");
158         }
159
160         *result = PQexec(pgsqlConn, sql);
161         result_status = PQresultStatus(*result);
162         if (result_status != PGRES_COMMAND_OK
163                 && result_status != PGRES_TUPLES_OK
164                 && result_status != PGRES_NONFATAL_ERROR) {
165
166                 ast_log(LOG_ERROR, "PostgreSQL RealTime: Failed to query '%s@%s'.\n", tablename, database);
167                 ast_log(LOG_ERROR, "PostgreSQL RealTime: Query Failed: %s\n", sql);
168                 ast_log(LOG_ERROR, "PostgreSQL RealTime: Query Failed because: %s (%s)\n",
169                         PQresultErrorMessage(*result),
170                         PQresStatus(result_status));
171
172                 /* we may have tried to run a command on a disconnected/disconnecting handle */
173                 /* are we no longer connected to the database... if not try again */
174                 if (PQstatus(pgsqlConn) != CONNECTION_OK) {
175                         PQfinish(pgsqlConn);
176                         pgsqlConn = NULL;
177                         return -2;
178                 }
179
180                 /* connection still okay, which means the query is just plain bad */
181                 return -1;
182         }
183
184         ast_debug(1, "PostgreSQL query successful: %s\n", sql);
185         return 0;
186 }
187
188 /*! \brief Do a postgres query, with reconnection support
189  *
190  *  Connect if not currently connected.  Run the given query
191  *  and if we're disconnected afterwards, reconnect and query again.
192  *
193  *  \param database   database name we are connected to (used for error logging)
194  *  \param tablename  table  name we are connected to (used for error logging)
195  *  \param sql        sql query string to execute
196  *  \param result     pointer for where to store the result handle
197  *
198  *  \return -1 on query failure
199  *  \return 0 on success
200  *
201  *  \example
202  *      int i, rows;
203  *      PGresult *result;
204  *      char *field_name, *field_type, *field_len, *field_notnull, *field_default;
205  *
206  *      pgsql_exec("db", "table", "SELECT 1", &result)
207  *
208  *      rows = PQntuples(result);
209  *      for (i = 0; i < rows; i++) {
210  *              field_name    = PQgetvalue(result, i, 0);
211  *              field_type    = PQgetvalue(result, i, 1);
212  *              field_len     = PQgetvalue(result, i, 2);
213  *              field_notnull = PQgetvalue(result, i, 3);
214  *              field_default = PQgetvalue(result, i, 4);
215  *      }
216  *
217  */
218 static int pgsql_exec(const char *database, const char *tablename, const char *sql, PGresult **result)
219 {
220         int attempts = 0;
221         int res;
222
223         /* Try the query, note failure if any */
224         /* On first failure, reconnect and try again (_pgsql_exec handles reconnect) */
225         /* On second failure, treat as fatal query error */
226
227         while (attempts++ < 2) {
228                 ast_debug(1, "PostgreSQL query attempt %d\n", attempts);
229                 res = _pgsql_exec(database, tablename, sql, result);
230
231                 if (res == 0) {
232                         if (attempts > 1) {
233                                 ast_log(LOG_NOTICE, "PostgreSQL RealTime: Query finally succeeded: %s\n", sql);
234                         }
235
236                         return 0;
237                 }
238
239                 if (res == -1) {
240                         return -1; /* Still connected to db, but could not process query (fatal error) */
241                 }
242
243                 /* res == -2 (query on a disconnected handle) */
244                 ast_debug(1, "PostgreSQL query attempt %d failed, trying again\n", attempts);
245         }
246
247         return -1;
248 }
249
250 static struct tables *find_table(const char *database, const char *orig_tablename)
251 {
252         struct columns *column;
253         struct tables *table;
254         struct ast_str *sql = ast_str_thread_get(&findtable_buf, 330);
255         PGresult *result;
256         int exec_result;
257         char *fname, *ftype, *flen, *fnotnull, *fdef;
258         int i, rows;
259
260         AST_LIST_LOCK(&psql_tables);
261         AST_LIST_TRAVERSE(&psql_tables, table, list) {
262                 if (!strcasecmp(table->name, orig_tablename)) {
263                         ast_debug(1, "Found table in cache; now locking\n");
264                         ast_rwlock_rdlock(&table->lock);
265                         ast_debug(1, "Lock cached table; now returning\n");
266                         AST_LIST_UNLOCK(&psql_tables);
267                         return table;
268                 }
269         }
270
271         if (database == NULL) {
272                 return NULL;
273         }
274
275         ast_debug(1, "Table '%s' not found in cache, querying now\n", orig_tablename);
276
277         /* Not found, scan the table */
278         if (has_schema_support) {
279                 char *schemaname, *tablename;
280                 if (strchr(orig_tablename, '.')) {
281                         schemaname = ast_strdupa(orig_tablename);
282                         tablename = strchr(schemaname, '.');
283                         *tablename++ = '\0';
284                 } else {
285                         schemaname = "";
286                         tablename = ast_strdupa(orig_tablename);
287                 }
288
289                 /* Escape special characters in schemaname */
290                 if (strchr(schemaname, '\\') || strchr(schemaname, '\'')) {
291                         char *tmp = schemaname, *ptr;
292
293                         ptr = schemaname = alloca(strlen(tmp) * 2 + 1);
294                         for (; *tmp; tmp++) {
295                                 if (strchr("\\'", *tmp)) {
296                                         *ptr++ = *tmp;
297                                 }
298                                 *ptr++ = *tmp;
299                         }
300                         *ptr = '\0';
301                 }
302                 /* Escape special characters in tablename */
303                 if (strchr(tablename, '\\') || strchr(tablename, '\'')) {
304                         char *tmp = tablename, *ptr;
305
306                         ptr = tablename = alloca(strlen(tmp) * 2 + 1);
307                         for (; *tmp; tmp++) {
308                                 if (strchr("\\'", *tmp)) {
309                                         *ptr++ = *tmp;
310                                 }
311                                 *ptr++ = *tmp;
312                         }
313                         *ptr = '\0';
314                 }
315
316                 ast_str_set(&sql, 0, "SELECT a.attname, t.typname, a.attlen, a.attnotnull, d.adsrc, a.atttypmod FROM (((pg_catalog.pg_class c INNER JOIN pg_catalog.pg_namespace n ON n.oid = c.relnamespace AND c.relname = '%s' AND n.nspname = %s%s%s) INNER JOIN pg_catalog.pg_attribute a ON (NOT a.attisdropped) AND a.attnum > 0 AND a.attrelid = c.oid) INNER JOIN pg_catalog.pg_type t ON t.oid = a.atttypid) LEFT OUTER JOIN pg_attrdef d ON a.atthasdef AND d.adrelid = a.attrelid AND d.adnum = a.attnum ORDER BY n.nspname, c.relname, attnum",
317                         tablename,
318                         ast_strlen_zero(schemaname) ? "" : "'", ast_strlen_zero(schemaname) ? "current_schema()" : schemaname, ast_strlen_zero(schemaname) ? "" : "'");
319         } else {
320                 /* Escape special characters in tablename */
321                 if (strchr(orig_tablename, '\\') || strchr(orig_tablename, '\'')) {
322                         const char *tmp = orig_tablename;
323                         char *ptr;
324
325                         orig_tablename = ptr = alloca(strlen(tmp) * 2 + 1);
326                         for (; *tmp; tmp++) {
327                                 if (strchr("\\'", *tmp)) {
328                                         *ptr++ = *tmp;
329                                 }
330                                 *ptr++ = *tmp;
331                         }
332                         *ptr = '\0';
333                 }
334
335                 ast_str_set(&sql, 0, "SELECT a.attname, t.typname, a.attlen, a.attnotnull, d.adsrc, a.atttypmod FROM pg_class c, pg_type t, pg_attribute a LEFT OUTER JOIN pg_attrdef d ON a.atthasdef AND d.adrelid = a.attrelid AND d.adnum = a.attnum WHERE c.oid = a.attrelid AND a.atttypid = t.oid AND (a.attnum > 0) AND c.relname = '%s' ORDER BY c.relname, attnum", orig_tablename);
336         }
337
338         exec_result = pgsql_exec(database, orig_tablename, ast_str_buffer(sql), &result);
339         ast_debug(1, "Query of table structure complete.  Now retrieving results.\n");
340         if (exec_result != 0) {
341                 ast_log(LOG_ERROR, "Failed to query database columns for table %s\n", orig_tablename);
342                 PQclear(result);
343                 AST_LIST_UNLOCK(&psql_tables);
344                 return NULL;
345         }
346
347         if (!(table = ast_calloc(1, sizeof(*table) + strlen(orig_tablename) + 1))) {
348                 ast_log(LOG_ERROR, "Unable to allocate memory for new table structure\n");
349                 PQclear(result);
350                 AST_LIST_UNLOCK(&psql_tables);
351                 return NULL;
352         }
353         strcpy(table->name, orig_tablename); /* SAFE */
354         ast_rwlock_init(&table->lock);
355         AST_LIST_HEAD_INIT_NOLOCK(&table->columns);
356
357         rows = PQntuples(result);
358         for (i = 0; i < rows; i++) {
359                 fname = PQgetvalue(result, i, 0);
360                 ftype = PQgetvalue(result, i, 1);
361                 flen = PQgetvalue(result, i, 2);
362                 fnotnull = PQgetvalue(result, i, 3);
363                 fdef = PQgetvalue(result, i, 4);
364                 ast_verb(4, "Found column '%s' of type '%s'\n", fname, ftype);
365
366                 if (!(column = ast_calloc(1, sizeof(*column) + strlen(fname) + strlen(ftype) + 2))) {
367                         ast_log(LOG_ERROR, "Unable to allocate column element for %s, %s\n", orig_tablename, fname);
368                         PQclear(result);
369                         destroy_table(table);
370                         AST_LIST_UNLOCK(&psql_tables);
371                         return NULL;
372                 }
373
374                 if (strcmp(flen, "-1") == 0) {
375                         /* Some types, like chars, have the length stored in a different field */
376                         flen = PQgetvalue(result, i, 5);
377                         sscanf(flen, "%30d", &column->len);
378                         column->len -= 4;
379                 } else {
380                         sscanf(flen, "%30d", &column->len);
381                 }
382                 column->name = (char *)column + sizeof(*column);
383                 column->type = (char *)column + sizeof(*column) + strlen(fname) + 1;
384                 strcpy(column->name, fname);
385                 strcpy(column->type, ftype);
386                 if (*fnotnull == 't') {
387                         column->notnull = 1;
388                 } else {
389                         column->notnull = 0;
390                 }
391                 if (!ast_strlen_zero(fdef)) {
392                         column->hasdefault = 1;
393                 } else {
394                         column->hasdefault = 0;
395                 }
396                 AST_LIST_INSERT_TAIL(&table->columns, column, list);
397         }
398         PQclear(result);
399
400         AST_LIST_INSERT_TAIL(&psql_tables, table, list);
401         ast_rwlock_rdlock(&table->lock);
402         AST_LIST_UNLOCK(&psql_tables);
403         return table;
404 }
405
406 #define release_table(table) ast_rwlock_unlock(&(table)->lock);
407
408 static struct columns *find_column(struct tables *t, const char *colname)
409 {
410         struct columns *column;
411
412         /* Check that the column exists in the table */
413         AST_LIST_TRAVERSE(&t->columns, column, list) {
414                 if (strcmp(column->name, colname) == 0) {
415                         return column;
416                 }
417         }
418         return NULL;
419 }
420
421 static struct ast_variable *realtime_pgsql(const char *database, const char *tablename, va_list ap)
422 {
423         PGresult *result = NULL;
424         int num_rows = 0, pgresult;
425         struct ast_str *sql = ast_str_thread_get(&sql_buf, 100);
426         struct ast_str *escapebuf = ast_str_thread_get(&escapebuf_buf, 100);
427         char *stringp;
428         char *chunk;
429         char *op;
430         const char *newparam, *newval;
431         struct ast_variable *var = NULL, *prev = NULL;
432
433         if (!tablename) {
434                 ast_log(LOG_WARNING, "PostgreSQL RealTime: No table specified.\n");
435                 return NULL;
436         }
437
438         /* Get the first parameter and first value in our list of passed paramater/value pairs */
439         newparam = va_arg(ap, const char *);
440         newval = va_arg(ap, const char *);
441         if (!newparam || !newval) {
442                 ast_log(LOG_WARNING,
443                                 "PostgreSQL RealTime: Realtime retrieval requires at least 1 parameter and 1 value to search on.\n");
444                 if (pgsqlConn) {
445                         PQfinish(pgsqlConn);
446                         pgsqlConn = NULL;
447                 }
448                 return NULL;
449         }
450
451         /* Create the first part of the query using the first parameter/value pairs we just extracted
452            If there is only 1 set, then we have our query. Otherwise, loop thru the list and concat */
453         op = strchr(newparam, ' ') ? "" : " =";
454
455         ESCAPE_STRING(escapebuf, newval);
456         if (pgresult) {
457                 ast_log(LOG_ERROR, "PostgreSQL RealTime: detected invalid input: '%s'\n", newval);
458                 va_end(ap);
459                 return NULL;
460         }
461
462         ast_str_set(&sql, 0, "SELECT * FROM %s WHERE %s%s '%s'", tablename, newparam, op, ast_str_buffer(escapebuf));
463         while ((newparam = va_arg(ap, const char *))) {
464                 newval = va_arg(ap, const char *);
465                 if (!strchr(newparam, ' '))
466                         op = " =";
467                 else
468                         op = "";
469
470                 ESCAPE_STRING(escapebuf, newval);
471                 if (pgresult) {
472                         ast_log(LOG_ERROR, "PostgreSQL RealTime: detected invalid input: '%s'\n", newval);
473                         va_end(ap);
474                         return NULL;
475                 }
476
477                 ast_str_append(&sql, 0, " AND %s%s '%s'", newparam, op, ast_str_buffer(escapebuf));
478         }
479         va_end(ap);
480
481         /* We now have our complete statement; Lets connect to the server and execute it. */
482         ast_mutex_lock(&pgsql_lock);
483
484         if (pgsql_exec(database, tablename, ast_str_buffer(sql), &result) != 0) {
485                 PQclear(result);
486                 ast_mutex_unlock(&pgsql_lock);
487                 return NULL;
488         }
489
490         ast_debug(1, "PostgreSQL RealTime: Result=%p Query: %s\n", result, ast_str_buffer(sql));
491
492         if ((num_rows = PQntuples(result)) > 0) {
493                 int i = 0;
494                 int rowIndex = 0;
495                 int numFields = PQnfields(result);
496                 char **fieldnames = NULL;
497
498                 ast_debug(1, "PostgreSQL RealTime: Found %d rows.\n", num_rows);
499
500                 if (!(fieldnames = ast_calloc(1, numFields * sizeof(char *)))) {
501                         PQclear(result);
502                         ast_mutex_unlock(&pgsql_lock);
503                         return NULL;
504                 }
505                 for (i = 0; i < numFields; i++)
506                         fieldnames[i] = PQfname(result, i);
507                 for (rowIndex = 0; rowIndex < num_rows; rowIndex++) {
508                         for (i = 0; i < numFields; i++) {
509                                 stringp = PQgetvalue(result, rowIndex, i);
510                                 while (stringp) {
511                                         chunk = strsep(&stringp, ";");
512                                         if (chunk && !ast_strlen_zero(ast_realtime_decode_chunk(ast_strip(chunk)))) {
513                                                 if (prev) {
514                                                         prev->next = ast_variable_new(fieldnames[i], chunk, "");
515                                                         if (prev->next) {
516                                                                 prev = prev->next;
517                                                         }
518                                                 } else {
519                                                         prev = var = ast_variable_new(fieldnames[i], chunk, "");
520                                                 }
521                                         }
522                                 }
523                         }
524                 }
525                 ast_free(fieldnames);
526         } else {
527                 ast_debug(1, "Postgresql RealTime: Could not find any rows in table %s@%s.\n", tablename, database);
528         }
529
530         PQclear(result);
531         ast_mutex_unlock(&pgsql_lock);
532
533         return var;
534 }
535
536 static struct ast_config *realtime_multi_pgsql(const char *database, const char *table, va_list ap)
537 {
538         PGresult *result = NULL;
539         int num_rows = 0, pgresult;
540         struct ast_str *sql = ast_str_thread_get(&sql_buf, 100);
541         struct ast_str *escapebuf = ast_str_thread_get(&escapebuf_buf, 100);
542         const char *initfield = NULL;
543         char *stringp;
544         char *chunk;
545         char *op;
546         const char *newparam, *newval;
547         struct ast_variable *var = NULL;
548         struct ast_config *cfg = NULL;
549         struct ast_category *cat = NULL;
550
551         if (!table) {
552                 ast_log(LOG_WARNING, "PostgreSQL RealTime: No table specified.\n");
553                 return NULL;
554         }
555
556         if (!(cfg = ast_config_new()))
557                 return NULL;
558
559         /* Get the first parameter and first value in our list of passed paramater/value pairs */
560         newparam = va_arg(ap, const char *);
561         newval = va_arg(ap, const char *);
562         if (!newparam || !newval) {
563                 ast_log(LOG_WARNING,
564                                 "PostgreSQL RealTime: Realtime retrieval requires at least 1 parameter and 1 value to search on.\n");
565                 if (pgsqlConn) {
566                         PQfinish(pgsqlConn);
567                         pgsqlConn = NULL;
568                 }
569                 ast_config_destroy(cfg);
570                 return NULL;
571         }
572
573         initfield = ast_strdupa(newparam);
574         if ((op = strchr(initfield, ' '))) {
575                 *op = '\0';
576         }
577
578         /* Create the first part of the query using the first parameter/value pairs we just extracted
579            If there is only 1 set, then we have our query. Otherwise, loop thru the list and concat */
580
581         if (!strchr(newparam, ' '))
582                 op = " =";
583         else
584                 op = "";
585
586         ESCAPE_STRING(escapebuf, newval);
587         if (pgresult) {
588                 ast_log(LOG_ERROR, "PostgreSQL RealTime: detected invalid input: '%s'\n", newval);
589                 va_end(ap);
590                 ast_config_destroy(cfg);
591                 return NULL;
592         }
593
594         ast_str_set(&sql, 0, "SELECT * FROM %s WHERE %s%s '%s'", table, newparam, op, ast_str_buffer(escapebuf));
595         while ((newparam = va_arg(ap, const char *))) {
596                 newval = va_arg(ap, const char *);
597                 if (!strchr(newparam, ' '))
598                         op = " =";
599                 else
600                         op = "";
601
602                 ESCAPE_STRING(escapebuf, newval);
603                 if (pgresult) {
604                         ast_log(LOG_ERROR, "PostgreSQL RealTime: detected invalid input: '%s'\n", newval);
605                         va_end(ap);
606                         ast_config_destroy(cfg);
607                         return NULL;
608                 }
609
610                 ast_str_append(&sql, 0, " AND %s%s '%s'", newparam, op, ast_str_buffer(escapebuf));
611         }
612
613         if (initfield) {
614                 ast_str_append(&sql, 0, " ORDER BY %s", initfield);
615         }
616
617         va_end(ap);
618
619         /* We now have our complete statement; Lets connect to the server and execute it. */
620         ast_mutex_lock(&pgsql_lock);
621
622         if (pgsql_exec(database, table, ast_str_buffer(sql), &result) != 0) {
623                 ast_mutex_unlock(&pgsql_lock);
624                 ast_config_destroy(cfg);
625                 return NULL;
626         } else {
627                 ExecStatusType result_status = PQresultStatus(result);
628                 if (result_status != PGRES_COMMAND_OK
629                         && result_status != PGRES_TUPLES_OK
630                         && result_status != PGRES_NONFATAL_ERROR) {
631                         ast_log(LOG_WARNING,
632                                         "PostgreSQL RealTime: Failed to query %s@%s. Check debug for more info.\n", table, database);
633                         ast_debug(1, "PostgreSQL RealTime: Query: %s\n", ast_str_buffer(sql));
634                         ast_debug(1, "PostgreSQL RealTime: Query Failed because: %s (%s)\n",
635                                                 PQresultErrorMessage(result), PQresStatus(result_status));
636                         PQclear(result);
637                         ast_mutex_unlock(&pgsql_lock);
638                         ast_config_destroy(cfg);
639                         return NULL;
640                 }
641         }
642
643         ast_debug(1, "PostgreSQL RealTime: Result=%p Query: %s\n", result, ast_str_buffer(sql));
644
645         if ((num_rows = PQntuples(result)) > 0) {
646                 int numFields = PQnfields(result);
647                 int i = 0;
648                 int rowIndex = 0;
649                 char **fieldnames = NULL;
650
651                 ast_debug(1, "PostgreSQL RealTime: Found %d rows.\n", num_rows);
652
653                 if (!(fieldnames = ast_calloc(1, numFields * sizeof(char *)))) {
654                         PQclear(result);
655                         ast_mutex_unlock(&pgsql_lock);
656                         ast_config_destroy(cfg);
657                         return NULL;
658                 }
659                 for (i = 0; i < numFields; i++)
660                         fieldnames[i] = PQfname(result, i);
661
662                 for (rowIndex = 0; rowIndex < num_rows; rowIndex++) {
663                         var = NULL;
664                         if (!(cat = ast_category_new("","",99999)))
665                                 continue;
666                         for (i = 0; i < numFields; i++) {
667                                 stringp = PQgetvalue(result, rowIndex, i);
668                                 while (stringp) {
669                                         chunk = strsep(&stringp, ";");
670                                         if (chunk && !ast_strlen_zero(ast_realtime_decode_chunk(ast_strip(chunk)))) {
671                                                 if (initfield && !strcmp(initfield, fieldnames[i])) {
672                                                         ast_category_rename(cat, chunk);
673                                                 }
674                                                 var = ast_variable_new(fieldnames[i], chunk, "");
675                                                 ast_variable_append(cat, var);
676                                         }
677                                 }
678                         }
679                         ast_category_append(cfg, cat);
680                 }
681                 ast_free(fieldnames);
682         } else {
683                 ast_debug(1, "PostgreSQL RealTime: Could not find any rows in table %s.\n", table);
684         }
685
686         PQclear(result);
687         ast_mutex_unlock(&pgsql_lock);
688
689         return cfg;
690 }
691
692 static int update_pgsql(const char *database, const char *tablename, const char *keyfield,
693                                                 const char *lookup, va_list ap)
694 {
695         PGresult *result = NULL;
696         int numrows = 0, pgresult;
697         const char *newparam, *newval;
698         struct ast_str *sql = ast_str_thread_get(&sql_buf, 100);
699         struct ast_str *escapebuf = ast_str_thread_get(&escapebuf_buf, 100);
700         struct tables *table;
701         struct columns *column = NULL;
702
703         if (!tablename) {
704                 ast_log(LOG_WARNING, "PostgreSQL RealTime: No table specified.\n");
705                 return -1;
706         }
707
708         if (!(table = find_table(database, tablename))) {
709                 ast_log(LOG_ERROR, "Table '%s' does not exist!!\n", tablename);
710                 return -1;
711         }
712
713         /* Get the first parameter and first value in our list of passed paramater/value pairs */
714         newparam = va_arg(ap, const char *);
715         newval = va_arg(ap, const char *);
716         if (!newparam || !newval) {
717                 ast_log(LOG_WARNING,
718                                 "PostgreSQL RealTime: Realtime retrieval requires at least 1 parameter and 1 value to search on.\n");
719                 if (pgsqlConn) {
720                         PQfinish(pgsqlConn);
721                         pgsqlConn = NULL;
722                 }
723                 release_table(table);
724                 return -1;
725         }
726
727         /* Check that the column exists in the table */
728         AST_LIST_TRAVERSE(&table->columns, column, list) {
729                 if (strcmp(column->name, newparam) == 0) {
730                         break;
731                 }
732         }
733
734         if (!column) {
735                 ast_log(LOG_ERROR, "PostgreSQL RealTime: Updating on column '%s', but that column does not exist within the table '%s'!\n", newparam, tablename);
736                 release_table(table);
737                 return -1;
738         }
739
740         /* Create the first part of the query using the first parameter/value pairs we just extracted
741            If there is only 1 set, then we have our query. Otherwise, loop thru the list and concat */
742
743         ESCAPE_STRING(escapebuf, newval);
744         if (pgresult) {
745                 ast_log(LOG_ERROR, "PostgreSQL RealTime: detected invalid input: '%s'\n", newval);
746                 va_end(ap);
747                 release_table(table);
748                 return -1;
749         }
750         ast_str_set(&sql, 0, "UPDATE %s SET %s = '%s'", tablename, newparam, ast_str_buffer(escapebuf));
751
752         while ((newparam = va_arg(ap, const char *))) {
753                 newval = va_arg(ap, const char *);
754
755                 if (!find_column(table, newparam)) {
756                         ast_log(LOG_NOTICE, "Attempted to update column '%s' in table '%s', but column does not exist!\n", newparam, tablename);
757                         continue;
758                 }
759
760                 ESCAPE_STRING(escapebuf, newval);
761                 if (pgresult) {
762                         ast_log(LOG_ERROR, "PostgreSQL RealTime: detected invalid input: '%s'\n", newval);
763                         va_end(ap);
764                         release_table(table);
765                         return -1;
766                 }
767
768                 ast_str_append(&sql, 0, ", %s = '%s'", newparam, ast_str_buffer(escapebuf));
769         }
770         va_end(ap);
771         release_table(table);
772
773         ESCAPE_STRING(escapebuf, lookup);
774         if (pgresult) {
775                 ast_log(LOG_ERROR, "PostgreSQL RealTime: detected invalid input: '%s'\n", lookup);
776                 va_end(ap);
777                 return -1;
778         }
779
780         ast_str_append(&sql, 0, " WHERE %s = '%s'", keyfield, ast_str_buffer(escapebuf));
781
782         ast_debug(1, "PostgreSQL RealTime: Update SQL: %s\n", ast_str_buffer(sql));
783
784         /* We now have our complete statement; Lets connect to the server and execute it. */
785         ast_mutex_lock(&pgsql_lock);
786
787         if (pgsql_exec(database, tablename, ast_str_buffer(sql), &result) != 0) {
788                 ast_mutex_unlock(&pgsql_lock);
789                 return -1;
790         } else {
791                 ExecStatusType result_status = PQresultStatus(result);
792                 if (result_status != PGRES_COMMAND_OK
793                         && result_status != PGRES_TUPLES_OK
794                         && result_status != PGRES_NONFATAL_ERROR) {
795                         ast_log(LOG_WARNING,
796                                         "PostgreSQL RealTime: Failed to query database. Check debug for more info.\n");
797                         ast_debug(1, "PostgreSQL RealTime: Query: %s\n", ast_str_buffer(sql));
798                         ast_debug(1, "PostgreSQL RealTime: Query Failed because: %s (%s)\n",
799                                                 PQresultErrorMessage(result), PQresStatus(result_status));
800                         PQclear(result);
801                         ast_mutex_unlock(&pgsql_lock);
802                         return -1;
803                 }
804         }
805
806         numrows = atoi(PQcmdTuples(result));
807         ast_mutex_unlock(&pgsql_lock);
808
809         ast_debug(1, "PostgreSQL RealTime: Updated %d rows on table: %s\n", numrows, tablename);
810
811         /* From http://dev.pgsql.com/doc/pgsql/en/pgsql-affected-rows.html
812          * An integer greater than zero indicates the number of rows affected
813          * Zero indicates that no records were updated
814          * -1 indicates that the query returned an error (although, if the query failed, it should have been caught above.)
815          */
816
817         if (numrows >= 0)
818                 return (int) numrows;
819
820         return -1;
821 }
822
823 static int update2_pgsql(const char *database, const char *tablename, va_list ap)
824 {
825         PGresult *result = NULL;
826         int numrows = 0, pgresult, first = 1;
827         struct ast_str *escapebuf = ast_str_thread_get(&escapebuf_buf, 16);
828         const char *newparam, *newval;
829         struct ast_str *sql = ast_str_thread_get(&sql_buf, 100);
830         struct ast_str *where = ast_str_thread_get(&where_buf, 100);
831         struct tables *table;
832
833         if (!tablename) {
834                 ast_log(LOG_WARNING, "PostgreSQL RealTime: No table specified.\n");
835                 return -1;
836         }
837
838         if (!escapebuf || !sql || !where) {
839                 /* Memory error, already handled */
840                 return -1;
841         }
842
843         if (!(table = find_table(database, tablename))) {
844                 ast_log(LOG_ERROR, "Table '%s' does not exist!!\n", tablename);
845                 return -1;
846         }
847
848         ast_str_set(&sql, 0, "UPDATE %s SET ", tablename);
849         ast_str_set(&where, 0, "WHERE");
850
851         while ((newparam = va_arg(ap, const char *))) {
852                 if (!find_column(table, newparam)) {
853                         ast_log(LOG_ERROR, "Attempted to update based on criteria column '%s' (%s@%s), but that column does not exist!\n", newparam, tablename, database);
854                         release_table(table);
855                         return -1;
856                 }
857
858                 newval = va_arg(ap, const char *);
859                 ESCAPE_STRING(escapebuf, newval);
860                 if (pgresult) {
861                         ast_log(LOG_ERROR, "PostgreSQL RealTime: detected invalid input: '%s'\n", newval);
862                         release_table(table);
863                         ast_free(sql);
864                         return -1;
865                 }
866                 ast_str_append(&where, 0, "%s %s='%s'", first ? "" : " AND", newparam, ast_str_buffer(escapebuf));
867                 first = 0;
868         }
869
870         if (first) {
871                 ast_log(LOG_WARNING,
872                                 "PostgreSQL RealTime: Realtime update requires at least 1 parameter and 1 value to search on.\n");
873                 if (pgsqlConn) {
874                         PQfinish(pgsqlConn);
875                         pgsqlConn = NULL;
876                 }
877                 release_table(table);
878                 return -1;
879         }
880
881         /* Now retrieve the columns to update */
882         first = 1;
883         while ((newparam = va_arg(ap, const char *))) {
884                 newval = va_arg(ap, const char *);
885
886                 /* If the column is not within the table, then skip it */
887                 if (!find_column(table, newparam)) {
888                         ast_log(LOG_NOTICE, "Attempted to update column '%s' in table '%s@%s', but column does not exist!\n", newparam, tablename, database);
889                         continue;
890                 }
891
892                 ESCAPE_STRING(escapebuf, newval);
893                 if (pgresult) {
894                         ast_log(LOG_ERROR, "PostgreSQL RealTime: detected invalid input: '%s'\n", newval);
895                         release_table(table);
896                         ast_free(sql);
897                         return -1;
898                 }
899
900                 ast_str_append(&sql, 0, "%s %s='%s'", first ? "" : ",", newparam, ast_str_buffer(escapebuf));
901         }
902         release_table(table);
903
904         ast_str_append(&sql, 0, " %s", ast_str_buffer(where));
905
906         ast_debug(1, "PostgreSQL RealTime: Update SQL: %s\n", ast_str_buffer(sql));
907
908         /* We now have our complete statement; connect to the server and execute it. */
909         if (pgsql_exec(database, tablename, ast_str_buffer(sql), &result) != 0) {
910                 ast_mutex_unlock(&pgsql_lock);
911                 return -1;
912         }
913
914         numrows = atoi(PQcmdTuples(result));
915         ast_mutex_unlock(&pgsql_lock);
916
917         ast_debug(1, "PostgreSQL RealTime: Updated %d rows on table: %s\n", numrows, tablename);
918
919         /* From http://dev.pgsql.com/doc/pgsql/en/pgsql-affected-rows.html
920          * An integer greater than zero indicates the number of rows affected
921          * Zero indicates that no records were updated
922          * -1 indicates that the query returned an error (although, if the query failed, it should have been caught above.)
923          */
924
925         if (numrows >= 0) {
926                 return (int) numrows;
927         }
928
929         return -1;
930 }
931
932 static int store_pgsql(const char *database, const char *table, va_list ap)
933 {
934         PGresult *result = NULL;
935         Oid insertid;
936         struct ast_str *buf = ast_str_thread_get(&escapebuf_buf, 256);
937         struct ast_str *sql1 = ast_str_thread_get(&sql_buf, 256);
938         struct ast_str *sql2 = ast_str_thread_get(&where_buf, 256);
939         int pgresult;
940         const char *newparam, *newval;
941
942         if (!table) {
943                 ast_log(LOG_WARNING, "PostgreSQL RealTime: No table specified.\n");
944                 return -1;
945         }
946
947         /* Get the first parameter and first value in our list of passed paramater/value pairs */
948         newparam = va_arg(ap, const char *);
949         newval = va_arg(ap, const char *);
950         if (!newparam || !newval) {
951                 ast_log(LOG_WARNING,
952                                 "PostgreSQL RealTime: Realtime storage requires at least 1 parameter and 1 value to store.\n");
953                 if (pgsqlConn) {
954                         PQfinish(pgsqlConn);
955                         pgsqlConn = NULL;
956                 }
957                 return -1;
958         }
959
960         /* Must connect to the server before anything else, as the escape function requires the connection handle.. */
961         ast_mutex_lock(&pgsql_lock);
962         if (!pgsql_reconnect(database)) {
963                 ast_mutex_unlock(&pgsql_lock);
964                 return -1;
965         }
966
967         /* Create the first part of the query using the first parameter/value pairs we just extracted
968            If there is only 1 set, then we have our query. Otherwise, loop thru the list and concat */
969         ESCAPE_STRING(buf, newparam);
970         ast_str_set(&sql1, 0, "INSERT INTO %s (%s", table, ast_str_buffer(buf));
971         ESCAPE_STRING(buf, newval);
972         ast_str_set(&sql2, 0, ") VALUES ('%s'", ast_str_buffer(buf));
973         while ((newparam = va_arg(ap, const char *))) {
974                 newval = va_arg(ap, const char *);
975                 ESCAPE_STRING(buf, newparam);
976                 ast_str_append(&sql1, 0, ", %s", ast_str_buffer(buf));
977                 ESCAPE_STRING(buf, newval);
978                 ast_str_append(&sql2, 0, ", '%s'", ast_str_buffer(buf));
979         }
980         va_end(ap);
981         ast_str_append(&sql1, 0, "%s)", ast_str_buffer(sql2));
982
983         ast_debug(1, "PostgreSQL RealTime: Insert SQL: %s\n", ast_str_buffer(sql1));
984
985         if (pgsql_exec(database, table, ast_str_buffer(sql1), &result) != 0) {
986                 ast_mutex_unlock(&pgsql_lock);
987                 return -1;
988         }
989
990         insertid = PQoidValue(result);
991         PQclear(result);
992         ast_mutex_unlock(&pgsql_lock);
993
994         ast_debug(1, "PostgreSQL RealTime: row inserted on table: %s, id: %u\n", table, insertid);
995
996         /* From http://dev.pgsql.com/doc/pgsql/en/pgsql-affected-rows.html
997          * An integer greater than zero indicates the number of rows affected
998          * Zero indicates that no records were updated
999          * -1 indicates that the query returned an error (although, if the query failed, it should have been caught above.)
1000          */
1001
1002         if (insertid >= 0)
1003                 return (int) insertid;
1004
1005         return -1;
1006 }
1007
1008 static int destroy_pgsql(const char *database, const char *table, const char *keyfield, const char *lookup, va_list ap)
1009 {
1010         PGresult *result = NULL;
1011         int numrows = 0;
1012         int pgresult;
1013         struct ast_str *sql = ast_str_thread_get(&sql_buf, 256);
1014         struct ast_str *buf1 = ast_str_thread_get(&where_buf, 60), *buf2 = ast_str_thread_get(&escapebuf_buf, 60);
1015         const char *newparam, *newval;
1016
1017         if (!table) {
1018                 ast_log(LOG_WARNING, "PostgreSQL RealTime: No table specified.\n");
1019                 return -1;
1020         }
1021
1022         /* Get the first parameter and first value in our list of passed paramater/value pairs */
1023         /*newparam = va_arg(ap, const char *);
1024         newval = va_arg(ap, const char *);
1025         if (!newparam || !newval) {*/
1026         if (ast_strlen_zero(keyfield) || ast_strlen_zero(lookup))  {
1027                 ast_log(LOG_WARNING,
1028                                 "PostgreSQL RealTime: Realtime destroy requires at least 1 parameter and 1 value to search on.\n");
1029                 if (pgsqlConn) {
1030                         PQfinish(pgsqlConn);
1031                         pgsqlConn = NULL;
1032                 };
1033                 return -1;
1034         }
1035
1036         /* Must connect to the server before anything else, as the escape function requires the connection handle.. */
1037         ast_mutex_lock(&pgsql_lock);
1038         if (!pgsql_reconnect(database)) {
1039                 ast_mutex_unlock(&pgsql_lock);
1040                 return -1;
1041         }
1042
1043
1044         /* Create the first part of the query using the first parameter/value pairs we just extracted
1045            If there is only 1 set, then we have our query. Otherwise, loop thru the list and concat */
1046
1047         ESCAPE_STRING(buf1, keyfield);
1048         ESCAPE_STRING(buf2, lookup);
1049         ast_str_set(&sql, 0, "DELETE FROM %s WHERE %s = '%s'", table, ast_str_buffer(buf1), ast_str_buffer(buf2));
1050         while ((newparam = va_arg(ap, const char *))) {
1051                 newval = va_arg(ap, const char *);
1052                 ESCAPE_STRING(buf1, newparam);
1053                 ESCAPE_STRING(buf2, newval);
1054                 ast_str_append(&sql, 0, " AND %s = '%s'", ast_str_buffer(buf1), ast_str_buffer(buf2));
1055         }
1056         va_end(ap);
1057
1058         ast_debug(1, "PostgreSQL RealTime: Delete SQL: %s\n", ast_str_buffer(sql));
1059
1060         if (pgsql_exec(database, table, ast_str_buffer(sql), &result) != 0) {
1061                 ast_mutex_unlock(&pgsql_lock);
1062                 return -1;
1063         }
1064
1065         numrows = atoi(PQcmdTuples(result));
1066         ast_mutex_unlock(&pgsql_lock);
1067
1068         ast_debug(1, "PostgreSQL RealTime: Deleted %d rows on table: %s\n", numrows, table);
1069
1070         /* From http://dev.pgsql.com/doc/pgsql/en/pgsql-affected-rows.html
1071          * An integer greater than zero indicates the number of rows affected
1072          * Zero indicates that no records were updated
1073          * -1 indicates that the query returned an error (although, if the query failed, it should have been caught above.)
1074          */
1075
1076         if (numrows >= 0)
1077                 return (int) numrows;
1078
1079         return -1;
1080 }
1081
1082
1083 static struct ast_config *config_pgsql(const char *database, const char *table,
1084                                                                            const char *file, struct ast_config *cfg,
1085                                                                            struct ast_flags flags, const char *suggested_incl, const char *who_asked)
1086 {
1087         PGresult *result = NULL;
1088         long num_rows;
1089         struct ast_variable *new_v;
1090         struct ast_category *cur_cat = NULL;
1091         struct ast_str *sql = ast_str_thread_get(&sql_buf, 100);
1092         char last[80] = "";
1093         int last_cat_metric = 0;
1094
1095         last[0] = '\0';
1096
1097         if (!file || !strcmp(file, RES_CONFIG_PGSQL_CONF)) {
1098                 ast_log(LOG_WARNING, "PostgreSQL RealTime: Cannot configure myself.\n");
1099                 return NULL;
1100         }
1101
1102         ast_str_set(&sql, 0, "SELECT category, var_name, var_val, cat_metric FROM %s "
1103                         "WHERE filename='%s' and commented=0 "
1104                         "ORDER BY cat_metric DESC, var_metric ASC, category, var_name ", table, file);
1105
1106         ast_debug(1, "PostgreSQL RealTime: Static SQL: %s\n", ast_str_buffer(sql));
1107
1108         ast_mutex_lock(&pgsql_lock);
1109
1110         /* We now have our complete statement; Lets connect to the server and execute it. */
1111         if (pgsql_exec(database, table, ast_str_buffer(sql), &result) != 0) {
1112                 ast_mutex_unlock(&pgsql_lock);
1113                 return NULL;
1114         }
1115
1116         if ((num_rows = PQntuples(result)) > 0) {
1117                 int rowIndex = 0;
1118
1119                 ast_debug(1, "PostgreSQL RealTime: Found %ld rows.\n", num_rows);
1120
1121                 for (rowIndex = 0; rowIndex < num_rows; rowIndex++) {
1122                         char *field_category = PQgetvalue(result, rowIndex, 0);
1123                         char *field_var_name = PQgetvalue(result, rowIndex, 1);
1124                         char *field_var_val = PQgetvalue(result, rowIndex, 2);
1125                         char *field_cat_metric = PQgetvalue(result, rowIndex, 3);
1126                         if (!strcmp(field_var_name, "#include")) {
1127                                 if (!ast_config_internal_load(field_var_val, cfg, flags, "", who_asked)) {
1128                                         PQclear(result);
1129                                         ast_mutex_unlock(&pgsql_lock);
1130                                         return NULL;
1131                                 }
1132                                 continue;
1133                         }
1134
1135                         if (strcmp(last, field_category) || last_cat_metric != atoi(field_cat_metric)) {
1136                                 cur_cat = ast_category_new(field_category, "", 99999);
1137                                 if (!cur_cat)
1138                                         break;
1139                                 strcpy(last, field_category);
1140                                 last_cat_metric = atoi(field_cat_metric);
1141                                 ast_category_append(cfg, cur_cat);
1142                         }
1143                         new_v = ast_variable_new(field_var_name, field_var_val, "");
1144                         ast_variable_append(cur_cat, new_v);
1145                 }
1146         } else {
1147                 ast_log(LOG_WARNING,
1148                                 "PostgreSQL RealTime: Could not find config '%s' in database.\n", file);
1149         }
1150
1151         PQclear(result);
1152         ast_mutex_unlock(&pgsql_lock);
1153
1154         return cfg;
1155 }
1156
1157 static int require_pgsql(const char *database, const char *tablename, va_list ap)
1158 {
1159         struct columns *column;
1160         struct tables *table = find_table(database, tablename);
1161         char *elm;
1162         int type, size, res = 0;
1163
1164         if (!table) {
1165                 ast_log(LOG_WARNING, "Table %s not found in database.  This table should exist if you're using realtime.\n", tablename);
1166                 return -1;
1167         }
1168
1169         while ((elm = va_arg(ap, char *))) {
1170                 type = va_arg(ap, require_type);
1171                 size = va_arg(ap, int);
1172                 AST_LIST_TRAVERSE(&table->columns, column, list) {
1173                         if (strcmp(column->name, elm) == 0) {
1174                                 /* Char can hold anything, as long as it is large enough */
1175                                 if ((strncmp(column->type, "char", 4) == 0 || strncmp(column->type, "varchar", 7) == 0 || strcmp(column->type, "bpchar") == 0)) {
1176                                         if ((size > column->len) && column->len != -1) {
1177                                                 ast_log(LOG_WARNING, "Column '%s' should be at least %d long, but is only %d long.\n", column->name, size, column->len);
1178                                                 res = -1;
1179                                         }
1180                                 } else if (strncmp(column->type, "int", 3) == 0) {
1181                                         int typesize = atoi(column->type + 3);
1182                                         /* Integers can hold only other integers */
1183                                         if ((type == RQ_INTEGER8 || type == RQ_UINTEGER8 ||
1184                                                 type == RQ_INTEGER4 || type == RQ_UINTEGER4 ||
1185                                                 type == RQ_INTEGER3 || type == RQ_UINTEGER3 ||
1186                                                 type == RQ_UINTEGER2) && typesize == 2) {
1187                                                 ast_log(LOG_WARNING, "Column '%s' may not be large enough for the required data length: %d\n", column->name, size);
1188                                                 res = -1;
1189                                         } else if ((type == RQ_INTEGER8 || type == RQ_UINTEGER8 ||
1190                                                 type == RQ_UINTEGER4) && typesize == 4) {
1191                                                 ast_log(LOG_WARNING, "Column '%s' may not be large enough for the required data length: %d\n", column->name, size);
1192                                                 res = -1;
1193                                         } else if (type == RQ_CHAR || type == RQ_DATETIME || type == RQ_FLOAT || type == RQ_DATE) {
1194                                                 ast_log(LOG_WARNING, "Column '%s' is of the incorrect type: (need %s(%d) but saw %s)\n",
1195                                                         column->name,
1196                                                                 type == RQ_CHAR ? "char" :
1197                                                                 type == RQ_DATETIME ? "datetime" :
1198                                                                 type == RQ_DATE ? "date" :
1199                                                                 type == RQ_FLOAT ? "float" :
1200                                                                 "a rather stiff drink ",
1201                                                         size, column->type);
1202                                                 res = -1;
1203                                         }
1204                                 } else if (strncmp(column->type, "float", 5) == 0) {
1205                                         if (!ast_rq_is_int(type) && type != RQ_FLOAT) {
1206                                                 ast_log(LOG_WARNING, "Column %s cannot be a %s\n", column->name, column->type);
1207                                                 res = -1;
1208                                         }
1209                                 } else if (strncmp(column->type, "timestamp", 9) == 0) {
1210                                         if (type != RQ_DATETIME && type != RQ_DATE) {
1211                                                 ast_log(LOG_WARNING, "Column %s cannot be a %s\n", column->name, column->type);
1212                                                 res = -1;
1213                                         }
1214                                 } else { /* There are other types that no module implements yet */
1215                                         ast_log(LOG_WARNING, "Possibly unsupported column type '%s' on column '%s'\n", column->type, column->name);
1216                                         res = -1;
1217                                 }
1218                                 break;
1219                         }
1220                 }
1221
1222                 if (!column) {
1223                         if (requirements == RQ_WARN) {
1224                                 ast_log(LOG_WARNING, "Table %s requires a column '%s' of size '%d', but no such column exists.\n", tablename, elm, size);
1225                         } else {
1226                                 struct ast_str *sql = ast_str_create(100);
1227                                 char fieldtype[15];
1228                                 PGresult *result;
1229
1230                                 if (requirements == RQ_CREATECHAR || type == RQ_CHAR) {
1231                                         /* Size is minimum length; make it at least 50% greater,
1232                                          * just to be sure, because PostgreSQL doesn't support
1233                                          * resizing columns. */
1234                                         snprintf(fieldtype, sizeof(fieldtype), "CHAR(%d)",
1235                                                 size < 15 ? size * 2 :
1236                                                 (size * 3 / 2 > 255) ? 255 : size * 3 / 2);
1237                                 } else if (type == RQ_INTEGER1 || type == RQ_UINTEGER1 || type == RQ_INTEGER2) {
1238                                         snprintf(fieldtype, sizeof(fieldtype), "INT2");
1239                                 } else if (type == RQ_UINTEGER2 || type == RQ_INTEGER3 || type == RQ_UINTEGER3 || type == RQ_INTEGER4) {
1240                                         snprintf(fieldtype, sizeof(fieldtype), "INT4");
1241                                 } else if (type == RQ_UINTEGER4 || type == RQ_INTEGER8) {
1242                                         snprintf(fieldtype, sizeof(fieldtype), "INT8");
1243                                 } else if (type == RQ_UINTEGER8) {
1244                                         /* No such type on PostgreSQL */
1245                                         snprintf(fieldtype, sizeof(fieldtype), "CHAR(20)");
1246                                 } else if (type == RQ_FLOAT) {
1247                                         snprintf(fieldtype, sizeof(fieldtype), "FLOAT8");
1248                                 } else if (type == RQ_DATE) {
1249                                         snprintf(fieldtype, sizeof(fieldtype), "DATE");
1250                                 } else if (type == RQ_DATETIME) {
1251                                         snprintf(fieldtype, sizeof(fieldtype), "TIMESTAMP");
1252                                 } else {
1253                                         ast_log(LOG_ERROR, "Unrecognized request type %d\n", type);
1254                                         ast_free(sql);
1255                                         continue;
1256                                 }
1257                                 ast_str_set(&sql, 0, "ALTER TABLE %s ADD COLUMN %s %s", tablename, elm, fieldtype);
1258                                 ast_debug(1, "About to lock pgsql_lock (running alter on table '%s' to add column '%s')\n", tablename, elm);
1259
1260                                 ast_mutex_lock(&pgsql_lock);
1261                                 ast_debug(1, "About to run ALTER query on table '%s' to add column '%s'\n", tablename, elm);
1262
1263                                 if (pgsql_exec(database, tablename, ast_str_buffer(sql), &result) != 0) {
1264                                         ast_mutex_unlock(&pgsql_lock);
1265                                         return -1;
1266                                 }
1267
1268                                 ast_debug(1, "Finished running ALTER query on table '%s'\n", tablename);
1269                                 if (PQresultStatus(result) != PGRES_COMMAND_OK) {
1270                                         ast_log(LOG_ERROR, "Unable to add column: %s\n", ast_str_buffer(sql));
1271                                 }
1272                                 PQclear(result);
1273                                 ast_mutex_unlock(&pgsql_lock);
1274
1275                                 ast_free(sql);
1276                         }
1277                 }
1278         }
1279         release_table(table);
1280         return res;
1281 }
1282
1283 static int unload_pgsql(const char *database, const char *tablename)
1284 {
1285         struct tables *cur;
1286         ast_debug(2, "About to lock table cache list\n");
1287         AST_LIST_LOCK(&psql_tables);
1288         ast_debug(2, "About to traverse table cache list\n");
1289         AST_LIST_TRAVERSE_SAFE_BEGIN(&psql_tables, cur, list) {
1290                 if (strcmp(cur->name, tablename) == 0) {
1291                         ast_debug(2, "About to remove matching cache entry\n");
1292                         AST_LIST_REMOVE_CURRENT(list);
1293                         ast_debug(2, "About to destroy matching cache entry\n");
1294                         destroy_table(cur);
1295                         ast_debug(1, "Cache entry '%s@%s' destroyed\n", tablename, database);
1296                         break;
1297                 }
1298         }
1299         AST_LIST_TRAVERSE_SAFE_END
1300         AST_LIST_UNLOCK(&psql_tables);
1301         ast_debug(2, "About to return\n");
1302         return cur ? 0 : -1;
1303 }
1304
1305 static struct ast_config_engine pgsql_engine = {
1306         .name = "pgsql",
1307         .load_func = config_pgsql,
1308         .realtime_func = realtime_pgsql,
1309         .realtime_multi_func = realtime_multi_pgsql,
1310         .store_func = store_pgsql,
1311         .destroy_func = destroy_pgsql,
1312         .update_func = update_pgsql,
1313         .update2_func = update2_pgsql,
1314         .require_func = require_pgsql,
1315         .unload_func = unload_pgsql,
1316 };
1317
1318 static int load_module(void)
1319 {
1320         if(!parse_config(0))
1321                 return AST_MODULE_LOAD_DECLINE;
1322
1323         ast_config_engine_register(&pgsql_engine);
1324         ast_verb(1, "PostgreSQL RealTime driver loaded.\n");
1325         ast_cli_register_multiple(cli_realtime, ARRAY_LEN(cli_realtime));
1326
1327         return 0;
1328 }
1329
1330 static int unload_module(void)
1331 {
1332         struct tables *table;
1333         /* Acquire control before doing anything to the module itself. */
1334         ast_mutex_lock(&pgsql_lock);
1335
1336         if (pgsqlConn) {
1337                 PQfinish(pgsqlConn);
1338                 pgsqlConn = NULL;
1339         }
1340         ast_cli_unregister_multiple(cli_realtime, ARRAY_LEN(cli_realtime));
1341         ast_config_engine_deregister(&pgsql_engine);
1342         ast_verb(1, "PostgreSQL RealTime unloaded.\n");
1343
1344         /* Destroy cached table info */
1345         AST_LIST_LOCK(&psql_tables);
1346         while ((table = AST_LIST_REMOVE_HEAD(&psql_tables, list))) {
1347                 destroy_table(table);
1348         }
1349         AST_LIST_UNLOCK(&psql_tables);
1350
1351         /* Unlock so something else can destroy the lock. */
1352         ast_mutex_unlock(&pgsql_lock);
1353
1354         return 0;
1355 }
1356
1357 static int reload(void)
1358 {
1359         parse_config(1);
1360
1361         return 0;
1362 }
1363
1364 static int parse_config(int is_reload)
1365 {
1366         struct ast_config *config;
1367         const char *s;
1368         struct ast_flags config_flags = { is_reload ? CONFIG_FLAG_FILEUNCHANGED : 0 };
1369
1370         config = ast_config_load(RES_CONFIG_PGSQL_CONF, config_flags);
1371         if (config == CONFIG_STATUS_FILEUNCHANGED) {
1372                 return 0;
1373         }
1374
1375         if (config == CONFIG_STATUS_FILEMISSING || config == CONFIG_STATUS_FILEINVALID) {
1376                 ast_log(LOG_WARNING, "Unable to load config %s\n", RES_CONFIG_PGSQL_CONF);
1377                 return 0;
1378         }
1379
1380         ast_mutex_lock(&pgsql_lock);
1381
1382         if (pgsqlConn) {
1383                 PQfinish(pgsqlConn);
1384                 pgsqlConn = NULL;
1385         }
1386
1387         if (!(s = ast_variable_retrieve(config, "general", "dbuser"))) {
1388                 ast_log(LOG_WARNING,
1389                                 "PostgreSQL RealTime: No database user found, using 'asterisk' as default.\n");
1390                 strcpy(dbuser, "asterisk");
1391         } else {
1392                 ast_copy_string(dbuser, s, sizeof(dbuser));
1393         }
1394
1395         if (!(s = ast_variable_retrieve(config, "general", "dbpass"))) {
1396                 ast_log(LOG_WARNING,
1397                                 "PostgreSQL RealTime: No database password found, using 'asterisk' as default.\n");
1398                 strcpy(dbpass, "asterisk");
1399         } else {
1400                 ast_copy_string(dbpass, s, sizeof(dbpass));
1401         }
1402
1403         if (!(s = ast_variable_retrieve(config, "general", "dbhost"))) {
1404                 ast_log(LOG_WARNING,
1405                                 "PostgreSQL RealTime: No database host found, using localhost via socket.\n");
1406                 dbhost[0] = '\0';
1407         } else {
1408                 ast_copy_string(dbhost, s, sizeof(dbhost));
1409         }
1410
1411         if (!(s = ast_variable_retrieve(config, "general", "dbname"))) {
1412                 ast_log(LOG_WARNING,
1413                                 "PostgreSQL RealTime: No database name found, using 'asterisk' as default.\n");
1414                 strcpy(dbname, "asterisk");
1415         } else {
1416                 ast_copy_string(dbname, s, sizeof(dbname));
1417         }
1418
1419         if (!(s = ast_variable_retrieve(config, "general", "dbport"))) {
1420                 ast_log(LOG_WARNING,
1421                                 "PostgreSQL RealTime: No database port found, using 5432 as default.\n");
1422                 dbport = 5432;
1423         } else {
1424                 dbport = atoi(s);
1425         }
1426
1427         if (!ast_strlen_zero(dbhost)) {
1428                 /* No socket needed */
1429         } else if (!(s = ast_variable_retrieve(config, "general", "dbsock"))) {
1430                 ast_log(LOG_WARNING,
1431                                 "PostgreSQL RealTime: No database socket found, using '/tmp/.s.PGSQL.%d' as default.\n", dbport);
1432                 strcpy(dbsock, "/tmp");
1433         } else {
1434                 ast_copy_string(dbsock, s, sizeof(dbsock));
1435         }
1436
1437         if (!(s = ast_variable_retrieve(config, "general", "requirements"))) {
1438                 ast_log(LOG_WARNING,
1439                                 "PostgreSQL RealTime: no requirements setting found, using 'warn' as default.\n");
1440                 requirements = RQ_WARN;
1441         } else if (!strcasecmp(s, "createclose")) {
1442                 requirements = RQ_CREATECLOSE;
1443         } else if (!strcasecmp(s, "createchar")) {
1444                 requirements = RQ_CREATECHAR;
1445         }
1446
1447         ast_config_destroy(config);
1448
1449         if (option_debug) {
1450                 if (!ast_strlen_zero(dbhost)) {
1451                         ast_debug(1, "PostgreSQL RealTime Host: %s\n", dbhost);
1452                         ast_debug(1, "PostgreSQL RealTime Port: %i\n", dbport);
1453                 } else {
1454                         ast_debug(1, "PostgreSQL RealTime Socket: %s\n", dbsock);
1455                 }
1456                 ast_debug(1, "PostgreSQL RealTime User: %s\n", dbuser);
1457                 ast_debug(1, "PostgreSQL RealTime Password: %s\n", dbpass);
1458                 ast_debug(1, "PostgreSQL RealTime DBName: %s\n", dbname);
1459         }
1460
1461         if (!pgsql_reconnect(NULL)) {
1462                 ast_log(LOG_WARNING,
1463                                 "PostgreSQL RealTime: Couldn't establish connection. Check debug.\n");
1464                 ast_debug(1, "PostgreSQL RealTime: Cannot Connect: %s\n", PQerrorMessage(pgsqlConn));
1465         }
1466
1467         ast_verb(2, "PostgreSQL RealTime reloaded.\n");
1468
1469         /* Done reloading. Release lock so others can now use driver. */
1470         ast_mutex_unlock(&pgsql_lock);
1471
1472         return 1;
1473 }
1474
1475 static int pgsql_reconnect(const char *database)
1476 {
1477         char my_database[50];
1478
1479         ast_copy_string(my_database, S_OR(database, dbname), sizeof(my_database));
1480
1481         /* mutex lock should have been locked before calling this function. */
1482
1483         if (pgsqlConn && PQstatus(pgsqlConn) != CONNECTION_OK) {
1484                 PQfinish(pgsqlConn);
1485                 pgsqlConn = NULL;
1486         }
1487
1488         /* DB password can legitimately be 0-length */
1489         if ((!pgsqlConn) && (!ast_strlen_zero(dbhost) || !ast_strlen_zero(dbsock)) && !ast_strlen_zero(dbuser) && !ast_strlen_zero(my_database)) {
1490                 struct ast_str *connInfo = ast_str_create(32);
1491
1492                 ast_str_set(&connInfo, 0, "host=%s port=%d dbname=%s user=%s",
1493                         S_OR(dbhost, dbsock), dbport, my_database, dbuser);
1494                 if (!ast_strlen_zero(dbpass))
1495                         ast_str_append(&connInfo, 0, " password=%s", dbpass);
1496
1497                 ast_debug(1, "%u connInfo=%s\n", (unsigned int)ast_str_size(connInfo), ast_str_buffer(connInfo));
1498                 pgsqlConn = PQconnectdb(ast_str_buffer(connInfo));
1499                 ast_debug(1, "%u connInfo=%s\n", (unsigned int)ast_str_size(connInfo), ast_str_buffer(connInfo));
1500                 ast_free(connInfo);
1501                 connInfo = NULL;
1502
1503                 ast_debug(1, "pgsqlConn=%p\n", pgsqlConn);
1504                 if (pgsqlConn && PQstatus(pgsqlConn) == CONNECTION_OK) {
1505                         ast_debug(1, "PostgreSQL RealTime: Successfully connected to database.\n");
1506                         connect_time = time(NULL);
1507                         version = PQserverVersion(pgsqlConn);
1508                         return 1;
1509                 } else {
1510                         ast_log(LOG_ERROR,
1511                                         "PostgreSQL RealTime: Failed to connect database %s on %s: %s\n",
1512                                         dbname, dbhost, PQresultErrorMessage(NULL));
1513                         return 0;
1514                 }
1515         } else {
1516                 ast_debug(1, "PostgreSQL RealTime: One or more of the parameters in the config does not pass our validity checks.\n");
1517                 return 1;
1518         }
1519 }
1520
1521 static char *handle_cli_realtime_pgsql_cache(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
1522 {
1523         struct tables *cur;
1524         int l, which;
1525         char *ret = NULL;
1526
1527         switch (cmd) {
1528         case CLI_INIT:
1529                 e->command = "realtime show pgsql cache";
1530                 e->usage =
1531                         "Usage: realtime show pgsql cache [<table>]\n"
1532                         "       Shows table cache for the PostgreSQL RealTime driver\n";
1533                 return NULL;
1534         case CLI_GENERATE:
1535                 if (a->argc != 4) {
1536                         return NULL;
1537                 }
1538                 l = strlen(a->word);
1539                 which = 0;
1540                 AST_LIST_LOCK(&psql_tables);
1541                 AST_LIST_TRAVERSE(&psql_tables, cur, list) {
1542                         if (!strncasecmp(a->word, cur->name, l) && ++which > a->n) {
1543                                 ret = ast_strdup(cur->name);
1544                                 break;
1545                         }
1546                 }
1547                 AST_LIST_UNLOCK(&psql_tables);
1548                 return ret;
1549         }
1550
1551         if (a->argc == 4) {
1552                 /* List of tables */
1553                 AST_LIST_LOCK(&psql_tables);
1554                 AST_LIST_TRAVERSE(&psql_tables, cur, list) {
1555                         ast_cli(a->fd, "%s\n", cur->name);
1556                 }
1557                 AST_LIST_UNLOCK(&psql_tables);
1558         } else if (a->argc == 5) {
1559                 /* List of columns */
1560                 if ((cur = find_table(NULL, a->argv[4]))) {
1561                         struct columns *col;
1562                         ast_cli(a->fd, "Columns for Table Cache '%s':\n", a->argv[4]);
1563                         ast_cli(a->fd, "%-20.20s %-20.20s %-3.3s %-8.8s\n", "Name", "Type", "Len", "Nullable");
1564                         AST_LIST_TRAVERSE(&cur->columns, col, list) {
1565                                 ast_cli(a->fd, "%-20.20s %-20.20s %3d %-8.8s\n", col->name, col->type, col->len, col->notnull ? "NOT NULL" : "");
1566                         }
1567                         release_table(cur);
1568                 } else {
1569                         ast_cli(a->fd, "No such table '%s'\n", a->argv[4]);
1570                 }
1571         }
1572         return 0;
1573 }
1574
1575 static char *handle_cli_realtime_pgsql_status(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
1576 {
1577         char status[256], credentials[100] = "";
1578         int ctimesec = time(NULL) - connect_time;
1579
1580         switch (cmd) {
1581         case CLI_INIT:
1582                 e->command = "realtime show pgsql status";
1583                 e->usage =
1584                         "Usage: realtime show pgsql status\n"
1585                         "       Shows connection information for the PostgreSQL RealTime driver\n";
1586                 return NULL;
1587         case CLI_GENERATE:
1588                 return NULL;
1589         }
1590
1591         if (a->argc != 4)
1592                 return CLI_SHOWUSAGE;
1593
1594         if (pgsqlConn && PQstatus(pgsqlConn) == CONNECTION_OK) {
1595                 if (!ast_strlen_zero(dbhost))
1596                         snprintf(status, sizeof(status), "Connected to %s@%s, port %d", dbname, dbhost, dbport);
1597                 else if (!ast_strlen_zero(dbsock))
1598                         snprintf(status, sizeof(status), "Connected to %s on socket file %s", dbname, dbsock);
1599                 else
1600                         snprintf(status, sizeof(status), "Connected to %s@%s", dbname, dbhost);
1601
1602                 if (!ast_strlen_zero(dbuser))
1603                         snprintf(credentials, sizeof(credentials), " with username %s", dbuser);
1604
1605                 if (ctimesec > 31536000)
1606                         ast_cli(a->fd, "%s%s for %d years, %d days, %d hours, %d minutes, %d seconds.\n",
1607                                         status, credentials, ctimesec / 31536000, (ctimesec % 31536000) / 86400,
1608                                         (ctimesec % 86400) / 3600, (ctimesec % 3600) / 60, ctimesec % 60);
1609                 else if (ctimesec > 86400)
1610                         ast_cli(a->fd, "%s%s for %d days, %d hours, %d minutes, %d seconds.\n", status,
1611                                         credentials, ctimesec / 86400, (ctimesec % 86400) / 3600, (ctimesec % 3600) / 60,
1612                                         ctimesec % 60);
1613                 else if (ctimesec > 3600)
1614                         ast_cli(a->fd, "%s%s for %d hours, %d minutes, %d seconds.\n", status, credentials,
1615                                         ctimesec / 3600, (ctimesec % 3600) / 60, ctimesec % 60);
1616                 else if (ctimesec > 60)
1617                         ast_cli(a->fd, "%s%s for %d minutes, %d seconds.\n", status, credentials, ctimesec / 60,
1618                                         ctimesec % 60);
1619                 else
1620                         ast_cli(a->fd, "%s%s for %d seconds.\n", status, credentials, ctimesec);
1621
1622                 return CLI_SUCCESS;
1623         } else {
1624                 return CLI_FAILURE;
1625         }
1626 }
1627
1628 /* needs usecount semantics defined */
1629 AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_LOAD_ORDER, "PostgreSQL RealTime Configuration Driver",
1630                 .load = load_module,
1631                 .unload = unload_module,
1632                 .reload = reload,
1633                 .load_pri = AST_MODPRI_REALTIME_DRIVER,
1634                );