2 * sql_mysql.c SQL Module
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20 * Copyright 2000 The FreeRADIUS server project
21 * Copyright 2000 Mike Machado <mike@innercite.com>
22 * Copyright 2000 Alan DeKok <aland@ox.org>
30 #include <mysql/errmsg.h>
34 #include <mysql/mysql.h>
37 typedef struct rlm_sql_mysql_sock {
44 /*************************************************************************
46 * Function: sql_create_socket
48 * Purpose: Establish connection to the db
50 *************************************************************************/
51 static int sql_init_socket(SQLSOCK *sqlsocket, SQL_CONFIG *config)
53 rlm_sql_mysql_sock *mysql_sock;
55 if (!sqlsocket->conn) {
56 sqlsocket->conn = (rlm_sql_mysql_sock *)rad_malloc(sizeof(rlm_sql_mysql_sock));
57 if (!sqlsocket->conn) {
61 mysql_sock = sqlsocket->conn;
62 memset(mysql_sock, 0, sizeof(*mysql_sock));
64 radlog(L_INFO, "rlm_sql_mysql: Starting connect to MySQL server for #%d",
67 mysql_init(&(mysql_sock->conn));
68 if (!(mysql_sock->sock = mysql_real_connect(&(mysql_sock->conn),
73 atoi(config->sql_port),
75 CLIENT_FOUND_ROWS))) {
76 radlog(L_ERR, "rlm_sql_mysql: Couldn't connect socket to MySQL server %s@%s:%s", config->sql_login, config->sql_server, config->sql_db);
77 radlog(L_ERR, "rlm_sql_mysql: Mysql error '%s'", mysql_error(&mysql_sock->conn));
78 mysql_sock->sock = NULL;
87 /*************************************************************************
89 * Function: sql_destroy_socket
91 * Purpose: Free socket and any private connection data
93 *************************************************************************/
94 static int sql_destroy_socket(SQLSOCK *sqlsocket, SQL_CONFIG *config)
96 free(sqlsocket->conn);
97 sqlsocket->conn = NULL;
103 /*************************************************************************
105 * Function: sql_check_error
107 * Purpose: check the error to see if the server is down
109 *************************************************************************/
110 static int sql_check_error(int error)
113 case CR_SERVER_GONE_ERROR:
116 radlog(L_DBG, "rlm_sql_mysql: MYSQL check_error: %d, returning SQL_DOWN", error);
122 case CR_OUT_OF_MEMORY:
123 case CR_COMMANDS_OUT_OF_SYNC:
124 case CR_UNKNOWN_ERROR:
126 radlog(L_DBG, "rlm_sql_mysql: MYSQL check_error: %d received", error);
133 /*************************************************************************
135 * Function: sql_query
137 * Purpose: Issue a query to the database
139 *************************************************************************/
140 static int sql_query(SQLSOCK * sqlsocket, SQL_CONFIG *config, char *querystr)
142 rlm_sql_mysql_sock *mysql_sock = sqlsocket->conn;
144 if (config->sqltrace)
145 radlog(L_DBG,"rlm_sql_mysql: query: %s", querystr);
146 if (mysql_sock->sock == NULL) {
147 radlog(L_ERR, "rlm_sql_mysql: Socket not connected");
151 mysql_query(mysql_sock->sock, querystr);
152 return sql_check_error(mysql_errno(mysql_sock->sock));
156 /*************************************************************************
158 * Function: sql_store_result
160 * Purpose: database specific store_result function. Returns a result
163 *************************************************************************/
164 static int sql_store_result(SQLSOCK * sqlsocket, SQL_CONFIG *config)
166 rlm_sql_mysql_sock *mysql_sock = sqlsocket->conn;
168 if (mysql_sock->sock == NULL) {
169 radlog(L_ERR, "rlm_sql_mysql: Socket not connected");
172 if (!(mysql_sock->result = mysql_store_result(mysql_sock->sock))) {
173 radlog(L_ERR, "rlm_sql_mysql: MYSQL Error: Cannot get result");
174 radlog(L_ERR, "rlm_sql_mysql: MYSQL Error: %s",
175 mysql_error(mysql_sock->sock));
176 return sql_check_error(mysql_errno(mysql_sock->sock));
182 /*************************************************************************
184 * Function: sql_num_fields
186 * Purpose: database specific num_fields function. Returns number
187 * of columns from query
189 *************************************************************************/
190 static int sql_num_fields(SQLSOCK * sqlsocket, SQL_CONFIG *config)
193 rlm_sql_mysql_sock *mysql_sock = sqlsocket->conn;
195 #if MYSQL_VERSION_ID >= 32224
196 if (!(num = mysql_field_count(mysql_sock->sock))) {
198 if (!(num = mysql_num_fields(mysql_sock->sock))) {
200 radlog(L_ERR, "rlm_sql_mysql: MYSQL Error: No Fields");
201 radlog(L_ERR, "rlm_sql_mysql: MYSQL error: %s",
202 mysql_error(mysql_sock->sock));
208 /*************************************************************************
210 * Function: sql_select_query
212 * Purpose: Issue a select query to the database
214 *************************************************************************/
215 static int sql_select_query(SQLSOCK *sqlsocket, SQL_CONFIG *config,
220 ret = sql_query(sqlsocket, config, querystr);
223 ret = sql_store_result(sqlsocket, config);
228 /* Why? Per http://www.mysql.com/doc/n/o/node_591.html,
229 * this cannot return an error. Perhaps just to complain if no
232 sql_num_fields(sqlsocket, config);
238 /*************************************************************************
240 * Function: sql_num_rows
242 * Purpose: database specific num_rows. Returns number of rows in
245 *************************************************************************/
246 static int sql_num_rows(SQLSOCK * sqlsocket, SQL_CONFIG *config)
248 rlm_sql_mysql_sock *mysql_sock = sqlsocket->conn;
250 if (mysql_sock->result)
251 return mysql_num_rows(mysql_sock->result);
257 /*************************************************************************
259 * Function: sql_fetch_row
261 * Purpose: database specific fetch_row. Returns a SQL_ROW struct
262 * with all the data for the query in 'sqlsocket->row'. Returns
263 * 0 on success, -1 on failure, SQL_DOWN if database is down.
265 *************************************************************************/
266 static int sql_fetch_row(SQLSOCK * sqlsocket, SQL_CONFIG *config)
268 rlm_sql_mysql_sock *mysql_sock = sqlsocket->conn;
271 * Check pointer before de-referencing it.
273 if (!mysql_sock->result) {
277 sqlsocket->row = mysql_fetch_row(mysql_sock->result);
279 if (sqlsocket->row == NULL) {
280 return sql_check_error(mysql_errno(mysql_sock->sock));
286 /*************************************************************************
288 * Function: sql_free_result
290 * Purpose: database specific free_result. Frees memory allocated
293 *************************************************************************/
294 static int sql_free_result(SQLSOCK * sqlsocket, SQL_CONFIG *config)
296 rlm_sql_mysql_sock *mysql_sock = sqlsocket->conn;
298 if (mysql_sock->result) {
299 mysql_free_result(mysql_sock->result);
300 mysql_sock->result = NULL;
308 /*************************************************************************
310 * Function: sql_error
312 * Purpose: database specific error. Returns error associated with
315 *************************************************************************/
316 static char *sql_error(SQLSOCK * sqlsocket, SQL_CONFIG *config)
318 rlm_sql_mysql_sock *mysql_sock = sqlsocket->conn;
320 if (mysql_sock == NULL || mysql_sock->sock == NULL) {
321 return "rlm_sql_mysql: no connection to db";
323 return mysql_error(mysql_sock->sock);
327 /*************************************************************************
329 * Function: sql_close
331 * Purpose: database specific close. Closes an open database
334 *************************************************************************/
335 static int sql_close(SQLSOCK * sqlsocket, SQL_CONFIG *config)
337 rlm_sql_mysql_sock *mysql_sock = sqlsocket->conn;
339 if (mysql_sock && mysql_sock->sock){
340 mysql_close(mysql_sock->sock);
341 mysql_sock->sock = NULL;
348 /*************************************************************************
350 * Function: sql_finish_query
352 * Purpose: End the query, such as freeing memory
354 *************************************************************************/
355 static int sql_finish_query(SQLSOCK * sqlsocket, SQL_CONFIG *config)
362 /*************************************************************************
364 * Function: sql_finish_select_query
366 * Purpose: End the select query, such as freeing memory or result
368 *************************************************************************/
369 static int sql_finish_select_query(SQLSOCK * sqlsocket, SQL_CONFIG *config)
371 sql_free_result(sqlsocket, config);
377 /*************************************************************************
379 * Function: sql_affected_rows
381 * Purpose: End the select query, such as freeing memory or result
383 *************************************************************************/
384 static int sql_affected_rows(SQLSOCK * sqlsocket, SQL_CONFIG *config)
386 rlm_sql_mysql_sock *mysql_sock = sqlsocket->conn;
388 return mysql_affected_rows(mysql_sock->sock);
392 /* Exported to rlm_sql */
393 rlm_sql_module_t rlm_sql_mysql = {
407 sql_finish_select_query,