/***************************************************************************** Copyright (c) 1995, 2017, Oracle and/or its affiliates. All rights reserved. Copyright (c) 2008, 2009, Google Inc. Copyright (c) 2009, Percona Inc. Copyright (c) 2013, 2017, MariaDB Corporation. Portions of this file contain modifications contributed and copyrighted by Google, Inc. Those modifications are gratefully acknowledged and are described briefly in the InnoDB documentation. The contributions by Google are incorporated with their permission, and subject to the conditions contained in the file COPYING.Google. Portions of this file contain modifications contributed and copyrighted by Percona Inc.. Those modifications are gratefully acknowledged and are described briefly in the InnoDB documentation. The contributions by Percona Inc. are incorporated with their permission, and subject to the conditions contained in the file COPYING.Percona. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Suite 500, Boston, MA 02110-1335 USA *****************************************************************************/ /**************************************************//** @file include/srv0srv.h The server main program Created 10/10/1995 Heikki Tuuri *******************************************************/ #ifndef srv0srv_h #define srv0srv_h #include "univ.i" #ifndef UNIV_HOTBACKUP #include "log0log.h" #include "sync0sync.h" #include "os0sync.h" #include "que0types.h" #include "trx0types.h" #include "srv0conc.h" #include "buf0checksum.h" #include "ut0counter.h" /* Global counters used inside InnoDB. */ struct srv_stats_t { typedef ib_counter_t ulint_ctr_64_t; typedef simple_counter lsn_ctr_1_t; typedef simple_counter ulint_ctr_1_t; typedef simple_counter ib_int64_ctr_1_t; /** Count the amount of data written in total (in bytes) */ ulint_ctr_1_t data_written; /** Number of the log write requests done */ ulint_ctr_1_t log_write_requests; /** Number of physical writes to the log performed */ ulint_ctr_1_t log_writes; /** Amount of data written to the log files in bytes */ lsn_ctr_1_t os_log_written; /** Number of writes being done to the log files. Protected by log_sys->write_mutex. */ ulint_ctr_1_t os_log_pending_writes; /** We increase this counter, when we don't have enough space in the log buffer and have to flush it */ ulint_ctr_1_t log_waits; /** Count the number of times the doublewrite buffer was flushed */ ulint_ctr_1_t dblwr_writes; /** Store the number of pages that have been flushed to the doublewrite buffer */ ulint_ctr_1_t dblwr_pages_written; /** Store the number of write requests issued */ ulint_ctr_1_t buf_pool_write_requests; /** Store the number of times when we had to wait for a free page in the buffer pool. It happens when the buffer pool is full and we need to make a flush, in order to be able to read or create a page. */ ulint_ctr_1_t buf_pool_wait_free; /** Count the number of pages that were written from buffer pool to the disk */ ulint_ctr_1_t buf_pool_flushed; /** Number of buffer pool reads that led to the reading of a disk page */ ulint_ctr_1_t buf_pool_reads; /** Number of bytes saved by page compression */ ulint_ctr_64_t page_compression_saved; /** Number of 512Byte TRIM by page compression */ ulint_ctr_64_t page_compression_trim_sect512; /** Number of 1K TRIM by page compression */ ulint_ctr_64_t page_compression_trim_sect1024; /** Number of 2K TRIM by page compression */ ulint_ctr_64_t page_compression_trim_sect2048; /** Number of 4K TRIM by page compression */ ulint_ctr_64_t page_compression_trim_sect4096; /** Number of 8K TRIM by page compression */ ulint_ctr_64_t page_compression_trim_sect8192; /** Number of 16K TRIM by page compression */ ulint_ctr_64_t page_compression_trim_sect16384; /** Number of 32K TRIM by page compression */ ulint_ctr_64_t page_compression_trim_sect32768; /* Number of index pages written */ ulint_ctr_64_t index_pages_written; /* Number of non index pages written */ ulint_ctr_64_t non_index_pages_written; /* Number of pages compressed with page compression */ ulint_ctr_64_t pages_page_compressed; /* Number of TRIM operations induced by page compression */ ulint_ctr_64_t page_compressed_trim_op; /* Number of TRIM operations saved by using actual write size knowledge */ ulint_ctr_64_t page_compressed_trim_op_saved; /* Number of pages decompressed with page compression */ ulint_ctr_64_t pages_page_decompressed; /* Number of page compression errors */ ulint_ctr_64_t pages_page_compression_error; /* Number of pages encrypted */ ulint_ctr_64_t pages_encrypted; /* Number of pages decrypted */ ulint_ctr_64_t pages_decrypted; /* Number of merge blocks encrypted */ ulint_ctr_64_t n_merge_blocks_encrypted; /* Number of merge blocks decrypted */ ulint_ctr_64_t n_merge_blocks_decrypted; /* Number of row log blocks encrypted */ ulint_ctr_64_t n_rowlog_blocks_encrypted; /* Number of row log blocks decrypted */ ulint_ctr_64_t n_rowlog_blocks_decrypted; /** Number of data read in total (in bytes) */ ulint_ctr_1_t data_read; /** Wait time of database locks */ ib_int64_ctr_1_t n_lock_wait_time; /** Number of database lock waits */ ulint_ctr_1_t n_lock_wait_count; /** Number of threads currently waiting on database locks */ simple_counter n_lock_wait_current_count; /** Number of rows read. */ ulint_ctr_64_t n_rows_read; /** Number of rows updated */ ulint_ctr_64_t n_rows_updated; /** Number of rows deleted */ ulint_ctr_64_t n_rows_deleted; /** Number of rows inserted */ ulint_ctr_64_t n_rows_inserted; /** Number of system rows read. */ ulint_ctr_64_t n_system_rows_read; /** Number of system rows updated */ ulint_ctr_64_t n_system_rows_updated; /** Number of system rows deleted */ ulint_ctr_64_t n_system_rows_deleted; /** Number of system rows inserted */ ulint_ctr_64_t n_system_rows_inserted; /** Number of times secondary index lookup triggered cluster lookup */ ulint_ctr_64_t n_sec_rec_cluster_reads; /** Number of times prefix optimization avoided triggering cluster lookup */ ulint_ctr_64_t n_sec_rec_cluster_reads_avoided; /** Number of times page 0 is read from tablespace */ ulint_ctr_64_t page0_read; /** Number of encryption_get_latest_key_version calls */ ulint_ctr_64_t n_key_requests; /** Number of spaces in keyrotation list */ ulint_ctr_64_t key_rotation_list_length; }; extern const char* srv_main_thread_op_info; /** Prefix used by MySQL to indicate pre-5.1 table name encoding */ extern const char srv_mysql50_table_name_prefix[10]; /** Event to signal srv_monitor_thread. Not protected by a mutex. Set after setting srv_print_innodb_monitor. */ extern os_event_t srv_monitor_event; /** Event to signal the shutdown of srv_error_monitor_thread. Not protected by a mutex. */ extern os_event_t srv_error_event; /** Event for waking up buf_dump_thread. Not protected by a mutex. Set on shutdown or by buf_dump_start() or buf_load_start(). */ extern os_event_t srv_buf_dump_event; /** The buffer pool dump/load file name */ #define SRV_BUF_DUMP_FILENAME_DEFAULT "ib_buffer_pool" extern char* srv_buf_dump_filename; /** Boolean config knobs that tell InnoDB to dump the buffer pool at shutdown and/or load it during startup. */ extern char srv_buffer_pool_dump_at_shutdown; extern char srv_buffer_pool_load_at_startup; /* Whether to disable file system cache if it is defined */ extern char srv_disable_sort_file_cache; /* If the last data file is auto-extended, we add this many pages to it at a time */ #define SRV_AUTO_EXTEND_INCREMENT \ (srv_auto_extend_increment * ((1024 * 1024) / UNIV_PAGE_SIZE)) /* Mutex for locking srv_monitor_file. Not created if srv_read_only_mode */ extern ib_mutex_t srv_monitor_file_mutex; /* Temporary file for innodb monitor output */ extern FILE* srv_monitor_file; /* Mutex for locking srv_dict_tmpfile. Only created if !srv_read_only_mode. This mutex has a very high rank; threads reserving it should not be holding any InnoDB latches. */ extern ib_mutex_t srv_dict_tmpfile_mutex; /* Temporary file for output from the data dictionary */ extern FILE* srv_dict_tmpfile; /* Mutex for locking srv_misc_tmpfile. Only created if !srv_read_only_mode. This mutex has a very low rank; threads reserving it should not acquire any further latches or sleep before releasing this one. */ extern ib_mutex_t srv_misc_tmpfile_mutex; /* Temporary file for miscellanous diagnostic output */ extern FILE* srv_misc_tmpfile; /* Server parameters which are read from the initfile */ extern char* srv_data_home; #ifdef UNIV_LOG_ARCHIVE extern char* srv_arch_dir; #endif /* UNIV_LOG_ARCHIVE */ /** Set if InnoDB must operate in read-only mode. We don't do any recovery and open all tables in RO mode instead of RW mode. We don't sync the max trx id to disk either. */ extern my_bool srv_read_only_mode; /** Set if InnoDB operates in read-only mode or innodb-force-recovery is greater than SRV_FORCE_NO_TRX_UNDO. */ extern my_bool high_level_read_only; /** store to its own file each table created by an user; data dictionary tables are in the system tablespace 0 */ extern my_bool srv_file_per_table; /** Sleep delay for threads waiting to enter InnoDB. In micro-seconds. */ extern ulong srv_thread_sleep_delay; #if defined(HAVE_ATOMIC_BUILTINS) /** Maximum sleep delay (in micro-seconds), value of 0 disables it.*/ extern ulong srv_adaptive_max_sleep_delay; #endif /* HAVE_ATOMIC_BUILTINS */ /** The file format to use on new *.ibd files. */ extern ulint srv_file_format; /** Whether to check file format during startup. A value of UNIV_FORMAT_MAX + 1 means no checking ie. FALSE. The default is to set it to the highest format we support. */ extern ulint srv_max_file_format_at_startup; /** Place locks to records only i.e. do not use next-key locking except on duplicate key checking and foreign key checking */ extern ibool srv_locks_unsafe_for_binlog; /** Sort buffer size in index creation */ extern ulong srv_sort_buf_size; /** Maximum modification log file size for online index creation */ extern unsigned long long srv_online_max_size; /* If this flag is TRUE, then we will use the native aio of the OS (provided we compiled Innobase with it in), otherwise we will use simulated aio we build below with threads. Currently we support native aio on windows and linux */ extern my_bool srv_use_native_aio; extern my_bool srv_numa_interleave; /* Use trim operation */ extern my_bool srv_use_trim; /* Use posix fallocate */ #ifdef HAVE_POSIX_FALLOCATE extern my_bool srv_use_posix_fallocate; #endif /* Use atomic writes i.e disable doublewrite buffer */ extern my_bool srv_use_atomic_writes; /* Compression algorithm*/ extern ulong innodb_compression_algorithm; /* Number of flush threads */ #define MTFLUSH_MAX_WORKER 64 #define MTFLUSH_DEFAULT_WORKER 8 /* Number of threads used for multi-threaded flush */ extern long srv_mtflush_threads; /* If this flag is TRUE, then we will use multi threaded flush. */ extern my_bool srv_use_mtflush; #ifdef __WIN__ extern ibool srv_use_native_conditions; #endif /* __WIN__ */ #endif /* !UNIV_HOTBACKUP */ /** Server undo tablespaces directory, can be absolute path. */ extern char* srv_undo_dir; /** Number of undo tablespaces to use. */ extern ulong srv_undo_tablespaces; /** The number of UNDO tablespaces that are open and ready to use. */ extern ulint srv_undo_tablespaces_open; /* The number of undo segments to use */ extern ulong srv_undo_logs; extern ulint srv_n_data_files; extern char** srv_data_file_names; extern ulint* srv_data_file_sizes; extern ulint* srv_data_file_is_raw_partition; extern uint srv_n_fil_crypt_threads; extern uint srv_n_fil_crypt_threads_started; extern ibool srv_auto_extend_last_data_file; extern ulint srv_last_file_size_max; extern char* srv_log_group_home_dir; #ifndef UNIV_HOTBACKUP extern ulong srv_auto_extend_increment; extern ibool srv_created_new_raw; /* Optimize prefix index queries to skip cluster index lookup when possible */ /* Enables or disables this prefix optimization. Disabled by default. */ extern my_bool srv_prefix_index_cluster_optimization; /** Maximum number of srv_n_log_files, or innodb_log_files_in_group */ #define SRV_N_LOG_FILES_MAX 100 extern ulong srv_n_log_files; extern ib_uint64_t srv_log_file_size; extern ib_uint64_t srv_log_file_size_requested; extern ulint srv_log_buffer_size; extern ulong srv_flush_log_at_trx_commit; extern uint srv_flush_log_at_timeout; extern char srv_adaptive_flushing; #ifdef WITH_INNODB_DISALLOW_WRITES /* When this event is reset we do not allow any file writes to take place. */ extern os_event_t srv_allow_writes_event; #endif /* WITH_INNODB_DISALLOW_WRITES */ /* If this flag is TRUE, then we will load the indexes' (and tables') metadata even if they are marked as "corrupted". Mostly it is for DBA to process corrupted index and table */ extern my_bool srv_load_corrupted; /* The sort order table of the MySQL latin1_swedish_ci character set collation */ extern const byte* srv_latin1_ordering; #ifndef UNIV_HOTBACKUP extern my_bool srv_use_sys_malloc; #else extern ibool srv_use_sys_malloc; #endif /* UNIV_HOTBACKUP */ extern ulint srv_buf_pool_size; /*!< requested size in bytes */ extern ulint srv_buf_pool_instances; /*!< requested number of buffer pool instances */ extern ulong srv_n_page_hash_locks; /*!< number of locks to protect buf_pool->page_hash */ extern ulong srv_LRU_scan_depth; /*!< Scan depth for LRU flush batch */ extern ulong srv_flush_neighbors; /*!< whether or not to flush neighbors of a block */ extern ulint srv_buf_pool_old_size; /*!< previously requested size */ extern ulint srv_buf_pool_curr_size; /*!< current size in bytes */ extern ulong srv_buf_pool_dump_pct; /*!< dump that may % of each buffer pool during BP dump */ extern ulint srv_mem_pool_size; extern ulint srv_lock_table_size; extern ulint srv_n_file_io_threads; extern my_bool srv_random_read_ahead; extern ulong srv_read_ahead_threshold; extern ulint srv_n_read_io_threads; extern ulint srv_n_write_io_threads; /* Defragmentation, Origianlly facebook default value is 100, but it's too high */ #define SRV_DEFRAGMENT_FREQUENCY_DEFAULT 40 extern my_bool srv_defragment; extern uint srv_defragment_n_pages; extern uint srv_defragment_stats_accuracy; extern uint srv_defragment_fill_factor_n_recs; extern double srv_defragment_fill_factor; extern uint srv_defragment_frequency; extern ulonglong srv_defragment_interval; extern ulong srv_idle_flush_pct; /* Number of IO operations per second the server can do */ extern ulong srv_io_capacity; /* We use this dummy default value at startup for max_io_capacity. The real value is set based on the value of io_capacity. */ #define SRV_MAX_IO_CAPACITY_DUMMY_DEFAULT (~0UL) #define SRV_MAX_IO_CAPACITY_LIMIT (~0UL) extern ulong srv_max_io_capacity; /* Returns the number of IO operations that is X percent of the capacity. PCT_IO(5) -> returns the number of IO operations that is 5% of the max where max is srv_io_capacity. */ #define PCT_IO(p) ((ulong) (srv_io_capacity * ((double) (p) / 100.0))) /* The "innodb_stats_method" setting, decides how InnoDB is going to treat NULL value when collecting statistics. It is not defined as enum type because the configure option takes unsigned integer type. */ extern ulong srv_innodb_stats_method; #ifdef UNIV_LOG_ARCHIVE extern ibool srv_log_archive_on; extern ibool srv_archive_recovery; extern ib_uint64_t srv_archive_recovery_limit_lsn; #endif /* UNIV_LOG_ARCHIVE */ extern char* srv_file_flush_method_str; extern ulint srv_unix_file_flush_method; extern ulint srv_win_file_flush_method; extern ulint srv_max_n_open_files; extern double srv_max_dirty_pages_pct; extern double srv_max_dirty_pages_pct_lwm; extern double srv_adaptive_flushing_lwm; extern ulong srv_flushing_avg_loops; extern ulong srv_force_recovery; extern ulint srv_fast_shutdown; /*!< If this is 1, do not do a purge and index buffer merge. If this 2, do not even flush the buffer pool to data files at the shutdown: we effectively 'crash' InnoDB (but lose no committed transactions). */ extern ibool srv_innodb_status; extern unsigned long long srv_stats_transient_sample_pages; extern my_bool srv_stats_persistent; extern unsigned long long srv_stats_persistent_sample_pages; extern my_bool srv_stats_auto_recalc; extern unsigned long long srv_stats_modified_counter; extern my_bool srv_stats_sample_traditional; extern my_bool srv_stats_include_delete_marked; extern ibool srv_use_doublewrite_buf; extern ulong srv_doublewrite_batch_size; extern my_bool srv_force_primary_key; extern double srv_max_buf_pool_modified_pct; extern ulong srv_max_purge_lag; extern ulong srv_max_purge_lag_delay; extern ulong srv_replication_delay; /*-------------------------------------------*/ extern my_bool srv_print_innodb_monitor; extern my_bool srv_print_innodb_lock_monitor; extern ibool srv_print_innodb_tablespace_monitor; extern ibool srv_print_verbose_log; #define DEPRECATED_MSG_INNODB_TABLE_MONITOR \ "Using innodb_table_monitor is deprecated and it may be removed " \ "in future releases. Please use the InnoDB INFORMATION_SCHEMA " \ "tables instead, see " REFMAN "innodb-i_s-tables.html" extern ibool srv_print_innodb_table_monitor; extern bool srv_monitor_active; extern bool srv_error_monitor_active; /* TRUE during the lifetime of the buffer pool dump/load thread */ extern bool srv_buf_dump_thread_active; /* TRUE during the lifetime of the stats thread */ extern bool srv_dict_stats_thread_active; /* TRUE if enable log scrubbing */ extern my_bool srv_scrub_log; extern ulong srv_n_spin_wait_rounds; extern ulong srv_n_free_tickets_to_enter; extern ulong srv_thread_sleep_delay; extern ulong srv_spin_wait_delay; extern ibool srv_priority_boost; extern ulint srv_truncated_status_writes; extern ulint srv_available_undo_logs; extern ulint srv_mem_pool_size; extern ulint srv_lock_table_size; #ifdef UNIV_DEBUG extern ibool srv_print_thread_releases; extern ibool srv_print_lock_waits; extern ibool srv_print_buf_io; extern ibool srv_print_log_io; extern ibool srv_print_latch_waits; #else /* UNIV_DEBUG */ # define srv_print_thread_releases FALSE # define srv_print_lock_waits FALSE # define srv_print_buf_io FALSE # define srv_print_log_io FALSE # define srv_print_latch_waits FALSE #endif /* UNIV_DEBUG */ #if defined UNIV_DEBUG || defined UNIV_IBUF_DEBUG extern my_bool srv_ibuf_disable_background_merge; #endif /* UNIV_DEBUG || UNIV_IBUF_DEBUG */ #ifdef UNIV_DEBUG extern my_bool srv_purge_view_update_only_debug; extern uint srv_sys_space_size_debug; #endif /* UNIV_DEBUG */ #define SRV_SEMAPHORE_WAIT_EXTENSION 7200 extern ulint srv_dml_needed_delay; #ifndef HAVE_ATOMIC_BUILTINS /** Mutex protecting some server global variables. */ extern ib_mutex_t server_mutex; #endif /* !HAVE_ATOMIC_BUILTINS */ #define SRV_MAX_N_IO_THREADS 130 /* Array of English strings describing the current state of an i/o handler thread */ extern const char* srv_io_thread_op_info[]; extern const char* srv_io_thread_function[]; /* the number of purge threads to use from the worker pool (currently 0 or 1) */ extern ulong srv_n_purge_threads; /* the number of pages to purge in one batch */ extern ulong srv_purge_batch_size; /* the number of sync wait arrays */ extern ulong srv_sync_array_size; /* print all user-level transactions deadlocks to mysqld stderr */ extern my_bool srv_print_all_deadlocks; extern my_bool srv_cmp_per_index_enabled; /* is encryption enabled */ extern ulong srv_encrypt_tables; /** Status variables to be passed to MySQL */ extern struct export_var_t export_vars; /** Global counters */ extern srv_stats_t srv_stats; /** Simulate compression failures. */ extern uint srv_simulate_comp_failures; /** Fatal semaphore wait threshold = maximum number of seconds that semaphore times out in InnoDB */ #define DEFAULT_SRV_FATAL_SEMAPHORE_TIMEOUT 600 extern ulong srv_fatal_semaphore_wait_threshold; /** Enable semaphore request instrumentation */ extern my_bool srv_instrument_semaphores; /** Buffer pool dump status frequence in percentages */ extern ulong srv_buf_dump_status_frequency; # ifdef UNIV_PFS_THREAD /* Keys to register InnoDB threads with performance schema */ extern mysql_pfs_key_t buf_page_cleaner_thread_key; extern mysql_pfs_key_t trx_rollback_clean_thread_key; extern mysql_pfs_key_t io_handler_thread_key; extern mysql_pfs_key_t srv_lock_timeout_thread_key; extern mysql_pfs_key_t srv_error_monitor_thread_key; extern mysql_pfs_key_t srv_monitor_thread_key; extern mysql_pfs_key_t srv_master_thread_key; extern mysql_pfs_key_t srv_purge_thread_key; extern mysql_pfs_key_t recv_writer_thread_key; /* This macro register the current thread and its key with performance schema */ # define pfs_register_thread(key) \ do { \ struct PSI_thread* psi = PSI_THREAD_CALL(new_thread)(key, NULL, 0);\ PSI_THREAD_CALL(set_thread)(psi); \ } while (0) /* This macro delist the current thread from performance schema */ # define pfs_delete_thread() \ do { \ PSI_THREAD_CALL(delete_current_thread)(); \ } while (0) # endif /* UNIV_PFS_THREAD */ #endif /* !UNIV_HOTBACKUP */ /** Types of raw partitions in innodb_data_file_path */ enum { SRV_NOT_RAW = 0, /*!< Not a raw partition */ SRV_NEW_RAW, /*!< A 'newraw' partition, only to be initialized */ SRV_OLD_RAW /*!< An initialized raw partition */ }; /** Alternatives for the file flush option in Unix; see the InnoDB manual about what these mean */ enum { SRV_UNIX_FSYNC = 1, /*!< fsync, the default */ SRV_UNIX_O_DSYNC, /*!< open log files in O_SYNC mode */ SRV_UNIX_LITTLESYNC, /*!< do not call os_file_flush() when writing data files, but do flush after writing to log files */ SRV_UNIX_NOSYNC, /*!< do not flush after writing */ SRV_UNIX_O_DIRECT, /*!< invoke os_file_set_nocache() on data files. This implies using non-buffered IO but still using fsync, the reason for which is that some FS do not flush meta-data when unbuffered IO happens */ SRV_UNIX_O_DIRECT_NO_FSYNC /*!< do not use fsync() when using direct IO i.e.: it can be set to avoid the fsync() call that we make when using SRV_UNIX_O_DIRECT. However, in this case user/DBA should be sure about the integrity of the meta-data */ }; /** Alternatives for file i/o in Windows */ enum { SRV_WIN_IO_NORMAL = 1, /*!< buffered I/O */ SRV_WIN_IO_UNBUFFERED /*!< unbuffered I/O; this is the default */ }; /** Alternatives for srv_force_recovery. Non-zero values are intended to help the user get a damaged database up so that he can dump intact tables and rows with SELECT INTO OUTFILE. The database must not otherwise be used with these options! A bigger number below means that all precautions of lower numbers are included. */ enum { SRV_FORCE_IGNORE_CORRUPT = 1, /*!< let the server run even if it detects a corrupt page */ SRV_FORCE_NO_BACKGROUND = 2, /*!< prevent the main thread from running: if a crash would occur in purge, this prevents it */ SRV_FORCE_NO_TRX_UNDO = 3, /*!< do not run trx rollback after recovery */ SRV_FORCE_NO_IBUF_MERGE = 4, /*!< prevent also ibuf operations: if they would cause a crash, better not do them */ SRV_FORCE_NO_UNDO_LOG_SCAN = 5, /*!< do not look at undo logs when starting the database: InnoDB will treat even incomplete transactions as committed */ SRV_FORCE_NO_LOG_REDO = 6 /*!< do not do the log roll-forward in connection with recovery */ }; /* Alternatives for srv_innodb_stats_method, which could be changed by setting innodb_stats_method */ enum srv_stats_method_name_enum { SRV_STATS_NULLS_EQUAL, /* All NULL values are treated as equal. This is the default setting for innodb_stats_method */ SRV_STATS_NULLS_UNEQUAL, /* All NULL values are treated as NOT equal. */ SRV_STATS_NULLS_IGNORED /* NULL values are ignored */ }; typedef enum srv_stats_method_name_enum srv_stats_method_name_t; #ifndef UNIV_HOTBACKUP /** Types of threads existing in the system. */ enum srv_thread_type { SRV_NONE, /*!< None */ SRV_WORKER, /*!< threads serving parallelized queries and queries released from lock wait */ SRV_PURGE, /*!< Purge coordinator thread */ SRV_MASTER /*!< the master thread, (whose type number must be biggest) */ }; /*********************************************************************//** Boots Innobase server. */ UNIV_INTERN void srv_boot(void); /*==========*/ /*********************************************************************//** Initializes the server. */ UNIV_INTERN void srv_init(void); /*==========*/ /*********************************************************************//** Frees the data structures created in srv_init(). */ UNIV_INTERN void srv_free(void); /*==========*/ /*********************************************************************//** Initializes the synchronization primitives, memory system, and the thread local storage. */ UNIV_INTERN void srv_general_init(void); /*==================*/ /*********************************************************************//** Sets the info describing an i/o thread current state. */ UNIV_INTERN void srv_set_io_thread_op_info( /*======================*/ ulint i, /*!< in: the 'segment' of the i/o thread */ const char* str); /*!< in: constant char string describing the state */ /*********************************************************************//** Resets the info describing an i/o thread current state. */ UNIV_INTERN void srv_reset_io_thread_op_info(); /*=========================*/ /*******************************************************************//** Tells the purge thread that there has been activity in the database and wakes up the purge thread if it is suspended (not sleeping). Note that there is a small chance that the purge thread stays suspended (we do not protect our operation with the srv_sys_t:mutex, for performance reasons). */ UNIV_INTERN void srv_wake_purge_thread_if_not_active(void); /*=====================================*/ /*******************************************************************//** Tells the Innobase server that there has been activity in the database and wakes up the master thread if it is suspended (not sleeping). Used in the MySQL interface. Note that there is a small chance that the master thread stays suspended (we do not protect our operation with the kernel mutex, for performace reasons). */ UNIV_INTERN void srv_active_wake_master_thread(void); /*===============================*/ /*******************************************************************//** Wakes up the master thread if it is suspended or being suspended. */ UNIV_INTERN void srv_wake_master_thread(void); /*========================*/ /******************************************************************//** Outputs to a file the output of the InnoDB Monitor. @return FALSE if not all information printed due to failure to obtain necessary mutex */ UNIV_INTERN ibool srv_printf_innodb_monitor( /*======================*/ FILE* file, /*!< in: output stream */ ibool nowait, /*!< in: whether to wait for the lock_sys_t::mutex */ ulint* trx_start, /*!< out: file position of the start of the list of active transactions */ ulint* trx_end); /*!< out: file position of the end of the list of active transactions */ /******************************************************************//** Function to pass InnoDB status variables to MySQL */ UNIV_INTERN void srv_export_innodb_status(void); /*==========================*/ /*******************************************************************//** Get current server activity count. We don't hold srv_sys::mutex while reading this value as it is only used in heuristics. @return activity count. */ UNIV_INTERN ulint srv_get_activity_count(void); /*========================*/ /*******************************************************************//** Check if there has been any activity. @return FALSE if no change in activity counter. */ UNIV_INTERN ibool srv_check_activity( /*===============*/ ulint old_activity_count); /*!< old activity count */ /******************************************************************//** Increment the server activity counter. */ UNIV_INTERN void srv_inc_activity_count(void); /*=========================*/ /**********************************************************************//** Enqueues a task to server task queue and releases a worker thread, if there is a suspended one. */ UNIV_INTERN void srv_que_task_enqueue_low( /*=====================*/ que_thr_t* thr); /*!< in: query thread */ /**********************************************************************//** Check whether any background thread is active. If so, return the thread type. @return SRV_NONE if all are are suspended or have exited, thread type if any are still active. */ UNIV_INTERN enum srv_thread_type srv_get_active_thread_type(void); /*============================*/ extern "C" { /*********************************************************************//** A thread which prints the info output by various InnoDB monitors. @return a dummy parameter */ UNIV_INTERN os_thread_ret_t DECLARE_THREAD(srv_monitor_thread)( /*===============================*/ void* arg); /*!< in: a dummy parameter required by os_thread_create */ /*********************************************************************//** The master thread controlling the server. @return a dummy parameter */ UNIV_INTERN os_thread_ret_t DECLARE_THREAD(srv_master_thread)( /*==============================*/ void* arg); /*!< in: a dummy parameter required by os_thread_create */ /************************************************************************* A thread which prints warnings about semaphore waits which have lasted too long. These can be used to track bugs which cause hangs. @return a dummy parameter */ UNIV_INTERN os_thread_ret_t DECLARE_THREAD(srv_error_monitor_thread)( /*=====================================*/ void* arg); /*!< in: a dummy parameter required by os_thread_create */ /*********************************************************************//** Purge coordinator thread that schedules the purge tasks. @return a dummy parameter */ UNIV_INTERN os_thread_ret_t DECLARE_THREAD(srv_purge_coordinator_thread)( /*=========================================*/ void* arg MY_ATTRIBUTE((unused))); /*!< in: a dummy parameter required by os_thread_create */ /*********************************************************************//** Worker thread that reads tasks from the work queue and executes them. @return a dummy parameter */ UNIV_INTERN os_thread_ret_t DECLARE_THREAD(srv_worker_thread)( /*==============================*/ void* arg MY_ATTRIBUTE((unused))); /*!< in: a dummy parameter required by os_thread_create */ } /* extern "C" */ /**********************************************************************//** Get count of tasks in the queue. @return number of tasks in queue */ UNIV_INTERN ulint srv_get_task_queue_length(void); /*===========================*/ /** Ensure that a given number of threads of the type given are running (or are already terminated). @param[in] type thread type @param[in] n number of threads that have to run */ void srv_release_threads(enum srv_thread_type type, ulint n); /** Wake up the purge threads. */ UNIV_INTERN void srv_purge_wakeup(); /** Check whether given space id is undo tablespace id @param[in] space_id space id to check @return true if it is undo tablespace else false. */ bool srv_is_undo_tablespace( ulint space_id); /** Status variables to be passed to MySQL */ struct export_var_t{ ulint innodb_data_pending_reads; /*!< Pending reads */ ulint innodb_data_pending_writes; /*!< Pending writes */ ulint innodb_data_pending_fsyncs; /*!< Pending fsyncs */ ulint innodb_data_fsyncs; /*!< Number of fsyncs so far */ ulint innodb_data_read; /*!< Data bytes read */ ulint innodb_data_writes; /*!< I/O write requests */ ulint innodb_data_written; /*!< Data bytes written */ ulint innodb_data_reads; /*!< I/O read requests */ char innodb_buffer_pool_dump_status[512];/*!< Buf pool dump status */ char innodb_buffer_pool_load_status[512];/*!< Buf pool load status */ ulint innodb_buffer_pool_pages_total; /*!< Buffer pool size */ ulint innodb_buffer_pool_pages_data; /*!< Data pages */ ulint innodb_buffer_pool_bytes_data; /*!< File bytes used */ ulint innodb_buffer_pool_pages_dirty; /*!< Dirty data pages */ ulint innodb_buffer_pool_bytes_dirty; /*!< File bytes modified */ ulint innodb_buffer_pool_pages_misc; /*!< Miscellanous pages */ ulint innodb_buffer_pool_pages_free; /*!< Free pages */ #ifdef UNIV_DEBUG ulint innodb_buffer_pool_pages_latched; /*!< Latched pages */ #endif /* UNIV_DEBUG */ ulint innodb_buffer_pool_read_requests; /*!< buf_pool->stat.n_page_gets */ ulint innodb_buffer_pool_reads; /*!< srv_buf_pool_reads */ ulint innodb_buffer_pool_wait_free; /*!< srv_buf_pool_wait_free */ ulint innodb_buffer_pool_pages_flushed; /*!< srv_buf_pool_flushed */ ulint innodb_buffer_pool_write_requests;/*!< srv_buf_pool_write_requests */ ulint innodb_buffer_pool_read_ahead_rnd;/*!< srv_read_ahead_rnd */ ulint innodb_buffer_pool_read_ahead; /*!< srv_read_ahead */ ulint innodb_buffer_pool_read_ahead_evicted;/*!< srv_read_ahead evicted*/ ulint innodb_dblwr_pages_written; /*!< srv_dblwr_pages_written */ ulint innodb_dblwr_writes; /*!< srv_dblwr_writes */ ibool innodb_have_atomic_builtins; /*!< HAVE_ATOMIC_BUILTINS */ ulint innodb_log_waits; /*!< srv_log_waits */ ulint innodb_log_write_requests; /*!< srv_log_write_requests */ ulint innodb_log_writes; /*!< srv_log_writes */ lsn_t innodb_os_log_written; /*!< srv_os_log_written */ ulint innodb_os_log_fsyncs; /*!< fil_n_log_flushes */ ulint innodb_os_log_pending_writes; /*!< srv_os_log_pending_writes */ ulint innodb_os_log_pending_fsyncs; /*!< fil_n_pending_log_flushes */ ulint innodb_page_size; /*!< UNIV_PAGE_SIZE */ ulint innodb_pages_created; /*!< buf_pool->stat.n_pages_created */ ulint innodb_pages_read; /*!< buf_pool->stat.n_pages_read*/ ulint innodb_page0_read; /*!< srv_stats.page0_read */ ulint innodb_pages_written; /*!< buf_pool->stat.n_pages_written */ ulint innodb_row_lock_waits; /*!< srv_n_lock_wait_count */ ulint innodb_row_lock_current_waits; /*!< srv_n_lock_wait_current_count */ ib_int64_t innodb_row_lock_time; /*!< srv_n_lock_wait_time / 1000 */ ulint innodb_row_lock_time_avg; /*!< srv_n_lock_wait_time / 1000 / srv_n_lock_wait_count */ ulint innodb_row_lock_time_max; /*!< srv_n_lock_max_wait_time / 1000 */ ulint innodb_rows_read; /*!< srv_n_rows_read */ ulint innodb_rows_inserted; /*!< srv_n_rows_inserted */ ulint innodb_rows_updated; /*!< srv_n_rows_updated */ ulint innodb_rows_deleted; /*!< srv_n_rows_deleted */ ulint innodb_system_rows_read; /*!< srv_n_system_rows_read */ ulint innodb_system_rows_inserted; /*!< srv_n_system_rows_inserted */ ulint innodb_system_rows_updated; /*!< srv_n_system_rows_updated */ ulint innodb_system_rows_deleted; /*!< srv_n_system_rows_deleted*/ ulint innodb_num_open_files; /*!< fil_n_file_opened */ ulint innodb_truncated_status_writes; /*!< srv_truncated_status_writes */ ulint innodb_available_undo_logs; /*!< srv_available_undo_logs */ ulint innodb_defragment_compression_failures; /*!< Number of defragment re-compression failures */ ulint innodb_defragment_failures; /*!< Number of defragment failures*/ ulint innodb_defragment_count; /*!< Number of defragment operations*/ ulint innodb_onlineddl_rowlog_rows; /*!< Online alter rows */ ulint innodb_onlineddl_rowlog_pct_used; /*!< Online alter percentage of used row log buffer */ ulint innodb_onlineddl_pct_progress; /*!< Online alter progress */ #ifdef UNIV_DEBUG ulint innodb_purge_trx_id_age; /*!< rw_max_trx_id - purged trx_id */ ulint innodb_purge_view_trx_id_age; /*!< rw_max_trx_id - purged view's min trx_id */ #endif /* UNIV_DEBUG */ ib_int64_t innodb_page_compression_saved;/*!< Number of bytes saved by page compression */ ib_int64_t innodb_page_compression_trim_sect512;/*!< Number of 512b TRIM by page compression */ ib_int64_t innodb_page_compression_trim_sect1024;/*!< Number of 1K TRIM by page compression */ ib_int64_t innodb_page_compression_trim_sect2048;/*!< Number of 2K TRIM by page compression */ ib_int64_t innodb_page_compression_trim_sect4096;/*!< Number of 4K byte TRIM by page compression */ ib_int64_t innodb_page_compression_trim_sect8192;/*!< Number of 8K TRIM by page compression */ ib_int64_t innodb_page_compression_trim_sect16384;/*!< Number of 16K TRIM by page compression */ ib_int64_t innodb_page_compression_trim_sect32768;/*!< Number of 32K TRIM by page compression */ ib_int64_t innodb_index_pages_written; /*!< Number of index pages written */ ib_int64_t innodb_non_index_pages_written; /*!< Number of non index pages written */ ib_int64_t innodb_pages_page_compressed;/*!< Number of pages compressed by page compression */ ib_int64_t innodb_page_compressed_trim_op;/*!< Number of TRIM operations induced by page compression */ ib_int64_t innodb_page_compressed_trim_op_saved;/*!< Number of TRIM operations saved by page compression */ ib_int64_t innodb_pages_page_decompressed;/*!< Number of pages decompressed by page compression */ ib_int64_t innodb_pages_page_compression_error;/*!< Number of page compression errors */ ib_int64_t innodb_pages_encrypted; /*!< Number of pages encrypted */ ib_int64_t innodb_pages_decrypted; /*!< Number of pages decrypted */ /*!< Number of merge blocks encrypted */ ib_int64_t innodb_n_merge_blocks_encrypted; /*!< Number of merge blocks decrypted */ ib_int64_t innodb_n_merge_blocks_decrypted; /*!< Number of row log blocks encrypted */ ib_int64_t innodb_n_rowlog_blocks_encrypted; /*!< Number of row log blocks decrypted */ ib_int64_t innodb_n_rowlog_blocks_decrypted; ulint innodb_sec_rec_cluster_reads; /*!< srv_sec_rec_cluster_reads */ ulint innodb_sec_rec_cluster_reads_avoided;/*!< srv_sec_rec_cluster_reads_avoided */ ulint innodb_encryption_rotation_pages_read_from_cache; ulint innodb_encryption_rotation_pages_read_from_disk; ulint innodb_encryption_rotation_pages_modified; ulint innodb_encryption_rotation_pages_flushed; ulint innodb_encryption_rotation_estimated_iops; ib_int64_t innodb_encryption_key_requests; ib_int64_t innodb_key_rotation_list_length; ulint innodb_scrub_page_reorganizations; ulint innodb_scrub_page_splits; ulint innodb_scrub_page_split_failures_underflow; ulint innodb_scrub_page_split_failures_out_of_filespace; ulint innodb_scrub_page_split_failures_missing_index; ulint innodb_scrub_page_split_failures_unknown; }; /** Thread slot in the thread table. */ struct srv_slot_t{ srv_thread_type type; /*!< thread type: user, utility etc. */ ibool in_use; /*!< TRUE if this slot is in use */ ibool suspended; /*!< TRUE if the thread is waiting for the event of this slot */ ib_time_t suspend_time; /*!< time when the thread was suspended. Initialized by lock_wait_table_reserve_slot() for lock wait */ ulong wait_timeout; /*!< wait time that if exceeded the thread will be timed out. Initialized by lock_wait_table_reserve_slot() for lock wait */ os_event_t event; /*!< event used in suspending the thread when it has nothing to do */ que_thr_t* thr; /*!< suspended query thread (only used for user threads) */ }; #else /* !UNIV_HOTBACKUP */ # define srv_use_adaptive_hash_indexes FALSE # define srv_use_native_aio FALSE # define srv_numa_interleave FALSE # define srv_force_recovery 0UL # define srv_set_io_thread_op_info(t,info) ((void) 0) # define srv_reset_io_thread_op_info() ((void) 0) # define srv_is_being_started 0 # define srv_win_file_flush_method SRV_WIN_IO_UNBUFFERED # define srv_unix_file_flush_method SRV_UNIX_O_DSYNC # define srv_start_raw_disk_in_use 0 # define srv_file_per_table 1 #endif /* !UNIV_HOTBACKUP */ #ifdef WITH_WSREP UNIV_INTERN void wsrep_srv_conc_cancel_wait( /*==================*/ trx_t* trx); /*!< in: transaction object associated with the thread */ #endif /* WITH_WSREP */ #endif