2 Bacula® - The Network Backup Solution
4 Copyright (C) 2000-2007 Free Software Foundation Europe e.V.
6 The main author of Bacula is Kern Sibbald, with contributions from
7 many others, a complete list can be found in the file AUTHORS.
8 This program is Free Software; you can redistribute it and/or
9 modify it under the terms of version two of the GNU General Public
10 License as published by the Free Software Foundation plus additions
11 that are listed in the file LICENSE.
13 This program is distributed in the hope that it will be useful, but
14 WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
23 Bacula® is a registered trademark of John Walker.
24 The licensor of Bacula is the Free Software Foundation Europe
25 (FSFE), Fiduciary Program, Sumatrastrasse 25, 8006 Zürich,
26 Switzerland, email:ftf@fsfeurope.org.
29 * Bacula Catalog Database routines specific to MySQL
30 * These are MySQL specific routines -- hopefully all
31 * other files are generic.
33 * Kern Sibbald, March 2000
39 /* The following is necessary so that we do not include
40 * the dummy external definition of DB.
42 #define __SQL_C /* indicate that this is sql.c */
49 /* -----------------------------------------------------------------------
51 * MySQL dependent defines and subroutines
53 * -----------------------------------------------------------------------
56 /* List of open databases */
57 static BQUEUE db_list = {&db_list, &db_list};
59 static pthread_mutex_t mutex = PTHREAD_MUTEX_INITIALIZER;
62 * Retrieve database type
71 * Initialize database data structure. In principal this should
72 * never have errors, or it is really fatal.
75 db_init_database(JCR *jcr, const char *db_name, const char *db_user, const char *db_password,
76 const char *db_address, int db_port, const char *db_socket,
77 int mult_db_connections)
82 Jmsg(jcr, M_FATAL, 0, _("A user name for MySQL must be supplied.\n"));
85 P(mutex); /* lock DB queue */
86 /* Look to see if DB already open */
87 if (!mult_db_connections) {
88 for (mdb=NULL; (mdb=(B_DB *)qnext(&db_list, &mdb->bq)); ) {
89 if (bstrcmp(mdb->db_name, db_name) &&
90 bstrcmp(mdb->db_address, db_address) &&
91 mdb->db_port == db_port) {
92 Dmsg2(100, "DB REopen %d %s\n", mdb->ref_count, db_name);
95 return mdb; /* already open */
99 Dmsg0(100, "db_open first time\n");
100 mdb = (B_DB *)malloc(sizeof(B_DB));
101 memset(mdb, 0, sizeof(B_DB));
102 mdb->db_name = bstrdup(db_name);
103 mdb->db_user = bstrdup(db_user);
105 mdb->db_password = bstrdup(db_password);
108 mdb->db_address = bstrdup(db_address);
111 mdb->db_socket = bstrdup(db_socket);
113 mdb->db_port = db_port;
114 mdb->have_insert_id = true;
115 mdb->errmsg = get_pool_memory(PM_EMSG); /* get error message buffer */
117 mdb->cmd = get_pool_memory(PM_EMSG); /* get command buffer */
118 mdb->cached_path = get_pool_memory(PM_FNAME);
119 mdb->cached_path_id = 0;
121 mdb->fname = get_pool_memory(PM_FNAME);
122 mdb->path = get_pool_memory(PM_FNAME);
123 mdb->esc_name = get_pool_memory(PM_FNAME);
124 mdb->esc_name2 = get_pool_memory(PM_FNAME);
125 qinsert(&db_list, &mdb->bq); /* put db in list */
131 * Now actually open the database. This can generate errors,
132 * which are returned in the errmsg
134 * DO NOT close the database or free(mdb) here !!!!
137 db_open_database(JCR *jcr, B_DB *mdb)
142 if (mdb->connected) {
146 mdb->connected = false;
148 if ((errstat=rwl_init(&mdb->lock)) != 0) {
149 Mmsg1(&mdb->errmsg, _("Unable to initialize DB lock. ERR=%s\n"),
155 /* connect to the database */
156 #ifdef HAVE_EMBEDDED_MYSQL
157 mysql_server_init(0, NULL, NULL);
159 mysql_init(&(mdb->mysql));
160 Dmsg0(50, "mysql_init done\n");
161 /* If connection fails, try at 5 sec intervals for 30 seconds. */
162 for (int retry=0; retry < 6; retry++) {
163 mdb->db = mysql_real_connect(
164 &(mdb->mysql), /* db */
165 mdb->db_address, /* default = localhost */
166 mdb->db_user, /* login name */
167 mdb->db_password, /* password */
168 mdb->db_name, /* database name */
169 mdb->db_port, /* default port */
170 mdb->db_socket, /* default = socket */
171 CLIENT_FOUND_ROWS); /* flags */
173 /* If no connect, try once more in case it is a timing problem */
174 if (mdb->db != NULL) {
180 mdb->mysql.reconnect = 1; /* so connection does not timeout */
181 Dmsg0(50, "mysql_real_connect done\n");
182 Dmsg3(50, "db_user=%s db_name=%s db_password=%s\n", mdb->db_user, mdb->db_name,
183 mdb->db_password==NULL?"(NULL)":mdb->db_password);
185 if (mdb->db == NULL) {
186 Mmsg2(&mdb->errmsg, _("Unable to connect to MySQL server.\n"
187 "Database=%s User=%s\n"
188 "MySQL connect failed either server not running or your authorization is incorrect.\n"),
189 mdb->db_name, mdb->db_user);
194 if (!check_tables_version(jcr, mdb)) {
199 #ifdef HAVE_THREAD_SAFE_MYSQL
203 mdb->connected = true;
209 db_close_database(JCR *jcr, B_DB *mdb)
214 db_end_transaction(jcr, mdb);
217 #if defined(HAVE_THREAD_SAFE_MYSQL)
220 if (mdb->ref_count == 0) {
222 if (mdb->connected && mdb->db) {
224 #ifdef HAVE_EMBEDDED_MYSQL
228 rwl_destroy(&mdb->lock);
229 free_pool_memory(mdb->errmsg);
230 free_pool_memory(mdb->cmd);
231 free_pool_memory(mdb->cached_path);
232 free_pool_memory(mdb->fname);
233 free_pool_memory(mdb->path);
234 free_pool_memory(mdb->esc_name);
235 free_pool_memory(mdb->esc_name2);
242 if (mdb->db_password) {
243 free(mdb->db_password);
245 if (mdb->db_address) {
246 free(mdb->db_address);
248 if (mdb->db_socket) {
249 free(mdb->db_socket);
257 * Return the next unique index (auto-increment) for
258 * the given table. Return NULL on error.
260 * For MySQL, NULL causes the auto-increment value
263 int db_next_index(JCR *jcr, B_DB *mdb, char *table, char *index)
265 strcpy(index, "NULL");
271 * Escape strings so that MySQL is happy
273 * NOTE! len is the length of the old string. Your new
274 * string must be long enough (max 2*old+1) to hold
275 * the escaped output.
278 db_escape_string(char *snew, char *old, int len)
280 mysql_escape_string(snew, old, len);
284 /* Should use mysql_real_escape_string ! */
285 unsigned long mysql_real_escape_string(MYSQL *mysql, char *to, const char *from, unsigned long length);
337 * Submit a general SQL command (cmd), and for each row returned,
338 * the sqlite_handler is called with the ctx.
340 int db_sql_query(B_DB *mdb, const char *query, DB_RESULT_HANDLER *result_handler, void *ctx)
346 if (sql_query(mdb, query) != 0) {
347 Mmsg(mdb->errmsg, _("Query failed: %s: ERR=%s\n"), query, sql_strerror(mdb));
351 if (result_handler != NULL) {
352 if ((mdb->result = sql_use_result(mdb)) != NULL) {
355 /* We *must* fetch all rows */
356 while ((row = sql_fetch_row(mdb)) != NULL) {
358 /* the result handler returns 1 when it has
359 * seen all the data it wants. However, we
360 * loop to the end of the data.
363 if (result_handler(ctx, num_fields, row)) {
369 sql_free_result(mdb);
377 char *my_mysql_batch_lock_path_query = "LOCK TABLES Path write, "
382 char *my_mysql_batch_lock_filename_query = "LOCK TABLES Filename write, "
384 " Filename as f write ";
386 char *my_mysql_batch_unlock_tables_query = "UNLOCK TABLES";
388 char *my_mysql_batch_fill_path_query = "INSERT INTO Path (Path) "
389 " SELECT a.Path FROM "
390 " (SELECT DISTINCT Path "
395 " WHERE p.Path = a.Path) ";
397 char *my_mysql_batch_fill_filename_query = "INSERT INTO Filename (Name) "
398 " SELECT a.Name FROM "
399 " (SELECT DISTINCT Name "
403 " FROM Filename AS f "
404 " WHERE f.Name = a.Name) ";
406 #endif /* HAVE_MYSQL */