← Back to branch summary

~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to storage/innobase/include/srv0srv.h

Merged in latest plugin-slot-reorg.

Show diffs side-by-side

added added

removed removed

Lines of Context:
storage/innobase/include/srv0srv.h
1
 
/******************************************************
2
 
The server main program
3
 
 
4
 
(c) 1995 Innobase Oy
5
 
 
6
 
Created 10/10/1995 Heikki Tuuri
7
 
*******************************************************/
8
 
 
9
 
 
10
 
#ifndef srv0srv_h
11
 
#define srv0srv_h
12
 
 
13
 
#include "univ.i"
14
 
#include "sync0sync.h"
15
 
#include "os0sync.h"
16
 
#include "que0types.h"
17
 
#include "trx0types.h"
18
 
 
19
 
extern const char*      srv_main_thread_op_info;
20
 
 
21
 
/* Prefix used by MySQL to indicate pre-5.1 table name encoding */
22
 
extern const char       srv_mysql50_table_name_prefix[9];
23
 
 
24
 
/* When this event is set the lock timeout and InnoDB monitor
25
 
thread starts running */
26
 
extern os_event_t       srv_lock_timeout_thread_event;
27
 
 
28
 
/* If the last data file is auto-extended, we add this many pages to it
29
 
at a time */
30
 
#define SRV_AUTO_EXTEND_INCREMENT       \
31
 
        (srv_auto_extend_increment * ((1024 * 1024) / UNIV_PAGE_SIZE))
32
 
 
33
 
/* This is set to TRUE if the MySQL user has set it in MySQL */
34
 
extern ibool    srv_lower_case_table_names;
35
 
 
36
 
/* Mutex for locking srv_monitor_file */
37
 
extern mutex_t  srv_monitor_file_mutex;
38
 
/* Temporary file for innodb monitor output */
39
 
extern FILE*    srv_monitor_file;
40
 
/* Mutex for locking srv_dict_tmpfile.
41
 
This mutex has a very high rank; threads reserving it should not
42
 
be holding any InnoDB latches. */
43
 
extern mutex_t  srv_dict_tmpfile_mutex;
44
 
/* Temporary file for output from the data dictionary */
45
 
extern FILE*    srv_dict_tmpfile;
46
 
/* Mutex for locking srv_misc_tmpfile.
47
 
This mutex has a very low rank; threads reserving it should not
48
 
acquire any further latches or sleep before releasing this one. */
49
 
extern mutex_t  srv_misc_tmpfile_mutex;
50
 
/* Temporary file for miscellanous diagnostic output */
51
 
extern FILE*    srv_misc_tmpfile;
52
 
 
53
 
/* Server parameters which are read from the initfile */
54
 
 
55
 
extern char*    srv_data_home;
56
 
#ifdef UNIV_LOG_ARCHIVE
57
 
extern char*    srv_arch_dir;
58
 
#endif /* UNIV_LOG_ARCHIVE */
59
 
 
60
 
extern ibool    srv_file_per_table;
61
 
extern ibool    srv_locks_unsafe_for_binlog;
62
 
 
63
 
extern ulint    srv_n_data_files;
64
 
extern char**   srv_data_file_names;
65
 
extern ulint*   srv_data_file_sizes;
66
 
extern ulint*   srv_data_file_is_raw_partition;
67
 
 
68
 
extern ibool    srv_auto_extend_last_data_file;
69
 
extern ulint    srv_last_file_size_max;
70
 
extern ulong    srv_auto_extend_increment;
71
 
 
72
 
extern ibool    srv_created_new_raw;
73
 
 
74
 
#define SRV_NEW_RAW     1
75
 
#define SRV_OLD_RAW     2
76
 
 
77
 
extern char**   srv_log_group_home_dirs;
78
 
 
79
 
extern ulint    srv_n_log_groups;
80
 
extern ulint    srv_n_log_files;
81
 
extern ulint    srv_log_file_size;
82
 
extern ulint    srv_log_buffer_size;
83
 
extern ulong    srv_flush_log_at_trx_commit;
84
 
 
85
 
extern byte     srv_latin1_ordering[256];/* The sort order table of the latin1
86
 
                                        character set */
87
 
extern ulint    srv_awe_window_size;
88
 
 
89
 
extern ulint    srv_n_file_io_threads;
90
 
 
91
 
#ifdef UNIV_LOG_ARCHIVE
92
 
extern ibool    srv_log_archive_on;
93
 
extern ibool    srv_archive_recovery;
94
 
extern dulint   srv_archive_recovery_limit_lsn;
95
 
#endif /* UNIV_LOG_ARCHIVE */
96
 
 
97
 
extern ulint    srv_lock_wait_timeout;
98
 
 
99
 
extern char*    srv_file_flush_method_str;
100
 
extern ulint    srv_unix_file_flush_method;
101
 
extern ulint    srv_win_file_flush_method;
102
 
 
103
 
extern ulint    srv_max_n_open_files;
104
 
 
105
 
extern ulint    srv_max_dirty_pages_pct;
106
 
 
107
 
extern ulint    srv_force_recovery;
108
 
extern ulong    srv_thread_concurrency;
109
 
extern ulong    srv_commit_concurrency;
110
 
 
111
 
extern ulint    srv_max_n_threads;
112
 
 
113
 
extern lint     srv_conc_n_threads;
114
 
 
115
 
extern ulint    srv_fast_shutdown;       /* If this is 1, do not do a
116
 
                                         purge and index buffer merge.
117
 
                                         If this 2, do not even flush the
118
 
                                         buffer pool to data files at the
119
 
                                         shutdown: we effectively 'crash'
120
 
                                         InnoDB (but lose no committed
121
 
                                         transactions). */
122
 
extern ibool    srv_innodb_status;
123
 
 
124
 
extern ibool    srv_stats_on_metadata;
125
 
 
126
 
extern ibool    srv_use_doublewrite_buf;
127
 
extern ibool    srv_use_checksums;
128
 
 
129
 
extern ibool    srv_set_thread_priorities;
130
 
extern int      srv_query_thread_priority;
131
 
 
132
 
extern ulong    srv_max_buf_pool_modified_pct;
133
 
extern ulong    srv_max_purge_lag;
134
 
extern ibool    srv_use_awe;
135
 
extern ibool    srv_use_adaptive_hash_indexes;
136
 
/*-------------------------------------------*/
137
 
 
138
 
extern ulint    srv_n_rows_inserted;
139
 
extern ulint    srv_n_rows_updated;
140
 
extern ulint    srv_n_rows_deleted;
141
 
extern ulint    srv_n_rows_read;
142
 
 
143
 
extern ibool    srv_print_innodb_monitor;
144
 
extern ibool    srv_print_innodb_lock_monitor;
145
 
extern ibool    srv_print_innodb_tablespace_monitor;
146
 
extern ibool    srv_print_verbose_log;
147
 
extern ibool    srv_print_innodb_table_monitor;
148
 
 
149
 
extern ibool    srv_lock_timeout_and_monitor_active;
150
 
extern ibool    srv_error_monitor_active;
151
 
 
152
 
extern ulong    srv_n_spin_wait_rounds;
153
 
extern ulong    srv_n_free_tickets_to_enter;
154
 
extern ulong    srv_thread_sleep_delay;
155
 
extern ulint    srv_spin_wait_delay;
156
 
extern ibool    srv_priority_boost;
157
 
 
158
 
extern  ulint   srv_pool_size;
159
 
extern  ulint   srv_mem_pool_size;
160
 
extern  ulint   srv_lock_table_size;
161
 
 
162
 
extern  ibool   srv_print_thread_releases;
163
 
extern  ibool   srv_print_lock_waits;
164
 
extern  ibool   srv_print_buf_io;
165
 
extern  ibool   srv_print_log_io;
166
 
extern  ibool   srv_print_latch_waits;
167
 
 
168
 
extern ulint    srv_activity_count;
169
 
extern ulint    srv_fatal_semaphore_wait_threshold;
170
 
extern ulint    srv_dml_needed_delay;
171
 
 
172
 
extern mutex_t* kernel_mutex_temp;/* mutex protecting the server, trx structs,
173
 
                                query threads, and lock table: we allocate
174
 
                                it from dynamic memory to get it to the
175
 
                                same DRAM page as other hotspot semaphores */
176
 
#define kernel_mutex (*kernel_mutex_temp)
177
 
 
178
 
#define SRV_MAX_N_IO_THREADS    100
179
 
 
180
 
/* Array of English strings describing the current state of an
181
 
i/o handler thread */
182
 
extern const char* srv_io_thread_op_info[];
183
 
extern const char* srv_io_thread_function[];
184
 
 
185
 
/* the number of the log write requests done */
186
 
extern ulint srv_log_write_requests;
187
 
 
188
 
/* the number of physical writes to the log performed */
189
 
extern ulint srv_log_writes;
190
 
 
191
 
/* amount of data written to the log files in bytes */
192
 
extern ulint srv_os_log_written;
193
 
 
194
 
/* amount of writes being done to the log files */
195
 
extern ulint srv_os_log_pending_writes;
196
 
 
197
 
/* we increase this counter, when there we don't have enough space in the
198
 
log buffer and have to flush it */
199
 
extern ulint srv_log_waits;
200
 
 
201
 
/* variable that counts amount of data read in total (in bytes) */
202
 
extern ulint srv_data_read;
203
 
 
204
 
/* here we count the amount of data written in total (in bytes) */
205
 
extern ulint srv_data_written;
206
 
 
207
 
/* this variable counts the amount of times, when the doublewrite buffer
208
 
was flushed */
209
 
extern ulint srv_dblwr_writes;
210
 
 
211
 
/* here we store the number of pages that have been flushed to the
212
 
doublewrite buffer */
213
 
extern ulint srv_dblwr_pages_written;
214
 
 
215
 
/* here we store the number of times when we had to wait for a free page
216
 
in the buffer pool. It happens when the buffer pool is full and we need
217
 
to make a flush, in order to be able to read or create a page. */
218
 
extern ulint srv_buf_pool_wait_free;
219
 
 
220
 
/* variable to count the number of pages that were written from the
221
 
buffer pool to disk */
222
 
extern ulint srv_buf_pool_flushed;
223
 
 
224
 
/* variable to count the number of buffer pool reads that led to the
225
 
reading of a disk page */
226
 
extern ulint srv_buf_pool_reads;
227
 
 
228
 
/* variable to count the number of sequential read-aheads were done */
229
 
extern ulint srv_read_ahead_seq;
230
 
 
231
 
/* variable to count the number of random read-aheads were done */
232
 
extern ulint srv_read_ahead_rnd;
233
 
 
234
 
/* In this structure we store status variables to be passed to MySQL */
235
 
typedef struct export_var_struct export_struc;
236
 
 
237
 
extern export_struc export_vars;
238
 
 
239
 
typedef struct srv_sys_struct   srv_sys_t;
240
 
 
241
 
/* The server system */
242
 
extern srv_sys_t*       srv_sys;
243
 
 
244
 
/* Alternatives for the file flush option in Unix; see the InnoDB manual
245
 
about what these mean */
246
 
#define SRV_UNIX_FSYNC          1       /* This is the default */
247
 
#define SRV_UNIX_O_DSYNC        2
248
 
#define SRV_UNIX_LITTLESYNC     3
249
 
#define SRV_UNIX_NOSYNC         4
250
 
#define SRV_UNIX_O_DIRECT       5
251
 
 
252
 
/* Alternatives for file i/o in Windows */
253
 
#define SRV_WIN_IO_NORMAL               1
254
 
#define SRV_WIN_IO_UNBUFFERED           2       /* This is the default */
255
 
 
256
 
/* Alternatives for srv_force_recovery. Non-zero values are intended
257
 
to help the user get a damaged database up so that he can dump intact
258
 
tables and rows with SELECT INTO OUTFILE. The database must not otherwise
259
 
be used with these options! A bigger number below means that all precautions
260
 
of lower numbers are included. */
261
 
 
262
 
#define SRV_FORCE_IGNORE_CORRUPT 1      /* let the server run even if it
263
 
                                        detects a corrupt page */
264
 
#define SRV_FORCE_NO_BACKGROUND 2       /* prevent the main thread from
265
 
                                        running: if a crash would occur
266
 
                                        in purge, this prevents it */
267
 
#define SRV_FORCE_NO_TRX_UNDO   3       /* do not run trx rollback after
268
 
                                        recovery */
269
 
#define SRV_FORCE_NO_IBUF_MERGE 4       /* prevent also ibuf operations:
270
 
                                        if they would cause a crash, better
271
 
                                        not do them */
272
 
#define SRV_FORCE_NO_UNDO_LOG_SCAN 5    /* do not look at undo logs when
273
 
                                        starting the database: InnoDB will
274
 
                                        treat even incomplete transactions
275
 
                                        as committed */
276
 
#define SRV_FORCE_NO_LOG_REDO   6       /* do not do the log roll-forward
277
 
                                        in connection with recovery */
278
 
 
279
 
/*************************************************************************
280
 
Boots Innobase server. */
281
 
 
282
 
ulint
283
 
srv_boot(void);
284
 
/*==========*/
285
 
                        /* out: DB_SUCCESS or error code */
286
 
/*************************************************************************
287
 
Initializes the server. */
288
 
 
289
 
void
290
 
srv_init(void);
291
 
/*==========*/
292
 
/*************************************************************************
293
 
Frees the OS fast mutex created in srv_boot(). */
294
 
 
295
 
void
296
 
srv_free(void);
297
 
/*==========*/
298
 
/*************************************************************************
299
 
Initializes the synchronization primitives, memory system, and the thread
300
 
local storage. */
301
 
 
302
 
void
303
 
srv_general_init(void);
304
 
/*==================*/
305
 
/*************************************************************************
306
 
Gets the number of threads in the system. */
307
 
 
308
 
ulint
309
 
srv_get_n_threads(void);
310
 
/*===================*/
311
 
/*************************************************************************
312
 
Returns the calling thread type. */
313
 
 
314
 
ulint
315
 
srv_get_thread_type(void);
316
 
/*=====================*/
317
 
                        /* out: SRV_COM, ... */
318
 
/*************************************************************************
319
 
Sets the info describing an i/o thread current state. */
320
 
 
321
 
void
322
 
srv_set_io_thread_op_info(
323
 
/*======================*/
324
 
        ulint           i,      /* in: the 'segment' of the i/o thread */
325
 
        const char*     str);   /* in: constant char string describing the
326
 
                                state */
327
 
/*************************************************************************
328
 
Releases threads of the type given from suspension in the thread table.
329
 
NOTE! The server mutex has to be reserved by the caller! */
330
 
 
331
 
ulint
332
 
srv_release_threads(
333
 
/*================*/
334
 
                        /* out: number of threads released: this may be
335
 
                        < n if not enough threads were suspended at the
336
 
                        moment */
337
 
        ulint   type,   /* in: thread type */
338
 
        ulint   n);     /* in: number of threads to release */
339
 
/*************************************************************************
340
 
The master thread controlling the server. */
341
 
 
342
 
os_thread_ret_t
343
 
srv_master_thread(
344
 
/*==============*/
345
 
                        /* out: a dummy parameter */
346
 
        void*   arg);   /* in: a dummy parameter required by
347
 
                        os_thread_create */
348
 
/***********************************************************************
349
 
Tells the Innobase server that there has been activity in the database
350
 
and wakes up the master thread if it is suspended (not sleeping). Used
351
 
in the MySQL interface. Note that there is a small chance that the master
352
 
thread stays suspended (we do not protect our operation with the kernel
353
 
mutex, for performace reasons). */
354
 
 
355
 
void
356
 
srv_active_wake_master_thread(void);
357
 
/*===============================*/
358
 
/***********************************************************************
359
 
Wakes up the master thread if it is suspended or being suspended. */
360
 
 
361
 
void
362
 
srv_wake_master_thread(void);
363
 
/*========================*/
364
 
/*************************************************************************
365
 
Puts an OS thread to wait if there are too many concurrent threads
366
 
(>= srv_thread_concurrency) inside InnoDB. The threads wait in a FIFO queue. */
367
 
 
368
 
void
369
 
srv_conc_enter_innodb(
370
 
/*==================*/
371
 
        trx_t*  trx);   /* in: transaction object associated with the
372
 
                        thread */
373
 
/*************************************************************************
374
 
This lets a thread enter InnoDB regardless of the number of threads inside
375
 
InnoDB. This must be called when a thread ends a lock wait. */
376
 
 
377
 
void
378
 
srv_conc_force_enter_innodb(
379
 
/*========================*/
380
 
        trx_t*  trx);   /* in: transaction object associated with the
381
 
                        thread */
382
 
/*************************************************************************
383
 
This must be called when a thread exits InnoDB in a lock wait or at the
384
 
end of an SQL statement. */
385
 
 
386
 
void
387
 
srv_conc_force_exit_innodb(
388
 
/*=======================*/
389
 
        trx_t*  trx);   /* in: transaction object associated with the
390
 
                        thread */
391
 
/*************************************************************************
392
 
This must be called when a thread exits InnoDB. */
393
 
 
394
 
void
395
 
srv_conc_exit_innodb(
396
 
/*=================*/
397
 
        trx_t*  trx);   /* in: transaction object associated with the
398
 
                        thread */
399
 
/*******************************************************************
400
 
Puts a MySQL OS thread to wait for a lock to be released. If an error
401
 
occurs during the wait trx->error_state associated with thr is
402
 
!= DB_SUCCESS when we return. DB_LOCK_WAIT_TIMEOUT and DB_DEADLOCK
403
 
are possible errors. DB_DEADLOCK is returned if selective deadlock
404
 
resolution chose this transaction as a victim. */
405
 
 
406
 
void
407
 
srv_suspend_mysql_thread(
408
 
/*=====================*/
409
 
        que_thr_t*      thr);   /* in: query thread associated with the MySQL
410
 
                                OS thread */
411
 
/************************************************************************
412
 
Releases a MySQL OS thread waiting for a lock to be released, if the
413
 
thread is already suspended. */
414
 
 
415
 
void
416
 
srv_release_mysql_thread_if_suspended(
417
 
/*==================================*/
418
 
        que_thr_t*      thr);   /* in: query thread associated with the
419
 
                                MySQL OS thread  */
420
 
/*************************************************************************
421
 
A thread which wakes up threads whose lock wait may have lasted too long.
422
 
This also prints the info output by various InnoDB monitors. */
423
 
 
424
 
os_thread_ret_t
425
 
srv_lock_timeout_and_monitor_thread(
426
 
/*================================*/
427
 
                        /* out: a dummy parameter */
428
 
        void*   arg);   /* in: a dummy parameter required by
429
 
                        os_thread_create */
430
 
/*************************************************************************
431
 
A thread which prints warnings about semaphore waits which have lasted
432
 
too long. These can be used to track bugs which cause hangs. */
433
 
 
434
 
os_thread_ret_t
435
 
srv_error_monitor_thread(
436
 
/*=====================*/
437
 
                        /* out: a dummy parameter */
438
 
        void*   arg);   /* in: a dummy parameter required by
439
 
                        os_thread_create */
440
 
/**********************************************************************
441
 
Outputs to a file the output of the InnoDB Monitor. */
442
 
 
443
 
void
444
 
srv_printf_innodb_monitor(
445
 
/*======================*/
446
 
        FILE*   file,           /* in: output stream */
447
 
        ulint*  trx_start,      /* out: file position of the start of
448
 
                                the list of active transactions */
449
 
        ulint*  trx_end);       /* out: file position of the end of
450
 
                                the list of active transactions */
451
 
 
452
 
/**********************************************************************
453
 
Function to pass InnoDB status variables to MySQL */
454
 
 
455
 
void
456
 
srv_export_innodb_status(void);
457
 
/*=====================*/
458
 
 
459
 
/* Types for the threads existing in the system. Threads of types 4 - 9
460
 
are called utility threads. Note that utility threads are mainly disk
461
 
bound, except that version threads 6 - 7 may also be CPU bound, if
462
 
cleaning versions from the buffer pool. */
463
 
 
464
 
#define SRV_COM         1       /* threads serving communication and queries */
465
 
#define SRV_CONSOLE     2       /* thread serving console */
466
 
#define SRV_WORKER      3       /* threads serving parallelized queries and
467
 
                                queries released from lock wait */
468
 
#define SRV_BUFFER      4       /* thread flushing dirty buffer blocks,
469
 
                                not currently in use */
470
 
#define SRV_RECOVERY    5       /* threads finishing a recovery,
471
 
                                not currently in use */
472
 
#define SRV_INSERT      6       /* thread flushing the insert buffer to disk,
473
 
                                not currently in use */
474
 
#define SRV_MASTER      7       /* the master thread, (whose type number must
475
 
                                be biggest) */
476
 
 
477
 
/* Thread slot in the thread table */
478
 
typedef struct srv_slot_struct  srv_slot_t;
479
 
 
480
 
/* Thread table is an array of slots */
481
 
typedef srv_slot_t      srv_table_t;
482
 
 
483
 
/* In this structure we store status variables to be passed to MySQL */
484
 
struct export_var_struct{
485
 
        ulint innodb_data_pending_reads;
486
 
        ulint innodb_data_pending_writes;
487
 
        ulint innodb_data_pending_fsyncs;
488
 
        ulint innodb_data_fsyncs;
489
 
        ulint innodb_data_read;
490
 
        ulint innodb_data_writes;
491
 
        ulint innodb_data_written;
492
 
        ulint innodb_data_reads;
493
 
        ulint innodb_buffer_pool_pages_total;
494
 
        ulint innodb_buffer_pool_pages_data;
495
 
        ulint innodb_buffer_pool_pages_dirty;
496
 
        ulint innodb_buffer_pool_pages_misc;
497
 
        ulint innodb_buffer_pool_pages_free;
498
 
        ulint innodb_buffer_pool_pages_latched;
499
 
        ulint innodb_buffer_pool_read_requests;
500
 
        ulint innodb_buffer_pool_reads;
501
 
        ulint innodb_buffer_pool_wait_free;
502
 
        ulint innodb_buffer_pool_pages_flushed;
503
 
        ulint innodb_buffer_pool_write_requests;
504
 
        ulint innodb_buffer_pool_read_ahead_seq;
505
 
        ulint innodb_buffer_pool_read_ahead_rnd;
506
 
        ulint innodb_dblwr_pages_written;
507
 
        ulint innodb_dblwr_writes;
508
 
        ulint innodb_log_waits;
509
 
        ulint innodb_log_write_requests;
510
 
        ulint innodb_log_writes;
511
 
        ulint innodb_os_log_written;
512
 
        ulint innodb_os_log_fsyncs;
513
 
        ulint innodb_os_log_pending_writes;
514
 
        ulint innodb_os_log_pending_fsyncs;
515
 
        ulint innodb_page_size;
516
 
        ulint innodb_pages_created;
517
 
        ulint innodb_pages_read;
518
 
        ulint innodb_pages_written;
519
 
        ulint innodb_row_lock_waits;
520
 
        ulint innodb_row_lock_current_waits;
521
 
        ib_longlong innodb_row_lock_time;
522
 
        ulint innodb_row_lock_time_avg;
523
 
        ulint innodb_row_lock_time_max;
524
 
        ulint innodb_rows_read;
525
 
        ulint innodb_rows_inserted;
526
 
        ulint innodb_rows_updated;
527
 
        ulint innodb_rows_deleted;
528
 
};
529
 
 
530
 
/* The server system struct */
531
 
struct srv_sys_struct{
532
 
        srv_table_t*    threads;        /* server thread table */
533
 
        UT_LIST_BASE_NODE_T(que_thr_t)
534
 
                        tasks;          /* task queue */
535
 
        dict_index_t*   dummy_ind1;     /* dummy index for old-style
536
 
                                        supremum and infimum records */
537
 
        dict_index_t*   dummy_ind2;     /* dummy index for new-style
538
 
                                        supremum and infimum records */
539
 
};
540
 
 
541
 
extern ulint    srv_n_threads_active[];
542
 
 
543
 
#endif
544