my_base.h
上传用户:romrleung
上传日期:2022-05-23
资源大小:18897k
文件大小:14k
源码类别:

MySQL数据库

开发平台:

Visual C++

  1. /* Copyright (C) 2000 MySQL AB
  2.    This program is free software; you can redistribute it and/or modify
  3.    it under the terms of the GNU General Public License as published by
  4.    the Free Software Foundation; either version 2 of the License, or
  5.    (at your option) any later version.
  6.    This program is distributed in the hope that it will be useful,
  7.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  8.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  9.    GNU General Public License for more details.
  10.    You should have received a copy of the GNU General Public License
  11.    along with this program; if not, write to the Free Software
  12.    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA */
  13. /* This file includes constants used with all databases */
  14. /* Author: Michael Widenius */
  15. #ifndef _my_base_h
  16. #define _my_base_h
  17. #ifndef stdin /* Included first in handler */
  18. #define USES_TYPES /* my_dir with sys/types is included */
  19. #define CHSIZE_USED
  20. #include <my_global.h>
  21. #include <my_dir.h> /* This includes types */
  22. #include <my_sys.h>
  23. #include <m_string.h>
  24. #include <errno.h>
  25. #ifndef EOVERFLOW
  26. #define EOVERFLOW 84
  27. #endif
  28. #ifdef MSDOS
  29. #include <share.h> /* Neaded for sopen() */
  30. #endif
  31. #if !defined(USE_MY_FUNC) && !defined(THREAD)
  32. #include <my_nosys.h> /* For faster code, after test */
  33. #endif /* USE_MY_FUNC */
  34. #endif /* stdin */
  35. #include <my_list.h>
  36. /* The following is bits in the flag parameter to ha_open() */
  37. #define HA_OPEN_ABORT_IF_LOCKED 0 /* default */
  38. #define HA_OPEN_WAIT_IF_LOCKED 1
  39. #define HA_OPEN_IGNORE_IF_LOCKED 2
  40. #define HA_OPEN_TMP_TABLE 4 /* Table is a temp table */
  41. #define HA_OPEN_DELAY_KEY_WRITE 8 /* Don't update index  */
  42. #define HA_OPEN_ABORT_IF_CRASHED 16
  43. #define HA_OPEN_FOR_REPAIR 32 /* open even if crashed */
  44. /* The following is parameter to ha_rkey() how to use key */
  45. /*
  46.   We define a complete-field prefix of a key value as a prefix where
  47.   the last included field in the prefix contains the full field, not
  48.   just some bytes from the start of the field. A partial-field prefix
  49.   is allowed to contain only a few first bytes from the last included
  50.   field.
  51.   Below HA_READ_KEY_EXACT, ..., HA_READ_BEFORE_KEY can take a
  52.   complete-field prefix of a key value as the search
  53.   key. HA_READ_PREFIX and HA_READ_PREFIX_LAST could also take a
  54.   partial-field prefix, but currently (4.0.10) they are only used with
  55.   complete-field prefixes. MySQL uses a padding trick to implement
  56.   LIKE 'abc%' queries.
  57.   NOTE that in InnoDB HA_READ_PREFIX_LAST will NOT work with a
  58.   partial-field prefix because InnoDB currently strips spaces from the
  59.   end of varchar fields!
  60. */
  61. enum ha_rkey_function {
  62.   HA_READ_KEY_EXACT,              /* Find first record else error */
  63.   HA_READ_KEY_OR_NEXT,            /* Record or next record */
  64.   HA_READ_KEY_OR_PREV,            /* Record or previous */
  65.   HA_READ_AFTER_KEY,              /* Find next rec. after key-record */
  66.   HA_READ_BEFORE_KEY,             /* Find next rec. before key-record */
  67.   HA_READ_PREFIX,                 /* Key which as same prefix */
  68.   HA_READ_PREFIX_LAST,            /* Last key with the same prefix */
  69.   HA_READ_PREFIX_LAST_OR_PREV,    /* Last or prev key with the same prefix */
  70.   HA_READ_MBR_CONTAIN,
  71.   HA_READ_MBR_INTERSECT,
  72.   HA_READ_MBR_WITHIN,
  73.   HA_READ_MBR_DISJOINT,
  74.   HA_READ_MBR_EQUAL
  75. };
  76. /* Key algorithm types */
  77. enum ha_key_alg {
  78.   HA_KEY_ALG_UNDEF= 0, /* Not specified (old file) */
  79.   HA_KEY_ALG_BTREE= 1, /* B-tree, default one          */
  80.   HA_KEY_ALG_RTREE= 2, /* R-tree, for spatial searches */
  81.   HA_KEY_ALG_HASH= 3, /* HASH keys (HEAP tables) */
  82.   HA_KEY_ALG_FULLTEXT= 4 /* FULLTEXT (MyISAM tables) */
  83. };
  84. /* The following is parameter to ha_extra() */
  85. enum ha_extra_function {
  86.   HA_EXTRA_NORMAL=0, /* Optimize for space (def) */
  87.   HA_EXTRA_QUICK=1, /* Optimize for speed */
  88.   HA_EXTRA_RESET=2, /* Reset database to after open */
  89.   HA_EXTRA_CACHE=3, /* Cache record in HA_rrnd() */
  90.   HA_EXTRA_NO_CACHE=4, /* End caching of records (def) */
  91.   HA_EXTRA_NO_READCHECK=5, /* No readcheck on update */
  92.   HA_EXTRA_READCHECK=6, /* Use readcheck (def) */
  93.   HA_EXTRA_KEYREAD=7, /* Read only key to database */
  94.   HA_EXTRA_NO_KEYREAD=8, /* Normal read of records (def) */
  95.   HA_EXTRA_NO_USER_CHANGE=9, /* No user is allowed to write */
  96.   HA_EXTRA_KEY_CACHE=10,
  97.   HA_EXTRA_NO_KEY_CACHE=11,
  98.   HA_EXTRA_WAIT_LOCK=12, /* Wait until file is avalably (def) */
  99.   HA_EXTRA_NO_WAIT_LOCK=13, /* If file is locked, return quickly */
  100.   HA_EXTRA_WRITE_CACHE=14, /* Use write cache in ha_write() */
  101.   HA_EXTRA_FLUSH_CACHE=15, /* flush write_record_cache */
  102.   HA_EXTRA_NO_KEYS=16, /* Remove all update of keys */
  103.   HA_EXTRA_KEYREAD_CHANGE_POS=17, /* Keyread, but change pos */
  104. /* xxxxchk -r must be used */
  105.   HA_EXTRA_REMEMBER_POS=18, /* Remember pos for next/prev */
  106.   HA_EXTRA_RESTORE_POS=19,
  107.   HA_EXTRA_REINIT_CACHE=20, /* init cache from current record */
  108.   HA_EXTRA_FORCE_REOPEN=21, /* Datafile have changed on disk */
  109.   HA_EXTRA_FLUSH, /* Flush tables to disk */
  110.   HA_EXTRA_NO_ROWS, /* Don't write rows */
  111.   HA_EXTRA_RESET_STATE, /* Reset positions */
  112.   HA_EXTRA_IGNORE_DUP_KEY, /* Dup keys don't rollback everything*/
  113.   HA_EXTRA_NO_IGNORE_DUP_KEY,
  114.   /*
  115.     Instructs InnoDB to retrieve all columns (except in key read), not just
  116.     those where field->query_id is the same as the current query id
  117.   */
  118.   HA_EXTRA_RETRIEVE_ALL_COLS,
  119.   /*
  120.     Instructs InnoDB to retrieve at least all the primary key columns
  121.   */
  122.   HA_EXTRA_RETRIEVE_PRIMARY_KEY,
  123.   HA_EXTRA_PREPARE_FOR_DELETE,
  124.   HA_EXTRA_PREPARE_FOR_UPDATE, /* Remove read cache if problems */
  125.   HA_EXTRA_PRELOAD_BUFFER_SIZE,         /* Set buffer size for preloading */
  126.   /*
  127.     On-the-fly switching between unique and non-unique key inserting.
  128.   */
  129.   HA_EXTRA_CHANGE_KEY_TO_UNIQUE,
  130.   HA_EXTRA_CHANGE_KEY_TO_DUP
  131. };
  132. /* The following is parameter to ha_panic() */
  133. enum ha_panic_function {
  134.   HA_PANIC_CLOSE, /* Close all databases */
  135.   HA_PANIC_WRITE, /* Unlock and write status */
  136.   HA_PANIC_READ /* Lock and read keyinfo */
  137. };
  138. /* The following is parameter to ha_create(); keytypes */
  139. enum ha_base_keytype {
  140.   HA_KEYTYPE_END=0,
  141.   HA_KEYTYPE_TEXT=1, /* Key is sorted as letters */
  142.   HA_KEYTYPE_BINARY=2, /* Key is sorted as unsigned chars */
  143.   HA_KEYTYPE_SHORT_INT=3,
  144.   HA_KEYTYPE_LONG_INT=4,
  145.   HA_KEYTYPE_FLOAT=5,
  146.   HA_KEYTYPE_DOUBLE=6,
  147.   HA_KEYTYPE_NUM=7, /* Not packed num with pre-space */
  148.   HA_KEYTYPE_USHORT_INT=8,
  149.   HA_KEYTYPE_ULONG_INT=9,
  150.   HA_KEYTYPE_LONGLONG=10,
  151.   HA_KEYTYPE_ULONGLONG=11,
  152.   HA_KEYTYPE_INT24=12,
  153.   HA_KEYTYPE_UINT24=13,
  154.   HA_KEYTYPE_INT8=14,
  155.   HA_KEYTYPE_VARTEXT=15, /* Key is sorted as letters */
  156.   HA_KEYTYPE_VARBINARY=16 /* Key is sorted as unsigned chars */
  157. };
  158. #define HA_MAX_KEYTYPE 31 /* Must be log2-1 */
  159. /* These flags kan be OR:ed to key-flag */
  160. #define HA_NOSAME  1 /* Set if not dupplicated records */
  161. #define HA_PACK_KEY  2 /* Pack string key to previous key */
  162. #define HA_AUTO_KEY  16
  163. #define HA_BINARY_PACK_KEY  32 /* Packing of all keys to prev key */
  164. #define HA_FULLTEXT 128     /* For full-text search */
  165. #define HA_UNIQUE_CHECK 256 /* Check the key for uniqueness */
  166. #define HA_SPATIAL 1024    /* For spatial search */
  167. #define HA_NULL_ARE_EQUAL 2048 /* NULL in key are cmp as equal */
  168. #define HA_GENERATED_KEY 8192 /* Automaticly generated key */
  169. /* Automatic bits in key-flag */
  170. #define HA_SPACE_PACK_USED  4 /* Test for if SPACE_PACK used */
  171. #define HA_VAR_LENGTH_KEY  8
  172. #define HA_NULL_PART_KEY  64
  173. #ifndef ISAM_LIBRARY
  174. #define HA_SORT_ALLOWS_SAME      512    /* Intern bit when sorting records */
  175. #else
  176. /* poor old NISAM has 8-bit flags :-( */
  177. #define HA_SORT_ALLOWS_SAME  128 /* Intern bit when sorting records */
  178. #endif
  179. /*
  180.   Key has a part that can have end space.  If this is an unique key
  181.   we have to handle it differently from other unique keys as we can find
  182.   many matching rows for one key (becaue end space are not compared)
  183. */
  184. #define HA_END_SPACE_KEY 4096
  185. /* These flags can be added to key-seg-flag */
  186. #define HA_SPACE_PACK  1 /* Pack space in key-seg */
  187. #define HA_PART_KEY_SEG  4 /* Used by MySQL for part-key-cols */
  188. #define HA_VAR_LENGTH  8
  189. #define HA_NULL_PART  16
  190. #define HA_BLOB_PART  32
  191. #define HA_SWAP_KEY  64
  192. #define HA_REVERSE_SORT  128 /* Sort key in reverse order */
  193. #define HA_NO_SORT               256 /* do not bother sorting on this keyseg */
  194. /* optionbits for database */
  195. #define HA_OPTION_PACK_RECORD 1
  196. #define HA_OPTION_PACK_KEYS 2
  197. #define HA_OPTION_COMPRESS_RECORD 4
  198. #define HA_OPTION_LONG_BLOB_PTR 8 /* new ISAM format */
  199. #define HA_OPTION_TMP_TABLE 16
  200. #define HA_OPTION_CHECKSUM 32
  201. #define HA_OPTION_DELAY_KEY_WRITE 64
  202. #define HA_OPTION_NO_PACK_KEYS 128  /* Reserved for MySQL */
  203. #define HA_OPTION_CREATE_FROM_ENGINE 256
  204. #define HA_OPTION_TEMP_COMPRESS_RECORD ((uint) 16384) /* set by isamchk */
  205. #define HA_OPTION_READ_ONLY_DATA ((uint) 32768) /* Set by isamchk */
  206. /* Bits in flag to create() */
  207. #define HA_DONT_TOUCH_DATA 1 /* Don't empty datafile (isamchk) */
  208. #define HA_PACK_RECORD 2 /* Request packed record format */
  209. #define HA_CREATE_TMP_TABLE 4
  210. #define HA_CREATE_CHECKSUM 8
  211. #define HA_CREATE_DELAY_KEY_WRITE 64
  212. /* Bits in flag to _status */
  213. #define HA_STATUS_POS 1 /* Return position */
  214. #define HA_STATUS_NO_LOCK 2 /* Don't use external lock */
  215. #define HA_STATUS_TIME 4 /* Return update time */
  216. #define HA_STATUS_CONST 8 /* Return constants values */
  217. #define HA_STATUS_VARIABLE 16
  218. #define HA_STATUS_ERRKEY 32
  219. #define HA_STATUS_AUTO 64
  220. /* Errorcodes given by functions */
  221. /* opt_sum_query() assumes these codes are > 1 */
  222. #define HA_ERR_KEY_NOT_FOUND 120 /* Didn't find key on read or update */
  223. #define HA_ERR_FOUND_DUPP_KEY 121 /* Dupplicate key on write */
  224. #define HA_ERR_RECORD_CHANGED 123 /* Uppdate with is recoverable */
  225. #define HA_ERR_WRONG_INDEX 124 /* Wrong index given to function */
  226. #define HA_ERR_CRASHED 126 /* Indexfile is crashed */
  227. #define HA_ERR_WRONG_IN_RECORD 127 /* Record-file is crashed */
  228. #define HA_ERR_OUT_OF_MEM 128 /* Record-file is crashed */
  229. #define HA_ERR_NOT_A_TABLE      130     /* not a MYI file - no signature */
  230. #define HA_ERR_WRONG_COMMAND 131 /* Command not supported */
  231. #define HA_ERR_OLD_FILE 132 /* old databasfile */
  232. #define HA_ERR_NO_ACTIVE_RECORD 133 /* No record read in update() */
  233. #define HA_ERR_RECORD_DELETED 134 /* Intern error-code */
  234. #define HA_ERR_RECORD_FILE_FULL 135 /* No more room in file */
  235. #define HA_ERR_INDEX_FILE_FULL 136 /* No more room in file */
  236. #define HA_ERR_END_OF_FILE 137 /* end in next/prev/first/last */
  237. #define HA_ERR_UNSUPPORTED 138 /* unsupported extension used */
  238. #define HA_ERR_TO_BIG_ROW 139 /* Too big row */
  239. #define HA_WRONG_CREATE_OPTION 140 /* Wrong create option */
  240. #define HA_ERR_FOUND_DUPP_UNIQUE 141 /* Dupplicate unique on write */
  241. #define HA_ERR_UNKNOWN_CHARSET  142 /* Can't open charset */
  242. #define HA_ERR_WRONG_MRG_TABLE_DEF 143    /* conflicting MyISAM tables in MERGE */
  243. #define HA_ERR_CRASHED_ON_REPAIR 144 /* Last (automatic?) repair failed */
  244. #define HA_ERR_CRASHED_ON_USAGE  145 /* Table must be repaired */
  245. #define HA_ERR_LOCK_WAIT_TIMEOUT 146
  246. #define HA_ERR_LOCK_TABLE_FULL   147
  247. #define HA_ERR_READ_ONLY_TRANSACTION 148 /* Updates not allowed */
  248. #define HA_ERR_LOCK_DEADLOCK  149
  249. #define HA_ERR_CANNOT_ADD_FOREIGN 150    /* Cannot add a foreign key constr. */
  250. #define HA_ERR_NO_REFERENCED_ROW 151     /* Cannot add a child row */
  251. #define HA_ERR_ROW_IS_REFERENCED 152     /* Cannot delete a parent row */
  252. #define HA_ERR_NO_SAVEPOINT  153     /* No savepoint with that name */
  253. #define HA_ERR_NON_UNIQUE_BLOCK_SIZE 154 /* Non unique key block size */
  254. #define HA_ERR_NO_SUCH_TABLE     155  /* The table does not exist in engine */
  255. #define HA_ERR_TABLE_EXIST       156  /* The table existed in storage engine */
  256. #define HA_ERR_NO_CONNECTION     157  /* Could not connect to storage engine */
  257. #define HA_ERR_NULL_IN_SPATIAL   158  /* NULLs are not supported in spatial index */
  258. /* Other constants */
  259. #define HA_NAMELEN 64 /* Max length of saved filename */
  260. #define NO_SUCH_KEY ((uint)~0)          /* used as a key no. */
  261. /* Intern constants in databases */
  262. /* bits in _search */
  263. #define SEARCH_FIND 1
  264. #define SEARCH_NO_FIND 2
  265. #define SEARCH_SAME 4
  266. #define SEARCH_BIGGER 8
  267. #define SEARCH_SMALLER 16
  268. #define SEARCH_SAVE_BUFF 32
  269. #define SEARCH_UPDATE 64
  270. #define SEARCH_PREFIX 128
  271. #define SEARCH_LAST 256
  272. #define MBR_CONTAIN     512
  273. #define MBR_INTERSECT   1024
  274. #define MBR_WITHIN      2048
  275. #define MBR_DISJOINT    4096
  276. #define MBR_EQUAL       8192
  277. #define MBR_DATA        16384
  278. #define SEARCH_NULL_ARE_EQUAL 32768 /* NULL in keys are equal */
  279. #define SEARCH_NULL_ARE_NOT_EQUAL 65536 /* NULL in keys are not equal */
  280. /* bits in opt_flag */
  281. #define QUICK_USED 1
  282. #define READ_CACHE_USED 2
  283. #define READ_CHECK_USED 4
  284. #define KEY_READ_USED 8
  285. #define WRITE_CACHE_USED 16
  286. #define OPT_NO_ROWS 32
  287. /* bits in update */
  288. #define HA_STATE_CHANGED 1 /* Database has changed */
  289. #define HA_STATE_AKTIV 2 /* Has a current record */
  290. #define HA_STATE_WRITTEN 4 /* Record is written */
  291. #define HA_STATE_DELETED 8
  292. #define HA_STATE_NEXT_FOUND 16 /* Next found record (record before) */
  293. #define HA_STATE_PREV_FOUND 32 /* Prev found record (record after) */
  294. #define HA_STATE_NO_KEY 64 /* Last read didn't find record */
  295. #define HA_STATE_KEY_CHANGED 128
  296. #define HA_STATE_WRITE_AT_END 256 /* set in _ps_find_writepos */
  297. #define HA_STATE_BUFF_SAVED 512 /* If current keybuff is info->buff */
  298. #define HA_STATE_ROW_CHANGED 1024 /* To invalide ROW cache */
  299. #define HA_STATE_EXTEND_BLOCK 2048
  300. #define HA_STATE_RNEXT_SAME 4096 /* rnext_same was called */
  301. enum en_fieldtype {
  302.   FIELD_LAST=-1,FIELD_NORMAL,FIELD_SKIP_ENDSPACE,FIELD_SKIP_PRESPACE,
  303.   FIELD_SKIP_ZERO,FIELD_BLOB,FIELD_CONSTANT,FIELD_INTERVALL,FIELD_ZERO,
  304.   FIELD_VARCHAR,FIELD_CHECK
  305. };
  306. enum data_file_type {
  307.   STATIC_RECORD,DYNAMIC_RECORD,COMPRESSED_RECORD
  308. };
  309. /* For key ranges */
  310. typedef struct st_key_range
  311. {
  312.   const byte *key;
  313.   uint length;
  314.   enum ha_rkey_function flag;
  315. } key_range;
  316. /* For number of records */
  317. #ifdef BIG_TABLES
  318. #define rows2double(A) ulonglong2double(A)
  319. typedef my_off_t ha_rows;
  320. #else
  321. #define rows2double(A) (double) (A)
  322. typedef ulong ha_rows;
  323. #endif
  324. #define HA_POS_ERROR (~ (ha_rows) 0)
  325. #define HA_OFFSET_ERROR (~ (my_off_t) 0)
  326. #if SYSTEM_SIZEOF_OFF_T == 4
  327. #define MAX_FILE_SIZE INT_MAX32
  328. #else
  329. #define MAX_FILE_SIZE LONGLONG_MAX
  330. #endif
  331. #endif /* _my_base_h */