~drizzle-trunk/drizzle/development

/* Copyright (C) 2000-2003 MySQL AB

   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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA */

/**

  @file

  @details

  Mostly this file is used in the server. But a little part of it is used in

  mysqlbinlog too (definition of SELECT_DISTINCT and others).

  The consequence is that 90% of the file is wrapped in \#ifndef MYSQL_CLIENT,

  except the part which must be in the server and in the client.

*/

#ifndef MYSQL_PRIV_H

#define MYSQL_PRIV_H

#ifndef MYSQL_CLIENT

#include <my_global.h>

#include <drizzle_version.h>

#include <my_sys.h>

#include <my_time.h>

#include <m_string.h>

#include <hash.h>

#include <signal.h>

#include <thr_lock.h>

#include <my_base.h>			/* Needed by field.h */

#include <queues.h>

#include "sql_bitmap.h"

#include "sql_array.h"

#include "sql_plugin.h"

#include "scheduler.h"

#ifdef HAVE_DTRACE

#define _DTRACE_VERSION 1

#endif

#include "probes.h"

#include <netdb.h>

/**

  Query type constants.

  QT_ORDINARY -- ordinary SQL query.

  QT_IS -- SQL query to be shown in INFORMATION_SCHEMA (in utf8 and without

  character set introducers).

*/

enum enum_query_type

{

  QT_ORDINARY,

  QT_IS

};

/* TODO convert all these three maps to Bitmap classes */

typedef ulonglong table_map;          /* Used for table bits in join */

#if MAX_INDEXES <= 64

typedef Bitmap<64>  key_map;          /* Used for finding keys */

#else

typedef Bitmap<((MAX_INDEXES+7)/8*8)> key_map; /* Used for finding keys */

#endif

typedef ulong nesting_map;  /* Used for flags of nesting constructs */

/*

  Used to identify NESTED_JOIN structures within a join (applicable only to

  structures that have not been simplified away and embed more the one

  element)

*/

typedef ulonglong nested_join_map;

/* query_id */

typedef ulonglong query_id_t;

extern query_id_t global_query_id;

/* increment query_id and return it.  */

inline query_id_t next_query_id() { return global_query_id++; }

/* useful constants */

extern const key_map key_map_empty;

extern key_map key_map_full;          /* Should be threaded as const */

extern const char *primary_key_name;

#include "drizzle_com.h"

#include <violite.h>

#include "unireg.h"

void init_sql_alloc(MEM_ROOT *root, uint block_size, uint pre_alloc_size);

void *sql_alloc(size_t);

void *sql_calloc(size_t);

char *sql_strdup(const char *str);

char *sql_strmake(const char *str, size_t len);

void *sql_memdup(const void * ptr, size_t size);

void sql_element_free(void *ptr);

char *sql_strmake_with_convert(const char *str, size_t arg_length,

			       CHARSET_INFO *from_cs,

			       size_t max_res_length,

			       CHARSET_INFO *to_cs, size_t *result_length);

uint kill_one_thread(THD *thd, ulong id, bool only_kill_query);

void sql_kill(THD *thd, ulong id, bool only_kill_query);

bool net_request_file(NET* net, const char* fname);

char* query_table_status(THD *thd,const char *db,const char *table_name);

#define x_free(A)	{ my_free((uchar*) (A),MYF(MY_WME | MY_FAE | MY_ALLOW_ZERO_PTR)); }

#define safeFree(x)	{ if(x) { my_free((uchar*) x,MYF(0)); x = NULL; } }

#define PREV_BITS(type,A)	((type) (((type) 1 << (A)) -1))

#define all_bits_set(A,B) ((A) & (B) != (B))

/*

  Generates a warning that a feature is deprecated. After a specified version

  asserts that the feature is removed.

  Using it as

    WARN_DEPRECATED(thd, 6,2, "BAD", "'GOOD'");

 Will result in a warning

    "The syntax 'BAD' is deprecated and will be removed in MySQL 6.2. Please

    use 'GOOD' instead"

 Note, that in macro arguments BAD is not quoted, while 'GOOD' is.

 Note, that the version is TWO numbers, separated with a comma

 (two macro arguments, that is)

*/

#define WARN_DEPRECATED(Thd,VerHi,VerLo,Old,New)                            \

  do {                                                                      \

    compile_time_assert(MYSQL_VERSION_ID < VerHi * 10000 + VerLo * 100);    \

    if (Thd)                                                                \

      push_warning_printf((Thd), MYSQL_ERROR::WARN_LEVEL_WARN,              \

                        ER_WARN_DEPRECATED_SYNTAX,                          \

                        ER(ER_WARN_DEPRECATED_SYNTAX_WITH_VER),             \

                        (Old), #VerHi "." #VerLo, (New));                   \

    else                                                                    \

      sql_print_warning("The syntax '%s' is deprecated and will be removed " \

                        "in MySQL %s. Please use %s instead.",              \

                        (Old), #VerHi "." #VerLo, (New));                   \

  } while(0)

extern CHARSET_INFO *system_charset_info, *files_charset_info ;

extern CHARSET_INFO *national_charset_info, *table_alias_charset;

enum Derivation

{

  DERIVATION_IGNORABLE= 5,

  DERIVATION_COERCIBLE= 4,

  DERIVATION_SYSCONST= 3,

  DERIVATION_IMPLICIT= 2,

  DERIVATION_NONE= 1,

  DERIVATION_EXPLICIT= 0

};

typedef struct my_locale_st

{

  uint  number;

  const char *name;

  const char *description;

  const bool is_ascii;

  TYPELIB *month_names;

  TYPELIB *ab_month_names;

  TYPELIB *day_names;

  TYPELIB *ab_day_names;

#ifdef __cplusplus 

  my_locale_st(uint number_par,

               const char *name_par, const char *descr_par, bool is_ascii_par,

               TYPELIB *month_names_par, TYPELIB *ab_month_names_par,

               TYPELIB *day_names_par, TYPELIB *ab_day_names_par) : 

    number(number_par),

    name(name_par), description(descr_par), is_ascii(is_ascii_par),

    month_names(month_names_par), ab_month_names(ab_month_names_par),

    day_names(day_names_par), ab_day_names(ab_day_names_par)

  {}

#endif

} MY_LOCALE;

extern MY_LOCALE my_locale_en_US;

extern MY_LOCALE *my_locales[];

extern MY_LOCALE *my_default_lc_time_names;

MY_LOCALE *my_locale_by_name(const char *name);

MY_LOCALE *my_locale_by_number(uint number);

/*************************************************************************/

/**

 Object_creation_ctx -- interface for creation context of database objects

 (views, stored routines, events, triggers). Creation context -- is a set

 of attributes, that should be fixed at the creation time and then be used

 each time the object is parsed or executed.

*/

class Object_creation_ctx

{

public:

  Object_creation_ctx *set_n_backup(THD *thd);

  void restore_env(THD *thd, Object_creation_ctx *backup_ctx);

protected:

  Object_creation_ctx() {}

  virtual Object_creation_ctx *create_backup_ctx(THD *thd) const = 0;

  virtual void change_env(THD *thd) const = 0;

public:

  virtual ~Object_creation_ctx()

  { }

};

/*************************************************************************/

/**

 Default_object_creation_ctx -- default implementation of

 Object_creation_ctx.

*/

class Default_object_creation_ctx : public Object_creation_ctx

{

public:

  CHARSET_INFO *get_client_cs()

  {

    return m_client_cs;

  }

  CHARSET_INFO *get_connection_cl()

  {

    return m_connection_cl;

  }

protected:

  Default_object_creation_ctx(THD *thd);

  Default_object_creation_ctx(CHARSET_INFO *client_cs,

                              CHARSET_INFO *connection_cl);

protected:

  virtual Object_creation_ctx *create_backup_ctx(THD *thd) const;

  virtual void change_env(THD *thd) const;

protected:

  /**

    client_cs stores the value of character_set_client session variable.

    The only character set attribute is used.

    Client character set is included into query context, because we save

    query in the original character set, which is client character set. So,

    in order to parse the query properly we have to switch client character

    set on parsing.

  */

  CHARSET_INFO *m_client_cs;

  /**

    connection_cl stores the value of collation_connection session

    variable. Both character set and collation attributes are used.

    Connection collation is included into query context, becase it defines

    the character set and collation of text literals in internal

    representation of query (item-objects).

  */

  CHARSET_INFO *m_connection_cl;

};

/**

  Opening modes for open_temporary_table and open_table_from_share

*/

enum open_table_mode

{

  OTM_OPEN= 0,

  OTM_CREATE= 1,

  OTM_ALTER= 2

};

/***************************************************************************

  Configuration parameters

****************************************************************************/

#define ACL_CACHE_SIZE		256

#define MAX_PASSWORD_LENGTH	32

#define HOST_CACHE_SIZE		128

#define MAX_ACCEPT_RETRY	10	// Test accept this many times

#define MAX_FIELDS_BEFORE_HASH	32

#define USER_VARS_HASH_SIZE     16

#define TABLE_OPEN_CACHE_MIN    64

#define TABLE_OPEN_CACHE_DEFAULT 64

/* 

 Value of 9236 discovered through binary search 2006-09-26 on Ubuntu Dapper

 Drake, libc6 2.3.6-0ubuntu2, Linux kernel 2.6.15-27-686, on x86.  (Added 

 100 bytes as reasonable buffer against growth and other environments'

 requirements.)

 Feel free to raise this by the smallest amount you can to get the

 "execution_constants" test to pass.

 */

#define STACK_MIN_SIZE          12000   ///< Abort if less stack during eval.

#define STACK_MIN_SIZE_FOR_OPEN 1024*80

#define STACK_BUFF_ALLOC        352     ///< For stack overrun checks

#ifndef MYSQLD_NET_RETRY_COUNT

#define MYSQLD_NET_RETRY_COUNT  10	///< Abort read after this many int.

#endif

#define TEMP_POOL_SIZE          128

#define QUERY_ALLOC_BLOCK_SIZE		8192

#define QUERY_ALLOC_PREALLOC_SIZE   	8192

#define TRANS_ALLOC_BLOCK_SIZE		4096

#define TRANS_ALLOC_PREALLOC_SIZE	4096

#define RANGE_ALLOC_BLOCK_SIZE		4096

#define ACL_ALLOC_BLOCK_SIZE		1024

#define UDF_ALLOC_BLOCK_SIZE		1024

#define TABLE_ALLOC_BLOCK_SIZE		1024

#define BDB_LOG_ALLOC_BLOCK_SIZE	1024

#define WARN_ALLOC_BLOCK_SIZE		2048

#define WARN_ALLOC_PREALLOC_SIZE	1024

#define PROFILE_ALLOC_BLOCK_SIZE  2048

#define PROFILE_ALLOC_PREALLOC_SIZE 1024

/*

  The following parameters is to decide when to use an extra cache to

  optimise seeks when reading a big table in sorted order

*/

#define MIN_FILE_LENGTH_TO_USE_ROW_CACHE (10L*1024*1024)

#define MIN_ROWS_TO_USE_TABLE_CACHE	 100

#define MIN_ROWS_TO_USE_BULK_INSERT	 100

/**

  The following is used to decide if MySQL should use table scanning

  instead of reading with keys.  The number says how many evaluation of the

  WHERE clause is comparable to reading one extra row from a table.

*/

#define TIME_FOR_COMPARE   5	// 5 compares == one read

/**

  Number of comparisons of table rowids equivalent to reading one row from a 

  table.

*/

#define TIME_FOR_COMPARE_ROWID  (TIME_FOR_COMPARE*2)

/*

  For sequential disk seeks the cost formula is:

    DISK_SEEK_BASE_COST + DISK_SEEK_PROP_COST * #blocks_to_skip  

  The cost of average seek 

    DISK_SEEK_BASE_COST + DISK_SEEK_PROP_COST*BLOCKS_IN_AVG_SEEK =1.0.

*/

#define DISK_SEEK_BASE_COST ((double)0.9)

#define BLOCKS_IN_AVG_SEEK  128

#define DISK_SEEK_PROP_COST ((double)0.1/BLOCKS_IN_AVG_SEEK)

/**

  Number of rows in a reference table when refereed through a not unique key.

  This value is only used when we don't know anything about the key

  distribution.

*/

#define MATCHING_ROWS_IN_OTHER_TABLE 10

/** Don't pack string keys shorter than this (if PACK_KEYS=1 isn't used). */

#define KEY_DEFAULT_PACK_LENGTH 8

/** Characters shown for the command in 'show processlist'. */

#define PROCESS_LIST_WIDTH 100

/* Characters shown for the command in 'information_schema.processlist' */

#define PROCESS_LIST_INFO_WIDTH 65535

#define PRECISION_FOR_DOUBLE 53

#define PRECISION_FOR_FLOAT  24

/*

  Default time to wait before aborting a new client connection

  that does not respond to "initial server greeting" timely

*/

#define CONNECT_TIMEOUT		10

/* The following can also be changed from the command line */

#define DEFAULT_CONCURRENCY	10

#define FLUSH_TIME		0		/**< Don't flush tables */

#define MAX_CONNECT_ERRORS	10		///< errors before disabling host

#define INTERRUPT_PRIOR 10

#define CONNECT_PRIOR	9

#define WAIT_PRIOR	8

#define QUERY_PRIOR	6

	/* Bits from testflag */

#define TEST_PRINT_CACHED_TABLES 1

#define TEST_NO_KEY_GROUP	 2

#define TEST_MIT_THREAD		4

#define TEST_BLOCKING		8

#define TEST_KEEP_TMP_TABLES	16

#define TEST_READCHECK		64	/**< Force use of readcheck */

#define TEST_NO_EXTRA		128

#define TEST_CORE_ON_SIGNAL	256	/**< Give core if signal */

#define TEST_NO_STACKTRACE	512

#define TEST_SIGINT		1024	/**< Allow sigint on threads */

#define TEST_SYNCHRONIZATION    2048    /**< get server to do sleep in

                                           some places */

#endif

/*

   This is included in the server and in the client.

   Options for select set by the yacc parser (stored in lex->options).

   XXX:

   log_event.h defines OPTIONS_WRITTEN_TO_BIN_LOG to specify what THD

   options list are written into binlog. These options can NOT change their

   values, or it will break replication between version.

   context is encoded as following:

   SELECT - SELECT_LEX_NODE::options

   THD    - THD::options

   intern - neither. used only as

            func(..., select_node->options | thd->options | OPTION_XXX, ...)

   TODO: separate three contexts above, move them to separate bitfields.

*/

#define SELECT_DISTINCT         (1ULL << 0)     // SELECT, user

#define SELECT_STRAIGHT_JOIN    (1ULL << 1)     // SELECT, user

#define SELECT_DESCRIBE         (1ULL << 2)     // SELECT, user

#define SELECT_SMALL_RESULT     (1ULL << 3)     // SELECT, user

#define SELECT_BIG_RESULT       (1ULL << 4)     // SELECT, user

#define OPTION_FOUND_ROWS       (1ULL << 5)     // SELECT, user

#define SELECT_NO_JOIN_CACHE    (1ULL << 7)     // intern

#define OPTION_BIG_TABLES       (1ULL << 8)     // THD, user

#define OPTION_BIG_SELECTS      (1ULL << 9)     // THD, user

#define OPTION_LOG_OFF          (1ULL << 10)    // THD, user

#define OPTION_QUOTE_SHOW_CREATE (1ULL << 11)   // THD, user, unused

#define TMP_TABLE_ALL_COLUMNS   (1ULL << 12)    // SELECT, intern

#define OPTION_WARNINGS         (1ULL << 13)    // THD, user

#define OPTION_AUTO_IS_NULL     (1ULL << 14)    // THD, user, binlog

#define OPTION_FOUND_COMMENT    (1ULL << 15)    // SELECT, intern, parser

#define OPTION_SAFE_UPDATES     (1ULL << 16)    // THD, user

#define OPTION_BUFFER_RESULT    (1ULL << 17)    // SELECT, user

#define OPTION_BIN_LOG          (1ULL << 18)    // THD, user

#define OPTION_NOT_AUTOCOMMIT   (1ULL << 19)    // THD, user

#define OPTION_BEGIN            (1ULL << 20)    // THD, intern

#define OPTION_TABLE_LOCK       (1ULL << 21)    // THD, intern

#define OPTION_QUICK            (1ULL << 22)    // SELECT (for DELETE)

#define OPTION_KEEP_LOG         (1ULL << 23)    // THD, user

/* The following is used to detect a conflict with DISTINCT */

#define SELECT_ALL              (1ULL << 24)    // SELECT, user, parser

/** The following can be set when importing tables in a 'wrong order'

   to suppress foreign key checks */

#define OPTION_NO_FOREIGN_KEY_CHECKS    (1ULL << 26) // THD, user, binlog

/** The following speeds up inserts to InnoDB tables by suppressing unique

   key checks in some cases */

#define OPTION_RELAXED_UNIQUE_CHECKS    (1ULL << 27) // THD, user, binlog

#define SELECT_NO_UNLOCK                (1ULL << 28) // SELECT, intern

#define OPTION_SCHEMA_TABLE             (1ULL << 29) // SELECT, intern

/** Flag set if setup_tables already done */

#define OPTION_SETUP_TABLES_DONE        (1ULL << 30) // intern

/** If not set then the thread will ignore all warnings with level notes. */

#define OPTION_SQL_NOTES                (1ULL << 31) // THD, user

/**

  Force the used temporary table to be a MyISAM table (because we will use

  fulltext functions when reading from it.

*/

#define TMP_TABLE_FORCE_MYISAM          (1ULL << 32)

#define OPTION_PROFILING                (1ULL << 33)

/*

  Dont report errors for individual rows,

  But just report error on commit (or read ofcourse)

*/

#define OPTION_ALLOW_BATCH              (1ULL << 33) // THD, intern (slave)

/**

  Maximum length of time zone name that we support

  (Time zone name is char(64) in db). mysqlbinlog needs it.

*/

#define MAX_TIME_ZONE_NAME_LENGTH       (NAME_LEN + 1)

/* The rest of the file is included in the server only */

#ifndef MYSQL_CLIENT

/* Bits for different SQL modes modes (including ANSI mode) */

#define MODE_REAL_AS_FLOAT              1

#define MODE_PIPES_AS_CONCAT            2

#define MODE_ANSI_QUOTES                4

#define MODE_IGNORE_SPACE		8

#define MODE_NOT_USED			16

#define MODE_ONLY_FULL_GROUP_BY		32

#define MODE_NO_UNSIGNED_SUBTRACTION	64

#define MODE_NO_DIR_IN_CREATE		128

#define MODE_POSTGRESQL			256

#define MODE_ORACLE			512

#define MODE_MSSQL			1024

#define MODE_DB2			2048

#define MODE_MAXDB			4096

#define MODE_NO_KEY_OPTIONS             8192

#define MODE_NO_TABLE_OPTIONS           16384

#define MODE_NO_FIELD_OPTIONS           32768

#define MODE_MYSQL323                   65536L

#define MODE_MYSQL40                    (MODE_MYSQL323*2)

#define MODE_ANSI	                (MODE_MYSQL40*2)

#define MODE_NO_AUTO_VALUE_ON_ZERO      (MODE_ANSI*2)

#define MODE_NO_BACKSLASH_ESCAPES       (MODE_NO_AUTO_VALUE_ON_ZERO*2)

#define MODE_STRICT_TRANS_TABLES	(MODE_NO_BACKSLASH_ESCAPES*2)

#define MODE_STRICT_ALL_TABLES		(MODE_STRICT_TRANS_TABLES*2)

#define MODE_NO_ZERO_IN_DATE		(MODE_STRICT_ALL_TABLES*2)

#define MODE_NO_ZERO_DATE		(MODE_NO_ZERO_IN_DATE*2)

#define MODE_INVALID_DATES		(MODE_NO_ZERO_DATE*2)

#define MODE_ERROR_FOR_DIVISION_BY_ZERO (MODE_INVALID_DATES*2)

#define MODE_TRADITIONAL		(MODE_ERROR_FOR_DIVISION_BY_ZERO*2)

#define MODE_NO_AUTO_CREATE_USER	(MODE_TRADITIONAL*2)

#define MODE_HIGH_NOT_PRECEDENCE	(MODE_NO_AUTO_CREATE_USER*2)

#define MODE_NO_ENGINE_SUBSTITUTION     (MODE_HIGH_NOT_PRECEDENCE*2)

#define MODE_PAD_CHAR_TO_FULL_LENGTH    (1ULL << 31)

/* @@optimizer_switch flags */

#define OPTIMIZER_SWITCH_NO_MATERIALIZATION 1

#define OPTIMIZER_SWITCH_NO_SEMIJOIN 2

/*

  Replication uses 8 bytes to store SQL_MODE in the binary log. The day you

  use strictly more than 64 bits by adding one more define above, you should

  contact the replication team because the replication code should then be

  updated (to store more bytes on disk).

  NOTE: When adding new SQL_MODE types, make sure to also add them to

  the scripts used for creating the MySQL system tables

  in scripts/mysql_system_tables.sql and scripts/mysql_system_tables_fix.sql

*/

#define RAID_BLOCK_SIZE 1024

#define MY_CHARSET_BIN_MB_MAXLEN 1

// uncachable cause

#define UNCACHEABLE_DEPENDENT   1

#define UNCACHEABLE_RAND        2

#define UNCACHEABLE_SIDEEFFECT	4

/// forcing to save JOIN for explain

#define UNCACHEABLE_EXPLAIN     8

/** Don't evaluate subqueries in prepare even if they're not correlated */

#define UNCACHEABLE_PREPARE    16

/* For uncorrelated SELECT in an UNION with some correlated SELECTs */

#define UNCACHEABLE_UNITED     32

/* Used to check GROUP BY list in the MODE_ONLY_FULL_GROUP_BY mode */

#define UNDEF_POS (-1)

#ifdef EXTRA_DEBUG

/**

  Sync points allow us to force the server to reach a certain line of code

  and block there until the client tells the server it is ok to go on.

  The client tells the server to block with SELECT GET_LOCK()

  and unblocks it with SELECT RELEASE_LOCK(). Used for debugging difficult

  concurrency problems

*/

#define DBUG_SYNC_POINT(lock_name,lock_timeout) \

 debug_sync_point(lock_name,lock_timeout)

void debug_sync_point(const char* lock_name, uint lock_timeout);

#else

#define DBUG_SYNC_POINT(lock_name,lock_timeout)

#endif /* EXTRA_DEBUG */

/* BINLOG_DUMP options */

#define BINLOG_DUMP_NON_BLOCK   1

/* sql_show.cc:show_log_files() */

#define SHOW_LOG_STATUS_FREE "FREE"

#define SHOW_LOG_STATUS_INUSE "IN USE"

struct TABLE_LIST;

class String;

void view_store_options(THD *thd, TABLE_LIST *table, String *buff);

/* Options to add_table_to_list() */

#define TL_OPTION_UPDATING	1

#define TL_OPTION_FORCE_INDEX	2

#define TL_OPTION_IGNORE_LEAVES 4

#define TL_OPTION_ALIAS         8

/* Some portable defines */

#define portable_sizeof_char_ptr 8

#define tmp_file_prefix "#sql"			/**< Prefix for tmp tables */

#define tmp_file_prefix_length 4

/* Flags for calc_week() function.  */

#define WEEK_MONDAY_FIRST    1

#define WEEK_YEAR            2

#define WEEK_FIRST_WEEKDAY   4

#define STRING_BUFFER_USUAL_SIZE 80

/*

  Some defines for exit codes for ::is_equal class functions.

*/

#define IS_EQUAL_NO 0

#define IS_EQUAL_YES 1

#define IS_EQUAL_PACK_LENGTH 2

enum enum_parsing_place

{

  NO_MATTER,

  IN_HAVING,

  SELECT_LIST,

  IN_WHERE,

  IN_ON

};

struct st_table;

#define thd_proc_info(thd, msg)  set_thd_proc_info(thd, msg, __func__, __FILE__, __LINE__)

class THD;

enum enum_check_fields

{

  CHECK_FIELD_IGNORE,

  CHECK_FIELD_WARN,

  CHECK_FIELD_ERROR_FOR_NULL

};

/** Struct to handle simple linked lists. */

typedef struct st_sql_list {

  uint elements;

  uchar *first;

  uchar **next;

  st_sql_list() {}                              /* Remove gcc warning */

  inline void empty()

  {

    elements=0;

    first=0;

    next= &first;

  }

  inline void link_in_list(uchar *element,uchar **next_ptr)

  {

    elements++;

    (*next)=element;

    next= next_ptr;

    *next=0;

  }

  inline void save_and_clear(struct st_sql_list *save)

  {

    *save= *this;

    empty();

  }

  inline void push_front(struct st_sql_list *save)

  {

    *save->next= first;				/* link current list last */

    first= save->first;

    elements+= save->elements;

  }

  inline void push_back(struct st_sql_list *save)

  {

    if (save->first)

    {

      *next= save->first;

      next= save->next;

      elements+= save->elements;

    }

  }

} SQL_LIST;

extern pthread_key(THD*, THR_THD);

inline THD *_current_thd(void)

{

  return (THD *)pthread_getspecific(THR_THD);

}

#define current_thd _current_thd()

/** 

  The meat of thd_proc_info(THD*, char*), a macro that packs the last

  three calling-info parameters. 

*/

extern "C"

const char *set_thd_proc_info(THD *thd, const char *info, 

                              const char *calling_func, 

                              const char *calling_file, 

                              const unsigned int calling_line);

/*

  External variables

*/

extern ulong server_id;

typedef my_bool (*qc_engine_callback)(THD *thd, char *table_key,

                                      uint key_length,

                                      ulonglong *engine_data);

#include "sql_string.h"

#include "sql_list.h"

#include "sql_map.h"

#include "my_decimal.h"

#include "handler.h"

#include "table.h"

#include "sql_error.h"

#include "field.h"				/* Field definitions */

#include "protocol.h"

#include "sql_udf.h"

class user_var_entry;

class Security_context;

enum enum_var_type

{

  OPT_DEFAULT= 0, OPT_SESSION, OPT_GLOBAL

};

class sys_var;

#ifdef MYSQL_SERVER

class Comp_creator;

typedef Comp_creator* (*chooser_compare_func_creator)(bool invert);

#endif

#include "item.h"

extern my_decimal decimal_zero;

/* sql_parse.cc */

void free_items(Item *item);

void cleanup_items(Item *item);

class THD;

void close_thread_tables(THD *thd);

bool multi_update_precheck(THD *thd, TABLE_LIST *tables);

bool multi_delete_precheck(THD *thd, TABLE_LIST *tables);

int mysql_multi_update_prepare(THD *thd);

int mysql_multi_delete_prepare(THD *thd);

bool mysql_insert_select_prepare(THD *thd);

bool update_precheck(THD *thd, TABLE_LIST *tables);

bool delete_precheck(THD *thd, TABLE_LIST *tables);

bool insert_precheck(THD *thd, TABLE_LIST *tables);

bool create_table_precheck(THD *thd, TABLE_LIST *tables,

                           TABLE_LIST *create_table);

int append_query_string(CHARSET_INFO *csinfo,

                        String const *from, String *to);

bool check_string_byte_length(LEX_STRING *str, const char *err_msg,

                              uint max_byte_length);

bool check_string_char_length(LEX_STRING *str, const char *err_msg,

                              uint max_char_length, CHARSET_INFO *cs,

                              bool no_error);

bool check_identifier_name(LEX_STRING *str, uint max_char_length,

                           uint err_code, const char *param_for_err_msg);

inline bool check_identifier_name(LEX_STRING *str, uint err_code)

{

  return check_identifier_name(str, NAME_CHAR_LEN, err_code, "");

}

inline bool check_identifier_name(LEX_STRING *str)

{

  return check_identifier_name(str, NAME_CHAR_LEN, 0, "");

}

bool test_if_data_home_dir(const char *dir);

bool parse_sql(THD *thd,

               class Lex_input_stream *lip,

               class Object_creation_ctx *creation_ctx);

enum enum_mysql_completiontype {

  ROLLBACK_RELEASE=-2, ROLLBACK=1,  ROLLBACK_AND_CHAIN=7,

  COMMIT_RELEASE=-1,   COMMIT=0,    COMMIT_AND_CHAIN=6

};

bool begin_trans(THD *thd);

bool end_active_trans(THD *thd);

int end_trans(THD *thd, enum enum_mysql_completiontype completion);

Item *negate_expression(THD *thd, Item *expr);

/* log.cc */

int vprint_msg_to_log(enum loglevel level, const char *format, va_list args);

void sql_print_error(const char *format, ...) ATTRIBUTE_FORMAT(printf, 1, 2);

void sql_print_warning(const char *format, ...) ATTRIBUTE_FORMAT(printf, 1, 2);

void sql_print_information(const char *format, ...)

  ATTRIBUTE_FORMAT(printf, 1, 2);

typedef void (*sql_print_message_func)(const char *format, ...)

  ATTRIBUTE_FORMAT(printf, 1, 2);

extern sql_print_message_func sql_print_message_handlers[];

int error_log_print(enum loglevel level, const char *format,

                    va_list args);

bool slow_log_print(THD *thd, const char *query, uint query_length,

                    ulonglong current_utime);

bool general_log_print(THD *thd, enum enum_server_command command,

                       const char *format,...);

bool general_log_write(THD *thd, enum enum_server_command command,

                       const char *query, uint query_length);

#include "sql_class.h"

#include "slave.h" // for tables_ok(), rpl_filter

#include "tztime.h"

#ifdef MYSQL_SERVER

#include "opt_range.h"

/*

  Error injector Macros to enable easy testing of recovery after failures

  in various error cases.

*/

#ifndef ERROR_INJECT_SUPPORT

#define ERROR_INJECT(x) 0

#define ERROR_INJECT_ACTION(x,action) 0

#define ERROR_INJECT_CRASH(x) 0

#define ERROR_INJECT_VALUE(x) 0

#define ERROR_INJECT_VALUE_ACTION(x,action) 0

#define ERROR_INJECT_VALUE_CRASH(x) 0

#define SET_ERROR_INJECT_VALUE(x)

#else

inline bool check_and_unset_keyword(const char *dbug_str)

{

  const char *extra_str= "-d,";

  char total_str[200];

  if (_db_strict_keyword_ (dbug_str))

  {

    strxmov(total_str, extra_str, dbug_str, NullS);

    return 1;

  }

  return 0;

}

inline bool

check_and_unset_inject_value(int value)

{

  THD *thd= current_thd;

  if (thd->error_inject_value == (uint)value)

  {

    thd->error_inject_value= 0;

    return 1;

  }

  return 0;

}

/*

  ERROR INJECT MODULE:

  --------------------

  These macros are used to insert macros from the application code.

  The event that activates those error injections can be activated

  from SQL by using:

  SET SESSION dbug=+d,code;

  After the error has been injected, the macros will automatically

  remove the debug code, thus similar to using:

  SET SESSION dbug=-d,code

  from SQL.

  ERROR_INJECT_CRASH will inject a crash of the MySQL Server if code

  is set when macro is called. ERROR_INJECT_CRASH can be used in

  if-statements, it will always return false unless of course it

  crashes in which case it doesn't return at all.

  ERROR_INJECT_ACTION will inject the action specified in the action

  parameter of the macro, before performing the action the code will

  be removed such that no more events occur. ERROR_INJECT_ACTION

  can also be used in if-statements and always returns FALSE.

  ERROR_INJECT can be used in a normal if-statement, where the action

  part is performed in the if-block. The macro returns TRUE if the

  error was activated and otherwise returns FALSE. If activated the

  code is removed.

  Sometimes it is necessary to perform error inject actions as a serie

  of events. In this case one can use one variable on the THD object.

  Thus one sets this value by using e.g. SET_ERROR_INJECT_VALUE(100).

  Then one can later test for it by using ERROR_INJECT_CRASH_VALUE,

  ERROR_INJECT_ACTION_VALUE and ERROR_INJECT_VALUE. This have the same

  behaviour as the above described macros except that they use the

  error inject value instead of a code used by DBUG macros.

*/

#define SET_ERROR_INJECT_VALUE(x) \

  current_thd->error_inject_value= (x)

#define ERROR_INJECT_CRASH(code) \

  DBUG_EVALUATE_IF(code, (abort(), 0), 0)

#define ERROR_INJECT_ACTION(code, action) \

  (check_and_unset_keyword(code) ? ((action), 0) : 0)

#define ERROR_INJECT(code) \

  check_and_unset_keyword(code)

#define ERROR_INJECT_VALUE(value) \

  check_and_unset_inject_value(value)

#define ERROR_INJECT_VALUE_ACTION(value,action) \

  (check_and_unset_inject_value(value) ? (action) : 0)

#define ERROR_INJECT_VALUE_CRASH(value) \

  ERROR_INJECT_VALUE_ACTION(value, (abort(), 0))

#endif

void write_bin_log(THD *thd, bool clear_error,

                   char const *query, ulong query_length);

/* sql_connect.cc */

int check_user(THD *thd, enum enum_server_command command, 

	       const char *passwd, uint passwd_len, const char *db,

	       bool check_count);

pthread_handler_t handle_one_connection(void *arg);

bool init_new_connection_handler_thread();

void reset_mqh(LEX_USER *lu, bool get_them);

bool check_mqh(THD *thd, uint check_command);

void time_out_user_resource_limits(THD *thd, USER_CONN *uc);

void decrease_user_connections(USER_CONN *uc);

void thd_init_client_charset(THD *thd, uint cs_number);

bool setup_connection_thread_globals(THD *thd);

bool login_connection(THD *thd);

void prepare_new_connection_state(THD* thd);

void end_connection(THD *thd);

int mysql_create_db(THD *thd, char *db, HA_CREATE_INFO *create, bool silent);

bool mysql_alter_db(THD *thd, const char *db, HA_CREATE_INFO *create);