mirror of
https://github.com/MariaDB/server.git
synced 2025-01-16 12:02:42 +01:00
054d2de499
include/mysql.h: cleanup of load data infile patch libmysql/libmysql.c: cleanup of load data infile patch myisam/mi_search.c: Added missing assert.h mysql-test/r/func_time.result: Make test more secure mysql-test/t/func_time.test: Make test more secure sql/item.cc: restore to use str_value in item::save_in_field sql/item.h: Simple cleanup sql/item_cmpfunc.cc: Safety fix sql/item_cmpfunc.h: Simple optimization sql/item_func.cc: Updated comment sql/sql_base.cc: Simple optimization sql/sql_select.cc: Simple optimization sql/sql_union.cc: safey fixes
708 lines
25 KiB
C
708 lines
25 KiB
C
/* 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; either version 2 of the License, or
|
|
(at your option) any later version.
|
|
|
|
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 */
|
|
|
|
#ifndef _mysql_h
|
|
#define _mysql_h
|
|
|
|
#ifdef __CYGWIN__ /* CYGWIN implements a UNIX API */
|
|
#undef WIN
|
|
#undef _WIN
|
|
#undef _WIN32
|
|
#undef _WIN64
|
|
#undef __WIN__
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#ifndef _global_h /* If not standard header */
|
|
#include <sys/types.h>
|
|
#ifdef __LCC__
|
|
#include <winsock.h> /* For windows */
|
|
#endif
|
|
typedef char my_bool;
|
|
#if (defined(_WIN32) || defined(_WIN64)) && !defined(__WIN__)
|
|
#define __WIN__
|
|
#endif
|
|
#if !defined(__WIN__)
|
|
#define STDCALL
|
|
#else
|
|
#define STDCALL __stdcall
|
|
#endif
|
|
typedef char * gptr;
|
|
|
|
#ifndef my_socket_defined
|
|
#ifdef __WIN__
|
|
#define my_socket SOCKET
|
|
#else
|
|
typedef int my_socket;
|
|
#endif /* __WIN__ */
|
|
#endif /* my_socket_defined */
|
|
#endif /* _global_h */
|
|
|
|
#include "mysql_com.h"
|
|
#include "mysql_version.h"
|
|
#include "typelib.h"
|
|
|
|
#include "my_list.h" /* for LISTs used in 'MYSQL' and 'MYSQL_STMT' */
|
|
|
|
extern unsigned int mysql_port;
|
|
extern char *mysql_unix_port;
|
|
|
|
#define CLIENT_NET_READ_TIMEOUT 365*24*3600 /* Timeout on read */
|
|
#define CLIENT_NET_WRITE_TIMEOUT 365*24*3600 /* Timeout on write */
|
|
|
|
#ifdef __NETWARE__
|
|
#pragma pack(push, 8) /* 8 byte alignment */
|
|
#endif
|
|
|
|
#define IS_PRI_KEY(n) ((n) & PRI_KEY_FLAG)
|
|
#define IS_NOT_NULL(n) ((n) & NOT_NULL_FLAG)
|
|
#define IS_BLOB(n) ((n) & BLOB_FLAG)
|
|
#define IS_NUM(t) ((t) <= FIELD_TYPE_INT24 || (t) == FIELD_TYPE_YEAR)
|
|
#define IS_NUM_FIELD(f) ((f)->flags & NUM_FLAG)
|
|
#define INTERNAL_NUM_FIELD(f) (((f)->type <= FIELD_TYPE_INT24 && ((f)->type != FIELD_TYPE_TIMESTAMP || (f)->length == 14 || (f)->length == 8)) || (f)->type == FIELD_TYPE_YEAR)
|
|
|
|
#define HAVE_DEPRECATED_411_API 1
|
|
|
|
typedef struct st_mysql_field {
|
|
char *name; /* Name of column */
|
|
char *org_name; /* Original column name, if an alias */
|
|
char *table; /* Table of column if column was a field */
|
|
char *org_table; /* Org table name, if table was an alias */
|
|
char *db; /* Database for table */
|
|
char *catalog; /* Catalog for table */
|
|
char *def; /* Default value (set by mysql_list_fields) */
|
|
unsigned long length; /* Width of column */
|
|
unsigned long max_length; /* Max width of selected set */
|
|
unsigned int name_length;
|
|
unsigned int org_name_length;
|
|
unsigned int table_length;
|
|
unsigned int org_table_length;
|
|
unsigned int db_length;
|
|
unsigned int catalog_length;
|
|
unsigned int def_length;
|
|
unsigned int flags; /* Div flags */
|
|
unsigned int decimals; /* Number of decimals in field */
|
|
unsigned int charsetnr; /* Character set */
|
|
enum enum_field_types type; /* Type of field. Se mysql_com.h for types */
|
|
} MYSQL_FIELD;
|
|
|
|
typedef char **MYSQL_ROW; /* return data as array of strings */
|
|
typedef unsigned int MYSQL_FIELD_OFFSET; /* offset to current field */
|
|
|
|
#ifndef _global_h
|
|
#if defined(NO_CLIENT_LONG_LONG)
|
|
typedef unsigned long my_ulonglong;
|
|
#elif defined (__WIN__)
|
|
typedef unsigned __int64 my_ulonglong;
|
|
#else
|
|
typedef unsigned long long my_ulonglong;
|
|
#endif
|
|
#endif
|
|
|
|
#define MYSQL_COUNT_ERROR (~(my_ulonglong) 0)
|
|
|
|
typedef struct st_mysql_rows {
|
|
struct st_mysql_rows *next; /* list of rows */
|
|
MYSQL_ROW data;
|
|
} MYSQL_ROWS;
|
|
|
|
typedef MYSQL_ROWS *MYSQL_ROW_OFFSET; /* offset to current row */
|
|
|
|
#include "my_alloc.h"
|
|
|
|
typedef struct st_mysql_data {
|
|
my_ulonglong rows;
|
|
unsigned int fields;
|
|
MYSQL_ROWS *data;
|
|
MEM_ROOT alloc;
|
|
#if !defined(CHECK_EMBEDDED_DIFFERENCES) || defined(EMBEDDED_LIBRARY)
|
|
MYSQL_ROWS **prev_ptr;
|
|
#endif
|
|
} MYSQL_DATA;
|
|
|
|
enum mysql_option
|
|
{
|
|
MYSQL_OPT_CONNECT_TIMEOUT, MYSQL_OPT_COMPRESS, MYSQL_OPT_NAMED_PIPE,
|
|
MYSQL_INIT_COMMAND, MYSQL_READ_DEFAULT_FILE, MYSQL_READ_DEFAULT_GROUP,
|
|
MYSQL_SET_CHARSET_DIR, MYSQL_SET_CHARSET_NAME, MYSQL_OPT_LOCAL_INFILE,
|
|
MYSQL_OPT_PROTOCOL, MYSQL_SHARED_MEMORY_BASE_NAME, MYSQL_OPT_READ_TIMEOUT,
|
|
MYSQL_OPT_WRITE_TIMEOUT, MYSQL_OPT_USE_RESULT,
|
|
MYSQL_OPT_USE_REMOTE_CONNECTION, MYSQL_OPT_USE_EMBEDDED_CONNECTION,
|
|
MYSQL_OPT_GUESS_CONNECTION, MYSQL_SET_CLIENT_IP, MYSQL_SECURE_AUTH
|
|
};
|
|
|
|
struct st_mysql_options {
|
|
unsigned int connect_timeout, read_timeout, write_timeout;
|
|
unsigned int port, protocol;
|
|
unsigned long client_flag;
|
|
char *host,*user,*password,*unix_socket,*db;
|
|
struct st_dynamic_array *init_commands;
|
|
char *my_cnf_file,*my_cnf_group, *charset_dir, *charset_name;
|
|
char *ssl_key; /* PEM key file */
|
|
char *ssl_cert; /* PEM cert file */
|
|
char *ssl_ca; /* PEM CA file */
|
|
char *ssl_capath; /* PEM directory of CA-s? */
|
|
char *ssl_cipher; /* cipher to use */
|
|
char *shared_memory_base_name;
|
|
unsigned long max_allowed_packet;
|
|
my_bool use_ssl; /* if to use SSL or not */
|
|
my_bool compress,named_pipe;
|
|
/*
|
|
On connect, find out the replication role of the server, and
|
|
establish connections to all the peers
|
|
*/
|
|
my_bool rpl_probe;
|
|
/*
|
|
Each call to mysql_real_query() will parse it to tell if it is a read
|
|
or a write, and direct it to the slave or the master
|
|
*/
|
|
my_bool rpl_parse;
|
|
/*
|
|
If set, never read from a master,only from slave, when doing
|
|
a read that is replication-aware
|
|
*/
|
|
my_bool no_master_reads;
|
|
#if !defined(CHECK_EMBEDDED_DIFFERENCES) || defined(EMBEDDED_LIBRARY)
|
|
my_bool separate_thread;
|
|
#endif
|
|
enum mysql_option methods_to_use;
|
|
char *client_ip;
|
|
/* Refuse client connecting to server if it uses old (pre-4.1.1) protocol */
|
|
my_bool secure_auth;
|
|
|
|
/* function pointers for local infile support */
|
|
int (*local_infile_init)(void **, const char *);
|
|
int (*local_infile_read)(void *, char *, uint);
|
|
void (*local_infile_end)(void *);
|
|
int (*local_infile_error)(void *, char *, uint);
|
|
};
|
|
|
|
enum mysql_status
|
|
{
|
|
MYSQL_STATUS_READY,MYSQL_STATUS_GET_RESULT,MYSQL_STATUS_USE_RESULT
|
|
};
|
|
|
|
enum mysql_protocol_type
|
|
{
|
|
MYSQL_PROTOCOL_DEFAULT, MYSQL_PROTOCOL_TCP, MYSQL_PROTOCOL_SOCKET,
|
|
MYSQL_PROTOCOL_PIPE, MYSQL_PROTOCOL_MEMORY
|
|
};
|
|
/*
|
|
There are three types of queries - the ones that have to go to
|
|
the master, the ones that go to a slave, and the adminstrative
|
|
type which must happen on the pivot connectioin
|
|
*/
|
|
enum mysql_rpl_type
|
|
{
|
|
MYSQL_RPL_MASTER, MYSQL_RPL_SLAVE, MYSQL_RPL_ADMIN
|
|
};
|
|
|
|
struct st_mysql_methods;
|
|
|
|
typedef struct st_mysql
|
|
{
|
|
NET net; /* Communication parameters */
|
|
gptr connector_fd; /* ConnectorFd for SSL */
|
|
char *host,*user,*passwd,*unix_socket,*server_version,*host_info,*info;
|
|
char *db;
|
|
struct charset_info_st *charset;
|
|
MYSQL_FIELD *fields;
|
|
MEM_ROOT field_alloc;
|
|
my_ulonglong affected_rows;
|
|
my_ulonglong insert_id; /* id if insert on table with NEXTNR */
|
|
my_ulonglong extra_info; /* Used by mysqlshow */
|
|
unsigned long thread_id; /* Id for connection in server */
|
|
unsigned long packet_length;
|
|
unsigned int port;
|
|
unsigned long client_flag,server_capabilities;
|
|
unsigned int protocol_version;
|
|
unsigned int field_count;
|
|
unsigned int server_status;
|
|
unsigned int server_language;
|
|
unsigned int warning_count;
|
|
struct st_mysql_options options;
|
|
enum mysql_status status;
|
|
my_bool free_me; /* If free in mysql_close */
|
|
my_bool reconnect; /* set to 1 if automatic reconnect */
|
|
|
|
/* session-wide random string */
|
|
char scramble[SCRAMBLE_LENGTH+1];
|
|
|
|
/*
|
|
Set if this is the original connection, not a master or a slave we have
|
|
added though mysql_rpl_probe() or mysql_set_master()/ mysql_add_slave()
|
|
*/
|
|
my_bool rpl_pivot;
|
|
/*
|
|
Pointers to the master, and the next slave connections, points to
|
|
itself if lone connection.
|
|
*/
|
|
struct st_mysql* master, *next_slave;
|
|
|
|
struct st_mysql* last_used_slave; /* needed for round-robin slave pick */
|
|
/* needed for send/read/store/use result to work correctly with replication */
|
|
struct st_mysql* last_used_con;
|
|
|
|
LIST *stmts; /* list of all statements */
|
|
const struct st_mysql_methods *methods;
|
|
void *thd;
|
|
/*
|
|
Points to boolean flag in MYSQL_RES or MYSQL_STMT. We set this flag
|
|
from mysql_stmt_close if close had to cancel result set of this object.
|
|
*/
|
|
my_bool *unbuffered_fetch_owner;
|
|
} MYSQL;
|
|
|
|
typedef struct st_mysql_res {
|
|
my_ulonglong row_count;
|
|
MYSQL_FIELD *fields;
|
|
MYSQL_DATA *data;
|
|
MYSQL_ROWS *data_cursor;
|
|
unsigned long *lengths; /* column lengths of current row */
|
|
MYSQL *handle; /* for unbuffered reads */
|
|
MEM_ROOT field_alloc;
|
|
unsigned int field_count, current_field;
|
|
MYSQL_ROW row; /* If unbuffered read */
|
|
MYSQL_ROW current_row; /* buffer to current row */
|
|
my_bool eof; /* Used by mysql_fetch_row */
|
|
/* mysql_stmt_close() had to cancel this result */
|
|
my_bool unbuffered_fetch_cancelled;
|
|
const struct st_mysql_methods *methods;
|
|
} MYSQL_RES;
|
|
|
|
#define MAX_MYSQL_MANAGER_ERR 256
|
|
#define MAX_MYSQL_MANAGER_MSG 256
|
|
|
|
#define MANAGER_OK 200
|
|
#define MANAGER_INFO 250
|
|
#define MANAGER_ACCESS 401
|
|
#define MANAGER_CLIENT_ERR 450
|
|
#define MANAGER_INTERNAL_ERR 500
|
|
|
|
#if !defined(MYSQL_SERVER) && !defined(MYSQL_CLIENT)
|
|
#define MYSQL_CLIENT
|
|
#endif
|
|
|
|
|
|
|
|
typedef struct st_mysql_manager
|
|
{
|
|
NET net;
|
|
char *host,*user,*passwd;
|
|
unsigned int port;
|
|
my_bool free_me;
|
|
my_bool eof;
|
|
int cmd_status;
|
|
int last_errno;
|
|
char* net_buf,*net_buf_pos,*net_data_end;
|
|
int net_buf_size;
|
|
char last_error[MAX_MYSQL_MANAGER_ERR];
|
|
} MYSQL_MANAGER;
|
|
|
|
/*
|
|
Set up and bring down the server; to ensure that applications will
|
|
work when linked against either the standard client library or the
|
|
embedded server library, these functions should be called.
|
|
*/
|
|
int STDCALL mysql_server_init(int argc, char **argv, char **groups);
|
|
void STDCALL mysql_server_end(void);
|
|
|
|
/*
|
|
Set up and bring down a thread; these function should be called
|
|
for each thread in an application which opens at least one MySQL
|
|
connection. All uses of the connection(s) should be between these
|
|
function calls.
|
|
*/
|
|
my_bool STDCALL mysql_thread_init(void);
|
|
void STDCALL mysql_thread_end(void);
|
|
|
|
/*
|
|
Functions to get information from the MYSQL and MYSQL_RES structures
|
|
Should definitely be used if one uses shared libraries.
|
|
*/
|
|
|
|
my_ulonglong STDCALL mysql_num_rows(MYSQL_RES *res);
|
|
unsigned int STDCALL mysql_num_fields(MYSQL_RES *res);
|
|
my_bool STDCALL mysql_eof(MYSQL_RES *res);
|
|
MYSQL_FIELD *STDCALL mysql_fetch_field_direct(MYSQL_RES *res,
|
|
unsigned int fieldnr);
|
|
MYSQL_FIELD * STDCALL mysql_fetch_fields(MYSQL_RES *res);
|
|
MYSQL_ROW_OFFSET STDCALL mysql_row_tell(MYSQL_RES *res);
|
|
MYSQL_FIELD_OFFSET STDCALL mysql_field_tell(MYSQL_RES *res);
|
|
|
|
unsigned int STDCALL mysql_field_count(MYSQL *mysql);
|
|
my_ulonglong STDCALL mysql_affected_rows(MYSQL *mysql);
|
|
my_ulonglong STDCALL mysql_insert_id(MYSQL *mysql);
|
|
unsigned int STDCALL mysql_errno(MYSQL *mysql);
|
|
const char * STDCALL mysql_error(MYSQL *mysql);
|
|
const char *STDCALL mysql_sqlstate(MYSQL *mysql);
|
|
unsigned int STDCALL mysql_warning_count(MYSQL *mysql);
|
|
const char * STDCALL mysql_info(MYSQL *mysql);
|
|
unsigned long STDCALL mysql_thread_id(MYSQL *mysql);
|
|
const char * STDCALL mysql_character_set_name(MYSQL *mysql);
|
|
|
|
MYSQL * STDCALL mysql_init(MYSQL *mysql);
|
|
my_bool STDCALL mysql_ssl_set(MYSQL *mysql, const char *key,
|
|
const char *cert, const char *ca,
|
|
const char *capath, const char *cipher);
|
|
my_bool STDCALL mysql_change_user(MYSQL *mysql, const char *user,
|
|
const char *passwd, const char *db);
|
|
MYSQL * STDCALL mysql_real_connect(MYSQL *mysql, const char *host,
|
|
const char *user,
|
|
const char *passwd,
|
|
const char *db,
|
|
unsigned int port,
|
|
const char *unix_socket,
|
|
unsigned long clientflag);
|
|
int STDCALL mysql_select_db(MYSQL *mysql, const char *db);
|
|
int STDCALL mysql_query(MYSQL *mysql, const char *q);
|
|
int STDCALL mysql_send_query(MYSQL *mysql, const char *q,
|
|
unsigned long length);
|
|
int STDCALL mysql_real_query(MYSQL *mysql, const char *q,
|
|
unsigned long length);
|
|
MYSQL_RES * STDCALL mysql_store_result(MYSQL *mysql);
|
|
MYSQL_RES * STDCALL mysql_use_result(MYSQL *mysql);
|
|
|
|
/* perform query on master */
|
|
my_bool STDCALL mysql_master_query(MYSQL *mysql, const char *q,
|
|
unsigned long length);
|
|
my_bool STDCALL mysql_master_send_query(MYSQL *mysql, const char *q,
|
|
unsigned long length);
|
|
/* perform query on slave */
|
|
my_bool STDCALL mysql_slave_query(MYSQL *mysql, const char *q,
|
|
unsigned long length);
|
|
my_bool STDCALL mysql_slave_send_query(MYSQL *mysql, const char *q,
|
|
unsigned long length);
|
|
|
|
/* local infile support */
|
|
|
|
#define LOCAL_INFILE_ERROR_LEN 512
|
|
|
|
void
|
|
mysql_set_local_infile_handler(MYSQL *mysql,
|
|
int (*local_infile_init)(void **, const char *),
|
|
int (*local_infile_read)(void *, char *, uint),
|
|
void (*local_infile_end)(void *),
|
|
int (*local_infile_error)(void *, char*, uint));
|
|
|
|
void
|
|
mysql_set_local_infile_default(MYSQL *mysql);
|
|
|
|
|
|
/*
|
|
enable/disable parsing of all queries to decide if they go on master or
|
|
slave
|
|
*/
|
|
void STDCALL mysql_enable_rpl_parse(MYSQL* mysql);
|
|
void STDCALL mysql_disable_rpl_parse(MYSQL* mysql);
|
|
/* get the value of the parse flag */
|
|
int STDCALL mysql_rpl_parse_enabled(MYSQL* mysql);
|
|
|
|
/* enable/disable reads from master */
|
|
void STDCALL mysql_enable_reads_from_master(MYSQL* mysql);
|
|
void STDCALL mysql_disable_reads_from_master(MYSQL* mysql);
|
|
/* get the value of the master read flag */
|
|
my_bool STDCALL mysql_reads_from_master_enabled(MYSQL* mysql);
|
|
|
|
enum mysql_rpl_type STDCALL mysql_rpl_query_type(const char* q, int len);
|
|
|
|
/* discover the master and its slaves */
|
|
my_bool STDCALL mysql_rpl_probe(MYSQL* mysql);
|
|
|
|
/* set the master, close/free the old one, if it is not a pivot */
|
|
int STDCALL mysql_set_master(MYSQL* mysql, const char* host,
|
|
unsigned int port,
|
|
const char* user,
|
|
const char* passwd);
|
|
int STDCALL mysql_add_slave(MYSQL* mysql, const char* host,
|
|
unsigned int port,
|
|
const char* user,
|
|
const char* passwd);
|
|
|
|
int STDCALL mysql_shutdown(MYSQL *mysql);
|
|
int STDCALL mysql_dump_debug_info(MYSQL *mysql);
|
|
int STDCALL mysql_refresh(MYSQL *mysql,
|
|
unsigned int refresh_options);
|
|
int STDCALL mysql_kill(MYSQL *mysql,unsigned long pid);
|
|
int STDCALL mysql_set_server_option(MYSQL *mysql,
|
|
enum enum_mysql_set_option
|
|
option);
|
|
int STDCALL mysql_ping(MYSQL *mysql);
|
|
const char * STDCALL mysql_stat(MYSQL *mysql);
|
|
const char * STDCALL mysql_get_server_info(MYSQL *mysql);
|
|
const char * STDCALL mysql_get_client_info(void);
|
|
unsigned long STDCALL mysql_get_client_version(void);
|
|
const char * STDCALL mysql_get_host_info(MYSQL *mysql);
|
|
unsigned long STDCALL mysql_get_server_version(MYSQL *mysql);
|
|
unsigned int STDCALL mysql_get_proto_info(MYSQL *mysql);
|
|
MYSQL_RES * STDCALL mysql_list_dbs(MYSQL *mysql,const char *wild);
|
|
MYSQL_RES * STDCALL mysql_list_tables(MYSQL *mysql,const char *wild);
|
|
MYSQL_RES * STDCALL mysql_list_processes(MYSQL *mysql);
|
|
int STDCALL mysql_options(MYSQL *mysql,enum mysql_option option,
|
|
const char *arg);
|
|
void STDCALL mysql_free_result(MYSQL_RES *result);
|
|
void STDCALL mysql_data_seek(MYSQL_RES *result,
|
|
my_ulonglong offset);
|
|
MYSQL_ROW_OFFSET STDCALL mysql_row_seek(MYSQL_RES *result,
|
|
MYSQL_ROW_OFFSET offset);
|
|
MYSQL_FIELD_OFFSET STDCALL mysql_field_seek(MYSQL_RES *result,
|
|
MYSQL_FIELD_OFFSET offset);
|
|
MYSQL_ROW STDCALL mysql_fetch_row(MYSQL_RES *result);
|
|
unsigned long * STDCALL mysql_fetch_lengths(MYSQL_RES *result);
|
|
MYSQL_FIELD * STDCALL mysql_fetch_field(MYSQL_RES *result);
|
|
MYSQL_RES * STDCALL mysql_list_fields(MYSQL *mysql, const char *table,
|
|
const char *wild);
|
|
unsigned long STDCALL mysql_escape_string(char *to,const char *from,
|
|
unsigned long from_length);
|
|
unsigned long STDCALL mysql_real_escape_string(MYSQL *mysql,
|
|
char *to,const char *from,
|
|
unsigned long length);
|
|
void STDCALL mysql_debug(const char *debug);
|
|
char * STDCALL mysql_odbc_escape_string(MYSQL *mysql,
|
|
char *to,
|
|
unsigned long to_length,
|
|
const char *from,
|
|
unsigned long from_length,
|
|
void *param,
|
|
char *
|
|
(*extend_buffer)
|
|
(void *, char *to,
|
|
unsigned long *length));
|
|
void STDCALL myodbc_remove_escape(MYSQL *mysql,char *name);
|
|
unsigned int STDCALL mysql_thread_safe(void);
|
|
MYSQL_MANAGER* STDCALL mysql_manager_init(MYSQL_MANAGER* con);
|
|
MYSQL_MANAGER* STDCALL mysql_manager_connect(MYSQL_MANAGER* con,
|
|
const char* host,
|
|
const char* user,
|
|
const char* passwd,
|
|
unsigned int port);
|
|
void STDCALL mysql_manager_close(MYSQL_MANAGER* con);
|
|
int STDCALL mysql_manager_command(MYSQL_MANAGER* con,
|
|
const char* cmd, int cmd_len);
|
|
int STDCALL mysql_manager_fetch_line(MYSQL_MANAGER* con,
|
|
char* res_buf,
|
|
int res_buf_size);
|
|
my_bool STDCALL mysql_read_query_result(MYSQL *mysql);
|
|
|
|
|
|
/*
|
|
The following definitions are added for the enhanced
|
|
client-server protocol
|
|
*/
|
|
|
|
/* statement state */
|
|
enum enum_mysql_stmt_state
|
|
{
|
|
MYSQL_STMT_INIT_DONE= 1, MYSQL_STMT_PREPARE_DONE, MYSQL_STMT_EXECUTE_DONE,
|
|
MYSQL_STMT_FETCH_DONE
|
|
};
|
|
|
|
/*
|
|
client TIME structure to handle TIME, DATE and TIMESTAMP directly in
|
|
binary protocol
|
|
*/
|
|
enum mysql_st_timestamp_type { MYSQL_TIMESTAMP_NONE, MYSQL_TIMESTAMP_DATE,
|
|
MYSQL_TIMESTAMP_FULL, MYSQL_TIMESTAMP_TIME };
|
|
|
|
typedef struct mysql_st_time
|
|
{
|
|
unsigned int year,month,day,hour,minute,second;
|
|
unsigned long second_part;
|
|
my_bool neg;
|
|
|
|
enum mysql_st_timestamp_type time_type;
|
|
|
|
} MYSQL_TIME;
|
|
|
|
|
|
/* bind structure */
|
|
typedef struct st_mysql_bind
|
|
{
|
|
unsigned long *length; /* output length pointer */
|
|
my_bool *is_null; /* Pointer to null indicators */
|
|
char *buffer; /* buffer to get/put data */
|
|
enum enum_field_types buffer_type; /* buffer type */
|
|
unsigned long buffer_length; /* buffer length, must be set for str/binary */
|
|
|
|
/* Following are for internal use. Set by mysql_bind_param */
|
|
unsigned char *inter_buffer; /* for the current data position */
|
|
unsigned long offset; /* offset position for char/binary fetch */
|
|
unsigned long internal_length; /* Used if length is 0 */
|
|
unsigned int param_number; /* For null count and error messages */
|
|
my_bool long_data_used; /* If used with mysql_send_long_data */
|
|
my_bool binary_data; /* data buffer is binary */
|
|
my_bool null_field; /* NULL data cache flag */
|
|
my_bool internal_is_null; /* Used if is_null is 0 */
|
|
void (*store_param_func)(NET *net, struct st_mysql_bind *param);
|
|
void (*fetch_result)(struct st_mysql_bind *, unsigned char **row);
|
|
} MYSQL_BIND;
|
|
|
|
|
|
/* statement handler */
|
|
typedef struct st_mysql_stmt
|
|
{
|
|
MEM_ROOT mem_root; /* root allocations */
|
|
LIST list; /* list to keep track of all stmts */
|
|
MYSQL *mysql; /* connection handle */
|
|
MYSQL_BIND *params; /* input parameters */
|
|
MYSQL_BIND *bind; /* output parameters */
|
|
MYSQL_FIELD *fields; /* result set metadata */
|
|
MYSQL_RES *result; /* cached result set */
|
|
/* copy of mysql->affected_rows after statement execution */
|
|
my_ulonglong affected_rows;
|
|
/*
|
|
mysql_stmt_fetch() calls this function to fetch one row (it's different
|
|
for buffered, unbuffered and cursor fetch).
|
|
*/
|
|
int (*read_row_func)(struct st_mysql_stmt *stmt,
|
|
unsigned char **row);
|
|
unsigned long stmt_id; /* Id for prepared statement */
|
|
unsigned int last_errno; /* error code */
|
|
unsigned int param_count; /* inpute parameters count */
|
|
unsigned int field_count; /* number of columns in result set */
|
|
enum enum_mysql_stmt_state state; /* statement state */
|
|
char last_error[MYSQL_ERRMSG_SIZE]; /* error message */
|
|
char sqlstate[SQLSTATE_LENGTH+1];
|
|
/* Types of input parameters should be sent to server */
|
|
my_bool send_types_to_server;
|
|
my_bool bind_param_done; /* input buffers were supplied */
|
|
my_bool bind_result_done; /* output buffers were supplied */
|
|
/* mysql_stmt_close() had to cancel this result */
|
|
my_bool unbuffered_fetch_cancelled;
|
|
} MYSQL_STMT;
|
|
|
|
|
|
typedef struct st_mysql_methods
|
|
{
|
|
my_bool (*read_query_result)(MYSQL *mysql);
|
|
my_bool (*advanced_command)(MYSQL *mysql,
|
|
enum enum_server_command command,
|
|
const char *header,
|
|
unsigned long header_length,
|
|
const char *arg,
|
|
unsigned long arg_length,
|
|
my_bool skip_check);
|
|
MYSQL_DATA *(*read_rows)(MYSQL *mysql,MYSQL_FIELD *mysql_fields,
|
|
unsigned int fields);
|
|
MYSQL_RES * (*use_result)(MYSQL *mysql);
|
|
void (*fetch_lengths)(unsigned long *to,
|
|
MYSQL_ROW column, unsigned int field_count);
|
|
#if !defined(MYSQL_SERVER) || defined(EMBEDDED_LIBRARY)
|
|
MYSQL_FIELD * (*list_fields)(MYSQL *mysql);
|
|
my_bool (*read_prepare_result)(MYSQL *mysql, MYSQL_STMT *stmt);
|
|
int (*stmt_execute)(MYSQL_STMT *stmt);
|
|
MYSQL_DATA *(*read_binary_rows)(MYSQL_STMT *stmt);
|
|
int (*unbuffered_fetch)(MYSQL *mysql, char **row);
|
|
void (*free_embedded_thd)(MYSQL *mysql);
|
|
const char *(*read_statistics)(MYSQL *mysql);
|
|
my_bool (*next_result)(MYSQL *mysql);
|
|
int (*read_change_user_result)(MYSQL *mysql, char *buff, const char *passwd);
|
|
#endif
|
|
} MYSQL_METHODS;
|
|
|
|
#ifdef HAVE_DEPRECATED_411_API
|
|
/* Deprecated calls (since MySQL 4.1.2) */
|
|
|
|
/* Use mysql_stmt_init + mysql_stmt_prepare instead */
|
|
MYSQL_STMT * STDCALL mysql_prepare(MYSQL * mysql, const char *query,
|
|
unsigned long length);
|
|
#define mysql_execute mysql_stmt_execute
|
|
#define mysql_fetch mysql_stmt_fetch
|
|
#define mysql_fetch_column mysql_stmt_fetch_column
|
|
#define mysql_bind_param mysql_stmt_bind_param
|
|
#define mysql_bind_result mysql_stmt_bind_result
|
|
#define mysql_param_count mysql_stmt_param_count
|
|
#define mysql_param_result mysql_stmt_param_metadata
|
|
#define mysql_get_metadata mysql_stmt_result_metadata
|
|
#define mysql_send_long_data mysql_stmt_send_long_data
|
|
|
|
#endif /* HAVE_DEPRECATED_411_API */
|
|
|
|
MYSQL_STMT * STDCALL mysql_stmt_init(MYSQL *mysql);
|
|
int STDCALL mysql_stmt_prepare(MYSQL_STMT *stmt, const char *query,
|
|
unsigned long length);
|
|
int STDCALL mysql_stmt_execute(MYSQL_STMT *stmt);
|
|
int STDCALL mysql_stmt_fetch(MYSQL_STMT *stmt);
|
|
int STDCALL mysql_stmt_fetch_column(MYSQL_STMT *stmt, MYSQL_BIND *bind,
|
|
unsigned int column,
|
|
unsigned long offset);
|
|
int STDCALL mysql_stmt_store_result(MYSQL_STMT *stmt);
|
|
unsigned long STDCALL mysql_stmt_param_count(MYSQL_STMT * stmt);
|
|
my_bool STDCALL mysql_stmt_bind_param(MYSQL_STMT * stmt, MYSQL_BIND * bnd);
|
|
my_bool STDCALL mysql_stmt_bind_result(MYSQL_STMT * stmt, MYSQL_BIND * bnd);
|
|
my_bool STDCALL mysql_stmt_close(MYSQL_STMT * stmt);
|
|
my_bool STDCALL mysql_stmt_reset(MYSQL_STMT * stmt);
|
|
my_bool STDCALL mysql_stmt_free_result(MYSQL_STMT *stmt);
|
|
my_bool STDCALL mysql_stmt_send_long_data(MYSQL_STMT *stmt,
|
|
unsigned int param_number,
|
|
const char *data,
|
|
unsigned long length);
|
|
MYSQL_RES *STDCALL mysql_stmt_result_metadata(MYSQL_STMT *stmt);
|
|
MYSQL_RES *STDCALL mysql_stmt_param_metadata(MYSQL_STMT *stmt);
|
|
unsigned int STDCALL mysql_stmt_errno(MYSQL_STMT * stmt);
|
|
const char *STDCALL mysql_stmt_error(MYSQL_STMT * stmt);
|
|
const char *STDCALL mysql_stmt_sqlstate(MYSQL_STMT * stmt);
|
|
MYSQL_ROW_OFFSET STDCALL mysql_stmt_row_seek(MYSQL_STMT *stmt,
|
|
MYSQL_ROW_OFFSET offset);
|
|
MYSQL_ROW_OFFSET STDCALL mysql_stmt_row_tell(MYSQL_STMT *stmt);
|
|
void STDCALL mysql_stmt_data_seek(MYSQL_STMT *stmt, my_ulonglong offset);
|
|
my_ulonglong STDCALL mysql_stmt_num_rows(MYSQL_STMT *stmt);
|
|
my_ulonglong STDCALL mysql_stmt_affected_rows(MYSQL_STMT *stmt);
|
|
|
|
my_bool STDCALL mysql_commit(MYSQL * mysql);
|
|
my_bool STDCALL mysql_rollback(MYSQL * mysql);
|
|
my_bool STDCALL mysql_autocommit(MYSQL * mysql, my_bool auto_mode);
|
|
my_bool STDCALL mysql_more_results(MYSQL *mysql);
|
|
int STDCALL mysql_next_result(MYSQL *mysql);
|
|
void STDCALL mysql_close(MYSQL *sock);
|
|
|
|
|
|
/* status return codes */
|
|
#define MYSQL_NO_DATA 100
|
|
|
|
#define mysql_reload(mysql) mysql_refresh((mysql),REFRESH_GRANT)
|
|
|
|
#ifdef USE_OLD_FUNCTIONS
|
|
MYSQL * STDCALL mysql_connect(MYSQL *mysql, const char *host,
|
|
const char *user, const char *passwd);
|
|
int STDCALL mysql_create_db(MYSQL *mysql, const char *DB);
|
|
int STDCALL mysql_drop_db(MYSQL *mysql, const char *DB);
|
|
#define mysql_reload(mysql) mysql_refresh((mysql),REFRESH_GRANT)
|
|
#endif
|
|
#define HAVE_MYSQL_REAL_CONNECT
|
|
|
|
/*
|
|
The following functions are mainly exported because of mysqlbinlog;
|
|
They are not for general usage
|
|
*/
|
|
|
|
#define simple_command(mysql, command, arg, length, skip_check) \
|
|
(*(mysql)->methods->advanced_command)(mysql, command, \
|
|
NullS, 0, arg, length, skip_check)
|
|
unsigned long net_safe_read(MYSQL* mysql);
|
|
|
|
#ifdef __NETWARE__
|
|
#pragma pack(pop) /* restore alignment */
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* _mysql_h */
|