BuildSystem: Depend not implicitly but explicitly on external libraries.
[asterisk/asterisk.git] / res / res_config_odbc.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 1999 - 2010, 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>res_odbc</depend>
33         <depend>generic_odbc</depend>
34         <support_level>core</support_level>
35  ***/
36
37 #include "asterisk.h"
38
39 #include "asterisk/file.h"
40 #include "asterisk/channel.h"
41 #include "asterisk/pbx.h"
42 #include "asterisk/config.h"
43 #include "asterisk/module.h"
44 #include "asterisk/lock.h"
45 #include "asterisk/res_odbc.h"
46 #include "asterisk/utils.h"
47 #include "asterisk/stringfields.h"
48
49 /*! Initial SQL query buffer size to allocate. */
50 #define SQL_BUF_SIZE    1024
51
52 AST_THREADSTORAGE(sql_buf);
53 AST_THREADSTORAGE(rowdata_buf);
54
55 struct custom_prepare_struct {
56         const char *sql;
57         const char *extra;
58         AST_DECLARE_STRING_FIELDS(
59                 AST_STRING_FIELD(encoding)[256];
60         );
61         const struct ast_variable *fields;
62         unsigned long long skip;
63 };
64
65 #define ENCODE_CHUNK(buffer, s) \
66         do { \
67                 char *eptr = buffer; \
68                 const char *vptr = s; \
69                 for (; *vptr && eptr < buffer + sizeof(buffer); vptr++) { \
70                         if (strchr("^;", *vptr)) { \
71                                 /* We use ^XX, instead of %XX because '%' is a special character in SQL */ \
72                                 snprintf(eptr, buffer + sizeof(buffer) - eptr, "^%02hhX", *vptr); \
73                                 eptr += 3; \
74                         } else { \
75                                 *eptr++ = *vptr; \
76                         } \
77                 } \
78                 if (eptr < buffer + sizeof(buffer)) { \
79                         *eptr = '\0'; \
80                 } else { \
81                         buffer[sizeof(buffer) - 1] = '\0'; \
82                 } \
83         } while(0)
84
85 static void decode_chunk(char *chunk)
86 {
87         for (; *chunk; chunk++) {
88                 if (*chunk == '^' && strchr("0123456789ABCDEF", chunk[1]) && strchr("0123456789ABCDEF", chunk[2])) {
89                         sscanf(chunk + 1, "%02hhX", (unsigned char *)chunk);
90                         memmove(chunk + 1, chunk + 3, strlen(chunk + 3) + 1);
91                 }
92         }
93 }
94
95 static inline int is_text(const struct odbc_cache_columns *column)
96 {
97         return column->type == SQL_CHAR || column->type == SQL_VARCHAR || column->type == SQL_LONGVARCHAR
98                 || column->type == SQL_WCHAR || column->type == SQL_WVARCHAR || column->type == SQL_WLONGVARCHAR;
99 }
100
101 static SQLHSTMT custom_prepare(struct odbc_obj *obj, void *data)
102 {
103         int res, x = 1, count = 0;
104         struct custom_prepare_struct *cps = data;
105         const struct ast_variable *field;
106         char encodebuf[1024];
107         SQLHSTMT stmt;
108
109         res = SQLAllocHandle(SQL_HANDLE_STMT, obj->con, &stmt);
110         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
111                 ast_log(LOG_WARNING, "SQL Alloc Handle failed!\n");
112                 return NULL;
113         }
114
115         ast_debug(1, "Skip: %llu; SQL: %s\n", cps->skip, cps->sql);
116
117         res = SQLPrepare(stmt, (unsigned char *)cps->sql, SQL_NTS);
118         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
119                 ast_log(LOG_WARNING, "SQL Prepare failed! [%s]\n", cps->sql);
120                 SQLFreeHandle (SQL_HANDLE_STMT, stmt);
121                 return NULL;
122         }
123
124         for (field = cps->fields; field; field = field->next) {
125                 const char *newval = field->value;
126
127                 if ((1LL << count++) & cps->skip) {
128                         ast_debug(1, "Skipping field '%s'='%s' (%llo/%llo)\n", field->name, newval, 1ULL << (count - 1), cps->skip);
129                         continue;
130                 }
131                 ast_debug(1, "Parameter %d ('%s') = '%s'\n", x, field->name, newval);
132                 if (strchr(newval, ';') || strchr(newval, '^')) {
133                         ENCODE_CHUNK(encodebuf, newval);
134                         ast_string_field_set(cps, encoding[x], encodebuf);
135                         newval = cps->encoding[x];
136                 }
137                 SQLBindParameter(stmt, x++, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_CHAR, strlen(newval), 0, (void *)newval, 0, NULL);
138         }
139
140         if (!ast_strlen_zero(cps->extra)) {
141                 const char *newval = cps->extra;
142                 ast_debug(1, "Parameter %d = '%s'\n", x, newval);
143                 if (strchr(newval, ';') || strchr(newval, '^')) {
144                         ENCODE_CHUNK(encodebuf, newval);
145                         ast_string_field_set(cps, encoding[x], encodebuf);
146                         newval = cps->encoding[x];
147                 }
148                 SQLBindParameter(stmt, x++, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_CHAR, strlen(newval), 0, (void *)newval, 0, NULL);
149         }
150
151         return stmt;
152 }
153
154 /*!
155  * \brief Excute an SQL query and return ast_variable list
156  * \param database
157  * \param table
158  * \param ap list containing one or more field/operator/value set.
159  *
160  * Select database and preform query on table, prepare the sql statement
161  * Sub-in the values to the prepared statement and execute it. Return results
162  * as a ast_variable list.
163  *
164  * \retval var on success
165  * \retval NULL on failure
166  */
167 static struct ast_variable *realtime_odbc(const char *database, const char *table, const struct ast_variable *fields)
168 {
169         struct odbc_obj *obj;
170         SQLHSTMT stmt;
171         char coltitle[256];
172         struct ast_str *sql = ast_str_thread_get(&sql_buf, SQL_BUF_SIZE);
173         struct ast_str *rowdata = ast_str_thread_get(&rowdata_buf, 128);
174         char *op;
175         const struct ast_variable *field = fields;
176         char *stringp;
177         char *chunk;
178         SQLSMALLINT collen;
179         int res;
180         int x;
181         struct ast_variable *var=NULL, *prev=NULL;
182         SQLULEN colsize;
183         SQLSMALLINT colcount=0;
184         SQLSMALLINT datatype;
185         SQLSMALLINT decimaldigits;
186         SQLSMALLINT nullable;
187         SQLLEN indicator;
188         struct custom_prepare_struct cps = { .fields = fields, };
189         struct ast_flags connected_flag = { RES_ODBC_CONNECTED };
190
191         if (!table || !field || !sql || !rowdata) {
192                 return NULL;
193         }
194
195         obj = ast_odbc_request_obj2(database, connected_flag);
196         if (!obj) {
197                 ast_log(LOG_ERROR, "No database handle available with the name of '%s' (check res_odbc.conf)\n", database);
198                 return NULL;
199         }
200
201         op = !strchr(field->name, ' ') ? " =" : "";
202         ast_str_set(&sql, 0, "SELECT * FROM %s WHERE %s%s ?%s", table, field->name, op,
203                 strcasestr(field->name, "LIKE") && !ast_odbc_backslash_is_escape(obj) ? " ESCAPE '\\\\'" : "");
204         while ((field = field->next)) {
205                 op = !strchr(field->name, ' ') ? " =" : "";
206                 ast_str_append(&sql, 0, " AND %s%s ?%s", field->name, op,
207                         strcasestr(field->name, "LIKE") && !ast_odbc_backslash_is_escape(obj) ? " ESCAPE '\\\\'" : "");
208         }
209
210         cps.sql = ast_str_buffer(sql);
211
212         if (ast_string_field_init(&cps, 256)) {
213                 ast_odbc_release_obj(obj);
214                 return NULL;
215         }
216         stmt = ast_odbc_prepare_and_execute(obj, custom_prepare, &cps);
217         ast_string_field_free_memory(&cps);
218
219         if (!stmt) {
220                 ast_odbc_release_obj(obj);
221                 return NULL;
222         }
223
224         res = SQLNumResultCols(stmt, &colcount);
225         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
226                 ast_log(LOG_WARNING, "SQL Column Count error! [%s]\n", ast_str_buffer(sql));
227                 SQLFreeHandle (SQL_HANDLE_STMT, stmt);
228                 ast_odbc_release_obj(obj);
229                 return NULL;
230         }
231
232         res = SQLFetch(stmt);
233         if (res == SQL_NO_DATA) {
234                 SQLFreeHandle (SQL_HANDLE_STMT, stmt);
235                 ast_odbc_release_obj(obj);
236                 return NULL;
237         }
238         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
239                 ast_log(LOG_WARNING, "SQL Fetch error! [%s]\n", ast_str_buffer(sql));
240                 SQLFreeHandle (SQL_HANDLE_STMT, stmt);
241                 ast_odbc_release_obj(obj);
242                 return NULL;
243         }
244         for (x = 0; x < colcount; x++) {
245                 colsize = 0;
246                 collen = sizeof(coltitle);
247                 res = SQLDescribeCol(stmt, x + 1, (unsigned char *)coltitle, sizeof(coltitle), &collen,
248                                         &datatype, &colsize, &decimaldigits, &nullable);
249                 if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
250                         ast_log(LOG_WARNING, "SQL Describe Column error! [%s]\n", ast_str_buffer(sql));
251                         if (var)
252                                 ast_variables_destroy(var);
253                         ast_odbc_release_obj(obj);
254                         return NULL;
255                 }
256
257                 ast_str_reset(rowdata);
258                 indicator = 0;
259
260                 res = SQLGetData(stmt, x + 1, SQL_CHAR, ast_str_buffer(rowdata), ast_str_size(rowdata), &indicator);
261                 ast_str_update(rowdata);
262                 if (indicator == SQL_NULL_DATA) {
263                         ast_str_reset(rowdata);
264                 } else if (!ast_str_strlen(rowdata)) {
265                         /* Because we encode the empty string for a NULL, we will encode
266                          * actual empty strings as a string containing a single whitespace. */
267                         ast_str_set(&rowdata, -1, "%s", " ");
268                 } else if ((res == SQL_SUCCESS) || (res == SQL_SUCCESS_WITH_INFO)) {
269                         if (indicator != ast_str_strlen(rowdata)) {
270                                 /* If the available space was not enough to contain the row data enlarge and read in the rest */
271                                 ast_str_make_space(&rowdata, indicator + 1);
272                                 res = SQLGetData(stmt, x + 1, SQL_CHAR, ast_str_buffer(rowdata) + ast_str_strlen(rowdata),
273                                         ast_str_size(rowdata) - ast_str_strlen(rowdata), &indicator);
274                                 ast_str_update(rowdata);
275                         }
276                 }
277
278                 if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
279                         ast_log(LOG_WARNING, "SQL Get Data error! [%s]\n", ast_str_buffer(sql));
280                         if (var)
281                                 ast_variables_destroy(var);
282                         ast_odbc_release_obj(obj);
283                         return NULL;
284                 }
285
286                 stringp = ast_str_buffer(rowdata);
287                 while (stringp) {
288                         chunk = strsep(&stringp, ";");
289                         if (!ast_strlen_zero(ast_strip(chunk))) {
290                                 if (strchr(chunk, '^')) {
291                                         decode_chunk(chunk);
292                                 }
293                                 if (prev) {
294                                         prev->next = ast_variable_new(coltitle, chunk, "");
295                                         if (prev->next) {
296                                                 prev = prev->next;
297                                         }
298                                 } else {
299                                         prev = var = ast_variable_new(coltitle, chunk, "");
300                                 }
301                         }
302                 }
303         }
304
305         SQLFreeHandle(SQL_HANDLE_STMT, stmt);
306         ast_odbc_release_obj(obj);
307         return var;
308 }
309
310 /*!
311  * \brief Excute an Select query and return ast_config list
312  * \param database
313  * \param table
314  * \param ap list containing one or more field/operator/value set.
315  *
316  * Select database and preform query on table, prepare the sql statement
317  * Sub-in the values to the prepared statement and execute it.
318  * Execute this prepared query against several ODBC connected databases.
319  * Return results as an ast_config variable.
320  *
321  * \retval var on success
322  * \retval NULL on failure
323  */
324 static struct ast_config *realtime_multi_odbc(const char *database, const char *table, const struct ast_variable *fields)
325 {
326         struct odbc_obj *obj;
327         SQLHSTMT stmt;
328         char coltitle[256];
329         struct ast_str *sql = ast_str_thread_get(&sql_buf, SQL_BUF_SIZE);
330         struct ast_str *rowdata = ast_str_thread_get(&rowdata_buf, 128);
331         const char *initfield;
332         char *op;
333         const struct ast_variable *field = fields;
334         char *stringp;
335         char *chunk;
336         SQLSMALLINT collen;
337         int res;
338         int x;
339         struct ast_variable *var=NULL;
340         struct ast_config *cfg=NULL;
341         struct ast_category *cat=NULL;
342         struct ast_flags connected_flag = { RES_ODBC_CONNECTED };
343         SQLULEN colsize;
344         SQLSMALLINT colcount=0;
345         SQLSMALLINT datatype;
346         SQLSMALLINT decimaldigits;
347         SQLSMALLINT nullable;
348         SQLLEN indicator;
349         struct custom_prepare_struct cps = { .fields = fields, };
350
351         if (!table || !field || !sql || !rowdata) {
352                 return NULL;
353         }
354
355         obj = ast_odbc_request_obj2(database, connected_flag);
356         if (!obj) {
357                 return NULL;
358         }
359
360         initfield = ast_strdupa(field->name);
361         if ((op = strchr(initfield, ' '))) {
362                 *op = '\0';
363         }
364
365         op = !strchr(field->name, ' ') ? " =" : "";
366         ast_str_set(&sql, 0, "SELECT * FROM %s WHERE %s%s ?%s", table, field->name, op,
367                 strcasestr(field->name, "LIKE") && !ast_odbc_backslash_is_escape(obj) ? " ESCAPE '\\\\'" : "");
368         while ((field = field->next)) {
369                 op = !strchr(field->name, ' ') ? " =" : "";
370                 ast_str_append(&sql, 0, " AND %s%s ?%s", field->name, op,
371                         strcasestr(field->name, "LIKE") && !ast_odbc_backslash_is_escape(obj) ? " ESCAPE '\\\\'" : "");
372         }
373         ast_str_append(&sql, 0, " ORDER BY %s", initfield);
374
375         cps.sql = ast_str_buffer(sql);
376
377         if (ast_string_field_init(&cps, 256)) {
378                 ast_odbc_release_obj(obj);
379                 return NULL;
380         }
381         stmt = ast_odbc_prepare_and_execute(obj, custom_prepare, &cps);
382         ast_string_field_free_memory(&cps);
383
384         if (!stmt) {
385                 ast_odbc_release_obj(obj);
386                 return NULL;
387         }
388
389         res = SQLNumResultCols(stmt, &colcount);
390         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
391                 ast_log(LOG_WARNING, "SQL Column Count error! [%s]\n", ast_str_buffer(sql));
392                 SQLFreeHandle(SQL_HANDLE_STMT, stmt);
393                 ast_odbc_release_obj(obj);
394                 return NULL;
395         }
396
397         cfg = ast_config_new();
398         if (!cfg) {
399                 ast_log(LOG_WARNING, "Out of memory!\n");
400                 SQLFreeHandle(SQL_HANDLE_STMT, stmt);
401                 ast_odbc_release_obj(obj);
402                 return NULL;
403         }
404
405         while ((res=SQLFetch(stmt)) != SQL_NO_DATA) {
406                 var = NULL;
407                 if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
408                         ast_log(LOG_WARNING, "SQL Fetch error! [%s]\n", ast_str_buffer(sql));
409                         continue;
410                 }
411                 cat = ast_category_new_anonymous();
412                 if (!cat) {
413                         continue;
414                 }
415                 for (x=0;x<colcount;x++) {
416                         colsize = 0;
417                         collen = sizeof(coltitle);
418                         res = SQLDescribeCol(stmt, x + 1, (unsigned char *)coltitle, sizeof(coltitle), &collen,
419                                                 &datatype, &colsize, &decimaldigits, &nullable);
420                         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
421                                 ast_log(LOG_WARNING, "SQL Describe Column error! [%s]\n", ast_str_buffer(sql));
422                                 ast_category_destroy(cat);
423                                 goto next_sql_fetch;
424                         }
425
426                         ast_str_reset(rowdata);
427                         indicator = 0;
428
429                         res = SQLGetData(stmt, x + 1, SQL_CHAR, ast_str_buffer(rowdata), ast_str_size(rowdata), &indicator);
430                         ast_str_update(rowdata);
431                         if (indicator == SQL_NULL_DATA) {
432                                 continue;
433                         }
434
435                         if ((res == SQL_SUCCESS) || (res == SQL_SUCCESS_WITH_INFO)) {
436                                 if (indicator != ast_str_strlen(rowdata)) {
437                                         /* If the available space was not enough to contain the row data enlarge and read in the rest */
438                                         ast_str_make_space(&rowdata, indicator + 1);
439                                         res = SQLGetData(stmt, x + 1, SQL_CHAR, ast_str_buffer(rowdata) + ast_str_strlen(rowdata),
440                                                 ast_str_size(rowdata) - ast_str_strlen(rowdata), &indicator);
441                                         ast_str_update(rowdata);
442                                 }
443                         }
444
445                         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
446                                 ast_log(LOG_WARNING, "SQL Get Data error! [%s]\n", ast_str_buffer(sql));
447                                 ast_category_destroy(cat);
448                                 goto next_sql_fetch;
449                         }
450                         stringp = ast_str_buffer(rowdata);
451                         while (stringp) {
452                                 chunk = strsep(&stringp, ";");
453                                 if (!ast_strlen_zero(ast_strip(chunk))) {
454                                         if (strchr(chunk, '^')) {
455                                                 decode_chunk(chunk);
456                                         }
457                                         if (!strcmp(initfield, coltitle)) {
458                                                 ast_category_rename(cat, chunk);
459                                         }
460                                         var = ast_variable_new(coltitle, chunk, "");
461                                         ast_variable_append(cat, var);
462                                 }
463                         }
464                 }
465                 ast_category_append(cfg, cat);
466 next_sql_fetch:;
467         }
468
469         SQLFreeHandle(SQL_HANDLE_STMT, stmt);
470         ast_odbc_release_obj(obj);
471         return cfg;
472 }
473
474 /*!
475  * \brief Excute an UPDATE query
476  * \param database
477  * \param table
478  * \param keyfield where clause field
479  * \param lookup value of field for where clause
480  * \param ap list containing one or more field/value set(s).
481  *
482  * Update a database table, prepare the sql statement using keyfield and lookup
483  * control the number of records to change. All values to be changed are stored in ap list.
484  * Sub-in the values to the prepared statement and execute it.
485  *
486  * \retval number of rows affected
487  * \retval -1 on failure
488  */
489 static int update_odbc(const char *database, const char *table, const char *keyfield, const char *lookup, const struct ast_variable *fields)
490 {
491         struct odbc_obj *obj;
492         SQLHSTMT stmt;
493         SQLLEN rowcount=0;
494         struct ast_str *sql = ast_str_thread_get(&sql_buf, SQL_BUF_SIZE);
495         const struct ast_variable *field = fields;
496         int res, count = 0, paramcount = 0;
497         struct custom_prepare_struct cps = { .extra = lookup, .fields = fields, };
498         struct odbc_cache_tables *tableptr;
499         struct odbc_cache_columns *column = NULL;
500         struct ast_flags connected_flag = { RES_ODBC_CONNECTED };
501
502         if (!table || !field || !keyfield || !sql) {
503                 return -1;
504         }
505
506         tableptr = ast_odbc_find_table(database, table);
507         if (!(obj = ast_odbc_request_obj2(database, connected_flag))) {
508                 ast_odbc_release_table(tableptr);
509                 return -1;
510         }
511
512         if (tableptr && !ast_odbc_find_column(tableptr, keyfield)) {
513                 ast_log(LOG_WARNING, "Key field '%s' does not exist in table '%s@%s'.  Update will fail\n", keyfield, table, database);
514         }
515
516         ast_str_set(&sql, 0, "UPDATE %s SET ", table);
517         while (field) {
518                 if ((tableptr && (column = ast_odbc_find_column(tableptr, field->name))) || count >= 64) {
519                         if (paramcount++) {
520                                 ast_str_append(&sql, 0, ", ");
521                         }
522                         /* NULL test for non-text columns */
523                         if (count < 64 && ast_strlen_zero(field->value) && column->nullable && !is_text(column)) {
524                                 ast_str_append(&sql, 0, "%s=NULL", field->name);
525                                 cps.skip |= (1LL << count);
526                         } else {
527                                 /* Value is not an empty string, or column is of text type, or we couldn't fit any more into cps.skip (count >= 64 ?!). */
528                                 ast_str_append(&sql, 0, "%s=?", field->name);
529                         }
530                 } else { /* the column does not exist in the table */
531                         cps.skip |= (1LL << count);
532                 }
533                 ++count;
534                 field = field->next;
535         }
536         ast_str_append(&sql, 0, " WHERE %s=?", keyfield);
537         ast_odbc_release_table(tableptr);
538
539         cps.sql = ast_str_buffer(sql);
540
541         if (ast_string_field_init(&cps, 256)) {
542                 ast_odbc_release_obj(obj);
543                 return -1;
544         }
545         stmt = ast_odbc_prepare_and_execute(obj, custom_prepare, &cps);
546         ast_string_field_free_memory(&cps);
547
548         if (!stmt) {
549                 ast_odbc_release_obj(obj);
550                 return -1;
551         }
552
553         res = SQLRowCount(stmt, &rowcount);
554         SQLFreeHandle (SQL_HANDLE_STMT, stmt);
555         ast_odbc_release_obj(obj);
556
557         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
558                 ast_log(LOG_WARNING, "SQL Row Count error! [%s]\n", ast_str_buffer(sql));
559                 return -1;
560         }
561
562         if (rowcount >= 0) {
563                 return (int) rowcount;
564         }
565
566         return -1;
567 }
568
569 struct update2_prepare_struct {
570         const char *database;
571         const char *table;
572         const struct ast_variable *lookup_fields;
573         const struct ast_variable *update_fields;
574 };
575
576 static SQLHSTMT update2_prepare(struct odbc_obj *obj, void *data)
577 {
578         int res, x = 1, first = 1;
579         struct update2_prepare_struct *ups = data;
580         const struct ast_variable *field;
581         struct ast_str *sql = ast_str_thread_get(&sql_buf, SQL_BUF_SIZE);
582         SQLHSTMT stmt;
583         struct odbc_cache_tables *tableptr;
584
585         if (!sql) {
586                 return NULL;
587         }
588
589         tableptr = ast_odbc_find_table(ups->database, ups->table);
590         if (!tableptr) {
591                 ast_log(LOG_ERROR, "Could not retrieve metadata for table '%s@%s'.  Update will fail!\n", ups->table, ups->database);
592                 return NULL;
593         }
594
595         res = SQLAllocHandle(SQL_HANDLE_STMT, obj->con, &stmt);
596         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
597                 ast_log(LOG_WARNING, "SQL Alloc Handle failed!\n");
598                 ast_odbc_release_table(tableptr);
599                 return NULL;
600         }
601
602         ast_str_set(&sql, 0, "UPDATE %s SET ", ups->table);
603
604         for (field = ups->update_fields; field; field = field->next) {
605                 if (ast_odbc_find_column(tableptr, field->name)) {
606                         ast_str_append(&sql, 0, "%s%s=? ", first ? "" : ", ", field->name);
607                         SQLBindParameter(stmt, x++, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_CHAR, strlen(field->name), 0, (void *)field->value, 0, NULL);
608                         first = 0;
609                 } else {
610                         ast_log(LOG_NOTICE, "Not updating column '%s' in '%s@%s' because that column does not exist!\n", field->name, ups->table, ups->database);
611                 }
612         }
613
614         ast_str_append(&sql, 0, "WHERE");
615         first = 1;
616
617         for (field = ups->lookup_fields; field; field = field->next) {
618                 if (!ast_odbc_find_column(tableptr, field->name)) {
619                         ast_log(LOG_ERROR, "One or more of the criteria columns '%s' on '%s@%s' for this update does not exist!\n", field->name, ups->table, ups->database);
620                         ast_odbc_release_table(tableptr);
621                         SQLFreeHandle(SQL_HANDLE_STMT, stmt);
622                         return NULL;
623                 }
624                 ast_str_append(&sql, 0, "%s %s=?", first ? "" : " AND", field->name);
625                 SQLBindParameter(stmt, x++, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_CHAR, strlen(field->value), 0, (void *)field->value, 0, NULL);
626                 first = 0;
627         }
628
629         /* Done with the table metadata */
630         ast_odbc_release_table(tableptr);
631
632         res = SQLPrepare(stmt, (unsigned char *)ast_str_buffer(sql), SQL_NTS);
633         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
634                 ast_log(LOG_WARNING, "SQL Prepare failed! [%s]\n", ast_str_buffer(sql));
635                 SQLFreeHandle(SQL_HANDLE_STMT, stmt);
636                 return NULL;
637         }
638
639         return stmt;
640 }
641
642 /*!
643  * \brief Execute an UPDATE query
644  * \param database
645  * \param table
646  * \param ap list containing one or more field/value set(s).
647  *
648  * Update a database table, preparing the sql statement from a list of
649  * key/value pairs specified in ap.  The lookup pairs are specified first
650  * and are separated from the update pairs by a sentinel value.
651  * Sub-in the values to the prepared statement and execute it.
652  *
653  * \retval number of rows affected
654  * \retval -1 on failure
655 */
656 static int update2_odbc(const char *database, const char *table, const struct ast_variable *lookup_fields, const struct ast_variable *update_fields)
657 {
658         struct odbc_obj *obj;
659         SQLHSTMT stmt;
660         struct update2_prepare_struct ups = { .database = database, .table = table, .lookup_fields = lookup_fields, .update_fields = update_fields, };
661         struct ast_str *sql;
662         int res;
663         SQLLEN rowcount = 0;
664
665         if (!(obj = ast_odbc_request_obj(database, 0))) {
666                 return -1;
667         }
668
669         if (!(stmt = ast_odbc_prepare_and_execute(obj, update2_prepare, &ups))) {
670                 ast_odbc_release_obj(obj);
671                 return -1;
672         }
673
674         res = SQLRowCount(stmt, &rowcount);
675         SQLFreeHandle(SQL_HANDLE_STMT, stmt);
676         ast_odbc_release_obj(obj);
677
678         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
679                 /* Since only a single thread can access this memory, we can retrieve what would otherwise be lost. */
680                 sql = ast_str_thread_get(&sql_buf, SQL_BUF_SIZE);
681                 ast_assert(sql != NULL);
682                 ast_log(LOG_WARNING, "SQL Row Count error! [%s]\n", ast_str_buffer(sql));
683                 return -1;
684         }
685
686         if (rowcount >= 0) {
687                 return (int)rowcount;
688         }
689
690         return -1;
691 }
692
693 /*!
694  * \brief Excute an INSERT query
695  * \param database
696  * \param table
697  * \param ap list containing one or more field/value set(s)
698  *
699  * Insert a new record into database table, prepare the sql statement.
700  * All values to be changed are stored in ap list.
701  * Sub-in the values to the prepared statement and execute it.
702  *
703  * \retval number of rows affected
704  * \retval -1 on failure
705  */
706 static int store_odbc(const char *database, const char *table, const struct ast_variable *fields)
707 {
708         struct odbc_obj *obj;
709         SQLHSTMT stmt;
710         SQLLEN rowcount=0;
711         const struct ast_variable *field = fields;
712         struct ast_str *keys;
713         struct ast_str *vals;
714         struct ast_str *sql = ast_str_thread_get(&sql_buf, SQL_BUF_SIZE);
715         int res;
716         struct custom_prepare_struct cps = { .fields = fields, };
717         struct ast_flags connected_flag = { RES_ODBC_CONNECTED };
718
719         keys = ast_str_create(SQL_BUF_SIZE / 2);
720         vals = ast_str_create(SQL_BUF_SIZE / 4);
721         if (!table || !field || !keys || !vals || !sql) {
722                 ast_free(vals);
723                 ast_free(keys);
724                 return -1;
725         }
726
727         obj = ast_odbc_request_obj2(database, connected_flag);
728         if (!obj) {
729                 ast_free(vals);
730                 ast_free(keys);
731                 return -1;
732         }
733
734         ast_str_set(&keys, 0, "%s", field->name);
735         ast_str_set(&vals, 0, "?");
736         while ((field = field->next)) {
737                 ast_str_append(&keys, 0, ", %s", field->name);
738                 ast_str_append(&vals, 0, ", ?");
739         }
740         ast_str_set(&sql, 0, "INSERT INTO %s (%s) VALUES (%s)",
741                 table, ast_str_buffer(keys), ast_str_buffer(vals));
742
743         ast_free(vals);
744         ast_free(keys);
745         cps.sql = ast_str_buffer(sql);
746
747         if (ast_string_field_init(&cps, 256)) {
748                 ast_odbc_release_obj(obj);
749                 return -1;
750         }
751         stmt = ast_odbc_prepare_and_execute(obj, custom_prepare, &cps);
752         ast_string_field_free_memory(&cps);
753
754         if (!stmt) {
755                 ast_odbc_release_obj(obj);
756                 return -1;
757         }
758
759         res = SQLRowCount(stmt, &rowcount);
760         SQLFreeHandle (SQL_HANDLE_STMT, stmt);
761         ast_odbc_release_obj(obj);
762
763         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
764                 ast_log(LOG_WARNING, "SQL Row Count error! [%s]\n", ast_str_buffer(sql));
765                 return -1;
766         }
767
768         if (rowcount >= 0)
769                 return (int)rowcount;
770
771         return -1;
772 }
773
774 /*!
775  * \brief Excute an DELETE query
776  * \param database
777  * \param table
778  * \param keyfield where clause field
779  * \param lookup value of field for where clause
780  * \param ap list containing one or more field/value set(s)
781  *
782  * Delete a row from a database table, prepare the sql statement using keyfield and lookup
783  * control the number of records to change. Additional params to match rows are stored in ap list.
784  * Sub-in the values to the prepared statement and execute it.
785  *
786  * \retval number of rows affected
787  * \retval -1 on failure
788  */
789 static int destroy_odbc(const char *database, const char *table, const char *keyfield, const char *lookup, const struct ast_variable *fields)
790 {
791         struct odbc_obj *obj;
792         SQLHSTMT stmt;
793         SQLLEN rowcount=0;
794         struct ast_str *sql = ast_str_thread_get(&sql_buf, SQL_BUF_SIZE);
795         const struct ast_variable *field;
796         int res;
797         struct custom_prepare_struct cps = { .extra = lookup, .fields = fields, };
798         struct ast_flags connected_flag = { RES_ODBC_CONNECTED };
799
800         if (!table || !sql) {
801                 return -1;
802         }
803
804         obj = ast_odbc_request_obj2(database, connected_flag);
805         if (!obj) {
806                 return -1;
807         }
808
809         ast_str_set(&sql, 0, "DELETE FROM %s WHERE ", table);
810         for (field = fields; field; field = field->next) {
811                 ast_str_append(&sql, 0, "%s=? AND ", field->name);
812         }
813         ast_str_append(&sql, 0, "%s=?", keyfield);
814
815         cps.sql = ast_str_buffer(sql);
816
817         if (ast_string_field_init(&cps, 256)) {
818                 ast_odbc_release_obj(obj);
819                 return -1;
820         }
821         stmt = ast_odbc_prepare_and_execute(obj, custom_prepare, &cps);
822         ast_string_field_free_memory(&cps);
823
824         if (!stmt) {
825                 ast_odbc_release_obj(obj);
826                 return -1;
827         }
828
829         res = SQLRowCount(stmt, &rowcount);
830         SQLFreeHandle (SQL_HANDLE_STMT, stmt);
831         ast_odbc_release_obj(obj);
832
833         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
834                 ast_log(LOG_WARNING, "SQL Row Count error! [%s]\n", ast_str_buffer(sql));
835                 return -1;
836         }
837
838         if (rowcount >= 0)
839                 return (int)rowcount;
840
841         return -1;
842 }
843
844 struct config_odbc_obj {
845         char *sql;
846         unsigned long cat_metric;
847         char category[128];
848         char var_name[128];
849         char *var_val;
850         unsigned long var_val_size;
851         SQLLEN err;
852 };
853
854
855 static SQLHSTMT length_determination_odbc_prepare(struct odbc_obj *obj, void *data)
856 {
857         struct config_odbc_obj *q = data;
858         SQLHSTMT sth;
859         int res;
860
861         res = SQLAllocHandle(SQL_HANDLE_STMT, obj->con, &sth);
862         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
863                 ast_verb(4, "Failure in AllocStatement %d\n", res);
864                 return NULL;
865         }
866
867         res = SQLPrepare(sth, (unsigned char *)q->sql, SQL_NTS);
868         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
869                 ast_verb(4, "Error in PREPARE %d\n", res);
870                 SQLFreeHandle(SQL_HANDLE_STMT, sth);
871                 return NULL;
872         }
873
874         SQLBindCol(sth, 1, SQL_C_ULONG, &q->var_val_size, sizeof(q->var_val_size), &q->err);
875
876         return sth;
877 }
878
879 static SQLHSTMT config_odbc_prepare(struct odbc_obj *obj, void *data)
880 {
881         struct config_odbc_obj *q = data;
882         SQLHSTMT sth;
883         int res;
884
885         res = SQLAllocHandle(SQL_HANDLE_STMT, obj->con, &sth);
886         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
887                 ast_verb(4, "Failure in AllocStatement %d\n", res);
888                 return NULL;
889         }
890
891         res = SQLPrepare(sth, (unsigned char *)q->sql, SQL_NTS);
892         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
893                 ast_verb(4, "Error in PREPARE %d\n", res);
894                 SQLFreeHandle(SQL_HANDLE_STMT, sth);
895                 return NULL;
896         }
897
898         SQLBindCol(sth, 1, SQL_C_ULONG, &q->cat_metric, sizeof(q->cat_metric), &q->err);
899         SQLBindCol(sth, 2, SQL_C_CHAR, q->category, sizeof(q->category), &q->err);
900         SQLBindCol(sth, 3, SQL_C_CHAR, q->var_name, sizeof(q->var_name), &q->err);
901         SQLBindCol(sth, 4, SQL_C_CHAR, q->var_val, q->var_val_size, &q->err);
902
903         return sth;
904 }
905
906 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, const char *who_asked)
907 {
908         struct ast_variable *new_v;
909         struct ast_category *cur_cat;
910         int res = 0;
911         struct odbc_obj *obj;
912         struct ast_str *sql = ast_str_thread_get(&sql_buf, SQL_BUF_SIZE);
913         unsigned int last_cat_metric = 0;
914         SQLSMALLINT rowcount = 0;
915         SQLHSTMT stmt;
916         char last[128] = "";
917         struct config_odbc_obj q;
918         struct ast_flags loader_flags = { 0 };
919         struct ast_flags connected_flag = { RES_ODBC_CONNECTED };
920
921         memset(&q, 0, sizeof(q));
922
923         if (!file || !strcmp (file, "res_config_odbc.conf") || !sql) {
924                 return NULL;            /* cant configure myself with myself ! */
925         }
926
927         obj = ast_odbc_request_obj2(database, connected_flag);
928         if (!obj)
929                 return NULL;
930
931         ast_str_set(&sql, 0, "SELECT MAX(LENGTH(var_val)) FROM %s WHERE filename='%s'",
932                 table, file);
933         q.sql = ast_str_buffer(sql);
934
935         stmt = ast_odbc_prepare_and_execute(obj, length_determination_odbc_prepare, &q);
936         if (!stmt) {
937                 ast_log(LOG_WARNING, "SQL select error! [%s]\n", ast_str_buffer(sql));
938                 ast_odbc_release_obj(obj);
939                 return NULL;
940         }
941
942         res = SQLNumResultCols(stmt, &rowcount);
943
944         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
945                 ast_log(LOG_WARNING, "SQL NumResultCols error! [%s]\n", ast_str_buffer(sql));
946                 SQLFreeHandle(SQL_HANDLE_STMT, stmt);
947                 ast_odbc_release_obj(obj);
948                 return NULL;
949         }
950
951         if (!rowcount) {
952                 ast_log(LOG_NOTICE, "found nothing\n");
953                 ast_odbc_release_obj(obj);
954                 return cfg;
955         }
956
957         /* There will be only one result for this, the maximum length of a variable value */
958         if (SQLFetch(stmt) == SQL_NO_DATA) {
959                 ast_log(LOG_NOTICE, "Failed to determine maximum length of a configuration value\n");
960                 SQLFreeHandle(SQL_HANDLE_STMT, stmt);
961                 ast_odbc_release_obj(obj);
962                 return NULL;
963         }
964
965         /* Reset stuff to a fresh state for the actual query which will retrieve all configuration */
966         SQLFreeHandle(SQL_HANDLE_STMT, stmt);
967
968         ast_str_set(&sql, 0, "SELECT cat_metric, category, var_name, var_val FROM %s ", table);
969         ast_str_append(&sql, 0, "WHERE filename='%s' AND commented=0 ", file);
970         ast_str_append(&sql, 0, "ORDER BY cat_metric DESC, var_metric ASC, category, var_name ");
971         q.sql = ast_str_buffer(sql);
972
973         q.var_val_size += 1;
974         q.var_val = ast_malloc(q.var_val_size);
975         if (!q.var_val) {
976                 ast_log(LOG_WARNING, "Could not create buffer for reading in configuration values for '%s'\n", file);
977                 ast_odbc_release_obj(obj);
978                 return NULL;
979         }
980
981         stmt = ast_odbc_prepare_and_execute(obj, config_odbc_prepare, &q);
982         if (!stmt) {
983                 ast_log(LOG_WARNING, "SQL select error! [%s]\n", ast_str_buffer(sql));
984                 ast_odbc_release_obj(obj);
985                 ast_free(q.var_val);
986                 return NULL;
987         }
988
989         res = SQLNumResultCols(stmt, &rowcount);
990
991         if ((res != SQL_SUCCESS) && (res != SQL_SUCCESS_WITH_INFO)) {
992                 ast_log(LOG_WARNING, "SQL NumResultCols error! [%s]\n", ast_str_buffer(sql));
993                 SQLFreeHandle(SQL_HANDLE_STMT, stmt);
994                 ast_odbc_release_obj(obj);
995                 ast_free(q.var_val);
996                 return NULL;
997         }
998
999         if (!rowcount) {
1000                 ast_log(LOG_NOTICE, "found nothing\n");
1001                 ast_odbc_release_obj(obj);
1002                 ast_free(q.var_val);
1003                 return cfg;
1004         }
1005
1006         cur_cat = ast_config_get_current_category(cfg);
1007
1008         while ((res = SQLFetch(stmt)) != SQL_NO_DATA) {
1009                 if (!strcmp (q.var_name, "#include")) {
1010                         if (!ast_config_internal_load(q.var_val, cfg, loader_flags, "", who_asked)) {
1011                                 SQLFreeHandle(SQL_HANDLE_STMT, stmt);
1012                                 ast_odbc_release_obj(obj);
1013                                 ast_free(q.var_val);
1014                                 return NULL;
1015                         }
1016                         continue;
1017                 }
1018                 if (strcmp(last, q.category) || last_cat_metric != q.cat_metric) {
1019                         cur_cat = ast_category_new_dynamic(q.category);
1020                         if (!cur_cat) {
1021                                 break;
1022                         }
1023                         strcpy(last, q.category);
1024                         last_cat_metric = q.cat_metric;
1025                         ast_category_append(cfg, cur_cat);
1026                 }
1027
1028                 new_v = ast_variable_new(q.var_name, q.var_val, "");
1029                 ast_variable_append(cur_cat, new_v);
1030         }
1031
1032         SQLFreeHandle(SQL_HANDLE_STMT, stmt);
1033         ast_odbc_release_obj(obj);
1034         ast_free(q.var_val);
1035         return cfg;
1036 }
1037
1038 #define warn_length(col, size)  ast_log(LOG_WARNING, "Realtime table %s@%s: column '%s' is not long enough to contain realtime data (needs %d)\n", table, database, col->name, size)
1039 #define warn_type(col, type)    ast_log(LOG_WARNING, "Realtime table %s@%s: column '%s' is of the incorrect type (%d) to contain the required realtime data\n", table, database, col->name, col->type)
1040
1041 static int require_odbc(const char *database, const char *table, va_list ap)
1042 {
1043         struct odbc_cache_tables *tableptr = ast_odbc_find_table(database, table);
1044         struct odbc_cache_columns *col;
1045         char *elm;
1046         int type, size;
1047
1048         if (!tableptr) {
1049                 return -1;
1050         }
1051
1052         while ((elm = va_arg(ap, char *))) {
1053                 type = va_arg(ap, require_type);
1054                 size = va_arg(ap, int);
1055                 /* Check if the field matches the criteria */
1056                 AST_RWLIST_TRAVERSE(&tableptr->columns, col, list) {
1057                         if (strcmp(col->name, elm) == 0) {
1058                                 /* Type check, first.  Some fields are more particular than others */
1059                                 switch (col->type) {
1060                                 case SQL_CHAR:
1061                                 case SQL_VARCHAR:
1062                                 case SQL_LONGVARCHAR:
1063 #ifdef HAVE_ODBC_WCHAR
1064                                 case SQL_WCHAR:
1065                                 case SQL_WVARCHAR:
1066                                 case SQL_WLONGVARCHAR:
1067 #endif
1068                                 case SQL_BINARY:
1069                                 case SQL_VARBINARY:
1070                                 case SQL_LONGVARBINARY:
1071                                 case SQL_GUID:
1072 #define CHECK_SIZE(n) \
1073                                                 if (col->size < n) {      \
1074                                                         warn_length(col, n);  \
1075                                                 }                         \
1076                                                 break;
1077                                         switch (type) {
1078                                         case RQ_UINTEGER1: CHECK_SIZE(3)  /*         255 */
1079                                         case RQ_INTEGER1:  CHECK_SIZE(4)  /*        -128 */
1080                                         case RQ_UINTEGER2: CHECK_SIZE(5)  /*       65535 */
1081                                         case RQ_INTEGER2:  CHECK_SIZE(6)  /*      -32768 */
1082                                         case RQ_UINTEGER3:                /*    16777215 */
1083                                         case RQ_INTEGER3:  CHECK_SIZE(8)  /*    -8388608 */
1084                                         case RQ_DATE:                     /*  2008-06-09 */
1085                                         case RQ_UINTEGER4: CHECK_SIZE(10) /*  4200000000 */
1086                                         case RQ_INTEGER4:  CHECK_SIZE(11) /* -2100000000 */
1087                                         case RQ_DATETIME:                 /* 2008-06-09 16:03:47 */
1088                                         case RQ_UINTEGER8: CHECK_SIZE(19) /* trust me    */
1089                                         case RQ_INTEGER8:  CHECK_SIZE(20) /* ditto       */
1090                                         case RQ_FLOAT:
1091                                         case RQ_CHAR:      CHECK_SIZE(size)
1092                                         }
1093 #undef CHECK_SIZE
1094                                         break;
1095                                 case SQL_TYPE_DATE:
1096                                         if (type != RQ_DATE) {
1097                                                 warn_type(col, type);
1098                                         }
1099                                         break;
1100                                 case SQL_TYPE_TIMESTAMP:
1101                                 case SQL_TIMESTAMP:
1102                                         if (type != RQ_DATE && type != RQ_DATETIME) {
1103                                                 warn_type(col, type);
1104                                         }
1105                                         break;
1106                                 case SQL_BIT:
1107                                         warn_length(col, size);
1108                                         break;
1109 #define WARN_TYPE_OR_LENGTH(n)  \
1110                                                 if (!ast_rq_is_int(type)) {  \
1111                                                         warn_type(col, type);    \
1112                                                 } else {                     \
1113                                                         warn_length(col, n);  \
1114                                                 }
1115                                 case SQL_TINYINT:
1116                                         if (type != RQ_UINTEGER1) {
1117                                                 WARN_TYPE_OR_LENGTH(size)
1118                                         }
1119                                         break;
1120                                 case SQL_C_STINYINT:
1121                                         if (type != RQ_INTEGER1) {
1122                                                 WARN_TYPE_OR_LENGTH(size)
1123                                         }
1124                                         break;
1125                                 case SQL_C_USHORT:
1126                                         if (type != RQ_UINTEGER1 && type != RQ_INTEGER1 && type != RQ_UINTEGER2) {
1127                                                 WARN_TYPE_OR_LENGTH(size)
1128                                         }
1129                                         break;
1130                                 case SQL_SMALLINT:
1131                                 case SQL_C_SSHORT:
1132                                         if (type != RQ_UINTEGER1 && type != RQ_INTEGER1 && type != RQ_INTEGER2) {
1133                                                 WARN_TYPE_OR_LENGTH(size)
1134                                         }
1135                                         break;
1136                                 case SQL_C_ULONG:
1137                                         if (type != RQ_UINTEGER1 && type != RQ_INTEGER1 &&
1138                                                 type != RQ_UINTEGER2 && type != RQ_INTEGER2 &&
1139                                                 type != RQ_UINTEGER3 && type != RQ_INTEGER3 &&
1140                                                 type != RQ_INTEGER4) {
1141                                                 WARN_TYPE_OR_LENGTH(size)
1142                                         }
1143                                         break;
1144                                 case SQL_INTEGER:
1145                                 case SQL_C_SLONG:
1146                                         if (type != RQ_UINTEGER1 && type != RQ_INTEGER1 &&
1147                                                 type != RQ_UINTEGER2 && type != RQ_INTEGER2 &&
1148                                                 type != RQ_UINTEGER3 && type != RQ_INTEGER3 &&
1149                                                 type != RQ_INTEGER4) {
1150                                                 WARN_TYPE_OR_LENGTH(size)
1151                                         }
1152                                         break;
1153                                 case SQL_C_UBIGINT:
1154                                         if (type != RQ_UINTEGER1 && type != RQ_INTEGER1 &&
1155                                                 type != RQ_UINTEGER2 && type != RQ_INTEGER2 &&
1156                                                 type != RQ_UINTEGER3 && type != RQ_INTEGER3 &&
1157                                                 type != RQ_UINTEGER4 && type != RQ_INTEGER4 &&
1158                                                 type != RQ_INTEGER8) {
1159                                                 WARN_TYPE_OR_LENGTH(size)
1160                                         }
1161                                         break;
1162                                 case SQL_BIGINT:
1163                                 case SQL_C_SBIGINT:
1164                                         if (type != RQ_UINTEGER1 && type != RQ_INTEGER1 &&
1165                                                 type != RQ_UINTEGER2 && type != RQ_INTEGER2 &&
1166                                                 type != RQ_UINTEGER3 && type != RQ_INTEGER3 &&
1167                                                 type != RQ_UINTEGER4 && type != RQ_INTEGER4 &&
1168                                                 type != RQ_INTEGER8) {
1169                                                 WARN_TYPE_OR_LENGTH(size)
1170                                         }
1171                                         break;
1172 #undef WARN_TYPE_OR_LENGTH
1173                                 case SQL_NUMERIC:
1174                                 case SQL_DECIMAL:
1175                                 case SQL_FLOAT:
1176                                 case SQL_REAL:
1177                                 case SQL_DOUBLE:
1178                                         if (!ast_rq_is_int(type) && type != RQ_FLOAT) {
1179                                                 warn_type(col, type);
1180                                         }
1181                                         break;
1182                                 default:
1183                                         ast_log(LOG_WARNING, "Realtime table %s@%s: column type (%d) unrecognized for column '%s'\n", table, database, col->type, elm);
1184                                 }
1185                                 break;
1186                         }
1187                 }
1188                 if (!col) {
1189                         ast_log(LOG_WARNING, "Realtime table %s@%s requires column '%s', but that column does not exist!\n", table, database, elm);
1190                 }
1191         }
1192         AST_RWLIST_UNLOCK(&tableptr->columns);
1193         return 0;
1194 }
1195 #undef warn_length
1196 #undef warn_type
1197
1198 static int unload_odbc(const char *a, const char *b)
1199 {
1200         return ast_odbc_clear_cache(a, b);
1201 }
1202
1203 static struct ast_config_engine odbc_engine = {
1204         .name = "odbc",
1205         .load_func = config_odbc,
1206         .realtime_func = realtime_odbc,
1207         .realtime_multi_func = realtime_multi_odbc,
1208         .store_func = store_odbc,
1209         .destroy_func = destroy_odbc,
1210         .update_func = update_odbc,
1211         .update2_func = update2_odbc,
1212         .require_func = require_odbc,
1213         .unload_func = unload_odbc,
1214 };
1215
1216 static int unload_module (void)
1217 {
1218         ast_config_engine_deregister(&odbc_engine);
1219
1220         return 0;
1221 }
1222
1223 static int load_module (void)
1224 {
1225         ast_config_engine_register(&odbc_engine);
1226
1227         return 0;
1228 }
1229
1230 static int reload_module(void)
1231 {
1232         return 0;
1233 }
1234
1235 AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_LOAD_ORDER, "Realtime ODBC configuration",
1236         .support_level = AST_MODULE_SUPPORT_CORE,
1237         .load = load_module,
1238         .unload = unload_module,
1239         .reload = reload_module,
1240         .load_pri = AST_MODPRI_REALTIME_DRIVER,
1241 );