2 * Bacula Catalog Database routines specific to MySQL
3 * These are MySQL specific routines -- hopefully all
4 * other files are generic.
6 * Kern Sibbald, March 2000
12 Copyright (C) 2000-2003 Kern Sibbald and John Walker
14 This program is free software; you can redistribute it and/or
15 modify it under the terms of the GNU General Public License as
16 published by the Free Software Foundation; either version 2 of
17 the License, or (at your option) any later version.
19 This program is distributed in the hope that it will be useful,
20 but WITHOUT ANY WARRANTY; without even the implied warranty of
21 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
22 General Public License for more details.
24 You should have received a copy of the GNU General Public
25 License along with this program; if not, write to the Free
26 Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
32 /* The following is necessary so that we do not include
33 * the dummy external definition of DB.
35 #define __SQL_C /* indicate that this is sql.c */
42 /* -----------------------------------------------------------------------
44 * MySQL dependent defines and subroutines
46 * -----------------------------------------------------------------------
49 /* List of open databases */
50 static BQUEUE db_list = {&db_list, &db_list};
52 static pthread_mutex_t mutex = PTHREAD_MUTEX_INITIALIZER;
55 * Initialize database data structure. In principal this should
56 * never have errors, or it is really fatal.
59 db_init_database(JCR *jcr, char *db_name, char *db_user, char *db_password,
60 char *db_address, int db_port, char *db_socket)
65 Jmsg(jcr, M_FATAL, 0, _("A user name for MySQL must be supplied.\n"));
68 P(mutex); /* lock DB queue */
69 /* Look to see if DB already open */
70 for (mdb=NULL; (mdb=(B_DB *)qnext(&db_list, &mdb->bq)); ) {
71 if (strcmp(mdb->db_name, db_name) == 0) {
72 Dmsg2(100, "DB REopen %d %s\n", mdb->ref_count, db_name);
75 return mdb; /* already open */
78 Dmsg0(100, "db_open first time\n");
79 mdb = (B_DB *) malloc(sizeof(B_DB));
80 memset(mdb, 0, sizeof(B_DB));
81 mdb->db_name = bstrdup(db_name);
82 mdb->db_user = bstrdup(db_user);
84 mdb->db_password = bstrdup(db_password);
87 mdb->db_address = bstrdup(db_address);
90 mdb->db_socket = bstrdup(db_socket);
92 mdb->db_port = db_port;
93 mdb->have_insert_id = TRUE;
94 mdb->errmsg = get_pool_memory(PM_EMSG); /* get error message buffer */
96 mdb->cmd = get_pool_memory(PM_EMSG); /* get command buffer */
97 mdb->cached_path = get_pool_memory(PM_FNAME);
98 mdb->cached_path_id = 0;
100 mdb->fname = get_pool_memory(PM_FNAME);
101 mdb->path = get_pool_memory(PM_FNAME);
102 mdb->esc_name = get_pool_memory(PM_FNAME);
103 qinsert(&db_list, &mdb->bq); /* put db in list */
109 * Now actually open the database. This can generate errors,
110 * which are returned in the errmsg
113 db_open_database(JCR *jcr, B_DB *mdb)
118 if (mdb->connected) {
122 mdb->connected = FALSE;
124 if ((errstat=rwl_init(&mdb->lock)) != 0) {
125 Mmsg1(&mdb->errmsg, _("Unable to initialize DB lock. ERR=%s\n"),
131 /* connect to the database */
132 #ifdef HAVE_EMBEDDED_MYSQL
133 mysql_server_init(0, NULL, NULL);
135 mysql_init(&(mdb->mysql));
136 Dmsg0(50, "mysql_init done\n");
137 mdb->db = mysql_real_connect(
138 &(mdb->mysql), /* db */
139 mdb->db_address, /* default = localhost */
140 mdb->db_user, /* login name */
141 mdb->db_password, /* password */
142 mdb->db_name, /* database name */
143 mdb->db_port, /* default port */
144 mdb->db_socket, /* default = socket */
145 CLIENT_FOUND_ROWS); /* flags */
147 /* If no connect, try once more in case it is a timing problem */
148 if (mdb->db == NULL) {
149 mdb->db = mysql_real_connect(
150 &(mdb->mysql), /* db */
151 mdb->db_address, /* default = localhost */
152 mdb->db_user, /* login name */
153 mdb->db_password, /* password */
154 mdb->db_name, /* database name */
155 mdb->db_port, /* default port */
156 mdb->db_socket, /* default = socket */
157 CLIENT_FOUND_ROWS); /* flags */
160 Dmsg0(50, "mysql_real_connect done\n");
161 Dmsg3(50, "db_user=%s db_name=%s db_password=%s\n", mdb->db_user, mdb->db_name,
162 mdb->db_password==NULL?"(NULL)":mdb->db_password);
164 if (mdb->db == NULL) {
165 Mmsg2(&mdb->errmsg, _("Unable to connect to MySQL server. \n\
166 Database=%s User=%s\n\
167 It is probably not running or your password is incorrect.\n"),
168 mdb->db_name, mdb->db_user);
173 if (!check_tables_version(jcr, mdb)) {
175 db_close_database(jcr, mdb);
179 #ifdef HAVE_TREAD_SAFE_MYSQL
183 mdb->connected = TRUE;
189 db_close_database(JCR *jcr, B_DB *mdb)
193 #ifdef HAVE_TREAD_SAFE_MYSQL
196 if (mdb->ref_count == 0) {
198 if (mdb->connected && mdb->db) {
200 #ifdef HAVE_EMBEDDED_MYSQL
204 rwl_destroy(&mdb->lock);
205 free_pool_memory(mdb->errmsg);
206 free_pool_memory(mdb->cmd);
207 free_pool_memory(mdb->cached_path);
208 free_pool_memory(mdb->fname);
209 free_pool_memory(mdb->path);
210 free_pool_memory(mdb->esc_name);
217 if (mdb->db_password) {
218 free(mdb->db_password);
220 if (mdb->db_address) {
221 free(mdb->db_address);
223 if (mdb->db_socket) {
224 free(mdb->db_socket);
232 * Return the next unique index (auto-increment) for
233 * the given table. Return NULL on error.
235 * For MySQL, NULL causes the auto-increment value
238 int db_next_index(JCR *jcr, B_DB *mdb, char *table, char *index)
240 strcpy(index, "NULL");
246 * Escape strings so that MySQL is happy
248 * NOTE! len is the length of the old string. Your new
249 * string must be long enough (max 2*old+1) to hold
250 * the escaped output.
253 db_escape_string(char *snew, char *old, int len)
255 mysql_escape_string(snew, old, len);
259 /* Should use mysql_real_escape_string ! */
260 unsigned long mysql_real_escape_string(MYSQL *mysql, char *to, const char *from, unsigned long length);
312 * Submit a general SQL command (cmd), and for each row returned,
313 * the sqlite_handler is called with the ctx.
315 int db_sql_query(B_DB *mdb, char *query, DB_RESULT_HANDLER *result_handler, void *ctx)
320 if (sql_query(mdb, query) != 0) {
321 Mmsg(&mdb->errmsg, _("Query failed: %s: ERR=%s\n"), query, sql_strerror(mdb));
325 if (result_handler != NULL) {
326 if ((mdb->result = sql_store_result(mdb)) != NULL) {
327 int num_fields = sql_num_fields(mdb);
329 while ((row = sql_fetch_row(mdb)) != NULL) {
330 if (result_handler(ctx, num_fields, row))
334 sql_free_result(mdb);
342 #endif /* HAVE_MYSQL */