Merge of kamaililo db_mysql module history into the sip-router tree.

This is a merge of the full history of the kamailio db_mysql module into the
git tree of the sip-router project. The purpose of the merge is to preserve
full history from kamailio svn also in the git repository.

The module db_mysql already exists in the sip-router tree, it contains the
sources merged from SER cvs (so called version 2 of the module). To avoid file
conflicts we renamed all files that have been imported from kamailio svn and
they are prefixed with km_.

Further integration with existing db_mysql module will be commited on top of
this merge.

* my_filtered: (45 commits)
  - fixed auto_reconnect c&p error
  - add one DBG log to each drivers error condition, that the mem is freed
  - fix one DBG msg (still using module prefix), two small indention fixes
  - partial revert of commit rev5359 for db_mysql module
  - add group functionality to read content from specified sections
  - unify common rows and row allocation functionality in the DB API core
  - change behaviour of db_str2val, this now copy strings
  - move db_mysql and db_unixodbc str2val implementation to the DB core,
  - fix a few errors in doxygen documentation
  - add a comment about the NULL value behaviour of libmysql
  - docs extension: explain fetch_result functionality better to prevent errors
  - remove not reached return statement at the end of val2str functions
  - initial support for BIGINT database in DB core and SQL based database
  - evaluate DECIMAL (and NEW_DECIMAL) type a DB_STRING, and not DB_INT
  - fixed compile error - MYSQL_TYPE_NEWDECIMAL date type is supported
  - fix link entity names, patch from Carsten Gross
  - port from opensips r4526, credits goes to bogdan
  - regenerated all READMEs (make modules-readme exclude_modules="")
  - renaming: changed entities in documentation
  - renaming: openser -> kamailio
  ...

modules/db_mysql/km_Makefile

@@ -0,0 +1,41 @@
+# $Id$
+#
+# WARNING: do not run this directly, it should be run by the master Makefile
+
+include ../../Makefile.defs
+auto_gen=
+NAME=db_mysql.so
+
+# set CROSS_COMPILE to true if you want to skip
+# the autodetection
+# CROSS_COMPILE=true
+
+ifeq ($(CROSS_COMPILE),)
+MYSQLCFG=$(shell which mysql_config)
+endif
+
+ifneq ($(MYSQLCFG),)
+
+	# use autodetection
+	DEFS += $(shell $(MYSQLCFG) --include | sed 's/\(-I.*\)\/mysql/\1/g' )
+	LIBS = $(shell $(MYSQLCFG) --libs)
+
+else
+
+	# use standard know paths
+	# mysql.h locations (freebsd,openbsd  solaris)
+	DEFS +=-I$(LOCALBASE)/include -I$(LOCALBASE)/include/mysql \
+		-I$(LOCALBASE)/mysql/include/mysql -I$(LOCALBASE)/mysql/include \
+		-I$(SYSBASE)/include/mysql
+
+	# libmysqlclient locations on RH/Suse, Solaris /OpenBSD, FreeBSD
+	# (Debian does the right thing and puts it in /usr/lib)
+	LIBS=-L$(SYSBASE)/lib/mysql -L$(LOCALBASE)/lib -L$(LOCALBASE)/lib/mysql \
+		-L$(LOCALBASE)/mysql/lib/mysql/ \
+		-L$(LOCALBASE)/mysql/lib \
+		-L$(SYSBASE)/lib64/mysql \
+		-lm -lmysqlclient -lz
+
+endif
+
+include ../../Makefile.modules

modules/db_mysql/km_README

@@ -0,0 +1,171 @@
+mysql Module
+
+Daniel-Constantin Mierla
+
+   <[email protected]>
+
+Edited by
+
+Daniel-Constantin Mierla
+
+   <[email protected]>
+
+   Copyright © 2006 voice-system.ro
+     __________________________________________________________
+
+   Table of Contents
+
+   1. Admin Guide
+
+        1.1. Overview
+        1.2. Dependencies
+
+              1.2.1. Kamailio Modules
+              1.2.2. External Libraries or Applications
+
+        1.3. Exported Parameters
+
+              1.3.1. ping_interval (integer)
+              1.3.2. timeout_interval (integer)
+              1.3.3. auto_reconnect (integer)
+
+        1.4. Exported Functions
+        1.5. Installation
+        1.6. Reading configuration from my.cnf
+
+   List of Examples
+
+   1.1. Set ping_interval parameter
+   1.2. Set timeout_interval parameter
+   1.3. Set auto_reconnect parameter
+   1.4. Set a my.cnf group in db_url parameter
+   1.5. Adding a kamailio group to my.cnf
+   1.6. Using [client] and specific group
+
+Chapter 1. Admin Guide
+
+1.1. Overview
+
+   This is a module which provides MySQL connectivity for
+   Kamailio. It implements the DB API defined in Kamailio.
+
+1.2. Dependencies
+
+1.2.1. Kamailio Modules
+
+   The following modules must be loaded before this module:
+     * No dependencies on other Kamailio modules.
+
+1.2.2. External Libraries or Applications
+
+   The following libraries or applications must be installed
+   before running Kamailio with this module loaded:
+     * mysql - the development libraries forthe Mysql database. In
+       some Linux distributions named "libmysqlclient-dev".
+
+1.3. Exported Parameters
+
+1.3.1. ping_interval (integer)
+
+   Time interval in seconds to send ping messages to MySQL server
+   in order to keep the connection open.
+
+   Default value is 300 (5 min).
+
+   Example 1.1. Set ping_interval parameter
+...
+modparam("db_mysql", "ping_interval", 600)
+...
+
+1.3.2. timeout_interval (integer)
+
+   Time interval (in seconds) after that an connection attempt,
+   read or write request is aborted. The value counts three times,
+   as several retries are done from the driver before it gives up.
+
+   The read timeout parameter is ignored on MySQL driver versions
+   prior to "5.1.12", "5.0.25" and "4.1.22". The write timeout
+   parameter is ignored on versions prior to "5.1.12" and
+   "5.0.25", the "4.1" release don't support it at all.
+
+   Default value is 2 (6 sec).
+
+   Example 1.2. Set timeout_interval parameter
+...
+modparam("db_mysql", "timeout_interval", 2)
+...
+
+1.3.3. auto_reconnect (integer)
+
+   Configure whether the module should automatically reconnect to
+   MySQL server if the connection was lost.
+
+   Default value is 1 (1 - on / 0 - off).
+
+   Example 1.3. Set auto_reconnect parameter
+...
+modparam("db_mysql", "auto_reconnect", 0)
+...
+
+1.4. Exported Functions
+
+   No function exported to be used from configuration file.
+
+1.5. Installation
+
+   Because it dependes on an external library, the mysql module is
+   not compiled and installed by default. You can use one of these
+   options.
+     * - edit the "Makefile" and remove "db_mysql" from
+       "excluded_modules" list. Then follow the standard procedure
+       to install Kamailio: "make all; make install".
+     * - from command line use: 'make all
+       include_modules="db_mysql"; make install
+       include_modules="db_mysql"'.
+
+1.6. Reading configuration from my.cnf
+
+   In order to take into account specific mysql client options, a
+   my.cnf config group can be passed using the db_url module
+   parameter. This is done by setting [group] in front of or
+   instead of the host part. The following examples are valid
+   db_url definitions, which include a my.cnf group:
+     * mysql://user:pass@[group]host:port/db
+     * mysql://user:pass@[group]:port/db
+     * mysql://user:pass@[group]/db
+     * mysql://[group]/db
+
+   Example 1.4. Set a my.cnf group in db_url parameter
+...
+modparam("usrloc", "db_url", "mysql://[kamailio]/kamailio)
+...
+
+   Example 1.5. Adding a kamailio group to my.cnf
+...
+[kamailio]
+socket = /path/to/mysql.sock
+user = kamailiouser
+password = kamailiopass
+default-character-set = utf8
+...
+
+   In addition to the given group, also the [client] section is
+   read, in the order given in my.cnf. So if you for example
+   specify a socket in both your specific group and the client
+   group, then the value is taken from the last one.
+
+   Example 1.6. Using [client] and specific group
+...
+[client]
+socket = /var/run/mysql/mysqld.sock
+
+[kamailio]
+socket = /path/to/mysqld.sock
+user = kamailiouser
+password = kamailiopass
+default-character-set = utf8
+...
+
+   In the example given above, the socket /path/to/mysqld.sock is
+   used by Kamailio because both [kamailio] and [client] define
+   this option, and the latter overwrites the first.

modules/db_mysql/km_db_mysql.c

@@ -0,0 +1,126 @@
+/* 
+ * $Id$ 
+ *
+ * MySQL module interface
+ *
+ * Copyright (C) 2001-2003 FhG Fokus
+ * Copyright (C) 2008 1&1 Internet AG
+ *
+ * This file is part of Kamailio, a free SIP server.
+ *
+ * Kamailio is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version
+ *
+ * Kamailio is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License 
+ * along with this program; if not, write to the Free Software 
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+/*
+ * History:
+ * --------
+ *  2003-03-11  updated to the new module exports interface (andrei)
+ *  2003-03-16  flags export parameter added (janakj)
+ */
+
+/*! \file
+ *  \brief DB_MYSQL :: Core
+ *  \ingroup db_mysql
+ *  Module: \ref db_mysql
+ */
+
+/*! \defgroup db_mysql DB_MYSQL :: the MySQL driver for Kamailio
+ *  \brief The Kamailio database interface to the MySQL database
+ *  - http://www.mysql.org
+ *
+ */
+
+#include "../../sr_module.h"
+#include "../../db/db.h"
+#include "dbase.h"
+#include "db_mysql.h"
+
+#include <mysql/mysql.h>
+
+unsigned int db_mysql_ping_interval = 5 * 60; /* Default is 5 minutes */
+unsigned int db_mysql_timeout_interval = 2;   /* Default is 6 seconds */
+unsigned int db_mysql_auto_reconnect = 1;     /* Default is enabled   */
+
+static int mysql_mod_init(void);
+
+MODULE_VERSION
+
+int db_mysql_bind_api(db_func_t *dbb);
+
+/*! \brief
+ * MySQL database module interface
+ */
+static cmd_export_t cmds[] = {
+	{"db_bind_api",         (cmd_function)db_mysql_bind_api,      0, 0, 0, 0},
+	{0, 0, 0, 0, 0, 0}
+};
+
+
+/*! \brief
+ * Exported parameters
+ */
+static param_export_t params[] = {
+	{"ping_interval",    INT_PARAM, &db_mysql_ping_interval},
+	{"timeout_interval", INT_PARAM, &db_mysql_timeout_interval},
+	{"auto_reconnect",   INT_PARAM, &db_mysql_auto_reconnect},
+	{0, 0, 0}
+};
+
+
+struct module_exports exports = {	
+	"db_mysql",
+	DEFAULT_DLFLAGS, /* dlopen flags */
+	cmds,
+	params,          /*  module parameters */
+	0,               /* exported statistics */
+	0,               /* exported MI functions */
+	0,               /* exported pseudo-variables */
+	0,               /* extra processes */
+	mysql_mod_init,  /* module initialization function */
+	0,               /* response function*/
+	0,               /* destroy function */
+	0                /* per-child init function */
+};
+
+
+static int mysql_mod_init(void)
+{
+	LM_DBG("MySQL client version is %s\n", mysql_get_client_info());
+	return 0;
+}
+
+int db_mysql_bind_api(db_func_t *dbb)
+{
+	if(dbb==NULL)
+		return -1;
+
+	memset(dbb, 0, sizeof(db_func_t));
+
+	dbb->use_table        = db_mysql_use_table;
+	dbb->init             = db_mysql_init;
+	dbb->close            = db_mysql_close;
+	dbb->query            = db_mysql_query;
+	dbb->fetch_result     = db_mysql_fetch_result;
+	dbb->raw_query        = db_mysql_raw_query;
+	dbb->free_result      = db_mysql_free_result;
+	dbb->insert           = db_mysql_insert;
+	dbb->delete           = db_mysql_delete;
+	dbb->update           = db_mysql_update;
+	dbb->replace          = db_mysql_replace;
+	dbb->last_inserted_id = db_last_inserted_id;
+	dbb->insert_update    = db_insert_update;
+
+	return 0;
+}
+

modules/db_mysql/km_db_mysql.h

@@ -0,0 +1,45 @@
+/* 
+ * $Id$ 
+ *
+ * MySQL module interface
+ *
+ * Copyright (C) 2001-2003 FhG Fokus
+ * Copyright (C) 2008 1&1 Internet AG
+ *
+ * This file is part of Kamailio, a free SIP server.
+ *
+ * Kamailio is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version
+ *
+ * Kamailio is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License 
+ * along with this program; if not, write to the Free Software 
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ * History:
+ * --------
+ *  2003-03-11  updated to the new module exports interface (andrei)
+ *  2003-03-16  flags export parameter added (janakj)
+ */
+
+/*! \file
+ *  \brief DB_MYSQL :: Core
+ *  \ingroup db_mysql
+ *  Module: \ref db_mysql
+ */
+
+
+#ifndef DB_MOD_H
+#define DB_MOD_H
+
+extern unsigned int db_mysql_ping_interval;
+extern unsigned int db_mysql_timeout_interval;
+extern unsigned int db_mysql_auto_reconnect;
+
+#endif /* DB_MOD_H */

modules/db_mysql/km_dbase.c

@@ -0,0 +1,536 @@
+/* 
+ * $Id$ 
+ *
+ * MySQL module core functions
+ *
+ * Copyright (C) 2001-2003 FhG Fokus
+ * Copyright (C) 2007-2008 1&1 Internet AG
+ *
+ * This file is part of Kamailio, a free SIP server.
+ *
+ * Kamailio is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version
+ *
+ * Kamailio is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License 
+ * along with this program; if not, write to the Free Software 
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+/*!
+ * \file
+ * \brief Implementation of core functions for the MySQL driver.
+ *
+ * This file contains the implementation of core functions for the MySQL
+ * database driver, for example to submit a query or fetch a result.
+ * \ingroup db_mysql
+ *  Module: \ref db_mysql
+ */
+
+#include <stdio.h>
+#include <string.h>
+#include <mysql/mysql.h>
+#include <mysql/errmsg.h>
+#include <mysql/mysql_version.h>
+#include "../../mem/mem.h"
+#include "../../dprint.h"
+#include "../../db/db_query.h"
+#include "../../db/db_ut.h"
+#include "val.h"
+#include "my_con.h"
+#include "res.h"
+#include "row.h"
+#include "db_mysql.h"
+#include "dbase.h"
+
+
+/**
+ * \brief Send a SQL query to the server.
+ *
+ * Send a SQL query to the database server. This methods tries to reconnect
+ * to the server if the connection is gone and the auto_reconnect parameter is
+ * enabled. It also issues a mysql_ping before the query to connect again after
+ * a long waiting period because for some older mysql versions the auto reconnect
+ * don't work sufficient. If auto_reconnect is enabled and the server supports it,
+ * then the mysql_ping is probably not necessary, but its safer to do it in this
+ * cases too.
+ *
+ * \param _h handle for the db
+ * \param _s executed query
+ * \return zero on success, negative value on failure
+ */
+static int db_mysql_submit_query(const db_con_t* _h, const str* _s)
+{	
+	time_t t;
+	int i, code;
+
+	if (!_h || !_s || !_s->s) {
+		LM_ERR("invalid parameter value\n");
+		return -1;
+	}
+
+	if (db_mysql_ping_interval) {
+		t = time(0);
+		if ((t - CON_TIMESTAMP(_h)) > db_mysql_ping_interval) {
+			if (mysql_ping(CON_CONNECTION(_h))) {
+				LM_WARN("driver error on ping: %s\n", mysql_error(CON_CONNECTION(_h)));
+			}
+		}
+		/*
+		 * We're doing later a query anyway that will reset the timout of the server,
+		 * so it makes sense to set the timestamp value to the actual time in order
+		 * to prevent unnecessary pings.
+		 */
+		CON_TIMESTAMP(_h) = t;
+	}
+
+	/* screws up the terminal when the query contains a BLOB :-( (by bogdan)
+	 * LM_DBG("submit_query(): %.*s\n", _s->len, _s->s);
+	 */
+
+	/* When a server connection is lost and a query is attempted, most of
+	 * the time the query will return a CR_SERVER_LOST, then at the second
+	 * attempt to execute it, the mysql lib will reconnect and succeed.
+	 * However is a few cases, the first attempt returns CR_SERVER_GONE_ERROR
+	 * the second CR_SERVER_LOST and only the third succeeds.
+	 * Thus the 3 in the loop count. Increasing the loop count over this
+	 * value shouldn't be needed, but it doesn't hurt either, since the loop
+	 * will most of the time stop at the second or sometimes at the third
+	 * iteration.
+	 */
+	for (i=0; i < (db_mysql_auto_reconnect ? 3 : 1); i++) {
+		if (mysql_real_query(CON_CONNECTION(_h), _s->s, _s->len) == 0) {
+			return 0;
+		}
+		code = mysql_errno(CON_CONNECTION(_h));
+		if (code != CR_SERVER_GONE_ERROR && code != CR_SERVER_LOST) {
+			break;
+		}
+	}
+	LM_ERR("driver error on query: %s\n", mysql_error(CON_CONNECTION(_h)));
+	return -2;
+}
+
+
+
+/**
+ * Initialize the database module.
+ * No function should be called before this
+ * \param _url URL used for initialization
+ * \return zero on success, negative value on failure
+ */
+db_con_t* db_mysql_init(const str* _url)
+{
+	return db_do_init(_url, (void *)db_mysql_new_connection);
+}
+
+
+/**
+ * Shut down the database module.
+ * No function should be called after this
+ * \param _h handle to the closed connection
+ * \return zero on success, negative value on failure
+ */
+void db_mysql_close(db_con_t* _h)
+{
+	db_do_close(_h, db_mysql_free_connection);
+}
+
+
+/**
+ * Retrieve a result set
+ * \param _h handle to the database
+ * \param _r result set that should be retrieved
+ * \return zero on success, negative value on failure
+ */
+static int db_mysql_store_result(const db_con_t* _h, db_res_t** _r)
+{
+	if ((!_h) || (!_r)) {
+		LM_ERR("invalid parameter value\n");
+		return -1;
+	}
+
+	*_r = db_new_result();
+	if (*_r == 0) {
+		LM_ERR("no memory left\n");
+		return -2;
+	}
+
+	CON_RESULT(_h) = mysql_store_result(CON_CONNECTION(_h));
+	if (!CON_RESULT(_h)) {
+		if (mysql_field_count(CON_CONNECTION(_h)) == 0) {
+			(*_r)->col.n = 0;
+			(*_r)->n = 0;
+			goto done;
+		} else {
+			LM_ERR("driver error: %s\n", mysql_error(CON_CONNECTION(_h)));
+			db_free_result(*_r);
+			*_r = 0;
+			return -3;
+		}
+	}
+
+	if (db_mysql_convert_result(_h, *_r) < 0) {
+		LM_ERR("error while converting result\n");
+		LM_DBG("freeing result set at %p\n", _r);
+		pkg_free(*_r);
+		*_r = 0;
+		/* all mem on openser API side is already freed by
+		 * db_mysql_convert_result in case of error, but we also need
+		 * to free the mem from the mysql lib side */
+		mysql_free_result(CON_RESULT(_h));
+#if (MYSQL_VERSION_ID >= 40100)
+		while( mysql_next_result( CON_CONNECTION(_h) ) > 0 ) {
+			MYSQL_RES *res = mysql_store_result( CON_CONNECTION(_h) );
+			mysql_free_result(res);
+		}
+#endif
+		CON_RESULT(_h) = 0;
+		return -4;
+	}
+
+done:
+#if (MYSQL_VERSION_ID >= 40100)
+	while( mysql_next_result( CON_CONNECTION(_h) ) > 0 ) {
+		MYSQL_RES *res = mysql_store_result( CON_CONNECTION(_h) );
+		mysql_free_result(res);
+	}
+#endif
+
+	return 0;
+}
+
+
+/**
+ * Release a result set from memory.
+ * \param _h handle to the database
+ * \param _r result set that should be freed
+ * \return zero on success, negative value on failure
+ */
+int db_mysql_free_result(db_con_t* _h, db_res_t* _r)
+{
+     if ((!_h) || (!_r)) {
+	     LM_ERR("invalid parameter value\n");
+	     return -1;
+     }
+
+     if (db_free_result(_r) < 0) {
+	     LM_ERR("unable to free result structure\n");
+	     return -1;
+     }
+     mysql_free_result(CON_RESULT(_h));
+     CON_RESULT(_h) = 0;
+     return 0;
+}
+
+
+/**
+ * Query a table for specified rows.
+ * \param _h structure representing database connection
+ * \param _k key names
+ * \param _op operators
+ *\param  _v values of the keys that must match
+ * \param _c column names to return
+ * \param _n number of key=values pairs to compare
+ * \param _nc number of columns to return
+ * \param _o order by the specified column
+ * \param _r pointer to a structure representing the result
+ * \return zero on success, negative value on failure
+ */
+int db_mysql_query(const db_con_t* _h, const db_key_t* _k, const db_op_t* _op,
+	     const db_val_t* _v, const db_key_t* _c, const int _n, const int _nc,
+	     const db_key_t _o, db_res_t** _r)
+{
+	return db_do_query(_h, _k, _op, _v, _c, _n, _nc, _o, _r,
+	db_mysql_val2str, db_mysql_submit_query, db_mysql_store_result);
+}
+
+/**
+ * \brief Gets a partial result set, fetch rows from a result
+ *
+ * Gets a partial result set, fetch a number of rows from a database result.
+ * This function initialize the given result structure on the first run, and
+ * fetches the nrows number of rows. On subsequenting runs, it uses the
+ * existing result and fetches more rows, until it reaches the end of the
+ * result set. Because of this the result needs to be null in the first
+ * invocation of the function. If the number of wanted rows is zero, the
+ * function returns anything with a result of zero.
+ * \param _h structure representing the database connection
+ * \param _r pointer to a structure representing the result
+ * \param nrows number of fetched rows
+ * \return zero on success, negative value on failure
+ */
+int db_mysql_fetch_result(const db_con_t* _h, db_res_t** _r, const int nrows)
+{
+	int rows, i;
+
+	if (!_h || !_r || nrows < 0) {
+		LM_ERR("Invalid parameter value\n");
+		return -1;
+	}
+
+	/* exit if the fetch count is zero */
+	if (nrows == 0) {
+		db_free_result(*_r);
+		*_r = 0;
+		return 0;
+	}
+
+	if(*_r==0) {
+		/* Allocate a new result structure */
+		*_r = db_new_result();
+		if (*_r == 0) {
+			LM_ERR("no memory left\n");
+			return -2;
+		}
+
+		CON_RESULT(_h) = mysql_store_result(CON_CONNECTION(_h));
+		if (!CON_RESULT(_h)) {
+			if (mysql_field_count(CON_CONNECTION(_h)) == 0) {
+				(*_r)->col.n = 0;
+				(*_r)->n = 0;
+				return 0;
+			} else {
+				LM_ERR("driver error: %s\n", mysql_error(CON_CONNECTION(_h)));
+				db_free_result(*_r);
+				*_r = 0;
+				return -3;
+			}
+		}
+		if (db_mysql_get_columns(_h, *_r) < 0) {
+			LM_ERR("error while getting column names\n");
+			return -4;
+		}
+
+		RES_NUM_ROWS(*_r) = mysql_num_rows(CON_RESULT(_h));
+		if (!RES_NUM_ROWS(*_r)) {
+			LM_DBG("no rows returned from the query\n");
+			RES_ROWS(*_r) = 0;
+			return 0;
+		}
+
+	} else {
+		/* free old rows */
+		if(RES_ROWS(*_r)!=0)
+			db_free_rows(*_r);
+		RES_ROWS(*_r) = 0;
+		RES_ROW_N(*_r) = 0;
+	}
+
+	/* determine the number of rows remaining to be processed */
+	rows = RES_NUM_ROWS(*_r) - RES_LAST_ROW(*_r);
+
+	/* If there aren't any more rows left to process, exit */
+	if(rows<=0)
+		return 0;
+
+	/* if the fetch count is less than the remaining rows to process                 */
+	/* set the number of rows to process (during this call) equal to the fetch count */
+	if(nrows < rows)
+		rows = nrows;
+
+	RES_ROW_N(*_r) = rows;
+
+	LM_DBG("converting row %d of %d count %d\n", RES_LAST_ROW(*_r),
+			RES_NUM_ROWS(*_r), RES_ROW_N(*_r));
+
+	RES_ROWS(*_r) = (struct db_row*)pkg_malloc(sizeof(db_row_t) * rows);
+	if (!RES_ROWS(*_r)) {
+		LM_ERR("no memory left\n");
+		return -5;
+	}
+
+	for(i = 0; i < rows; i++) {
+		CON_ROW(_h) = mysql_fetch_row(CON_RESULT(_h));
+		if (!CON_ROW(_h)) {
+			LM_ERR("driver error: %s\n", mysql_error(CON_CONNECTION(_h)));
+			RES_ROW_N(*_r) = i;
+			db_free_rows(*_r);
+			return -6;
+		}
+		if (db_mysql_convert_row(_h, *_r, &(RES_ROWS(*_r)[i])) < 0) {
+			LM_ERR("error while converting row #%d\n", i);
+			RES_ROW_N(*_r) = i;
+			db_free_rows(*_r);
+			return -7;
+		}
+	}
+
+	/* update the total number of rows processed */
+	RES_LAST_ROW(*_r) += rows;
+	return 0;
+}
+
+/**
+ * Execute a raw SQL query.
+ * \param _h handle for the database
+ * \param _s raw query string
+ * \param _r result set for storage
+ * \return zero on success, negative value on failure
+ */
+int db_mysql_raw_query(const db_con_t* _h, const str* _s, db_res_t** _r)
+{
+	return db_do_raw_query(_h, _s, _r, db_mysql_submit_query,
+	db_mysql_store_result);
+}
+
+
+/**
+ * Insert a row into a specified table.
+ * \param _h structure representing database connection
+ * \param _k key names
+ * \param _v values of the keys
+ * \param _n number of key=value pairs
+ * \return zero on success, negative value on failure
+ */
+int db_mysql_insert(const db_con_t* _h, const db_key_t* _k, const db_val_t* _v, const int _n)
+{
+	return db_do_insert(_h, _k, _v, _n, db_mysql_val2str,
+	db_mysql_submit_query);
+}
+
+
+/**
+ * Delete a row from the specified table
+ * \param _h structure representing database connection
+ * \param _k key names
+ * \param _o operators
+ * \param _v values of the keys that must match
+ * \param _n number of key=value pairs
+ * \return zero on success, negative value on failure
+ */
+int db_mysql_delete(const db_con_t* _h, const db_key_t* _k, const db_op_t* _o,
+	const db_val_t* _v, const int _n)
+{
+	return db_do_delete(_h, _k, _o, _v, _n, db_mysql_val2str,
+	db_mysql_submit_query);
+}
+
+
+/**
+ * Update some rows in the specified table
+ * \param _h structure representing database connection
+ * \param _k key names
+ * \param _o operators
+ * \param _v values of the keys that must match
+ * \param _uk updated columns
+ * \param _uv updated values of the columns
+ * \param _n number of key=value pairs
+ * \param _un number of columns to update
+ * \return zero on success, negative value on failure
+ */
+int db_mysql_update(const db_con_t* _h, const db_key_t* _k, const db_op_t* _o, 
+	const db_val_t* _v, const db_key_t* _uk, const db_val_t* _uv, const int _n, 
+	const int _un)
+{
+	return db_do_update(_h, _k, _o, _v, _uk, _uv, _n, _un, db_mysql_val2str,
+	db_mysql_submit_query);
+}
+
+
+/**
+ * Just like insert, but replace the row if it exists.
+ * \param _h database handle
+ * \param _k key names
+ * \param _v values of the keys that must match
+ * \param _n number of key=value pairs
+ * \return zero on success, negative value on failure
+ */
+int db_mysql_replace(const db_con_t* _h, const db_key_t* _k, const db_val_t* _v, const int _n)
+{
+	return db_do_replace(_h, _k, _v, _n, db_mysql_val2str,
+	db_mysql_submit_query);
+}
+
+
+/**
+ * Returns the last inserted ID.
+ * \param _h database handle
+ * \return returns the ID as integer or returns 0 if the previous statement
+ * does not use an AUTO_INCREMENT value.
+ */
+int db_last_inserted_id(const db_con_t* _h)
+{
+	if (!_h) {
+		LM_ERR("invalid parameter value\n");
+		return -1;
+	}
+	return mysql_insert_id(CON_CONNECTION(_h));
+}
+
+
+ /**
+  * Insert a row into a specified table, update on duplicate key.
+  * \param _h structure representing database connection
+  * \param _k key names
+  * \param _v values of the keys
+  * \param _n number of key=value pairs
+ */
+ int db_insert_update(const db_con_t* _h, const db_key_t* _k, const db_val_t* _v,
+	const int _n)
+ {
+	int off, ret;
+	static str  sql_str;
+	static char sql_buf[SQL_BUF_LEN];
+ 
+	if ((!_h) || (!_k) || (!_v) || (!_n)) {
+		LM_ERR("invalid parameter value\n");
+		return -1;
+	}
+ 
+	ret = snprintf(sql_buf, SQL_BUF_LEN, "insert into %.*s (", CON_TABLE(_h)->len, CON_TABLE(_h)->s);
+	if (ret < 0 || ret >= SQL_BUF_LEN) goto error;
+	off = ret;
+
+	ret = db_print_columns(sql_buf + off, SQL_BUF_LEN - off, _k, _n);
+	if (ret < 0) return -1;
+	off += ret;
+
+	ret = snprintf(sql_buf + off, SQL_BUF_LEN - off, ") values (");
+	if (ret < 0 || ret >= (SQL_BUF_LEN - off)) goto error;
+	off += ret;
+	ret = db_print_values(_h, sql_buf + off, SQL_BUF_LEN - off, _v, _n, db_mysql_val2str);
+	if (ret < 0) return -1;
+	off += ret;
+
+	*(sql_buf + off++) = ')';
+	
+	ret = snprintf(sql_buf + off, SQL_BUF_LEN - off, " on duplicate key update ");
+	if (ret < 0 || ret >= (SQL_BUF_LEN - off)) goto error;
+	off += ret;
+	
+	ret = db_print_set(_h, sql_buf + off, SQL_BUF_LEN - off, _k, _v, _n, db_mysql_val2str);
+	if (ret < 0) return -1;
+	off += ret;
+	
+	sql_str.s = sql_buf;
+	sql_str.len = off;
+ 
+	if (db_mysql_submit_query(_h, &sql_str) < 0) {
+		LM_ERR("error while submitting query\n");
+		return -2;
+	}
+	return 0;
+
+error:
+	LM_ERR("error while preparing insert_update operation\n");
+	return -1;
+}
+
+
+/**
+ * Store the name of table that will be used by subsequent database functions
+ * \param _h database handle
+ * \param _t table name
+ * \return zero on success, negative value on failure
+ */
+int db_mysql_use_table(db_con_t* _h, const str* _t)
+{
+	return db_use_table(_h, _t);
+}

modules/db_mysql/km_dbase.h

@@ -0,0 +1,128 @@
+/*
+ * $Id$
+ *
+ * MySQL module core functions
+ *
+ * Copyright (C) 2001-2003 FhG Fokus
+ * Copyright (C) 2008 1&1 Internet AG
+ *
+ * This file is part of Kamailio, a free SIP server.
+ *
+ * Kamailio is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version
+ *
+ * Kamailio is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License 
+ * along with this program; if not, write to the Free Software 
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+/*! \file
+ *  \brief DB_MYSQL :: Core
+ *  \ingroup db_mysql
+ *  Module: \ref db_mysql
+ */
+
+
+
+#ifndef DBASE_H
+#define DBASE_H
+
+
+#include "../../db/db_con.h"
+#include "../../db/db_res.h"
+#include "../../db/db_key.h"
+#include "../../db/db_op.h"
+#include "../../db/db_val.h"
+#include "../../str.h"
+
+/*! \brief
+ * Initialize database connection
+ */
+db_con_t* db_mysql_init(const str* _sqlurl);
+
+
+/*! \brief
+ * Close a database connection
+ */
+void db_mysql_close(db_con_t* _h);
+
+
+/*! \brief
+ * Free all memory allocated by get_result
+ */
+int db_mysql_free_result(db_con_t* _h, db_res_t* _r);
+
+
+/*! \brief
+ * Do a query
+ */
+int db_mysql_query(const db_con_t* _h, const db_key_t* _k, const db_op_t* _op,
+	     const db_val_t* _v, const db_key_t* _c, const int _n, const int _nc,
+	     const db_key_t _o, db_res_t** _r);
+
+
+/*! \brief
+ * fetch rows from a result
+ */
+int db_mysql_fetch_result(const db_con_t* _h, db_res_t** _r, const int nrows);
+
+
+/*! \brief
+ * Raw SQL query
+ */
+int db_mysql_raw_query(const db_con_t* _h, const str* _s, db_res_t** _r);
+
+
+/*! \brief
+ * Insert a row into table
+ */
+int db_mysql_insert(const db_con_t* _h, const db_key_t* _k, const db_val_t* _v, const int _n);
+
+
+/*! \brief
+ * Delete a row from table
+ */
+int db_mysql_delete(const db_con_t* _h, const db_key_t* _k, const 
+	db_op_t* _o, const db_val_t* _v, const int _n);
+
+
+/*! \brief
+ * Update a row in table
+ */
+int db_mysql_update(const db_con_t* _h, const db_key_t* _k, const db_op_t* _o,
+	const db_val_t* _v, const db_key_t* _uk, const db_val_t* _uv, const int _n,
+	const int _un);
+
+
+/*! \brief
+ * Just like insert, but replace the row if it exists
+ */
+int db_mysql_replace(const db_con_t* handle, const db_key_t* keys, const db_val_t* vals, const int n);
+
+/*! \brief
+ * Returns the last inserted ID
+ */
+int db_last_inserted_id(const db_con_t* _h);
+
+/*! \brief
+ * Insert a row into table, update on duplicate key
+ */
+int db_insert_update(const db_con_t* _h, const db_key_t* _k, const db_val_t* _v,
+	const int _n);
+
+
+/*! \brief
+ * Store name of table that will be used by
+ * subsequent database functions
+ */
+int db_mysql_use_table(db_con_t* _h, const str* _t);
+
+
+#endif /* DBASE_H */

modules/db_mysql/km_doc/db_mysql.xml

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding='ISO-8859-1'?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+
+
+<!ENTITY admin SYSTEM "db_mysql_admin.xml">
+<!ENTITY faq SYSTEM "../../../doc/module_faq.xml">
+
+<!-- Include general documentation entities -->
+<!ENTITY % docentities SYSTEM "../../../doc/entities.xml">
+%docentities;
+
+]>
+
+<book>
+    <bookinfo>
+	<title>mysql Module</title>
+	<productname class="trade">&kamailioname;</productname>
+	<authorgroup>
+	    <author>
+		<firstname>Daniel-Constantin</firstname>
+		<surname>Mierla</surname>
+		<email>[email protected]</email>
+	    </author>
+	    <editor>
+		<firstname>Daniel-Constantin</firstname>
+		<surname>Mierla</surname>
+		    <email>[email protected]</email>
+	    </editor>
+	</authorgroup>
+	<copyright>
+	    <year>2006</year>
+	    <holder>&voicesystem;</holder>
+	</copyright>
+    </bookinfo>
+    <toc></toc>
+    
+    &admin;
+    &faq;
+    
+</book>

modules/db_mysql/km_doc/db_mysql_admin.xml

@@ -0,0 +1,198 @@
+<!-- Module User's Guide -->
+
+<chapter>
+	
+	<title>&adminguide;</title>
+	
+	<section>
+	<title>Overview</title>
+	<para>
+		This is a module which provides MySQL connectivity for Kamailio.
+		It implements the DB API defined in Kamailio.
+	</para>
+	</section>
+
+	<section>
+	<title>Dependencies</title>
+	<section>
+		<title>&kamailio; Modules</title>
+		<para>
+		The following modules must be loaded before this module:
+			<itemizedlist>
+			<listitem>
+			<para>
+				<emphasis>No dependencies on other &kamailio; modules</emphasis>.
+			</para>
+			</listitem>
+			</itemizedlist>
+		</para>
+	</section>
+	<section>
+		<title>External Libraries or Applications</title>
+		<para>
+		The following libraries or applications must be installed before running
+		&kamailio; with this module loaded:
+			<itemizedlist>
+			<listitem>
+			<para>
+				<emphasis>mysql</emphasis> - the development libraries forthe Mysql database. In some Linux distributions named "libmysqlclient-dev".
+			</para>
+			</listitem>
+			</itemizedlist>
+		</para>
+	</section>
+	</section>
+	<section>
+	<title>Exported Parameters</title>
+	<section>
+		<title><varname>ping_interval</varname> (integer)</title>
+		<para>
+		Time interval in seconds to send ping messages to MySQL server in order to keep
+		the connection open.
+		</para>
+		<para>
+		<emphasis>
+			Default value is 300 (5 min).
+		</emphasis>
+		</para>
+		<example>
+		<title>Set <varname>ping_interval</varname> parameter</title>
+		<programlisting format="linespecific">
+...
+modparam("db_mysql", "ping_interval", 600)
+...
+</programlisting>
+		</example>
+	</section>
+		<section>
+		<title><varname>timeout_interval</varname> (integer)</title>
+		<para>
+		Time interval (in seconds) after that an connection attempt, read or write request
+		is aborted. The value counts three times, as several retries are done
+		from the driver before it gives up.
+		</para>
+		<para>
+		The read timeout parameter is ignored on MySQL driver versions prior to
+		<quote>5.1.12</quote>, <quote>5.0.25</quote> and <quote>4.1.22</quote>.
+		The write timeout parameter is ignored on versions prior to <quote>5.1.12</quote>
+		and <quote>5.0.25</quote>, the <quote>4.1</quote> release don't support it at all.
+		</para>
+		<para>
+		<emphasis>
+			Default value is 2 (6 sec).
+		</emphasis>
+		</para>
+		<example>
+		<title>Set <varname>timeout_interval</varname> parameter</title>
+		<programlisting format="linespecific">
+...
+modparam("db_mysql", "timeout_interval", 2)
+...
+</programlisting>
+		</example>
+	</section>
+	<section>
+		<title><varname>auto_reconnect</varname> (integer)</title>
+		<para>
+		Configure whether the module should automatically reconnect to MySQL server if the
+		connection was lost.
+		</para>
+		<para>
+		<emphasis>
+			Default value is 1 (1 - on / 0 - off).
+		</emphasis>
+		</para>
+		<example>
+		<title>Set <varname>auto_reconnect</varname> parameter</title>
+		<programlisting format="linespecific">
+...
+modparam("db_mysql", "auto_reconnect", 0)
+...
+</programlisting>
+		</example>
+	</section>
+	</section>
+	<section>
+	<title>Exported Functions</title>
+		<para>
+		No function exported to be used from configuration file.
+		</para>
+	</section>
+	<section>
+	<title>Installation</title>
+		<para>
+		Because it dependes on an external library, the mysql module is not
+		compiled and installed by default. You can use one of these options.
+		</para>
+		<itemizedlist>
+			<listitem>
+			<para>
+			- edit the "Makefile" and remove "db_mysql" from "excluded_modules"
+			list. Then follow the standard procedure to install &kamailio;:
+			"make all; make install".
+			</para>
+			</listitem>
+			<listitem>
+			<para>
+			- from command line use: 'make all include_modules="db_mysql";
+			make install include_modules="db_mysql"'.
+			</para>
+			</listitem>
+		</itemizedlist>
+	</section>
+	<section>
+		<title>Reading configuration from my.cnf</title>
+		<para>
+		In order to take into account specific mysql client options, a my.cnf config group can be passed using the <emphasis>db_url</emphasis> module parameter. This is done by setting <emphasis>[group]</emphasis> in front of or instead of the host part. The following examples are valid <emphasis>db_url</emphasis> definitions, which include a my.cnf group:
+		</para>
+
+		<itemizedlist>
+			<listitem>mysql://user:pass@[group]host:port/db</listitem>
+			<listitem>mysql://user:pass@[group]:port/db</listitem>
+			<listitem>mysql://user:pass@[group]/db</listitem>
+			<listitem>mysql://[group]/db</listitem>
+		</itemizedlist>
+		<example>
+		<title>Set a my.cnf group in <varname>db_url</varname> parameter</title>
+		<programlisting format="linespecific">
+...
+modparam("usrloc", "db_url", "mysql://[kamailio]/kamailio)
+...
+</programlisting>
+		</example>
+		<example>
+		<title>Adding a kamailio group to my.cnf</title>
+		<programlisting format="linespecific">
+...
+[kamailio]
+socket = /path/to/mysql.sock
+user = kamailiouser
+password = kamailiopass
+default-character-set = utf8
+...
+</programlisting>
+		</example>
+		<para>
+		In addition to the given group, also the <emphasis>[client]</emphasis> section is read, in the order given in my.cnf. So if you for example specify a <emphasis>socket</emphasis> in both your specific group and the client group, then the value is taken from the last one.
+		</para>
+		<example>
+		<title>Using [client] and specific group</title>
+		<programlisting format="linespecific">
+...
+[client]
+socket = /var/run/mysql/mysqld.sock
+
+[kamailio]
+socket = /path/to/mysqld.sock
+user = kamailiouser
+password = kamailiopass
+default-character-set = utf8
+...
+</programlisting>
+		</example>
+		<para>
+		In the example given above, the socket <emphasis>/path/to/mysqld.sock</emphasis> is used by &kamailio; because both <emphasis>[kamailio]</emphasis> and <emphasis>[client]</emphasis> define this option, and the latter overwrites the first.
+		</para>
+	</section>
+</chapter>
+

modules/db_mysql/km_my_con.c

@@ -0,0 +1,151 @@
+/* 
+ * $Id$
+ *
+ * Copyright (C) 2001-2004 iptel.org
+ * Copyright (C) 2008 1&1 Internet AG
+ *
+ * This file is part of Kamailio, a free SIP server.
+ *
+ * Kamailio is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version
+ *
+ * Kamailio is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License 
+ * along with this program; if not, write to the Free Software 
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+/*! \file
+ *  \brief DB_MYSQL :: Connections
+ *  \ingroup db_mysql
+ *  Module: \ref db_mysql
+ */
+
+
+#include "my_con.h"
+#include "db_mysql.h"
+#include <mysql/mysql_version.h>
+#include "../../mem/mem.h"
+#include "../../dprint.h"
+#include "../../ut.h"
+
+
+/*! \brief
+ * Create a new connection structure,
+ * open the MySQL connection and set reference count to 1
+ */
+struct my_con* db_mysql_new_connection(const struct db_id* id)
+{
+	struct my_con* ptr;
+	char *host, *grp;
+
+	if (!id) {
+		LM_ERR("invalid parameter value\n");
+		return 0;
+	}
+
+	ptr = (struct my_con*)pkg_malloc(sizeof(struct my_con));
+	if (!ptr) {
+		LM_ERR("no private memory left\n");
+		return 0;
+	}
+
+	memset(ptr, 0, sizeof(struct my_con));
+	ptr->ref = 1;
+	
+	ptr->con = (MYSQL*)pkg_malloc(sizeof(MYSQL));
+	if (!ptr->con) {
+		LM_ERR("no private memory left\n");
+		goto err;
+	}
+
+	mysql_init(ptr->con);
+
+	if (id->host[0] == '[' && (host = strchr(id->host, ']')) != NULL) {
+		grp = id->host + 1;
+		*host = '\0';
+		if (host != id->host + strlen(id->host)-1) {
+			host += 1; // host found after closing bracket
+		}
+		else {
+			// let mysql read host info from my.cnf
+			// (defaults to "localhost")
+			host = NULL;
+		}
+		// read [client] and [<grp>] sections in the order
+		// given in my.cnf
+		mysql_options(ptr->con, MYSQL_READ_DEFAULT_GROUP, grp);
+	}
+	else {
+		host = id->host;
+	}
+
+	if (id->port) {
+		LM_DBG("opening connection: mysql://xxxx:xxxx@%s:%d/%s\n", ZSW(host),
+			id->port, ZSW(id->database));
+	} else {
+		LM_DBG("opening connection: mysql://xxxx:xxxx@%s/%s\n", ZSW(host),
+			ZSW(id->database));
+	}
+
+	// set connect, read and write timeout, the value counts three times
+	mysql_options(ptr->con, MYSQL_OPT_CONNECT_TIMEOUT, (const char *)&db_mysql_timeout_interval);
+	mysql_options(ptr->con, MYSQL_OPT_READ_TIMEOUT, (const char *)&db_mysql_timeout_interval);
+	mysql_options(ptr->con, MYSQL_OPT_WRITE_TIMEOUT, (const char *)&db_mysql_timeout_interval);
+
+#if (MYSQL_VERSION_ID >= 40100)
+	if (!mysql_real_connect(ptr->con, host, id->username, id->password,
+				id->database, id->port, 0, CLIENT_MULTI_STATEMENTS)) {
+#else
+	if (!mysql_real_connect(ptr->con, host, id->username, id->password,
+				id->database, id->port, 0, 0)) {
+#endif
+		LM_ERR("driver error: %s\n", mysql_error(ptr->con));
+		mysql_close(ptr->con);
+		goto err;
+	}
+	/* force reconnection if enabled */
+	if (db_mysql_auto_reconnect)
+		ptr->con->reconnect = 1;
+	else 
+		ptr->con->reconnect = 0;
+
+	LM_DBG("connection type is %s\n", mysql_get_host_info(ptr->con));
+	LM_DBG("protocol version is %d\n", mysql_get_proto_info(ptr->con));
+	LM_DBG("server version is %s\n", mysql_get_server_info(ptr->con));
+
+	ptr->timestamp = time(0);
+	ptr->id = (struct db_id*)id;
+	return ptr;
+
+ err:
+	if (ptr && ptr->con) pkg_free(ptr->con);
+	if (ptr) pkg_free(ptr);
+	return 0;
+}
+
+
+/*! \brief
+ * Close the connection and release memory
+ */
+void db_mysql_free_connection(struct pool_con* con)
+{
+	if (!con) return;
+
+	struct my_con * _c;
+	_c = (struct my_con*) con;
+
+	if (_c->res) mysql_free_result(_c->res);
+	if (_c->id) free_db_id(_c->id);
+	if (_c->con) {
+		mysql_close(_c->con);
+		pkg_free(_c->con);
+	}
+	pkg_free(_c);
+}

modules/db_mysql/km_my_con.h

@@ -0,0 +1,75 @@
+/* 
+ * $Id$
+ *
+ * Copyright (C) 2001-2003 FhG Fokus
+ * Copyright (C) 2008 1&1 Internet AG
+ *
+ * This file is part of Kamailio, a free SIP server.
+ *
+ * Kamailio is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version
+ *
+ * Kamailio is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License 
+ * along with this program; if not, write to the Free Software 
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+/*! \file
+ *  \brief DB_MYSQL :: Core
+ *  \ref my_con.c
+ *  \ingroup db_mysql
+ *  Module: \ref db_mysql
+ */
+
+
+#ifndef MY_CON_H
+#define MY_CON_H
+
+#include "../../db/db_pool.h"
+#include "../../db/db_id.h"
+
+#include <time.h>
+#include <mysql/mysql.h>
+
+
+struct my_con {
+	struct db_id* id;        /*!< Connection identifier */
+	unsigned int ref;        /*!< Reference count */
+	struct pool_con* next;   /*!< Next connection in the pool */
+
+	MYSQL_RES* res;          /*!< Actual result */
+	MYSQL* con;              /*!< Connection representation */
+	MYSQL_ROW row;           /*!< Actual row in the result */
+	time_t timestamp;        /*!< Timestamp of last query */
+};
+
+
+/*
+ * Some convenience wrappers
+ */
+#define CON_RESULT(db_con)     (((struct my_con*)((db_con)->tail))->res)
+#define CON_CONNECTION(db_con) (((struct my_con*)((db_con)->tail))->con)
+#define CON_ROW(db_con)        (((struct my_con*)((db_con)->tail))->row)
+#define CON_TIMESTAMP(db_con)  (((struct my_con*)((db_con)->tail))->timestamp)
+
+
+/*! \brief
+ * Create a new connection structure,
+ * open the MySQL connection and set reference count to 1
+ */
+struct my_con* db_mysql_new_connection(const struct db_id* id);
+
+
+/*! \brief
+ * Close the connection and release memory
+ */
+void db_mysql_free_connection(struct pool_con* con);
+
+#endif /* MY_CON_H */

modules/db_mysql/km_res.c

@@ -0,0 +1,223 @@
+/* 
+ * $Id$ 
+ *
+ * MySQL module result related functions
+ *
+ * Copyright (C) 2001-2003 FhG Fokus
+ * Copyright (C) 2007-2008 1&1 Internet AG
+ *
+ * This file is part of Kamailio, a free SIP server.
+ *
+ * Kamailio is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version
+ *
+ * Kamailio is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License 
+ * along with this program; if not, write to the Free Software 
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+
+/*! \file
+ *  \brief DB_MYSQL :: Result related functions
+ *  \ingroup db_mysql
+ *  Module: \ref db_mysql
+ */
+
+
+#include <string.h>
+#include <mysql/mysql.h>
+#include "../../db/db_res.h"
+#include "../../mem/mem.h"
+#include "../../dprint.h"
+#include "row.h"
+#include "my_con.h"
+#include "res.h"
+
+
+/*!
+ * \brief Get and convert columns from a result
+ *
+ * Get and convert columns from a result, fills the result structure
+ * with data from the database.
+ * \param _h database connection
+ * \param _r database result set
+ * \return 0 on success, negative on failure
+ */
+int db_mysql_get_columns(const db_con_t* _h, db_res_t* _r)
+{
+	int col;
+	MYSQL_FIELD* fields;
+
+	if ((!_h) || (!_r)) {
+		LM_ERR("invalid parameter\n");
+		return -1;
+	}
+
+	RES_COL_N(_r) = mysql_field_count(CON_CONNECTION(_h));
+	if (!RES_COL_N(_r)) {
+		LM_ERR("no columns returned from the query\n");
+		return -2;
+	} else {
+		LM_DBG("%d columns returned from the query\n", RES_COL_N(_r));
+	}
+	
+	if (db_allocate_columns(_r, RES_COL_N(_r)) != 0) {
+		LM_ERR("could not allocate columns\n");
+		return -3;
+	}
+
+	fields = mysql_fetch_fields(CON_RESULT(_h));
+	for(col = 0; col < RES_COL_N(_r); col++) {
+		RES_NAMES(_r)[col] = (str*)pkg_malloc(sizeof(str));
+		if (! RES_NAMES(_r)[col]) {
+			LM_ERR("no private memory left\n");
+			db_free_columns(_r);
+			return -4;
+		}
+		LM_DBG("allocate %lu bytes for RES_NAMES[%d] at %p\n",
+				(unsigned long)sizeof(str), col, RES_NAMES(_r)[col]);
+
+		/* The pointer that is here returned is part of the result structure. */
+		RES_NAMES(_r)[col]->s = fields[col].name;
+		RES_NAMES(_r)[col]->len = strlen(fields[col].name);
+
+		LM_DBG("RES_NAMES(%p)[%d]=[%.*s]\n", RES_NAMES(_r)[col], col,
+				RES_NAMES(_r)[col]->len, RES_NAMES(_r)[col]->s);
+
+		switch(fields[col].type) {
+			case MYSQL_TYPE_TINY:
+			case MYSQL_TYPE_SHORT:
+			case MYSQL_TYPE_LONG:
+			case MYSQL_TYPE_INT24:
+			case MYSQL_TYPE_TIMESTAMP:
+				LM_DBG("use DB_INT result type\n");
+				RES_TYPES(_r)[col] = DB_INT;
+				break;
+
+			case MYSQL_TYPE_LONGLONG:
+				LM_DBG("use DB_BIGINT result type\n");
+				RES_TYPES(_r)[col] = DB_BIGINT;
+				break;
+
+			case MYSQL_TYPE_FLOAT:
+			case MYSQL_TYPE_DOUBLE:
+				LM_DBG("use DB_DOUBLE result type\n");
+				RES_TYPES(_r)[col] = DB_DOUBLE;
+				break;
+
+			case MYSQL_TYPE_DATETIME:
+				LM_DBG("use DB_DATETIME result type\n");
+				RES_TYPES(_r)[col] = DB_DATETIME;
+				break;
+
+			case MYSQL_TYPE_BLOB:
+				LM_DBG("use DB_BLOB result type\n");
+				RES_TYPES(_r)[col] = DB_BLOB;
+				break;
+
+			case FIELD_TYPE_SET:
+				LM_DBG("use DB_BITMAP result type\n");
+				RES_TYPES(_r)[col] = DB_BITMAP;
+				break;
+
+			case MYSQL_TYPE_DECIMAL:
+			#if MYSQL_VERSION_ID > 49999
+			case MYSQL_TYPE_NEWDECIMAL:
+			#endif
+			case MYSQL_TYPE_STRING:
+			case MYSQL_TYPE_VAR_STRING:
+				LM_DBG("use DB_STRING result type\n");
+				RES_TYPES(_r)[col] = DB_STRING;
+				break;
+
+			default:
+				LM_WARN("unhandled data type column (%.*s) type id (%d), "
+						"use DB_STRING as default\n", RES_NAMES(_r)[col]->len,
+						RES_NAMES(_r)[col]->s, fields[col].type);
+				RES_TYPES(_r)[col] = DB_STRING;
+				break;
+		}
+	}
+	return 0;
+}
+
+
+/*!
+ * \brief Convert rows from mysql to db API representation
+ * \param _h database connection
+ * \param _r database result set
+ * \return 0 on success, negative on failure
+ */
+static inline int db_mysql_convert_rows(const db_con_t* _h, db_res_t* _r)
+{
+	int row;
+
+	if ((!_h) || (!_r)) {
+		LM_ERR("invalid parameter\n");
+		return -1;
+	}
+
+	RES_ROW_N(_r) = mysql_num_rows(CON_RESULT(_h));
+	if (!RES_ROW_N(_r)) {
+		LM_DBG("no rows returned from the query\n");
+		RES_ROWS(_r) = 0;
+		return 0;
+	}
+
+	if (db_allocate_rows(_r) < 0) {
+		LM_ERR("could not allocate rows");
+		return -2;
+	}
+
+	for(row = 0; row < RES_ROW_N(_r); row++) {
+		CON_ROW(_h) = mysql_fetch_row(CON_RESULT(_h));
+		if (!CON_ROW(_h)) {
+			LM_ERR("driver error: %s\n", mysql_error(CON_CONNECTION(_h)));
+			RES_ROW_N(_r) = row;
+			db_free_rows(_r);
+			return -3;
+		}
+		if (db_mysql_convert_row(_h, _r, &(RES_ROWS(_r)[row])) < 0) {
+			LM_ERR("error while converting row #%d\n", row);
+			RES_ROW_N(_r) = row;
+			db_free_rows(_r);
+			return -4;
+		}
+	}
+	return 0;
+}
+
+
+/*!
+ * \brief Fill the result structure with data from database
+ * \param _h database connection
+ * \param _r database result
+ * \return 0 on success, negative on failure
+ */
+int db_mysql_convert_result(const db_con_t* _h, db_res_t* _r)
+{
+	if ((!_h) || (!_r)) {
+		LM_ERR("invalid parameter\n");
+		return -1;
+	}
+
+	if (db_mysql_get_columns(_h, _r) < 0) {
+		LM_ERR("error while getting column names\n");
+		return -2;
+	}
+
+	if (db_mysql_convert_rows(_h, _r) < 0) {
+		LM_ERR("error while converting rows\n");
+		db_free_columns(_r);
+		return -3;
+	}
+	return 0;
+}
+

modules/db_mysql/km_res.h

@@ -0,0 +1,58 @@
+/* 
+ * $Id$ 
+ *
+ * MySQL module result related functions
+ *
+ * Copyright (C) 2001-2003 FhG Fokus
+ * Copyright (C) 2007-2008 1&1 Internet AG
+ *
+ * This file is part of Kamailio, a free SIP server.
+ *
+ * Kamailio is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version
+ *
+ * Kamailio is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License 
+ * along with this program; if not, write to the Free Software 
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+/*! \file
+ *  \brief DB_MYSQL :: Result related functions
+ *  \ref res.c
+ *  \ingroup db_mysql
+ *  Module: \ref db_mysql
+ */
+
+
+#ifndef RES_H
+#define RES_H
+
+#include "../../db/db_res.h"
+#include "../../db/db_con.h"
+
+
+/*!
+ * \brief Fill the result structure with data from database
+ * \param _h database connection
+ * \param _r database result
+ * \return 0 on success, negative on failure
+ */
+int db_mysql_convert_result(const db_con_t* _h, db_res_t* _r);
+
+
+/*!
+ * \brief Get and convert columns from a result
+ * \param _h database connection
+ * \param _r database result set
+ * \return 0 on success, negative on failure
+ */
+int db_mysql_get_columns(const db_con_t* _h, db_res_t* _r);
+
+#endif

modules/db_mysql/km_row.c

@@ -0,0 +1,74 @@
+/* 
+ * $Id$ 
+ *
+ * MySQL module row related functions
+ *
+ * Copyright (C) 2001-2003 FhG Fokus
+ * Copyright (C) 2008 1&1 Internet AG
+ *
+ * This file is part of Kamailio, a free SIP server.
+ *
+ * Kamailio is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version
+ *
+ * Kamailio is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License 
+ * along with this program; if not, write to the Free Software 
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+/*! \file
+ *  \brief DB_MYSQL :: Row related functions
+ *  \ingroup db_mysql
+ *  Module: \ref db_mysql
+ */
+
+#include "../../dprint.h"
+#include "../../mem/mem.h"
+#include "../../db/db_row.h"
+#include "../../db/db_val.h"
+#include "my_con.h"
+#include "val.h"
+#include "row.h"
+
+/*!
+ * \brief Convert a row from result into DB API representation
+ * \param _h database connection
+ * \param _res database result in the DB API representation
+ * \param _r database result row
+ * \return 0 on success, -1 on failure
+ */
+int db_mysql_convert_row(const db_con_t* _h, db_res_t* _res, db_row_t* _r)
+{
+	unsigned long* lengths;
+	int i;
+
+	if ((!_h) || (!_res) || (!_r)) {
+		LM_ERR("invalid parameter value\n");
+		return -1;
+	}
+
+	if (db_allocate_row(_res, _r) != 0) {
+		LM_ERR("could not allocate row");
+		return -2;
+	}
+	
+	lengths = mysql_fetch_lengths(CON_RESULT(_h));
+
+	for(i = 0; i < RES_COL_N(_res); i++) {
+		if (db_str2val(RES_TYPES(_res)[i], &(ROW_VALUES(_r)[i]),
+			    ((MYSQL_ROW)CON_ROW(_h))[i], lengths[i], 0) < 0) {
+			LM_ERR("failed to convert value\n");
+			LM_DBG("free row at %p\n", _r);
+			db_free_row(_r);
+			return -3;
+		}
+	}
+	return 0;
+}

modules/db_mysql/km_row.h

@@ -0,0 +1,51 @@
+/* 
+ * $Id$ 
+ *
+ * MySQL module row related functions
+ *
+ * Copyright (C) 2001-2003 FhG Fokus
+ * Copyright (C) 2008 1&1 Internet AG
+ *
+ * This file is part of Kamailio, a free SIP server.
+ *
+ * Kamailio is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version
+ *
+ * Kamailio is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License 
+ * along with this program; if not, write to the Free Software 
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+/*! \file
+ *  \brief DB_MYSQL :: Row related functions
+ *  \ref row.c
+ *  \ingroup db_mysql
+ *  Module: \ref db_mysql
+ */
+
+
+#ifndef ROW_H
+#define ROW_H
+
+#include "../../db/db_con.h"
+#include "../../db/db_res.h"
+#include "../../db/db_row.h"
+
+
+/*!
+ * \brief Convert a row from result into DB API representation
+ * \param _h database connection
+ * \param _res database result in the DB API representation
+ * \param _r database result row
+ * \return 0 on success, -1 on failure
+ */
+int db_mysql_convert_row(const db_con_t* _h, db_res_t* _res, db_row_t* _r);
+
+#endif

modules/db_mysql/km_val.c

@@ -0,0 +1,107 @@
+/* 
+ * $Id$ 
+ *
+ * Copyright (C) 2001-2003 FhG Fokus
+ * Copyright (C) 2008 1&1 Internet AG
+ *
+ * This file is part of Kamailio, a free SIP server.
+ *
+ * Kamailio is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version
+ *
+ * Kamailio is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License 
+ * along with this program; if not, write to the Free Software 
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+/*! \file
+ *  \brief DB_MYSQL :: Data conversions
+ *  \ingroup db_mysql
+ *  Module: \ref db_mysql
+ */
+
+#include "../../dprint.h"
+#include "../../db/db_ut.h"
+#include "val.h"
+#include "my_con.h"
+
+
+/*!
+ * \brief Converting a value to a string
+ *
+ * Converting a value to a string, used when converting result from a query
+ * \param _c database connection
+ * \param _v source value
+ * \param _s target string
+ * \param _len target string length
+ * \return 0 on success, negative on error
+ */
+int db_mysql_val2str(const db_con_t* _c, const db_val_t* _v, char* _s, int* _len)
+{
+	int l, tmp;
+	char* old_s;
+
+	tmp = db_val2str(_c, _v, _s, _len);
+	if (tmp < 1)
+		return tmp;
+
+	switch(VAL_TYPE(_v)) {
+	case DB_STRING:
+		l = strlen(VAL_STRING(_v));
+		if (*_len < (l * 2 + 3)) {
+			LM_ERR("destination buffer too short\n");
+			return -6;
+		} else {
+			old_s = _s;
+			*_s++ = '\'';
+			_s += mysql_real_escape_string(CON_CONNECTION(_c), _s, VAL_STRING(_v), l);
+			*_s++ = '\'';
+			*_s = '\0'; /* FIXME */
+			*_len = _s - old_s;
+			return 0;
+		}
+		break;
+
+	case DB_STR:
+		if (*_len < (VAL_STR(_v).len * 2 + 3)) {
+			LM_ERR("destination buffer too short\n");
+			return -7;
+		} else {
+			old_s = _s;
+			*_s++ = '\'';
+			_s += mysql_real_escape_string(CON_CONNECTION(_c), _s, VAL_STR(_v).s, VAL_STR(_v).len);
+			*_s++ = '\'';
+			*_s = '\0';
+			*_len = _s - old_s;
+			return 0;
+		}
+		break;
+
+	case DB_BLOB:
+		l = VAL_BLOB(_v).len;
+		if (*_len < (l * 2 + 3)) {
+			LM_ERR("destination buffer too short\n");
+			return -9;
+		} else {
+			old_s = _s;
+			*_s++ = '\'';
+			_s += mysql_real_escape_string(CON_CONNECTION(_c), _s, VAL_STR(_v).s, l);
+			*_s++ = '\'';
+			*_s = '\0';
+			*_len = _s - old_s;
+			return 0;
+		}			
+		break;
+
+	default:
+		LM_DBG("unknown data type\n");
+		return -10;
+	}
+}

modules/db_mysql/km_val.h

@@ -0,0 +1,52 @@
+/* 
+ * $Id$ 
+ *
+ * Copyright (C) 2001-2003 FhG Fokus
+ * Copyright (C) 2008 1&1 Internet AG
+ *
+ * This file is part of Kamailio, a free SIP server.
+ *
+ * Kamailio is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version
+ *
+ * Kamailio is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License 
+ * along with this program; if not, write to the Free Software 
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+/*! \file
+ *  \brief DB_MYSQL :: Data conversions
+ *  \ref val.c
+ *  \ingroup db_mysql
+ *  Module: \ref db_mysql
+ */
+
+
+#ifndef VAL_H
+#define VAL_H
+
+#include <mysql/mysql.h>
+#include "../../db/db_val.h"
+#include "../../db/db.h"
+
+
+/*!
+ * \brief Converting a value to a string
+ *
+ * Converting a value to a string, used when converting result from a query
+ * \param _c database connection
+ * \param _v source value
+ * \param _s target string
+ * \param _len target string length
+ * \return 0 on success, negative on error
+ */
+int db_mysql_val2str(const db_con_t* _con, const db_val_t* _v, char* _s, int* _len);
+
+#endif