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 */
#ifndef _my_base_h
#define _my_base_h
#ifndef stdin
#define CHSIZE_USED
#include <my_global.h>
#include <my_dir.h>
#include <my_sys.h>
#include <m_string.h>
#include <errno.h>
#ifndef EOVERFLOW
#define EOVERFLOW 84
#endif
#endif
#include <my_list.h>
#define HA_OPEN_ABORT_IF_LOCKED 0
#define HA_OPEN_WAIT_IF_LOCKED 1
#define HA_OPEN_IGNORE_IF_LOCKED 2
#define HA_OPEN_TMP_TABLE 4
#define HA_OPEN_DELAY_KEY_WRITE 8
#define HA_OPEN_ABORT_IF_CRASHED 16
#define HA_OPEN_FOR_REPAIR 32
#define HA_OPEN_FROM_SQL_LAYER 64
#define HA_OPEN_MMAP 128
#define HA_OPEN_COPY 256
#define HA_OPEN_INTERNAL_TABLE 512
Don't connect any share_psi to the handler, since it is a partition.
It would not be used, since partitions don't call unbind_psi()/rebind_psi().
*/
#define HA_OPEN_NO_PSI_CALL 1024
We define a complete-field prefix of a key value as a prefix where
the last included field in the prefix contains the full field, not
just some bytes from the start of the field. A partial-field prefix
is allowed to contain only a few first bytes from the last included
field.
Below HA_READ_KEY_EXACT, ..., HA_READ_BEFORE_KEY can take a
complete-field prefix of a key value as the search
key. HA_READ_PREFIX and HA_READ_PREFIX_LAST could also take a
partial-field prefix, but currently (4.0.10) they are only used with
complete-field prefixes. MySQL uses a padding trick to implement
LIKE 'abc%' queries.
NOTE that in InnoDB HA_READ_PREFIX_LAST will NOT work with a
partial-field prefix because InnoDB currently strips spaces from the
end of varchar fields!
*/
enum ha_rkey_function {
HA_READ_KEY_EXACT,
HA_READ_KEY_OR_NEXT,
HA_READ_KEY_OR_PREV,
HA_READ_AFTER_KEY,
HA_READ_BEFORE_KEY,
HA_READ_PREFIX,
HA_READ_PREFIX_LAST,
HA_READ_PREFIX_LAST_OR_PREV,
HA_READ_MBR_CONTAIN,
HA_READ_MBR_INTERSECT,
HA_READ_MBR_WITHIN,
HA_READ_MBR_DISJOINT,
HA_READ_MBR_EQUAL
};
enum ha_key_alg {
HA_KEY_ALG_UNDEF= 0,
HA_KEY_ALG_BTREE= 1,
HA_KEY_ALG_RTREE= 2,
HA_KEY_ALG_HASH= 3,
HA_KEY_ALG_FULLTEXT= 4
};
enum ha_storage_media {
HA_SM_DEFAULT= 0,
HA_SM_DISK= 1,
HA_SM_MEMORY= 2
};
enum ha_extra_function {
HA_EXTRA_NORMAL=0,
HA_EXTRA_QUICK=1,
HA_EXTRA_NOT_USED=2,
HA_EXTRA_CACHE=3,
HA_EXTRA_NO_CACHE=4,
HA_EXTRA_NO_READCHECK=5,
HA_EXTRA_READCHECK=6,
HA_EXTRA_KEYREAD=7,
HA_EXTRA_NO_KEYREAD=8,
HA_EXTRA_NO_USER_CHANGE=9,
HA_EXTRA_KEY_CACHE=10,
HA_EXTRA_NO_KEY_CACHE=11,
HA_EXTRA_WAIT_LOCK=12,
HA_EXTRA_NO_WAIT_LOCK=13,
HA_EXTRA_WRITE_CACHE=14,
HA_EXTRA_FLUSH_CACHE=15,
HA_EXTRA_NO_KEYS=16,
HA_EXTRA_KEYREAD_CHANGE_POS=17,
HA_EXTRA_REMEMBER_POS=18,
HA_EXTRA_RESTORE_POS=19,
HA_EXTRA_REINIT_CACHE=20,
HA_EXTRA_FORCE_REOPEN=21,
HA_EXTRA_FLUSH,
HA_EXTRA_NO_ROWS,
HA_EXTRA_RESET_STATE,
HA_EXTRA_IGNORE_DUP_KEY,
HA_EXTRA_NO_IGNORE_DUP_KEY,
HA_EXTRA_PREPARE_FOR_DROP,
HA_EXTRA_PREPARE_FOR_UPDATE,
HA_EXTRA_PRELOAD_BUFFER_SIZE,
On-the-fly switching between unique and non-unique key inserting.
*/
HA_EXTRA_CHANGE_KEY_TO_UNIQUE,
HA_EXTRA_CHANGE_KEY_TO_DUP,
When using HA_EXTRA_KEYREAD, overwrite only key member fields and keep
other fields intact. When this is off (by default) InnoDB will use memcpy
to overwrite entire row.
*/
HA_EXTRA_KEYREAD_PRESERVE_FIELDS,
HA_EXTRA_MMAP,
Ignore if the a tuple is not found, continue processing the
transaction and ignore that 'row'. Needed for idempotency
handling on the slave
Currently only used by NDB storage engine. Partition handler ignores flag.
*/
HA_EXTRA_IGNORE_NO_KEY,
HA_EXTRA_NO_IGNORE_NO_KEY,
Mark the table as a log table. For some handlers (e.g. CSV) this results
in a special locking for the table.
*/
HA_EXTRA_MARK_AS_LOG_TABLE,
Informs handler that write_row() which tries to insert new row into the
table and encounters some already existing row with same primary/unique
key can replace old row with new row instead of reporting error (basically
it informs handler that we do REPLACE instead of simple INSERT).
Off by default.
*/
HA_EXTRA_WRITE_CAN_REPLACE,
HA_EXTRA_WRITE_CANNOT_REPLACE,
Inform handler that delete_row()/update_row() cannot batch deletes/updates
and should perform them immediately. This may be needed when table has
AFTER DELETE/UPDATE triggers which access to subject table.
These flags are reset by the handler::extra(HA_EXTRA_RESET) call.
*/
HA_EXTRA_DELETE_CANNOT_BATCH,
HA_EXTRA_UPDATE_CANNOT_BATCH,
Inform handler that an "INSERT...ON DUPLICATE KEY UPDATE" will be
executed. This condition is unset by HA_EXTRA_NO_IGNORE_DUP_KEY.
*/
HA_EXTRA_INSERT_WITH_UPDATE,
HA_EXTRA_PREPARE_FOR_RENAME,
Special actions for MERGE tables.
*/
HA_EXTRA_ADD_CHILDREN_LIST,
HA_EXTRA_ATTACH_CHILDREN,
HA_EXTRA_IS_ATTACHED_CHILDREN,
HA_EXTRA_DETACH_CHILDREN,
Prepare table for export
(e.g. quiesce the table and write table metadata).
*/
HA_EXTRA_EXPORT,
HA_EXTRA_SECONDARY_SORT_ROWID
};
#define HA_EXTRA_PREPARE_FOR_DELETE HA_EXTRA_PREPARE_FOR_DROP
enum ha_panic_function {
HA_PANIC_CLOSE,
HA_PANIC_WRITE,
HA_PANIC_READ
};
enum ha_base_keytype {
HA_KEYTYPE_END=0,
HA_KEYTYPE_TEXT=1,
HA_KEYTYPE_BINARY=2,
HA_KEYTYPE_SHORT_INT=3,
HA_KEYTYPE_LONG_INT=4,
HA_KEYTYPE_FLOAT=5,
HA_KEYTYPE_DOUBLE=6,
HA_KEYTYPE_NUM=7,
HA_KEYTYPE_USHORT_INT=8,
HA_KEYTYPE_ULONG_INT=9,
HA_KEYTYPE_LONGLONG=10,
HA_KEYTYPE_ULONGLONG=11,
HA_KEYTYPE_INT24=12,
HA_KEYTYPE_UINT24=13,
HA_KEYTYPE_INT8=14,
HA_KEYTYPE_VARTEXT1=15,
HA_KEYTYPE_VARBINARY1=16,
HA_KEYTYPE_VARTEXT2=17,
HA_KEYTYPE_VARBINARY2=18,
HA_KEYTYPE_BIT=19
};
#define HA_MAX_KEYTYPE 31
#define HA_NOSAME 1
#define HA_PACK_KEY 2
#define HA_AUTO_KEY 16
#define HA_BINARY_PACK_KEY 32
#define HA_FULLTEXT 128
#define HA_UNIQUE_CHECK 256
#define HA_SPATIAL 1024
#define HA_NULL_ARE_EQUAL 2048
#define HA_GENERATED_KEY 8192
#define HA_CLUSTERING (1<<31)
#define HA_KEYFLAG_MASK (HA_NOSAME | HA_PACK_KEY | HA_AUTO_KEY | \
HA_BINARY_PACK_KEY | HA_FULLTEXT | HA_UNIQUE_CHECK | \
HA_SPATIAL | HA_NULL_ARE_EQUAL | HA_GENERATED_KEY | \
HA_CLUSTERING)
Key contains partial segments.
This flag is internal to the MySQL server by design. It is not supposed
neither to be saved in FRM-files, nor to be passed to storage engines.
It is intended to pass information into internal static sort_keys(KEY *,
KEY *) function.
This flag can be calculated -- it's based on key lengths comparison.
*/
#define HA_KEY_HAS_PART_KEY_SEG 65536
#define HA_SPACE_PACK_USED 4
#define HA_VAR_LENGTH_KEY 8
#define HA_NULL_PART_KEY 64
#define HA_USES_COMMENT 4096
#define HA_USES_PARSER 16384
#define HA_USES_BLOCK_SIZE ((uint) 32768)
#define HA_SORT_ALLOWS_SAME 512
#define HA_SPACE_PACK 1
#define HA_PART_KEY_SEG 4
#define HA_VAR_LENGTH_PART 8
#define HA_NULL_PART 16
#define HA_BLOB_PART 32
#define HA_SWAP_KEY 64
#define HA_REVERSE_SORT 128
#define HA_NO_SORT 256
End space in unique/varchar are considered equal. (Like 'a' and 'a ')
Only needed for internal temporary tables.
*/
#define HA_END_SPACE_ARE_EQUAL 512
#define HA_BIT_PART 1024
#define HA_OPTION_PACK_RECORD 1
#define HA_OPTION_PACK_KEYS 2
#define HA_OPTION_COMPRESS_RECORD 4
#define HA_OPTION_LONG_BLOB_PTR 8
#define HA_OPTION_TMP_TABLE 16
#define HA_OPTION_CHECKSUM 32
#define HA_OPTION_DELAY_KEY_WRITE 64
#define HA_OPTION_NO_PACK_KEYS 128
#define HA_OPTION_CREATE_FROM_ENGINE 256
#define HA_OPTION_RELIES_ON_SQL_LAYER 512
#define HA_OPTION_NULL_FIELDS 1024
#define HA_OPTION_PAGE_CHECKSUM 2048
or ALTER TABLE). Table and index statistics that are collected by the
storage engine and used by the optimizer for query optimization will be
stored on disk and will not change after a server restart. */
#define HA_OPTION_STATS_PERSISTENT 4096
for the table will be wiped away on server shutdown and new ones recalculated
after the server is started again. If none of HA_OPTION_STATS_PERSISTENT or
HA_OPTION_NO_STATS_PERSISTENT is set, this means that the setting is not
explicitly set at table level and the corresponding table will use whatever
is the global server default. */
#define HA_OPTION_NO_STATS_PERSISTENT 8192
#define HA_OPTION_TEMP_COMPRESS_RECORD ((uint) 16384)
#define HA_OPTION_READ_ONLY_DATA ((uint) 32768)
#define HA_DONT_TOUCH_DATA 1
#define HA_PACK_RECORD 2
#define HA_CREATE_TMP_TABLE 4
#define HA_CREATE_CHECKSUM 8
#define HA_CREATE_KEEP_FILES 16
#define HA_CREATE_PAGE_CHECKSUM 32
#define HA_CREATE_DELAY_KEY_WRITE 64
#define HA_CREATE_RELIES_ON_SQL_LAYER 128
#define HA_CREATE_INTERNAL_TABLE 256
The following flags (OR-ed) are passed to handler::info() method.
The method copies misc handler information out of the storage engine
to data structures accessible from MySQL
Same flags are also passed down to mi_status, myrg_status, etc.
*/
#define HA_STATUS_POS 1
assuming the table keeps shared actual copy of the 'info' and
local, possibly outdated copy, the following flag means that
it should not try to get the actual data (locking the shared structure)
slightly outdated version will suffice
*/
#define HA_STATUS_NO_LOCK 2
#define HA_STATUS_TIME 4
update the 'constant' part of the info:
handler::max_data_file_length, max_index_file_length, create_time
sortkey, ref_length, block_size, data_file_name, index_file_name.
handler::table->s->keys_in_use, keys_for_keyread, rec_per_key
*/
#define HA_STATUS_CONST 8
update the 'variable' part of the info:
handler::records, deleted, data_file_length, index_file_length,
check_time, mean_rec_length
*/
#define HA_STATUS_VARIABLE 16
get the information about the key that caused last duplicate value error
update handler::errkey and handler::dupp_ref
see handler::get_dup_key()
*/
#define HA_STATUS_ERRKEY 32
update handler::auto_increment_value
*/
#define HA_STATUS_AUTO 64
Get also delete_length when HA_STATUS_VARIABLE is called. It's ok to set it also
when only HA_STATUS_VARIABLE but it won't be used.
*/
#define HA_STATUS_VARIABLE_EXTRA 128
Errorcodes given by handler functions
opt_sum_query() assumes these codes are > 1
Do not add error numbers before HA_ERR_FIRST.
If necessary to add lower numbers, change HA_ERR_FIRST accordingly.
*/
#define HA_ERR_FIRST 120
#define HA_ERR_KEY_NOT_FOUND 120
#define HA_ERR_FOUND_DUPP_KEY 121
#define HA_ERR_INTERNAL_ERROR 122
#define HA_ERR_RECORD_CHANGED 123
#define HA_ERR_WRONG_INDEX 124
#define HA_ERR_CRASHED 126
#define HA_ERR_WRONG_IN_RECORD 127
#define HA_ERR_OUT_OF_MEM 128
#define HA_ERR_NOT_A_TABLE 130
#define HA_ERR_WRONG_COMMAND 131
#define HA_ERR_OLD_FILE 132
#define HA_ERR_NO_ACTIVE_RECORD 133
#define HA_ERR_RECORD_DELETED 134
#define HA_ERR_RECORD_FILE_FULL 135
#define HA_ERR_INDEX_FILE_FULL 136
#define HA_ERR_END_OF_FILE 137
#define HA_ERR_UNSUPPORTED 138
#define HA_ERR_TO_BIG_ROW 139
#define HA_WRONG_CREATE_OPTION 140
#define HA_ERR_FOUND_DUPP_UNIQUE 141
#define HA_ERR_UNKNOWN_CHARSET 142
#define HA_ERR_WRONG_MRG_TABLE_DEF 143
#define HA_ERR_CRASHED_ON_REPAIR 144
#define HA_ERR_CRASHED_ON_USAGE 145
#define HA_ERR_LOCK_WAIT_TIMEOUT 146
#define HA_ERR_LOCK_TABLE_FULL 147
#define HA_ERR_READ_ONLY_TRANSACTION 148
#define HA_ERR_LOCK_DEADLOCK 149
#define HA_ERR_CANNOT_ADD_FOREIGN 150
#define HA_ERR_NO_REFERENCED_ROW 151
#define HA_ERR_ROW_IS_REFERENCED 152
#define HA_ERR_NO_SAVEPOINT 153
#define HA_ERR_NON_UNIQUE_BLOCK_SIZE 154
#define HA_ERR_NO_SUCH_TABLE 155
#define HA_ERR_TABLE_EXIST 156
#define HA_ERR_NO_CONNECTION 157
#define HA_ERR_NULL_IN_SPATIAL 158
#define HA_ERR_TABLE_DEF_CHANGED 159
#define HA_ERR_NO_PARTITION_FOUND 160
#define HA_ERR_RBR_LOGGING_FAILED 161
#define HA_ERR_DROP_INDEX_FK 162
Upholding foreign key constraints would lead to a duplicate key error
in some other table.
*/
#define HA_ERR_FOREIGN_DUPLICATE_KEY 163
#define HA_ERR_TABLE_NEEDS_UPGRADE 164
#define HA_ERR_TABLE_READONLY 165
#define HA_ERR_AUTOINC_READ_FAILED 166
#define HA_ERR_AUTOINC_ERANGE 167
#define HA_ERR_GENERIC 168
#define HA_ERR_RECORD_IS_THE_SAME 169
#define HA_ERR_LOGGING_IMPOSSIBLE 170
statement */
#define HA_ERR_CORRUPT_EVENT 171
illegal data being read */
#define HA_ERR_NEW_FILE 172
#define HA_ERR_ROWS_EVENT_APPLY 173
no other hanlder error happened */
#define HA_ERR_INITIALIZATION 174
#define HA_ERR_FILE_TOO_SHORT 175
#define HA_ERR_WRONG_CRC 176
#define HA_ERR_TOO_MANY_CONCURRENT_TRXS 177
#define HA_ERR_NOT_IN_LOCK_PARTITIONS 178
#define HA_ERR_INDEX_COL_TOO_LONG 179
#define HA_ERR_INDEX_CORRUPT 180
#define HA_ERR_UNDO_REC_TOO_BIG 181
#define HA_FTS_INVALID_DOCID 182
#define HA_ERR_TABLE_IN_FK_CHECK 183
#define HA_ERR_TABLESPACE_EXISTS 184
#define HA_ERR_TOO_MANY_FIELDS 185
#define HA_ERR_ROW_IN_WRONG_PARTITION 186
#define HA_ERR_INNODB_READ_ONLY 187
#define HA_ERR_FTS_EXCEED_RESULT_CACHE_LIMIT 188
#define HA_ERR_TEMP_FILE_WRITE_FAILURE 189
#define HA_ERR_INNODB_FORCED_RECOVERY 190
#define HA_ERR_FTS_TOO_MANY_WORDS_IN_PHRASE 191
#define HA_ERR_LAST 191
#define HA_ERR_ERRORS (HA_ERR_LAST - HA_ERR_FIRST + 1)
#define HA_NAMELEN 64
#define NO_SUCH_KEY (~(uint)0)
typedef ulong key_part_map;
#define HA_WHOLE_KEY (~(key_part_map)0)
#define SEARCH_FIND 1
#define SEARCH_NO_FIND 2
#define SEARCH_SAME 4
#define SEARCH_BIGGER 8
#define SEARCH_SMALLER 16
#define SEARCH_SAVE_BUFF 32
#define SEARCH_UPDATE 64
#define SEARCH_PREFIX 128
#define SEARCH_LAST 256
#define MBR_CONTAIN 512
#define MBR_INTERSECT 1024
#define MBR_WITHIN 2048
#define MBR_DISJOINT 4096
#define MBR_EQUAL 8192
#define MBR_DATA 16384
#define SEARCH_NULL_ARE_EQUAL 32768
#define SEARCH_NULL_ARE_NOT_EQUAL 65536
#define QUICK_USED 1
#define READ_CACHE_USED 2
#define READ_CHECK_USED 4
#define KEY_READ_USED 8
#define WRITE_CACHE_USED 16
#define OPT_NO_ROWS 32
#define HA_STATE_CHANGED 1
#define HA_STATE_AKTIV 2
#define HA_STATE_WRITTEN 4
#define HA_STATE_DELETED 8
#define HA_STATE_NEXT_FOUND 16
#define HA_STATE_PREV_FOUND 32
#define HA_STATE_NO_KEY 64
#define HA_STATE_KEY_CHANGED 128
#define HA_STATE_WRITE_AT_END 256
#define HA_STATE_BUFF_SAVED 512
#define HA_STATE_ROW_CHANGED 1024
#define HA_STATE_EXTEND_BLOCK 2048
enum en_fieldtype {
FIELD_LAST=-1,FIELD_NORMAL,FIELD_SKIP_ENDSPACE,FIELD_SKIP_PRESPACE,
FIELD_SKIP_ZERO,FIELD_BLOB,FIELD_CONSTANT,FIELD_INTERVALL,FIELD_ZERO,
FIELD_VARCHAR,FIELD_CHECK,
FIELD_enum_val_count
};
enum data_file_type {
STATIC_RECORD, DYNAMIC_RECORD, COMPRESSED_RECORD, BLOCK_RECORD
};
enum key_range_flag {
NO_MIN_RANGE= 1 << 0,
NO_MAX_RANGE= 1 << 1,
NEAR_MIN= 1 << 2,
NEAR_MAX= 1 << 3,
This flag means that index is a unique index, and the interval is
equivalent to "AND(keypart_i = const_i)", where all of const_i are
not NULLs.
*/
UNIQUE_RANGE= 1 << 4,
This flag means that the interval is equivalent to
"AND(keypart_i = const_i)", where not all key parts may be used
but all of const_i are not NULLs.
*/
EQ_RANGE= 1 << 5,
This flag has the same meaning as UNIQUE_RANGE, except that for at
least one keypart the condition is "keypart IS NULL".
*/
NULL_RANGE= 1 << 6,
GEOM_FLAG= 1 << 7,
SKIP_RANGE= 1 << 8,
Used together with EQ_RANGE to indicate that index statistics
should be used instead of sampling the index.
*/
USE_INDEX_STATISTICS= 1 << 9
};
typedef struct st_key_range
{
const uchar *key;
uint length;
key_part_map keypart_map;
enum ha_rkey_function flag;
} key_range;
typedef struct st_key_multi_range
{
key_range start_key;
key_range end_key;
char *ptr;
uint range_flag;
} KEY_MULTI_RANGE;
#ifdef BIG_TABLES
#define rows2double(A) ulonglong2double(A)
typedef my_off_t ha_rows;
#else
#define rows2double(A) (double) (A)
typedef ulong ha_rows;
#endif
#define HA_POS_ERROR (~ (ha_rows) 0)
#define HA_OFFSET_ERROR (~ (my_off_t) 0)
#if SYSTEM_SIZEOF_OFF_T == 4
#define MAX_FILE_SIZE INT_MAX32
#else
#define MAX_FILE_SIZE LONGLONG_MAX
#endif
#define HA_VARCHAR_PACKLENGTH(field_length) ((field_length) < 256 ? 1 :2)
C_MODE_START
typedef void (* invalidator_by_filename)(const char * filename);
C_MODE_END
#endif