← Back to branch summary

~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to drizzled/slave.h

  • Committer: Monty Taylor
  • Date: 2008-12-08 01:15:27 UTC
  • mto: This revision was merged to the branch mainline in revision 670.
  • Revision ID: monty@inaugust.com-20081208011527-lq9m47jsmiiqn999
Replaced my hacked up m4/ac_system_extensions.m4 with the one from gnulib.

Show diffs side-by-side

added added

removed removed

Lines of Context:
drizzled/slave.h
 
1
/* -*- mode: c++; c-basic-offset: 2; indent-tabs-mode: nil; -*-
 
2
 *  vim:expandtab:shiftwidth=2:tabstop=2:smarttab:
 
3
 *
 
4
 *  Copyright (C) 2008 Sun Microsystems
 
5
 *
 
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; version 2 of the License.
 
9
 *
 
10
 *  This program is distributed in the hope that it will be useful,
 
11
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 
12
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
13
 *  GNU General Public License for more details.
 
14
 *
 
15
 *  You should have received a copy of the GNU General Public License
 
16
 *  along with this program; if not, write to the Free Software
 
17
 *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 
18
 */
 
19
 
 
20
#ifndef DRIZZLE_SERVER_SLAVE_H
 
21
#define DRIZZLE_SERVER_SLAVE_H
 
22
 
 
23
/**
 
24
  @defgroup Replication Replication
 
25
  @{
 
26
 
 
27
  @file
 
28
*/
 
29
 
 
30
/**
 
31
   Some of defines are need in parser even though replication is not
 
32
   compiled in (embedded).
 
33
*/
 
34
 
 
35
 
 
36
#include <drizzled/log.h>
 
37
#include <mysys/my_list.h>
 
38
#include <libdrizzle/libdrizzle.h>
 
39
#include <mysys/hash.h>
 
40
#include <drizzled/replication/tblmap.h>
 
41
 
 
42
 
 
43
// Forward declarations
 
44
class Relay_log_info;
 
45
class Master_info;
 
46
 
 
47
 
 
48
/*****************************************************************************
 
49
 
 
50
  MySQL Replication
 
51
 
 
52
  Replication is implemented via two types of threads:
 
53
 
 
54
    I/O Thread - One of these threads is started for each master server.
 
55
                 They maintain a connection to their master server, read log
 
56
                 events from the master as they arrive, and queues them into
 
57
                 a single, shared relay log file.  A Master_info
 
58
                 represents each of these threads.
 
59
 
 
60
    SQL Thread - One of these threads is started and reads from the relay log
 
61
                 file, executing each event.  A Relay_log_info
 
62
                 represents this thread.
 
63
 
 
64
  Buffering in the relay log file makes it unnecessary to reread events from
 
65
  a master server across a slave restart.  It also decouples the slave from
 
66
  the master where long-running updates and event logging are concerned--ie
 
67
  it can continue to log new events while a slow query executes on the slave.
 
68
 
 
69
*****************************************************************************/
 
70
 
 
71
/*
 
72
  MUTEXES in replication:
 
73
 
 
74
  LOCK_active_mi: [note: this was originally meant for multimaster, to switch
 
75
  from a master to another, to protect active_mi] It is used to SERIALIZE ALL
 
76
  administrative commands of replication: START SLAVE, STOP SLAVE, CHANGE
 
77
  MASTER, RESET SLAVE, end_slave() (when mysqld stops) [init_slave() does not
 
78
  need it it's called early]. Any of these commands holds the mutex from the
 
79
  start till the end. This thus protects us against a handful of deadlocks
 
80
  (consider start_slave_thread() which, when starting the I/O thread, releases
 
81
  mi->run_lock, keeps rli->run_lock, and tries to re-acquire mi->run_lock).
 
82
 
 
83
  Currently active_mi never moves (it's created at startup and deleted at
 
84
  shutdown, and not changed: it always points to the same Master_info struct),
 
85
  because we don't have multimaster. So for the moment, mi does not move, and
 
86
  mi->rli does not either.
 
87
 
 
88
  In Master_info: run_lock, data_lock
 
89
  run_lock protects all information about the run state: slave_running, session
 
90
  and the existence of the I/O thread to stop/start it, you need this mutex).
 
91
  data_lock protects some moving members of the struct: counters (log name,
 
92
  position) and relay log (DRIZZLE_BIN_LOG object).
 
93
 
 
94
  In Relay_log_info: run_lock, data_lock
 
95
  see Master_info
 
96
 
 
97
  Order of acquisition: if you want to have LOCK_active_mi and a run_lock, you
 
98
  must acquire LOCK_active_mi first.
 
99
 
 
100
  In DRIZZLE_BIN_LOG: LOCK_log, LOCK_index of the binlog and the relay log
 
101
  LOCK_log: when you write to it. LOCK_index: when you create/delete a binlog
 
102
  (so that you have to update the .index file).
 
103
*/
 
104
 
 
105
extern uint32_t master_retry_count;
 
106
extern MY_BITMAP slave_error_mask;
 
107
extern bool use_slave_mask;
 
108
extern char *slave_load_tmpdir;
 
109
extern char *master_info_file, *relay_log_info_file;
 
110
extern char *opt_relay_logname, *opt_relaylog_index_name;
 
111
extern bool opt_skip_slave_start;
 
112
extern bool opt_reckless_slave;
 
113
extern bool opt_log_slave_updates;
 
114
extern uint64_t relay_log_space_limit;
 
115
 
 
116
/*
 
117
  3 possible values for Master_info::slave_running and
 
118
  Relay_log_info::slave_running.
 
119
  The values 0,1,2 are very important: to keep the diff small, I didn't
 
120
  substitute places where we use 0/1 with the newly defined symbols. So don't change
 
121
  these values.
 
122
  The same way, code is assuming that in Relay_log_info we use only values
 
123
  0/1.
 
124
  I started with using an enum, but
 
125
  enum_variable=1; is not legal so would have required many line changes.
 
126
*/
 
127
#define DRIZZLE_SLAVE_NOT_RUN         0
 
128
#define DRIZZLE_SLAVE_RUN_NOT_CONNECT 1
 
129
#define DRIZZLE_SLAVE_RUN_CONNECT     2
 
130
 
 
131
#define RPL_LOG_NAME (rli->group_master_log_name.length() ? rli->group_master_log_name.c_str() : "FIRST")
 
132
#define IO_RPL_LOG_NAME (mi->getLogName() ? mi->getLogName() : "FIRST")
 
133
 
 
134
/*
 
135
  If the following is set, if first gives an error, second will be
 
136
  tried. Otherwise, if first fails, we fail.
 
137
*/
 
138
#define SLAVE_FORCE_ALL 4
 
139
 
 
140
int32_t init_slave();
 
141
void init_slave_skip_errors(const char* arg);
 
142
bool flush_relay_log_info(Relay_log_info* rli);
 
143
int32_t register_slave_on_master(DRIZZLE *drizzle);
 
144
int32_t terminate_slave_threads(Master_info* mi, int32_t thread_mask,
 
145
                             bool skip_lock = 0);
 
146
int32_t start_slave_threads(bool need_slave_mutex, bool wait_for_start,
 
147
                        Master_info* mi, const char* master_info_fname,
 
148
                        const char* slave_info_fname, int32_t thread_mask);
 
149
/*
 
150
  cond_lock is usually same as start_lock. It is needed for the case when
 
151
  start_lock is 0 which happens if start_slave_thread() is called already
 
152
  inside the start_lock section, but at the same time we want a
 
153
  pthread_cond_wait() on start_cond,start_lock
 
154
*/
 
155
int32_t start_slave_thread(pthread_handler h_func, pthread_mutex_t* start_lock,
 
156
                       pthread_mutex_t *cond_lock,
 
157
                       pthread_cond_t* start_cond,
 
158
                       volatile uint32_t *slave_running,
 
159
                       volatile uint32_t *slave_run_id,
 
160
                       Master_info* mi,
 
161
                       bool high_priority);
 
162
 
 
163
/* If fd is -1, dump to NET */
 
164
int32_t mysql_table_dump(Session* session, const char* db,
 
165
                     const char* tbl_name, int32_t fd = -1);
 
166
 
 
167
/* retrieve table from master and copy to slave*/
 
168
int32_t fetch_master_table(Session* session, const char* db_name, const char* table_name,
 
169
                       Master_info* mi, DRIZZLE *drizzle, bool overwrite);
 
170
 
 
171
bool show_master_info(Session* session, Master_info* mi);
 
172
bool show_binlog_info(Session* session);
 
173
bool rpl_master_has_bug(Relay_log_info *rli, uint32_t bug_id, bool report= true);
 
174
bool rpl_master_erroneous_autoinc(Session* session);
 
175
 
 
176
const char *print_slave_db_safe(const char *db);
 
177
int32_t check_expected_error(Session* session, Relay_log_info const *rli, int32_t error_code);
 
178
void skip_load_data_infile(NET* net);
 
179
 
 
180
void end_slave(); /* clean up */
 
181
void clear_until_condition(Relay_log_info* rli);
 
182
void clear_slave_error(Relay_log_info* rli);
 
183
void end_relay_log_info(Relay_log_info* rli);
 
184
void lock_slave_threads(Master_info* mi);
 
185
void unlock_slave_threads(Master_info* mi);
 
186
void init_thread_mask(int32_t* mask,Master_info* mi,bool inverse);
 
187
int32_t init_relay_log_pos(Relay_log_info* rli,const char* log,uint64_t pos,
 
188
                       bool need_data_lock, const char** errmsg,
 
189
                       bool look_for_description_event);
 
190
 
 
191
int32_t purge_relay_logs(Relay_log_info* rli, Session *session, bool just_reset,
 
192
                     const char** errmsg);
 
193
void set_slave_thread_options(Session* session);
 
194
void rotate_relay_log(Master_info* mi);
 
195
int32_t apply_event_and_update_pos(Log_event* ev, Session* session, Relay_log_info* rli,
 
196
                               bool skip);
 
197
 
 
198
pthread_handler_t handle_slave_io(void *arg);
 
199
pthread_handler_t handle_slave_sql(void *arg);
 
200
extern bool volatile abort_loop;
 
201
extern Master_info main_mi, *active_mi; /* active_mi for multi-master */
 
202
extern LIST master_list;
 
203
extern bool replicate_same_server_id;
 
204
 
 
205
extern int32_t disconnect_slave_event_count, abort_slave_event_count ;
 
206
 
 
207
/* the master variables are defaults read from drizzle.cnf or command line */
 
208
extern uint32_t master_port, master_connect_retry, report_port;
 
209
extern char * master_user, *master_password, *master_host;
 
210
extern char *master_info_file, *relay_log_info_file, *report_user;
 
211
extern char *report_host, *report_password;
 
212
 
 
213
extern bool master_ssl;
 
214
extern char *master_ssl_ca, *master_ssl_capath, *master_ssl_cert;
 
215
extern char *master_ssl_cipher, *master_ssl_key;
 
216
 
 
217
extern I_List<Session> threads;
 
218
 
 
219
 
 
220
/**
 
221
  @} (end of group Replication)
 
222
*/
 
223
 
 
224
#endif /* DRIZZLE_SERVER_SLAVE_H */