/***************************************************************************** Copyright (c) 1994, 2010, Innobase Oy. All Rights Reserved. Copyright (c) 2008, Google Inc. Copyright (c) 2009, Sun Microsystems, Inc. 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 Sun Microsystems, Inc. Those modifications are gratefully acknowledged and are described briefly in the InnoDB documentation. The contributions by Sun Microsystems are incorporated with their permission, and subject to the conditions contained in the file COPYING.Sun_Microsystems. 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 St, Fifth Floor, Boston, MA 02110-1301 USA *****************************************************************************/ /***********************************************************************//** @file include/univ.i Version control for database, common definitions, and include files Created 1/20/1994 Heikki Tuuri ****************************************************************************/ #ifndef univ_i #define univ_i #ifdef UNIV_HOTBACKUP #include "hb_univ.i" #endif /* UNIV_HOTBACKUP */ /* aux macros to convert M into "123" (string) if M is defined like #define M 123 */ #define _IB_TO_STR(s) #s #define IB_TO_STR(s) _IB_TO_STR(s) #include #define INNODB_VERSION_MAJOR MYSQL_MAJOR_VERSION #define INNODB_VERSION_MINOR MYSQL_MINOR_VERSION /* The following is the InnoDB version as shown in SELECT plugin_version FROM information_schema.plugins; calculated in make_version_string() in sql/sql_show.cc like this: "version >> 8" . "version & 0xff" because the version is shown with only one dot, we skip the last component, i.e. we show M.N.P as M.N */ #define INNODB_VERSION_SHORT \ (INNODB_VERSION_MAJOR << 8 | INNODB_VERSION_MINOR) #ifndef PERCONA_INNODB_VERSION #define PERCONA_INNODB_VERSION 38.13 #endif #define INNODB_VERSION_STR "5.5.61-MariaDB-" IB_TO_STR(PERCONA_INNODB_VERSION) #define REFMAN "http://dev.mysql.com/doc/refman/" \ IB_TO_STR(MYSQL_MAJOR_VERSION) "." \ IB_TO_STR(MYSQL_MINOR_VERSION) "/en/" #ifdef MYSQL_DYNAMIC_PLUGIN /* In the dynamic plugin, redefine some externally visible symbols in order not to conflict with the symbols of a builtin InnoDB. */ /* Rename all C++ classes that contain virtual functions, because we have not figured out how to apply the visibility=hidden attribute to the virtual method table (vtable) in GCC 3. */ # define ha_innobase ha_innodb #endif /* MYSQL_DYNAMIC_PLUGIN */ #if (defined(WIN32) || defined(_WIN32) || defined(WIN64) || defined(_WIN64)) && !defined(MYSQL_SERVER) && !defined(__WIN__) # undef __WIN__ # define __WIN__ # include # ifdef _NT_ # define __NT__ # endif #else /* The defines used with MySQL */ /* Include two header files from MySQL to make the Unix flavor used in compiling more Posix-compatible. These headers also define __WIN__ if we are compiling on Windows. */ #ifndef UNIV_HOTBACKUP # include # include #endif /* UNIV_HOTBACKUP */ /* Include to get S_I... macros defined for os0file.c */ # include # if !defined(__WIN__) # include /* mmap() for os0proc.c */ # endif /* Include the header file generated by GNU autoconf */ # ifndef __WIN__ # ifndef UNIV_HOTBACKUP # include "config.h" # endif /* UNIV_HOTBACKUP */ # endif # ifdef HAVE_SCHED_H # include # endif # ifdef HAVE_MALLOC_H # include # endif /* We only try to do explicit inlining of functions with gcc and Sun Studio */ # if !defined(__GNUC__) && !(defined(__SUNPRO_C) || defined(__SUNPRO_CC)) # undef UNIV_MUST_NOT_INLINE /* Remove compiler warning */ # define UNIV_MUST_NOT_INLINE # endif # ifdef HAVE_PREAD # define HAVE_PWRITE # endif #endif /* #if (defined(WIN32) || ... */ /* Following defines are to enable performance schema instrumentation in each of four InnoDB modules if HAVE_PSI_INTERFACE is defined. */ #ifdef HAVE_PSI_INTERFACE # define UNIV_PFS_MUTEX # define UNIV_PFS_RWLOCK /* For I/O instrumentation, performance schema rely on a native descriptor to identify the file, this descriptor could conflict with our OS level descriptor. Disable IO instrumentation on Windows until this is resolved */ # ifndef __WIN__ # define UNIV_PFS_IO # endif # define UNIV_PFS_THREAD #endif /* HAVE_PSI_INTERFACE */ /* DEBUG VERSION CONTROL ===================== */ /* When this macro is defined then additional test functions will be compiled. These functions live at the end of each relevant source file and have "test_" prefix. These functions are not called from anywhere in the code, they can be called from gdb after innobase_start_or_create_for_mysql() has executed using the call command. Not tested on Windows. */ /* #define UNIV_COMPILE_TEST_FUNCS */ #if defined(HAVE_VALGRIND) && defined(HAVE_valgrind) # define UNIV_DEBUG_VALGRIND #endif #if 0 #define UNIV_DEBUG_VALGRIND /* Enable extra Valgrind instrumentation */ #define UNIV_DEBUG_PRINT /* Enable the compilation of some debug print functions */ #define UNIV_AHI_DEBUG /* Enable adaptive hash index debugging without UNIV_DEBUG */ #define UNIV_BUF_DEBUG /* Enable buffer pool debugging without UNIV_DEBUG */ #define UNIV_BLOB_LIGHT_DEBUG /* Enable off-page column debugging without UNIV_DEBUG */ #define UNIV_BLOB_NULL_DEBUG /* Enable deep off-page column debugging */ #define UNIV_DEBUG /* Enable ut_ad() assertions and disable UNIV_INLINE */ #define UNIV_DEBUG_LOCK_VALIDATE /* Enable ut_ad(lock_rec_validate_page()) assertions. */ #define UNIV_DEBUG_FILE_ACCESSES /* Enable freed block access debugging without UNIV_DEBUG */ #define UNIV_LRU_DEBUG /* debug the buffer pool LRU */ #define UNIV_HASH_DEBUG /* debug HASH_ macros */ #define UNIV_LIST_DEBUG /* debug UT_LIST_ macros */ #define UNIV_LOG_LSN_DEBUG /* write LSN to the redo log; this will break redo log file compatibility, but it may be useful when debugging redo log application problems. */ #define UNIV_MEM_DEBUG /* detect memory leaks etc */ #define UNIV_IBUF_DEBUG /* debug the insert buffer */ #define UNIV_BLOB_DEBUG /* track BLOB ownership; assumes that no BLOBs survive server restart */ #define UNIV_IBUF_COUNT_DEBUG /* debug the insert buffer; this limits the database to IBUF_COUNT_N_SPACES and IBUF_COUNT_N_PAGES, and the insert buffer must be empty when the database is started */ #define UNIV_SYNC_DEBUG /* debug mutex and latch operations (very slow); also UNIV_DEBUG must be defined */ #define UNIV_SEARCH_DEBUG /* debug B-tree comparisons */ #define UNIV_SYNC_PERF_STAT /* operation counts for rw-locks and mutexes */ #define UNIV_SEARCH_PERF_STAT /* statistics for the adaptive hash index */ #define UNIV_SRV_PRINT_LATCH_WAITS /* enable diagnostic output in sync0sync.c */ #define UNIV_BTR_PRINT /* enable functions for printing B-trees */ #define UNIV_ZIP_DEBUG /* extensive consistency checks for compressed pages */ #define UNIV_ZIP_COPY /* call page_zip_copy_recs() more often */ #define UNIV_AIO_DEBUG /* prints info about submitted and reaped AIO requests to the log. */ #endif #define UNIV_BTR_DEBUG /* check B-tree links */ #define UNIV_LIGHT_MEM_DEBUG /* light memory debugging */ /* #define UNIV_SQL_DEBUG #define UNIV_LOG_DEBUG */ /* the above option prevents forcing of log to disk at a buffer page write: it should be tested with this option off; also some ibuf tests are suppressed */ /* Linkage specifier for non-static InnoDB symbols (variables and functions) that are only referenced from within InnoDB, not from MySQL. We disable the GCC visibility directive on all Sun operating systems because there is no easy way to get it to work. See http://bugs.mysql.com/bug.php?id=52263. */ #if defined(__GNUC__) && (__GNUC__ >= 4) && !defined(sun) || defined(__INTEL_COMPILER) # define UNIV_INTERN __attribute__((visibility ("hidden"))) #else # define UNIV_INTERN #endif #if defined __GNUC__ && (__GNUC__ > 4 || __GNUC__ == 4 && __GNUC_MINOR__ >= 3) /** Starting with GCC 4.3, the "cold" attribute is used to inform the compiler that a function is unlikely executed. The function is optimized for size rather than speed and on many targets it is placed into special subsection of the text section so all cold functions appears close together improving code locality of non-cold parts of program. The paths leading to call of cold functions within code are marked as unlikely by the branch prediction mechanism. optimize a rarely invoked function for size instead for speed. */ # define UNIV_COLD __attribute__((cold)) #else # define UNIV_COLD /* empty */ #endif #ifndef UNIV_MUST_NOT_INLINE /* Definition for inline version */ #ifdef __WIN__ # define UNIV_INLINE __inline #elif defined(__SUNPRO_CC) || defined(__SUNPRO_C) # define UNIV_INLINE static inline #else # define UNIV_INLINE static __inline__ #endif #else /* If we want to compile a noninlined version we use the following macro definitions: */ #define UNIV_NONINL #define UNIV_INLINE UNIV_INTERN #endif /* UNIV_DEBUG */ #ifdef _WIN32 #define UNIV_WORD_SIZE 4 #elif defined(_WIN64) #define UNIV_WORD_SIZE 8 #else /* MySQL config.h generated by GNU autoconf will define SIZEOF_LONG in Posix */ #define UNIV_WORD_SIZE SIZEOF_LONG #endif /* The following alignment is used in memory allocations in memory heap management to ensure correct alignment for doubles etc. */ #define UNIV_MEM_ALIGNMENT 8 /* The following alignment is used in aligning lints etc. */ #define UNIV_WORD_ALIGNMENT UNIV_WORD_SIZE /* DATABASE VERSION CONTROL ======================== */ /** There are currently two InnoDB file formats which are used to group features with similar restrictions and dependencies. Using an enum allows switch statements to give a compiler warning when a new one is introduced. */ enum innodb_file_formats_enum { /** Antelope File Format: InnoDB/MySQL up to 5.1. This format includes REDUNDANT and COMPACT row formats */ UNIV_FORMAT_A = 0, /** Barracuda File Format: Introduced in InnoDB plugin for 5.1: This format includes COMPRESSED and DYNAMIC row formats. It includes the ability to create secondary indexes from data that is not on the clustered index page and the ability to store more data off the clustered index page. */ UNIV_FORMAT_B = 1 }; typedef enum innodb_file_formats_enum innodb_file_formats_t; /* The 2-logarithm of UNIV_PAGE_SIZE: */ /* #define UNIV_PAGE_SIZE_SHIFT 14 */ #define UNIV_PAGE_SIZE_SHIFT_MAX 14 #define UNIV_PAGE_SIZE_SHIFT srv_page_size_shift /* The universal page size of the database */ /* #define UNIV_PAGE_SIZE (1u << UNIV_PAGE_SIZE_SHIFT) */ #define UNIV_PAGE_SIZE srv_page_size #define UNIV_PAGE_SIZE_MAX (1u << UNIV_PAGE_SIZE_SHIFT_MAX) /* Maximum number of parallel threads in a parallelized operation */ #define UNIV_MAX_PARALLELISM 32 /** This is the "mbmaxlen" for my_charset_filename (defined in strings/ctype-utf8.c), which is used to encode File and Database names. */ #define FILENAME_CHARSET_MAXNAMLEN 5 /** The maximum length of an encode table name in bytes. The max table and database names are NAME_CHAR_LEN (64) characters. After the encoding, the max length would be NAME_CHAR_LEN (64) * FILENAME_CHARSET_MAXNAMLEN (5) = 320 bytes. The number does not include a terminating '\0'. InnoDB can handle longer names internally */ #define MAX_TABLE_NAME_LEN 320 /* The maximum length of a database name. Like MAX_TABLE_NAME_LEN this is the MySQL's NAME_LEN, see check_and_convert_db_name(). */ #define MAX_DATABASE_NAME_LEN MAX_TABLE_NAME_LEN /* MAX_FULL_NAME_LEN defines the full name path including the database name and table name. In addition, 14 bytes is added for: 2 for surrounding quotes around table name 1 for the separating dot (.) 9 for the #mysql50# prefix */ #define MAX_FULL_NAME_LEN \ (MAX_TABLE_NAME_LEN + MAX_DATABASE_NAME_LEN + 14) /* UNIVERSAL TYPE DEFINITIONS ========================== */ /* Note that inside MySQL 'byte' is defined as char on Linux! */ #define byte unsigned char /* Define an unsigned integer type that is exactly 32 bits. */ #if SIZEOF_INT == 4 typedef unsigned int ib_uint32_t; #elif SIZEOF_LONG == 4 typedef unsigned long ib_uint32_t; #else #error "Neither int or long is 4 bytes" #endif /* Another basic type we use is unsigned long integer which should be equal to the word size of the machine, that is on a 32-bit platform 32 bits, and on a 64-bit platform 64 bits. We also give the printf format for the type as a macro ULINTPF. */ #ifdef _WIN64 typedef unsigned __int64 ulint; #define ULINTPF "%I64u" typedef __int64 lint; #define MYSQL_SYSVAR_ULINT MYSQL_SYSVAR_ULONGLONG #else typedef unsigned long int ulint; #define ULINTPF "%lu" typedef long int lint; #define MYSQL_SYSVAR_ULINT MYSQL_SYSVAR_ULONG #endif #ifdef __WIN__ typedef __int64 ib_int64_t; typedef unsigned __int64 ib_uint64_t; #elif !defined(UNIV_HOTBACKUP) /* Note: longlong and ulonglong come from MySQL headers. */ typedef longlong ib_int64_t; typedef ulonglong ib_uint64_t; #endif #ifndef UNIV_HOTBACKUP typedef unsigned long long int ullint; #endif /* UNIV_HOTBACKUP */ #ifndef __WIN__ #if SIZEOF_LONG != SIZEOF_VOIDP #error "Error: InnoDB's ulint must be of the same size as void*" #endif #endif /* The 'undefined' value for a ulint */ #define ULINT_UNDEFINED ((ulint)(-1)) /** The bitmask of 32-bit unsigned integer */ #define ULINT32_MASK 0xFFFFFFFF /* The undefined 32-bit unsigned integer */ #define ULINT32_UNDEFINED ULINT32_MASK /* Maximum value for a ulint */ #define ULINT_MAX ((ulint)(-2)) /* Maximum value for ib_uint64_t */ #define IB_ULONGLONG_MAX ((ib_uint64_t) (~0ULL)) /** The generic InnoDB system object identifier data type */ typedef ib_uint64_t ib_id_t; /* The 'undefined' value for a ullint */ #define ULLINT_UNDEFINED ((ullint)(-1)) /* This 'ibool' type is used within Innobase. Remember that different included headers may define 'bool' differently. Do not assume that 'bool' is a ulint! */ #define ibool ulint #ifndef TRUE #define TRUE 1 #define FALSE 0 #endif /* The following number as the length of a logical field means that the field has the SQL NULL as its value. NOTE that because we assume that the length of a field is a 32-bit integer when we store it, for example, to an undo log on disk, we must have also this number fit in 32 bits, also in 64-bit computers! */ #define UNIV_SQL_NULL ULINT32_UNDEFINED /* Lengths which are not UNIV_SQL_NULL, but bigger than the following number indicate that a field contains a reference to an externally stored part of the field in the tablespace. The length field then contains the sum of the following flag and the locally stored len. */ #define UNIV_EXTERN_STORAGE_FIELD (UNIV_SQL_NULL - UNIV_PAGE_SIZE_MAX) /* Some macros to improve branch prediction and reduce cache misses */ #if defined(__GNUC__) && (__GNUC__ > 2) && ! defined(__INTEL_COMPILER) /* Tell the compiler that 'expr' probably evaluates to 'constant'. */ # define UNIV_EXPECT(expr,constant) __builtin_expect(expr, constant) /* Tell the compiler that a pointer is likely to be NULL */ # define UNIV_LIKELY_NULL(ptr) __builtin_expect((ulint) ptr, 0) /* Minimize cache-miss latency by moving data at addr into a cache before it is read. */ # define UNIV_PREFETCH_R(addr) __builtin_prefetch(addr, 0, 3) /* Minimize cache-miss latency by moving data at addr into a cache before it is read or written. */ # define UNIV_PREFETCH_RW(addr) __builtin_prefetch(addr, 1, 3) /* Sun Studio includes sun_prefetch.h as of version 5.9 */ #elif (defined(__SUNPRO_C) && __SUNPRO_C >= 0x590) \ || (defined(__SUNPRO_CC) && __SUNPRO_CC >= 0x590) # include #if __SUNPRO_C >= 0x550 # undef UNIV_INTERN # define UNIV_INTERN __hidden #endif /* __SUNPRO_C >= 0x550 */ /* Use sun_prefetch when compile with Sun Studio */ # define UNIV_EXPECT(expr,value) (expr) # define UNIV_LIKELY_NULL(expr) (expr) # define UNIV_PREFETCH_R(addr) sun_prefetch_read_many((void*) addr) # define UNIV_PREFETCH_RW(addr) sun_prefetch_write_many(addr) #else /* Dummy versions of the macros */ # define UNIV_EXPECT(expr,value) (expr) # define UNIV_LIKELY_NULL(expr) (expr) # define UNIV_PREFETCH_R(addr) ((void) 0) # define UNIV_PREFETCH_RW(addr) ((void) 0) #endif /* Tell the compiler that cond is likely to hold */ #define UNIV_LIKELY(cond) UNIV_EXPECT(cond, TRUE) /* Tell the compiler that cond is unlikely to hold */ #define UNIV_UNLIKELY(cond) UNIV_EXPECT(cond, FALSE) /* Compile-time constant of the given array's size. */ #define UT_ARR_SIZE(a) (sizeof(a) / sizeof((a)[0])) /* The return type from a thread's start function differs between Unix and Windows, so define a typedef for it and a macro to use at the end of such functions. */ #ifdef __WIN__ typedef ulint os_thread_ret_t; #define OS_THREAD_DUMMY_RETURN return(0) #else typedef void* os_thread_ret_t; #define OS_THREAD_DUMMY_RETURN return(NULL) #endif #include #include "ut0dbg.h" #include "ut0ut.h" #include "db0err.h" #include /* define UNIV macros in terms of my_valgrind.h */ # define UNIV_MEM_INVALID(addr, size) MEM_UNDEFINED(addr, size) # define UNIV_MEM_FREE(addr, size) MEM_NOACCESS(addr, size) # define UNIV_MEM_ALLOC(addr, size) UNIV_MEM_INVALID(addr, size) /* macros below cannot be defined in terms of my_valgrind.h */ #ifdef UNIV_DEBUG_VALGRIND # include # define UNIV_MEM_VALID(addr, size) VALGRIND_MAKE_MEM_DEFINED(addr, size) # define UNIV_MEM_DESC(addr, size, b) VALGRIND_CREATE_BLOCK(addr, size, b) # define UNIV_MEM_UNDESC(b) VALGRIND_DISCARD(b) # define UNIV_MEM_ASSERT_RW(addr, size) do { \ const void* _p = (const void*) (ulint) \ VALGRIND_CHECK_MEM_IS_DEFINED(addr, size); \ if (UNIV_LIKELY_NULL(_p)) \ fprintf(stderr, "%s:%d: %p[%u] undefined at %ld\n", \ __FILE__, __LINE__, \ (const void*) (addr), (unsigned) (size), (long) \ (((const char*) _p) - ((const char*) (addr)))); \ } while (0) # define UNIV_MEM_ASSERT_W(addr, size) do { \ const void* _p = (const void*) (ulint) \ VALGRIND_CHECK_MEM_IS_ADDRESSABLE(addr, size); \ if (UNIV_LIKELY_NULL(_p)) \ fprintf(stderr, "%s:%d: %p[%u] unwritable at %ld\n", \ __FILE__, __LINE__, \ (const void*) (addr), (unsigned) (size), (long) \ (((const char*) _p) - ((const char*) (addr)))); \ } while (0) #else # define UNIV_MEM_VALID(addr, size) do {} while(0) # define UNIV_MEM_DESC(addr, size, b) do {} while(0) # define UNIV_MEM_UNDESC(b) do {} while(0) # define UNIV_MEM_ASSERT_RW(addr, size) do {} while(0) # define UNIV_MEM_ASSERT_W(addr, size) do {} while(0) #endif extern ulint srv_page_size_shift; extern ulint srv_page_size; #endif