Doxygen cleanups/fixes.
[asterisk/asterisk.git] / res / res_config_odbc.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 1999 - 2005, Digium, Inc.
5  *
6  * Mark Spencer <markster@digium.com>
7  *
8  * Copyright (C) 2004 - 2005 Anthony Minessale II <anthmct@yahoo.com>
9  *
10  * See http://www.asterisk.org for more information about
11  * the Asterisk project. Please do not directly contact
12  * any of the maintainers of this project for assistance;
13  * the project provides a web site, mailing lists and IRC
14  * channels for your use.
15  *
16  * This program is free software, distributed under the terms of
17  * the GNU General Public License Version 2. See the LICENSE file
18  * at the top of the source tree.
19  */
20
21 /*! \file
22  *
23  * \brief odbc+odbc plugin for portable configuration engine
24  *
25  * \author Mark Spencer <markster@digium.com>
26  * \author Anthony Minessale II <anthmct@yahoo.com>
27  *
28  * \arg http://www.unixodbc.org
29  */
30
31 /*** MODULEINFO
32         <depend>unixodbc</depend>
33         <depend>ltdl</depend>
34         <depend>res_odbc</depend>
35  ***/
36
37 #include "asterisk.h"
38
39 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
40
41 #include <stdio.h>
42 #include <stdlib.h>
43 #include <unistd.h>
44 #include <string.h>
45
46 #include "asterisk/file.h"
47 #include "asterisk/logger.h"
48 #include "asterisk/channel.h"
49 #include "asterisk/pbx.h"
50 #include "asterisk/config.h"
51 #include "asterisk/module.h"
52 #include "asterisk/lock.h"
53 #include "asterisk/options.h"
54 #include "asterisk/res_odbc.h"
55 #include "asterisk/utils.h"
56
57 struct custom_prepare_struct {
58         const char *sql;
59         const char *extra;
60         va_list ap;
61 };
62
63 static SQLHSTMT custom_prepare(struct odbc_obj *obj, void *data)
64 {
65         int res, x = 1;
66         struct custom_prepare_struct *cps = data;
67         const char *newparam, *newval;
68         SQLHSTMT stmt;
69         va_list ap;
70
71         va_copy(ap, cps->ap);
72
73         res = SQLAllocHandle(SQL_HANDLE_STMT, obj->con, &stmt);
74         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
75                 ast_log(LOG_WARNING, "SQL Alloc Handle failed!\n");
76                 return NULL;
77         }
78
79         res = SQLPrepare(stmt, (unsigned char *)cps->sql, SQL_NTS);
80         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
81                 ast_log(LOG_WARNING, "SQL Prepare failed![%s]\n", cps->sql);
82                 SQLFreeHandle (SQL_HANDLE_STMT, stmt);
83                 return NULL;
84         }
85
86         while ((newparam = va_arg(ap, const char *))) {
87                 newval = va_arg(ap, const char *);
88                 SQLBindParameter(stmt, x++, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_CHAR, strlen(newval), 0, (void *)newval, 0, NULL);
89         }
90         va_end(ap);
91
92         if (!ast_strlen_zero(cps->extra))
93                 SQLBindParameter(stmt, x++, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_CHAR, strlen(cps->extra), 0, (void *)cps->extra, 0, NULL);
94         return stmt;
95 }
96
97 /*!
98  * \brief Excute an SQL query and return ast_variable list
99  * \param database
100  * \param table
101  * \param ap list containing one or more field/operator/value set.
102  *
103  * Select database and preform query on table, prepare the sql statement
104  * Sub-in the values to the prepared statement and execute it. Return results
105  * as a ast_variable list.
106  *
107  * \retval var on success
108  * \retval NULL on failure
109 */
110 static struct ast_variable *realtime_odbc(const char *database, const char *table, va_list ap)
111 {
112         struct odbc_obj *obj;
113         SQLHSTMT stmt;
114         char sql[1024];
115         char coltitle[256];
116         char rowdata[2048];
117         char *op;
118         const char *newparam, *newval;
119         char *stringp;
120         char *chunk;
121         SQLSMALLINT collen;
122         int res;
123         int x;
124         struct ast_variable *var=NULL, *prev=NULL;
125         SQLULEN colsize;
126         SQLSMALLINT colcount=0;
127         SQLSMALLINT datatype;
128         SQLSMALLINT decimaldigits;
129         SQLSMALLINT nullable;
130         SQLLEN indicator;
131         va_list aq;
132         struct custom_prepare_struct cps = { .sql = sql };
133
134         va_copy(cps.ap, ap);
135         va_copy(aq, ap);
136
137         if (!table)
138                 return NULL;
139
140         obj = ast_odbc_request_obj(database, 0);
141
142         if (!obj) {
143                 ast_log(LOG_ERROR, "No database handle available with the name of '%s' (check res_odbc.conf)\n", database);
144                 return NULL;
145         }
146
147         newparam = va_arg(aq, const char *);
148         if (!newparam)
149                 return NULL;
150         newval = va_arg(aq, const char *);
151         op = !strchr(newparam, ' ') ? " =" : "";
152         snprintf(sql, sizeof(sql), "SELECT * FROM %s WHERE %s%s ?", table, newparam, op);
153         while((newparam = va_arg(aq, const char *))) {
154                 op = !strchr(newparam, ' ') ? " =" : "";
155                 snprintf(sql + strlen(sql), sizeof(sql) - strlen(sql), " AND %s%s ?%s", newparam, op,
156                         strcasestr(newparam, "LIKE") ? " ESCAPE '\\'" : "");
157                 newval = va_arg(aq, const char *);
158         }
159         va_end(aq);
160
161         stmt = ast_odbc_prepare_and_execute(obj, custom_prepare, &cps);
162
163         if (!stmt) {
164                 ast_odbc_release_obj(obj);
165                 return NULL;
166         }
167
168         res = SQLNumResultCols(stmt, &colcount);
169         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
170                 ast_log(LOG_WARNING, "SQL Column Count error!\n[%s]\n\n", sql);
171                 SQLFreeHandle (SQL_HANDLE_STMT, stmt);
172                 ast_odbc_release_obj(obj);
173                 return NULL;
174         }
175
176         res = SQLFetch(stmt);
177         if (res == SQL_NO_DATA) {
178                 SQLFreeHandle (SQL_HANDLE_STMT, stmt);
179                 ast_odbc_release_obj(obj);
180                 return NULL;
181         }
182         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
183                 ast_log(LOG_WARNING, "SQL Fetch error!\n[%s]\n\n", sql);
184                 SQLFreeHandle (SQL_HANDLE_STMT, stmt);
185                 ast_odbc_release_obj(obj);
186                 return NULL;
187         }
188         for (x = 0; x < colcount; x++) {
189                 rowdata[0] = '\0';
190                 collen = sizeof(coltitle);
191                 res = SQLDescribeCol(stmt, x + 1, (unsigned char *)coltitle, sizeof(coltitle), &collen, 
192                                         &datatype, &colsize, &decimaldigits, &nullable);
193                 if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
194                         ast_log(LOG_WARNING, "SQL Describe Column error!\n[%s]\n\n", sql);
195                         if (var)
196                                 ast_variables_destroy(var);
197                         ast_odbc_release_obj(obj);
198                         return NULL;
199                 }
200
201                 indicator = 0;
202                 res = SQLGetData(stmt, x + 1, SQL_CHAR, rowdata, sizeof(rowdata), &indicator);
203                 if (indicator == SQL_NULL_DATA)
204                         rowdata[0] = '\0';
205                 else if (ast_strlen_zero(rowdata)) {
206                         /* Because we encode the empty string for a NULL, we will encode
207                          * actual empty strings as a string containing a single whitespace. */
208                         ast_copy_string(rowdata, " ", sizeof(rowdata));
209                 }
210
211                 if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
212                         ast_log(LOG_WARNING, "SQL Get Data error!\n[%s]\n\n", sql);
213                         if (var)
214                                 ast_variables_destroy(var);
215                         ast_odbc_release_obj(obj);
216                         return NULL;
217                 }
218                 stringp = rowdata;
219                 while(stringp) {
220                         chunk = strsep(&stringp, ";");
221                         if (!ast_strlen_zero(ast_strip(chunk))) {
222                                 if (prev) {
223                                         prev->next = ast_variable_new(coltitle, chunk, "");
224                                         if (prev->next)
225                                                 prev = prev->next;
226                                 } else 
227                                         prev = var = ast_variable_new(coltitle, chunk, "");
228                         }
229                 }
230         }
231
232
233         SQLFreeHandle(SQL_HANDLE_STMT, stmt);
234         ast_odbc_release_obj(obj);
235         return var;
236 }
237
238 /*!
239  * \brief Excute an Select query and return ast_config list
240  * \param database
241  * \param table
242  * \param ap list containing one or more field/operator/value set.
243  *
244  * Select database and preform query on table, prepare the sql statement
245  * Sub-in the values to the prepared statement and execute it. 
246  * Execute this prepared query against several ODBC connected databases.
247  * Return results as an ast_config variable.
248  *
249  * \retval var on success
250  * \retval NULL on failure
251 */
252 static struct ast_config *realtime_multi_odbc(const char *database, const char *table, va_list ap)
253 {
254         struct odbc_obj *obj;
255         SQLHSTMT stmt;
256         char sql[1024];
257         char coltitle[256];
258         char rowdata[2048];
259         const char *initfield=NULL;
260         char *op;
261         const char *newparam, *newval;
262         char *stringp;
263         char *chunk;
264         SQLSMALLINT collen;
265         int res;
266         int x;
267         struct ast_variable *var=NULL;
268         struct ast_config *cfg=NULL;
269         struct ast_category *cat=NULL;
270         SQLULEN colsize;
271         SQLSMALLINT colcount=0;
272         SQLSMALLINT datatype;
273         SQLSMALLINT decimaldigits;
274         SQLSMALLINT nullable;
275         SQLLEN indicator;
276         struct custom_prepare_struct cps = { .sql = sql };
277         va_list aq;
278
279         va_copy(cps.ap, ap);
280         va_copy(aq, ap);
281
282         if (!table)
283                 return NULL;
284
285         obj = ast_odbc_request_obj(database, 0);
286         if (!obj)
287                 return NULL;
288
289         newparam = va_arg(aq, const char *);
290         if (!newparam)  {
291                 ast_odbc_release_obj(obj);
292                 return NULL;
293         }
294         initfield = ast_strdupa(newparam);
295         if ((op = strchr(initfield, ' '))) 
296                 *op = '\0';
297         newval = va_arg(aq, const char *);
298         op = !strchr(newparam, ' ') ? " =" : "";
299         snprintf(sql, sizeof(sql), "SELECT * FROM %s WHERE %s%s ?", table, newparam, op);
300         while((newparam = va_arg(aq, const char *))) {
301                 op = !strchr(newparam, ' ') ? " =" : "";
302                 snprintf(sql + strlen(sql), sizeof(sql) - strlen(sql), " AND %s%s ?%s", newparam, op,
303                         strcasestr(newparam, "LIKE") ? " ESCAPE '\\'" : "");
304                 newval = va_arg(aq, const char *);
305         }
306         if (initfield)
307                 snprintf(sql + strlen(sql), sizeof(sql) - strlen(sql), " ORDER BY %s", initfield);
308         va_end(aq);
309
310         stmt = ast_odbc_prepare_and_execute(obj, custom_prepare, &cps);
311
312         if (!stmt) {
313                 ast_odbc_release_obj(obj);
314                 return NULL;
315         }
316
317         res = SQLNumResultCols(stmt, &colcount);
318         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
319                 ast_log(LOG_WARNING, "SQL Column Count error!\n[%s]\n\n", sql);
320                 SQLFreeHandle(SQL_HANDLE_STMT, stmt);
321                 ast_odbc_release_obj(obj);
322                 return NULL;
323         }
324
325         cfg = ast_config_new();
326         if (!cfg) {
327                 ast_log(LOG_WARNING, "Out of memory!\n");
328                 SQLFreeHandle(SQL_HANDLE_STMT, stmt);
329                 ast_odbc_release_obj(obj);
330                 return NULL;
331         }
332
333         while ((res=SQLFetch(stmt)) != SQL_NO_DATA) {
334                 var = NULL;
335                 if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
336                         ast_log(LOG_WARNING, "SQL Fetch error!\n[%s]\n\n", sql);
337                         continue;
338                 }
339                 cat = ast_category_new("","",99999);
340                 if (!cat) {
341                         ast_log(LOG_WARNING, "Out of memory!\n");
342                         continue;
343                 }
344                 for (x=0;x<colcount;x++) {
345                         rowdata[0] = '\0';
346                         collen = sizeof(coltitle);
347                         res = SQLDescribeCol(stmt, x + 1, (unsigned char *)coltitle, sizeof(coltitle), &collen, 
348                                                 &datatype, &colsize, &decimaldigits, &nullable);
349                         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
350                                 ast_log(LOG_WARNING, "SQL Describe Column error!\n[%s]\n\n", sql);
351                                 ast_category_destroy(cat);
352                                 continue;
353                         }
354
355                         indicator = 0;
356                         res = SQLGetData(stmt, x + 1, SQL_CHAR, rowdata, sizeof(rowdata), &indicator);
357                         if (indicator == SQL_NULL_DATA)
358                                 continue;
359
360                         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
361                                 ast_log(LOG_WARNING, "SQL Get Data error!\n[%s]\n\n", sql);
362                                 ast_category_destroy(cat);
363                                 continue;
364                         }
365                         stringp = rowdata;
366                         while(stringp) {
367                                 chunk = strsep(&stringp, ";");
368                                 if (!ast_strlen_zero(ast_strip(chunk))) {
369                                         if (initfield && !strcmp(initfield, coltitle))
370                                                 ast_category_rename(cat, chunk);
371                                         var = ast_variable_new(coltitle, chunk, "");
372                                         ast_variable_append(cat, var);
373                                 }
374                         }
375                 }
376                 ast_category_append(cfg, cat);
377         }
378
379         SQLFreeHandle(SQL_HANDLE_STMT, stmt);
380         ast_odbc_release_obj(obj);
381         return cfg;
382 }
383
384 /*!
385  * \brief Excute an UPDATE query
386  * \param database
387  * \param table
388  * \param keyfield where clause field
389  * \param lookup value of field for where clause
390  * \param ap list containing one or more field/value set(s).
391  *
392  * Update a database table, prepare the sql statement using keyfield and lookup
393  * control the number of records to change. All values to be changed are stored in ap list.
394  * Sub-in the values to the prepared statement and execute it.
395  *
396  * \retval number of rows affected
397  * \retval -1 on failure
398 */
399 static int update_odbc(const char *database, const char *table, const char *keyfield, const char *lookup, va_list ap)
400 {
401         struct odbc_obj *obj;
402         SQLHSTMT stmt;
403         char sql[256];
404         SQLLEN rowcount=0;
405         const char *newparam, *newval;
406         int res;
407         va_list aq;
408         struct custom_prepare_struct cps = { .sql = sql, .extra = lookup };
409
410         va_copy(cps.ap, ap);
411         va_copy(aq, ap);
412         
413         if (!table)
414                 return -1;
415
416         obj = ast_odbc_request_obj(database, 0);
417         if (!obj)
418                 return -1;
419
420         newparam = va_arg(aq, const char *);
421         if (!newparam)  {
422                 ast_odbc_release_obj(obj);
423                 return -1;
424         }
425         newval = va_arg(aq, const char *);
426         snprintf(sql, sizeof(sql), "UPDATE %s SET %s=?", table, newparam);
427         while((newparam = va_arg(aq, const char *))) {
428                 snprintf(sql + strlen(sql), sizeof(sql) - strlen(sql), ", %s=?", newparam);
429                 newval = va_arg(aq, const char *);
430         }
431         va_end(aq);
432         snprintf(sql + strlen(sql), sizeof(sql) - strlen(sql), " WHERE %s=?", keyfield);
433
434         stmt = ast_odbc_prepare_and_execute(obj, custom_prepare, &cps);
435
436         if (!stmt) {
437                 ast_odbc_release_obj(obj);
438                 return -1;
439         }
440
441         res = SQLRowCount(stmt, &rowcount);
442         SQLFreeHandle (SQL_HANDLE_STMT, stmt);
443         ast_odbc_release_obj(obj);
444
445         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
446                 ast_log(LOG_WARNING, "SQL Row Count error!\n[%s]\n\n", sql);
447                 return -1;
448         }
449
450         if (rowcount >= 0)
451                 return (int)rowcount;
452
453         return -1;
454 }
455
456 /*!
457  * \brief Excute an INSERT query
458  * \param database
459  * \param table
460  * \param ap list containing one or more field/value set(s)
461  *
462  * Insert a new record into database table, prepare the sql statement.
463  * All values to be changed are stored in ap list.
464  * Sub-in the values to the prepared statement and execute it.
465  *
466  * \retval number of rows affected
467  * \retval -1 on failure
468 */
469 static int store_odbc(const char *database, const char *table, va_list ap)
470 {
471         struct odbc_obj *obj;
472         SQLHSTMT stmt;
473         char sql[256];
474         char keys[256];
475         char vals[256];
476         SQLLEN rowcount=0;
477         const char *newparam, *newval;
478         int res;
479         va_list aq;
480         struct custom_prepare_struct cps = { .sql = sql, .extra = NULL };
481
482         va_copy(cps.ap, ap);
483         va_copy(aq, ap);
484         
485         if (!table)
486                 return -1;
487
488         obj = ast_odbc_request_obj(database, 0);
489         if (!obj)
490                 return -1;
491
492         newparam = va_arg(aq, const char *);
493         if (!newparam)  {
494                 ast_odbc_release_obj(obj);
495                 return -1;
496         }
497         newval = va_arg(aq, const char *);
498         snprintf(keys, sizeof(keys), "%s", newparam);
499         snprintf(vals, sizeof(vals), "?");
500         while ((newparam = va_arg(aq, const char *))) {
501                 snprintf(keys + strlen(keys), sizeof(keys) - strlen(keys), ", %s", newparam);
502                 snprintf(vals + strlen(vals), sizeof(vals) - strlen(vals), ", ?");
503                 newval = va_arg(aq, const char *);
504         }
505         va_end(aq);
506         snprintf(sql, sizeof(sql), "INSERT INTO %s (%s) VALUES (%s)", table, keys, vals);
507
508         stmt = ast_odbc_prepare_and_execute(obj, custom_prepare, &cps);
509
510         if (!stmt) {
511                 ast_odbc_release_obj(obj);
512                 return -1;
513         }
514
515         res = SQLRowCount(stmt, &rowcount);
516         SQLFreeHandle (SQL_HANDLE_STMT, stmt);
517         ast_odbc_release_obj(obj);
518
519         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
520                 ast_log(LOG_WARNING, "SQL Row Count error!\n[%s]\n\n", sql);
521                 return -1;
522         }
523
524         if (rowcount >= 0)
525                 return (int)rowcount;
526
527         return -1;
528 }
529
530 /*!
531  * \brief Excute an DELETE query
532  * \param database
533  * \param table
534  * \param keyfield where clause field
535  * \param lookup value of field for where clause
536  * \param ap list containing one or more field/value set(s)
537  *
538  * Delete a row from a database table, prepare the sql statement using keyfield and lookup
539  * control the number of records to change. Additional params to match rows are stored in ap list.
540  * Sub-in the values to the prepared statement and execute it.
541  *
542  * \retval number of rows affected
543  * \retval -1 on failure
544 */
545 static int destroy_odbc(const char *database, const char *table, const char *keyfield, const char *lookup, va_list ap)
546 {
547         struct odbc_obj *obj;
548         SQLHSTMT stmt;
549         char sql[256];
550         SQLLEN rowcount=0;
551         const char *newparam, *newval;
552         int res;
553         va_list aq;
554         struct custom_prepare_struct cps = { .sql = sql, .extra = lookup };
555
556         va_copy(cps.ap, ap);
557         va_copy(aq, ap);
558         
559         if (!table)
560                 return -1;
561
562         obj = ast_odbc_request_obj(database, 0);
563         if (!obj)
564                 return -1;
565
566         snprintf(sql, sizeof(sql), "DELETE FROM %s WHERE ", table);
567         while((newparam = va_arg(aq, const char *))) {
568                 snprintf(sql + strlen(sql), sizeof(sql) - strlen(sql), "%s=? AND ", newparam);
569                 newval = va_arg(aq, const char *);
570         }
571         va_end(aq);
572         snprintf(sql + strlen(sql), sizeof(sql) - strlen(sql), "%s=?", keyfield);
573
574         stmt = ast_odbc_prepare_and_execute(obj, custom_prepare, &cps);
575
576         if (!stmt) {
577                 ast_odbc_release_obj(obj);
578                 return -1;
579         }
580
581         res = SQLRowCount(stmt, &rowcount);
582         SQLFreeHandle (SQL_HANDLE_STMT, stmt);
583         ast_odbc_release_obj(obj);
584
585         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
586                 ast_log(LOG_WARNING, "SQL Row Count error!\n[%s]\n\n", sql);
587                 return -1;
588         }
589
590         if (rowcount >= 0)
591                 return (int)rowcount;
592
593         return -1;
594 }
595
596
597 struct config_odbc_obj {
598         char *sql;
599         unsigned long cat_metric;
600         char category[128];
601         char var_name[128];
602         char var_val[1024]; /* changed from 128 to 1024 via bug 8251 */
603         SQLLEN err;
604 };
605
606 static SQLHSTMT config_odbc_prepare(struct odbc_obj *obj, void *data)
607 {
608         struct config_odbc_obj *q = data;
609         SQLHSTMT sth;
610         int res;
611
612         res = SQLAllocHandle(SQL_HANDLE_STMT, obj->con, &sth);
613         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
614                 ast_verb(4, "Failure in AllocStatement %d\n", res);
615                 return NULL;
616         }
617
618         res = SQLPrepare(sth, (unsigned char *)q->sql, SQL_NTS);
619         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
620                 ast_verb(4, "Error in PREPARE %d\n", res);
621                 SQLFreeHandle(SQL_HANDLE_STMT, sth);
622                 return NULL;
623         }
624
625         SQLBindCol(sth, 1, SQL_C_ULONG, &q->cat_metric, sizeof(q->cat_metric), &q->err);
626         SQLBindCol(sth, 2, SQL_C_CHAR, q->category, sizeof(q->category), &q->err);
627         SQLBindCol(sth, 3, SQL_C_CHAR, q->var_name, sizeof(q->var_name), &q->err);
628         SQLBindCol(sth, 4, SQL_C_CHAR, q->var_val, sizeof(q->var_val), &q->err);
629
630         return sth;
631 }
632
633 static struct ast_config *config_odbc(const char *database, const char *table, const char *file, struct ast_config *cfg, struct ast_flags flags, const char *sugg_incl)
634 {
635         struct ast_variable *new_v;
636         struct ast_category *cur_cat;
637         int res = 0;
638         struct odbc_obj *obj;
639         char sqlbuf[1024] = "";
640         char *sql = sqlbuf;
641         size_t sqlleft = sizeof(sqlbuf);
642         unsigned int last_cat_metric = 0;
643         SQLSMALLINT rowcount = 0;
644         SQLHSTMT stmt;
645         char last[128] = "";
646         struct config_odbc_obj q;
647         struct ast_flags loader_flags = { 0 };
648
649         memset(&q, 0, sizeof(q));
650
651         if (!file || !strcmp (file, "res_config_odbc.conf"))
652                 return NULL;            /* cant configure myself with myself ! */
653
654         obj = ast_odbc_request_obj(database, 0);
655         if (!obj)
656                 return NULL;
657
658         ast_build_string(&sql, &sqlleft, "SELECT cat_metric, category, var_name, var_val FROM %s ", table);
659         ast_build_string(&sql, &sqlleft, "WHERE filename='%s' AND commented=0 ", file);
660         ast_build_string(&sql, &sqlleft, "ORDER BY cat_metric DESC, var_metric ASC, category, var_name ");
661         q.sql = sqlbuf;
662
663         stmt = ast_odbc_prepare_and_execute(obj, config_odbc_prepare, &q);
664
665         if (!stmt) {
666                 ast_log(LOG_WARNING, "SQL select error!\n[%s]\n\n", sql);
667                 ast_odbc_release_obj(obj);
668                 return NULL;
669         }
670
671         res = SQLNumResultCols(stmt, &rowcount);
672
673         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
674                 ast_log(LOG_WARNING, "SQL NumResultCols error!\n[%s]\n\n", sql);
675                 SQLFreeHandle(SQL_HANDLE_STMT, stmt);
676                 ast_odbc_release_obj(obj);
677                 return NULL;
678         }
679
680         if (!rowcount) {
681                 ast_log(LOG_NOTICE, "found nothing\n");
682                 ast_odbc_release_obj(obj);
683                 return cfg;
684         }
685
686         cur_cat = ast_config_get_current_category(cfg);
687
688         while ((res = SQLFetch(stmt)) != SQL_NO_DATA) {
689                 if (!strcmp (q.var_name, "#include")) {
690                         if (!ast_config_internal_load(q.var_val, cfg, loader_flags, "")) {
691                                 SQLFreeHandle(SQL_HANDLE_STMT, stmt);
692                                 ast_odbc_release_obj(obj);
693                                 return NULL;
694                         }
695                         continue;
696                 } 
697                 if (strcmp(last, q.category) || last_cat_metric != q.cat_metric) {
698                         cur_cat = ast_category_new(q.category, "", 99999);
699                         if (!cur_cat) {
700                                 ast_log(LOG_WARNING, "Out of memory!\n");
701                                 break;
702                         }
703                         strcpy(last, q.category);
704                         last_cat_metric = q.cat_metric;
705                         ast_category_append(cfg, cur_cat);
706                 }
707
708                 new_v = ast_variable_new(q.var_name, q.var_val, "");
709                 ast_variable_append(cur_cat, new_v);
710         }
711
712         SQLFreeHandle(SQL_HANDLE_STMT, stmt);
713         ast_odbc_release_obj(obj);
714         return cfg;
715 }
716
717 static struct ast_config_engine odbc_engine = {
718         .name = "odbc",
719         .load_func = config_odbc,
720         .realtime_func = realtime_odbc,
721         .realtime_multi_func = realtime_multi_odbc,
722         .store_func = store_odbc,
723         .destroy_func = destroy_odbc,
724         .update_func = update_odbc
725 };
726
727 static int unload_module (void)
728 {
729         ast_config_engine_deregister(&odbc_engine);
730         ast_verb(1, "res_config_odbc unloaded.\n");
731         return 0;
732 }
733
734 static int load_module (void)
735 {
736         ast_config_engine_register(&odbc_engine);
737         ast_verb(1, "res_config_odbc loaded.\n");
738         return 0;
739 }
740
741 AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_GLOBAL_SYMBOLS, "Realtime ODBC configuration",
742                 .load = load_module,
743                 .unload = unload_module,
744                 );