xref: /PHP-8.0/ext/mysqlnd/mysqlnd_enum_n_def.h (revision 5d6e923d)
1 /*
2   +----------------------------------------------------------------------+
3   | Copyright (c) The PHP Group                                          |
4   +----------------------------------------------------------------------+
5   | This source file is subject to version 3.01 of the PHP license,      |
6   | that is bundled with this package in the file LICENSE, and is        |
7   | available through the world-wide-web at the following url:           |
8   | http://www.php.net/license/3_01.txt                                  |
9   | If you did not receive a copy of the PHP license and are unable to   |
10   | obtain it through the world-wide-web, please send a note to          |
11   | license@php.net so we can mail you a copy immediately.               |
12   +----------------------------------------------------------------------+
13   | Authors: Andrey Hristov <andrey@php.net>                             |
14   |          Ulf Wendel <uw@php.net>                                     |
15   |          Georg Richter <georg@php.net>                               |
16   +----------------------------------------------------------------------+
17 */
18 
19 #ifndef MYSQLND_ENUM_N_DEF_H
20 #define MYSQLND_ENUM_N_DEF_H
21 
22 #ifndef TRUE
23 #define TRUE 1
24 #endif
25 
26 #ifndef FALSE
27 #define FALSE 0
28 #endif
29 
30 
31 #define MYSQLND_MIN_COMPRESS_LEN 0
32 
33 #define MYSQLND_MAX_PACKET_SIZE (256L*256L*256L-1)
34 
35 #define MYSQLND_ASSEMBLED_PACKET_MAX_SIZE 3UL*1024UL*1024UL*1024UL
36 
37 #define MYSQLND_DEFAULT_AUTH_PROTOCOL "mysql_native_password"
38 
39 #define MYSQLND_ERRMSG_SIZE			512
40 #define MYSQLND_SQLSTATE_LENGTH		5
41 #define MYSQLND_SQLSTATE_NULL		"00000"
42 
43 #define MYSQLND_MAX_ALLOWED_USER_LEN	252		/* 63 char * 4byte . MySQL supports now only 16 char, but let it be forward compatible */
44 #define MYSQLND_MAX_ALLOWED_DB_LEN		1024	/* 256 char * 4byte. MySQL supports now only 64 char in the tables, but on the FS could be different. Forward compatible. */
45 
46 #define MYSQLND_NET_CMD_BUFFER_MIN_SIZE			4096
47 #define MYSQLND_NET_CMD_BUFFER_MIN_SIZE_STR		"4096"
48 
49 #define MYSQLND_STMT_ID_LENGTH 4
50 
51 
52 #define SERVER_STATUS_IN_TRANS					1	/* Transaction has started */
53 #define SERVER_STATUS_AUTOCOMMIT				2	/* Server in auto_commit mode */
54 #define SERVER_MORE_RESULTS_EXISTS				8	/* Multi query - next query exists */
55 #define SERVER_QUERY_NO_GOOD_INDEX_USED	16
56 #define SERVER_QUERY_NO_INDEX_USED		32
57 /*
58   The server was able to fulfill the clients request and opened a
59   read-only non-scrollable cursor for a query. This flag comes
60   in reply to COM_STMT_EXECUTE and COM_STMT_FETCH commands.
61 */
62 #define SERVER_STATUS_CURSOR_EXISTS				64
63 /*
64   This flag is sent when a read-only cursor is exhausted, in reply to
65   COM_STMT_FETCH command.
66 */
67 #define SERVER_STATUS_LAST_ROW_SENT				128
68 #define SERVER_STATUS_DB_DROPPED				256 /* A database was dropped */
69 #define SERVER_STATUS_NO_BACKSLASH_ESCAPES		512
70 #define SERVER_QUERY_WAS_SLOW					2048
71 #define SERVER_PS_OUT_PARAMS            		4096
72 
73 #define MYSQLND_NO_DATA			100
74 #define MYSQLND_DATA_TRUNCATED	101
75 
76 #define SHA1_MAX_LENGTH 20
77 #define SCRAMBLE_LENGTH 20
78 #define SCRAMBLE_LENGTH_323 8
79 
80 #define CLIENT_LONG_PASSWORD		1		/* new more secure passwords */
81 #define CLIENT_FOUND_ROWS			2		/* Found instead of affected rows */
82 #define CLIENT_LONG_FLAG			4		/* Get all column flags */
83 #define CLIENT_CONNECT_WITH_DB		8		/* One can specify db on connect */
84 #define CLIENT_NO_SCHEMA			16		/* Don't allow database.table.column */
85 #define CLIENT_COMPRESS				32		/* Can use compression protocol */
86 #define CLIENT_ODBC					64		/* Odbc client */
87 #define CLIENT_LOCAL_FILES			128		/* Can use LOAD DATA LOCAL */
88 #define CLIENT_IGNORE_SPACE			256		/* Ignore spaces before '(' */
89 #define CLIENT_PROTOCOL_41			512		/* New 4.1 protocol */
90 #define CLIENT_INTERACTIVE			1024	/* This is an interactive client */
91 #define CLIENT_SSL					2048	/* Switch to SSL after handshake */
92 #define CLIENT_IGNORE_SIGPIPE		4096	/* IGNORE sigpipes */
93 #define CLIENT_TRANSACTIONS			8192	/* Client knows about transactions */
94 #define CLIENT_RESERVED				16384	/* Old flag for 4.1 protocol */
95 #define CLIENT_SECURE_CONNECTION	32768	/* New 4.1 authentication */
96 #define CLIENT_MULTI_STATEMENTS		(1UL << 16) /* Enable/disable multi-stmt support */
97 #define CLIENT_MULTI_RESULTS		(1UL << 17) /* Enable/disable multi-results */
98 #define CLIENT_PS_MULTI_RESULTS		(1UL << 18) /* Multi-results in PS-protocol */
99 #define CLIENT_PLUGIN_AUTH			(1UL << 19) /* Client supports plugin authentication */
100 #define CLIENT_CONNECT_ATTRS		(1UL << 20) /* Client supports connection attributes */
101 #define CLIENT_PLUGIN_AUTH_LENENC_CLIENT_DATA	(1UL << 21) /* Enable authentication response packet to be larger than 255 bytes. */
102 #define CLIENT_CAN_HANDLE_EXPIRED_PASSWORDS		(1UL << 22) /* Don't close the connection for a connection with expired password. */
103 #define CLIENT_SESSION_TRACK					(1UL << 23) /* Extended OK */
104 /*
105   This is a mysqlnd extension. CLIENT_ODBC is not used anyway. We will reuse it for our case and translate it to not using SSL peer verification
106 */
107 #define CLIENT_SSL_DONT_VERIFY_SERVER_CERT	CLIENT_ODBC
108 #define CLIENT_SSL_VERIFY_SERVER_CERT	(1UL << 30)
109 #define CLIENT_REMEMBER_OPTIONS			(1UL << 31)
110 
111 #define MYSQLND_CAPABILITIES (CLIENT_LONG_PASSWORD | CLIENT_LONG_FLAG | CLIENT_TRANSACTIONS | \
112 				CLIENT_PROTOCOL_41 | CLIENT_SECURE_CONNECTION | \
113 				CLIENT_MULTI_RESULTS  | CLIENT_LOCAL_FILES | CLIENT_PLUGIN_AUTH)
114 
115 #define MYSQLND_PROTOCOL_FLAG_USE_COMPRESSION 1
116 
117 
118 /* Client Error codes */
119 #define CR_UNKNOWN_ERROR		2000
120 #define CR_CONNECTION_ERROR		2002
121 #define CR_SERVER_GONE_ERROR	2006
122 #define CR_OUT_OF_MEMORY		2008
123 #define CR_SERVER_LOST			2013
124 #define CR_COMMANDS_OUT_OF_SYNC	2014
125 #define CR_CANT_FIND_CHARSET	2019
126 #define CR_MALFORMED_PACKET		2027
127 #define CR_NOT_IMPLEMENTED		2054
128 #define CR_NO_PREPARE_STMT		2030
129 #define CR_PARAMS_NOT_BOUND		2031
130 #define CR_INVALID_PARAMETER_NO	2034
131 #define CR_INVALID_BUFFER_USE	2035
132 
133 #define MYSQLND_EE_FILENOTFOUND	 7890
134 
135 #define UNKNOWN_SQLSTATE		"HY000"
136 
137 #define MAX_CHARSET_LEN			32
138 
139 
140 #define TRANS_START_NO_OPT						0
141 #define TRANS_START_WITH_CONSISTENT_SNAPSHOT	1
142 #define TRANS_START_READ_WRITE					2
143 #define TRANS_START_READ_ONLY					4
144 
145 #define TRANS_COR_NO_OPT		0
146 #define TRANS_COR_AND_CHAIN		1
147 #define TRANS_COR_AND_NO_CHAIN	2
148 #define TRANS_COR_RELEASE		4
149 #define TRANS_COR_NO_RELEASE	8
150 
151 typedef enum mysqlnd_extension
152 {
153 	MYSQLND_MYSQL = 0,
154 	MYSQLND_MYSQLI
155 } enum_mysqlnd_extension;
156 
157 enum
158 {
159 	MYSQLND_FETCH_ASSOC = 1,
160 	MYSQLND_FETCH_NUM = 2,
161 	MYSQLND_FETCH_BOTH = 1|2
162 };
163 
164 /* Follow libmysql convention */
165 typedef enum func_status
166 {
167 	PASS = 0,
168 	FAIL = 1
169 } enum_func_status;
170 
171 typedef enum mysqlnd_query_type
172 {
173 	QUERY_UPSERT,
174 	QUERY_SELECT,
175 	QUERY_LOAD_LOCAL
176 } enum_mysqlnd_query_type;
177 
178 typedef enum mysqlnd_res_type
179 {
180 	MYSQLND_RES_NORMAL = 1,
181 	MYSQLND_RES_PS_BUF,
182 	MYSQLND_RES_PS_UNBUF
183 } enum_mysqlnd_res_type;
184 
185 typedef enum mysqlnd_send_query_type
186 {
187 	MYSQLND_SEND_QUERY_IMPLICIT = 0,
188 	MYSQLND_SEND_QUERY_EXPLICIT
189 } enum_mysqlnd_send_query_type;
190 
191 typedef enum mysqlnd_reap_result_type
192 {
193 	MYSQLND_REAP_RESULT_IMPLICIT = 0,
194 	MYSQLND_REAP_RESULT_EXPLICIT
195 } enum_mysqlnd_reap_result_type;
196 
197 typedef enum mysqlnd_send_execute_type
198 {
199 	MYSQLND_SEND_EXECUTE_IMPLICIT = 0,
200 	MYSQLND_SEND_EXECUTE_EXPLICIT
201 } enum_mysqlnd_send_execute_type;
202 
203 typedef enum mysqlnd_parse_exec_response_type
204 {
205 	MYSQLND_PARSE_EXEC_RESPONSE_IMPLICIT = 0,
206 	MYSQLND_PARSE_EXEC_RESPONSE_IMPLICIT_NEXT_RESULT,
207 	MYSQLND_PARSE_EXEC_RESPONSE_IMPLICIT_OUT_VARIABLES,
208 	MYSQLND_PARSE_EXEC_RESPONSE_EXPLICIT,
209 } enum_mysqlnd_parse_exec_response_type;
210 
211 typedef enum mysqlnd_client_option
212 {
213 	MYSQL_OPT_CONNECT_TIMEOUT,
214 	MYSQL_OPT_COMPRESS,
215 	MYSQL_OPT_NAMED_PIPE,
216 	MYSQL_INIT_COMMAND,
217 	MYSQL_READ_DEFAULT_FILE,
218 	MYSQL_READ_DEFAULT_GROUP,
219 	MYSQL_SET_CHARSET_DIR,
220 	MYSQL_SET_CHARSET_NAME,
221 	MYSQL_OPT_LOCAL_INFILE,
222 	MYSQL_OPT_PROTOCOL,
223 	MYSQL_SHARED_MEMORY_BASE_NAME,
224 	MYSQL_OPT_READ_TIMEOUT,
225 	MYSQL_OPT_WRITE_TIMEOUT,
226 	MYSQL_OPT_USE_RESULT,
227 	MYSQL_OPT_USE_REMOTE_CONNECTION,
228 	MYSQL_OPT_USE_EMBEDDED_CONNECTION,
229 	MYSQL_OPT_GUESS_CONNECTION,
230 	MYSQL_SET_CLIENT_IP,
231 	MYSQL_SECURE_AUTH,
232 	MYSQL_REPORT_DATA_TRUNCATION,
233 	MYSQL_OPT_RECONNECT,
234 	MYSQL_OPT_SSL_VERIFY_SERVER_CERT,
235 	MYSQL_PLUGIN_DIR,
236 	MYSQL_DEFAULT_AUTH,
237 	MYSQL_OPT_BIND,
238 	MYSQL_OPT_SSL_KEY,
239 	MYSQL_OPT_SSL_CERT,
240 	MYSQL_OPT_SSL_CA,
241 	MYSQL_OPT_SSL_CAPATH,
242 	MYSQL_OPT_SSL_CIPHER,
243 	MYSQL_OPT_SSL_CRL,
244 	MYSQL_OPT_SSL_CRLPATH,
245 	MYSQL_OPT_CONNECT_ATTR_RESET,
246 	MYSQL_OPT_CONNECT_ATTR_ADD,
247 	MYSQL_OPT_CONNECT_ATTR_DELETE,
248 	MYSQL_SERVER_PUBLIC_KEY,
249 	MYSQL_ENABLE_CLEARTEXT_PLUGIN,
250 	MYSQL_OPT_CAN_HANDLE_EXPIRED_PASSWORDS,
251 	MYSQL_OPT_SSL_ENFORCE,
252 	MYSQL_OPT_MAX_ALLOWED_PACKET,
253 	MYSQL_OPT_NET_BUFFER_LENGTH,
254 	MYSQL_OPT_TLS_VERSION,
255 	MYSQL_OPT_SSL_MODE,
256 	MYSQLND_DEPRECATED_ENUM1 = 200,
257 #ifdef MYSQLND_STRING_TO_INT_CONVERSION
258 	MYSQLND_OPT_INT_AND_FLOAT_NATIVE = 201,
259 #endif
260 	MYSQLND_OPT_NET_CMD_BUFFER_SIZE = 202,
261 	MYSQLND_OPT_NET_READ_BUFFER_SIZE = 203,
262 	MYSQLND_OPT_SSL_KEY = 204,
263 	MYSQLND_OPT_SSL_CERT = 205,
264 	MYSQLND_OPT_SSL_CA = 206,
265 	MYSQLND_OPT_SSL_CAPATH = 207,
266 	MYSQLND_OPT_SSL_CIPHER = 208,
267 	MYSQLND_OPT_SSL_PASSPHRASE = 209,
268 	MYSQLND_OPT_MAX_ALLOWED_PACKET = 210,
269 	MYSQLND_OPT_AUTH_PROTOCOL = 211
270 } enum_mysqlnd_client_option;
271 
272 typedef enum mysqlnd_session_protocol_type
273 {
274 	MYSQL_PROTOCOL_DEFAULT = 0,
275 	MYSQL_PROTOCOL_TCP,		/* all, supported */
276 	MYSQL_PROTOCOL_SOCKET,	/* unix, supported */
277 	MYSQL_PROTOCOL_PIPE,	/* win32, not-supported */
278 	MYSQL_PROTOCOL_MEMORY,	/* win32, not-supported */
279 	MYSQL_PROTOCOL_LAST
280 } enum_mysqlnd_session_protocol_type;
281 
282 typedef enum mysqlnd_field_types
283 {
284 	MYSQL_TYPE_DECIMAL	= 0,
285 	MYSQL_TYPE_TINY		= 1,
286 	MYSQL_TYPE_SHORT	= 2,
287 	MYSQL_TYPE_LONG		= 3,
288 	MYSQL_TYPE_FLOAT	= 4,
289 	MYSQL_TYPE_DOUBLE	= 5,
290 	MYSQL_TYPE_NULL		= 6,
291 	MYSQL_TYPE_TIMESTAMP= 7,
292 	MYSQL_TYPE_LONGLONG	= 8,
293 	MYSQL_TYPE_INT24	= 9,
294 	MYSQL_TYPE_DATE		= 10,
295 	MYSQL_TYPE_TIME		= 11,
296 	MYSQL_TYPE_DATETIME	= 12,
297 	MYSQL_TYPE_YEAR		= 13,
298 	MYSQL_TYPE_NEWDATE	= 14,
299 	MYSQL_TYPE_VARCHAR	= 15,
300 	MYSQL_TYPE_BIT		= 16,
301 	MYSQL_TYPE_JSON=245,
302 	MYSQL_TYPE_NEWDECIMAL=246,
303 	MYSQL_TYPE_ENUM=247,
304 	MYSQL_TYPE_SET=248,
305 	MYSQL_TYPE_TINY_BLOB=249,
306 	MYSQL_TYPE_MEDIUM_BLOB=250,
307 	MYSQL_TYPE_LONG_BLOB=251,
308 	MYSQL_TYPE_BLOB=252,
309 	MYSQL_TYPE_VAR_STRING=253,
310 	MYSQL_TYPE_STRING=254,
311 	MYSQL_TYPE_GEOMETRY=255
312 } enum_mysqlnd_field_types;
313 
314 /* Please update this if there is a new type after MYSQL_TYPE_GEOMETRY */
315 #define MYSQL_TYPE_LAST		MYSQL_TYPE_GEOMETRY
316 
317 
318 typedef enum mysqlnd_server_option
319 {
320 	MYSQL_OPTION_MULTI_STATEMENTS_ON,
321 	MYSQL_OPTION_MULTI_STATEMENTS_OFF
322 } enum_mysqlnd_server_option;
323 
324 
325 #define FIELD_TYPE_DECIMAL		MYSQL_TYPE_DECIMAL
326 #define FIELD_TYPE_NEWDECIMAL	MYSQL_TYPE_NEWDECIMAL
327 #define FIELD_TYPE_TINY			MYSQL_TYPE_TINY
328 #define FIELD_TYPE_SHORT		MYSQL_TYPE_SHORT
329 #define FIELD_TYPE_LONG			MYSQL_TYPE_LONG
330 #define FIELD_TYPE_FLOAT		MYSQL_TYPE_FLOAT
331 #define FIELD_TYPE_DOUBLE		MYSQL_TYPE_DOUBLE
332 #define FIELD_TYPE_NULL			MYSQL_TYPE_NULL
333 #define FIELD_TYPE_TIMESTAMP	MYSQL_TYPE_TIMESTAMP
334 #define FIELD_TYPE_LONGLONG		MYSQL_TYPE_LONGLONG
335 #define FIELD_TYPE_INT24		MYSQL_TYPE_INT24
336 #define FIELD_TYPE_DATE			MYSQL_TYPE_DATE
337 #define FIELD_TYPE_TIME			MYSQL_TYPE_TIME
338 #define FIELD_TYPE_DATETIME		MYSQL_TYPE_DATETIME
339 #define FIELD_TYPE_YEAR			MYSQL_TYPE_YEAR
340 #define FIELD_TYPE_NEWDATE		MYSQL_TYPE_NEWDATE
341 #define FIELD_TYPE_ENUM			MYSQL_TYPE_ENUM
342 #define FIELD_TYPE_SET			MYSQL_TYPE_SET
343 #define FIELD_TYPE_JSON 		MYSQL_TYPE_JSON
344 #define FIELD_TYPE_TINY_BLOB	MYSQL_TYPE_TINY_BLOB
345 #define FIELD_TYPE_MEDIUM_BLOB	MYSQL_TYPE_MEDIUM_BLOB
346 #define FIELD_TYPE_LONG_BLOB	MYSQL_TYPE_LONG_BLOB
347 #define FIELD_TYPE_BLOB			MYSQL_TYPE_BLOB
348 #define FIELD_TYPE_VAR_STRING	MYSQL_TYPE_VAR_STRING
349 #define FIELD_TYPE_STRING		MYSQL_TYPE_STRING
350 #define FIELD_TYPE_CHAR			MYSQL_TYPE_TINY
351 #define FIELD_TYPE_INTERVAL		MYSQL_TYPE_ENUM
352 #define FIELD_TYPE_GEOMETRY		MYSQL_TYPE_GEOMETRY
353 #define FIELD_TYPE_BIT			MYSQL_TYPE_BIT
354 
355 #define NOT_NULL_FLAG			    1
356 #define PRI_KEY_FLAG			    2
357 #define UNIQUE_KEY_FLAG			    4
358 #define MULTIPLE_KEY_FLAG		    8
359 #define BLOB_FLAG				   16
360 #define UNSIGNED_FLAG			   32
361 #define ZEROFILL_FLAG			   64
362 #define BINARY_FLAG				  128
363 #define ENUM_FLAG				  256
364 #define AUTO_INCREMENT_FLAG		  512
365 #define TIMESTAMP_FLAG			 1024
366 #define SET_FLAG				 2048
367 #define NO_DEFAULT_VALUE_FLAG	 4096
368 #define ON_UPDATE_NOW_FLAG		 8192
369 #define PART_KEY_FLAG			16384
370 #define GROUP_FLAG				32768
371 #define NUM_FLAG				32768
372 
373 #define IS_PRI_KEY(n)	((n) & PRI_KEY_FLAG)
374 #define IS_NOT_NULL(n)	((n) & NOT_NULL_FLAG)
375 #define IS_BLOB(n)		((n) & BLOB_FLAG)
376 #define IS_NUM(t)		((t) <= FIELD_TYPE_INT24 || (t) == FIELD_TYPE_YEAR || (t) == FIELD_TYPE_NEWDECIMAL)
377 
378 
379 /* see mysqlnd_charset.c for more information */
380 #define MYSQLND_BINARY_CHARSET_NR	63
381 
382 
383 /*
384 		/-----> CONN_CLOSE  <---------------\
385 		|           ^                         \
386 		|           |                         \
387 	CONN_READY -> CONN_QUERY_SENT -> CONN_FETCHING_DATA
388 		^                                      |
389 		\-------------------------------------/
390 */
391 typedef enum mysqlnd_connection_state
392 {
393 	CONN_ALLOCED = 0,
394 	CONN_READY = 1,
395 	CONN_QUERY_SENT = 2,
396 	CONN_SENDING_LOAD_DATA = 3,
397 	CONN_FETCHING_DATA = 4,
398 	CONN_NEXT_RESULT_PENDING = 5,
399 	CONN_QUIT_SENT = 6 /* object is "destroyed" at this stage */
400 } enum_mysqlnd_connection_state;
401 
402 
403 typedef enum mysqlnd_stmt_state
404 {
405 	MYSQLND_STMT_INITTED = 0,
406 	MYSQLND_STMT_PREPARED = 1,
407 	MYSQLND_STMT_EXECUTED = 2,
408 	MYSQLND_STMT_WAITING_USE_OR_STORE = 3,
409 	MYSQLND_STMT_USE_OR_STORE_CALLED = 4,
410 	MYSQLND_STMT_USER_FETCHING = 5/* fetch_row_buff or fetch_row_unbuf */
411 } enum_mysqlnd_stmt_state;
412 
413 
414 typedef enum param_bind_flags
415 {
416 	MYSQLND_PARAM_BIND_BLOB_USED = 1
417 } enum_param_bind_flags;
418 
419 
420 /* PS */
421 enum mysqlnd_stmt_attr
422 {
423 	STMT_ATTR_UPDATE_MAX_LENGTH,
424 	STMT_ATTR_CURSOR_TYPE,
425 	STMT_ATTR_PREFETCH_ROWS
426 };
427 
428 enum myslqnd_cursor_type
429 {
430 	CURSOR_TYPE_NO_CURSOR= 0,
431 	CURSOR_TYPE_READ_ONLY= 1,
432 	CURSOR_TYPE_FOR_UPDATE= 2,
433 	CURSOR_TYPE_SCROLLABLE= 4
434 };
435 
436 typedef enum mysqlnd_connection_close_type
437 {
438 	MYSQLND_CLOSE_EXPLICIT = 0,
439 	MYSQLND_CLOSE_IMPLICIT,
440 	MYSQLND_CLOSE_DISCONNECTED,
441 	MYSQLND_CLOSE_LAST	/* for checking, should always be last */
442 } enum_connection_close_type;
443 
444 
445 typedef enum mysqlnd_collected_stats
446 {
447 	STAT_BYTES_SENT,
448 	STAT_BYTES_RECEIVED,
449 	STAT_PACKETS_SENT,
450 	STAT_PACKETS_RECEIVED,
451 	STAT_PROTOCOL_OVERHEAD_IN,
452 	STAT_PROTOCOL_OVERHEAD_OUT,
453 	STAT_BYTES_RECEIVED_OK,
454 	STAT_BYTES_RECEIVED_EOF,
455 	STAT_BYTES_RECEIVED_RSET_HEADER,
456 	STAT_BYTES_RECEIVED_RSET_FIELD_META,
457 	STAT_BYTES_RECEIVED_RSET_ROW,
458 	STAT_BYTES_RECEIVED_PREPARE_RESPONSE,
459 	STAT_BYTES_RECEIVED_CHANGE_USER,
460 	STAT_PACKETS_SENT_CMD,
461 	STAT_PACKETS_RECEIVED_OK,
462 	STAT_PACKETS_RECEIVED_EOF,
463 	STAT_PACKETS_RECEIVED_RSET_HEADER,
464 	STAT_PACKETS_RECEIVED_RSET_FIELD_META,
465 	STAT_PACKETS_RECEIVED_RSET_ROW,
466 	STAT_PACKETS_RECEIVED_PREPARE_RESPONSE,
467 	STAT_PACKETS_RECEIVED_CHANGE_USER,
468 	STAT_RSET_QUERY,
469 	STAT_NON_RSET_QUERY,
470 	STAT_NO_INDEX_USED,
471 	STAT_BAD_INDEX_USED,
472 	STAT_QUERY_WAS_SLOW,
473 	STAT_BUFFERED_SETS,
474 	STAT_UNBUFFERED_SETS,
475 	STAT_PS_BUFFERED_SETS,
476 	STAT_PS_UNBUFFERED_SETS,
477 	STAT_FLUSHED_NORMAL_SETS,
478 	STAT_FLUSHED_PS_SETS,
479 	STAT_PS_PREPARED_NEVER_EXECUTED,
480 	STAT_PS_PREPARED_ONCE_USED,
481 	STAT_ROWS_FETCHED_FROM_SERVER_NORMAL,
482 	STAT_ROWS_FETCHED_FROM_SERVER_PS,
483 	STAT_ROWS_BUFFERED_FROM_CLIENT_NORMAL,
484 	STAT_ROWS_BUFFERED_FROM_CLIENT_PS,
485 	STAT_ROWS_FETCHED_FROM_CLIENT_NORMAL_BUF,
486 	STAT_ROWS_FETCHED_FROM_CLIENT_NORMAL_UNBUF,
487 	STAT_ROWS_FETCHED_FROM_CLIENT_PS_BUF,
488 	STAT_ROWS_FETCHED_FROM_CLIENT_PS_UNBUF,
489 	STAT_ROWS_FETCHED_FROM_CLIENT_PS_CURSOR,
490 	STAT_ROWS_AFFECTED_NORMAL,
491 	STAT_ROWS_AFFECTED_PS,
492 	STAT_ROWS_SKIPPED_NORMAL,
493 	STAT_ROWS_SKIPPED_PS,
494 	STAT_COPY_ON_WRITE_SAVED,
495 	STAT_COPY_ON_WRITE_PERFORMED,
496 	STAT_CMD_BUFFER_TOO_SMALL,
497 	STAT_CONNECT_SUCCESS,
498 	STAT_CONNECT_FAILURE,
499 	STAT_CONNECT_REUSED,
500 	STAT_RECONNECT,
501 	STAT_PCONNECT_SUCCESS,
502 	STAT_OPENED_CONNECTIONS,
503 	STAT_OPENED_PERSISTENT_CONNECTIONS,
504 	STAT_CLOSE_EXPLICIT,
505 	STAT_CLOSE_IMPLICIT,
506 	STAT_CLOSE_DISCONNECT,
507 	STAT_CLOSE_IN_MIDDLE,
508 	STAT_FREE_RESULT_EXPLICIT,
509 	STAT_FREE_RESULT_IMPLICIT,
510 	STAT_STMT_CLOSE_EXPLICIT,
511 	STAT_STMT_CLOSE_IMPLICIT,
512 	STAT_MEM_EMALLOC_COUNT,
513 	STAT_MEM_EMALLOC_AMOUNT,
514 	STAT_MEM_ECALLOC_COUNT,
515 	STAT_MEM_ECALLOC_AMOUNT,
516 	STAT_MEM_EREALLOC_COUNT,
517 	STAT_MEM_EREALLOC_AMOUNT,
518 	STAT_MEM_EFREE_COUNT,
519 	STAT_MEM_EFREE_AMOUNT,
520 	STAT_MEM_MALLOC_COUNT,
521 	STAT_MEM_MALLOC_AMOUNT,
522 	STAT_MEM_CALLOC_COUNT,
523 	STAT_MEM_CALLOC_AMOUNT,
524 	STAT_MEM_REALLOC_COUNT,
525 	STAT_MEM_REALLOC_AMOUNT,
526 	STAT_MEM_FREE_COUNT,
527 	STAT_MEM_FREE_AMOUNT,
528 	STAT_MEM_ESTRNDUP_COUNT,
529 	STAT_MEM_STRNDUP_COUNT,
530 	STAT_MEM_ESTRDUP_COUNT,
531 	STAT_MEM_STRDUP_COUNT,
532 	STAT_MEM_EDUP_COUNT,
533 	STAT_MEM_DUP_COUNT,
534 	STAT_TEXT_TYPE_FETCHED_NULL,
535 	STAT_TEXT_TYPE_FETCHED_BIT,
536 	STAT_TEXT_TYPE_FETCHED_INT8,
537 	STAT_TEXT_TYPE_FETCHED_INT16,
538 	STAT_TEXT_TYPE_FETCHED_INT24,
539 	STAT_TEXT_TYPE_FETCHED_INT32,
540 	STAT_TEXT_TYPE_FETCHED_INT64,
541 	STAT_TEXT_TYPE_FETCHED_DECIMAL,
542 	STAT_TEXT_TYPE_FETCHED_FLOAT,
543 	STAT_TEXT_TYPE_FETCHED_DOUBLE,
544 	STAT_TEXT_TYPE_FETCHED_DATE,
545 	STAT_TEXT_TYPE_FETCHED_YEAR,
546 	STAT_TEXT_TYPE_FETCHED_TIME,
547 	STAT_TEXT_TYPE_FETCHED_DATETIME,
548 	STAT_TEXT_TYPE_FETCHED_TIMESTAMP,
549 	STAT_TEXT_TYPE_FETCHED_STRING,
550 	STAT_TEXT_TYPE_FETCHED_JSON,
551 	STAT_TEXT_TYPE_FETCHED_BLOB,
552 	STAT_TEXT_TYPE_FETCHED_ENUM,
553 	STAT_TEXT_TYPE_FETCHED_SET,
554 	STAT_TEXT_TYPE_FETCHED_GEOMETRY,
555 	STAT_TEXT_TYPE_FETCHED_OTHER,
556 	STAT_BINARY_TYPE_FETCHED_NULL,
557 	STAT_BINARY_TYPE_FETCHED_BIT,
558 	STAT_BINARY_TYPE_FETCHED_INT8,
559 	STAT_BINARY_TYPE_FETCHED_INT16,
560 	STAT_BINARY_TYPE_FETCHED_INT24,
561 	STAT_BINARY_TYPE_FETCHED_INT32,
562 	STAT_BINARY_TYPE_FETCHED_INT64,
563 	STAT_BINARY_TYPE_FETCHED_DECIMAL,
564 	STAT_BINARY_TYPE_FETCHED_FLOAT,
565 	STAT_BINARY_TYPE_FETCHED_DOUBLE,
566 	STAT_BINARY_TYPE_FETCHED_DATE,
567 	STAT_BINARY_TYPE_FETCHED_YEAR,
568 	STAT_BINARY_TYPE_FETCHED_TIME,
569 	STAT_BINARY_TYPE_FETCHED_DATETIME,
570 	STAT_BINARY_TYPE_FETCHED_TIMESTAMP,
571 	STAT_BINARY_TYPE_FETCHED_STRING,
572 	STAT_BINARY_TYPE_FETCHED_BLOB,
573 	STAT_BINARY_TYPE_FETCHED_ENUM,
574 	STAT_BINARY_TYPE_FETCHED_SET,
575 	STAT_BINARY_TYPE_FETCHED_GEOMETRY,
576 	STAT_BINARY_TYPE_FETCHED_OTHER,
577 	STAT_INIT_COMMAND_EXECUTED_COUNT,
578 	STAT_INIT_COMMAND_FAILED_COUNT,
579 	STAT_COM_QUIT,
580 	STAT_COM_INIT_DB,
581 	STAT_COM_QUERY,
582 	STAT_COM_FIELD_LIST,
583 	STAT_COM_CREATE_DB,
584 	STAT_COM_DROP_DB,
585 	STAT_COM_REFRESH,
586 	STAT_COM_SHUTDOWN,
587 	STAT_COM_STATISTICS,
588 	STAT_COM_PROCESS_INFO,
589 	STAT_COM_CONNECT,
590 	STAT_COM_PROCESS_KILL,
591 	STAT_COM_DEBUG,
592 	STAT_COM_PING,
593 	STAT_COM_TIME,
594 	STAT_COM_DELAYED_INSERT,
595 	STAT_COM_CHANGE_USER,
596 	STAT_COM_BINLOG_DUMP,
597 	STAT_COM_TABLE_DUMP,
598 	STAT_COM_CONNECT_OUT,
599 	STAT_COM_REGISTER_SLAVE,
600 	STAT_COM_STMT_PREPARE,
601 	STAT_COM_STMT_EXECUTE,
602 	STAT_COM_STMT_SEND_LONG_DATA,
603 	STAT_COM_STMT_CLOSE,
604 	STAT_COM_STMT_RESET,
605 	STAT_COM_SET_OPTION,
606 	STAT_COM_STMT_FETCH,
607 	STAT_COM_DAEMON,
608 	STAT_BYTES_RECEIVED_PURE_DATA_TEXT,
609 	STAT_BYTES_RECEIVED_PURE_DATA_PS,
610 	STAT_LAST /* Should be always the last */
611 } enum_mysqlnd_collected_stats;
612 
613 
614 /* Enums */
615 enum mysqlnd_packet_type
616 {
617 	PROT_GREET_PACKET= 0,
618 	PROT_AUTH_PACKET,
619 	PROT_AUTH_RESP_PACKET,
620 	PROT_CHANGE_AUTH_RESP_PACKET,
621 	PROT_OK_PACKET,
622 	PROT_EOF_PACKET,
623 	PROT_CMD_PACKET,
624 	PROT_RSET_HEADER_PACKET,
625 	PROT_RSET_FLD_PACKET,
626 	PROT_ROW_PACKET,
627 	PROT_STATS_PACKET,
628 	PROT_PREPARE_RESP_PACKET,
629 	PROT_CHG_USER_RESP_PACKET,
630 	PROT_SHA256_PK_REQUEST_PACKET,
631 	PROT_SHA256_PK_REQUEST_RESPONSE_PACKET,
632 	PROT_CACHED_SHA2_RESULT_PACKET,
633 	PROT_LAST /* should always be last */
634 };
635 
636 
637 /*
638   After adding new elements please update
639   `mysqlnd_command_to_text` in mysqlnd_wireprotocol.c
640 */
641 enum php_mysqlnd_server_command
642 {
643 	COM_SLEEP = 0,
644 	COM_QUIT,
645 	COM_INIT_DB,
646 	COM_QUERY,
647 	COM_FIELD_LIST,
648 	COM_CREATE_DB,
649 	COM_DROP_DB,
650 	COM_REFRESH,
651 	COM_SHUTDOWN,
652 	COM_STATISTICS,
653 	COM_PROCESS_INFO,
654 	COM_CONNECT,
655 	COM_PROCESS_KILL,
656 	COM_DEBUG,
657 	COM_PING,
658 	COM_TIME = 15,
659 	COM_DELAYED_INSERT,
660 	COM_CHANGE_USER,
661 	COM_BINLOG_DUMP,
662 	COM_TABLE_DUMP,
663 	COM_CONNECT_OUT = 20,
664 	COM_REGISTER_SLAVE,
665 	COM_STMT_PREPARE = 22,
666 	COM_STMT_EXECUTE = 23,
667 	COM_STMT_SEND_LONG_DATA = 24,
668 	COM_STMT_CLOSE = 25,
669 	COM_STMT_RESET = 26,
670 	COM_SET_OPTION = 27,
671 	COM_STMT_FETCH = 28,
672 	COM_DAEMON = 29,
673 	COM_BINLOG_DUMP_GTID = 30,
674 	COM_RESET_CONNECTION = 31,
675 	COM_STMT_EXECUTE_BATCH = 32,
676 	COM_END,
677 	/* Here follow own, non-protocol, commands */
678 	COM_REAP_RESULT=240,	/* own command */
679 	COM_ENABLE_SSL,			/* own command */
680 	COM_HANDSHAKE,			/* own command */
681 };
682 
683 
684 #define MYSQLND_DEFAULT_PREFETCH_ROWS (zend_ulong) 1
685 
686 #define MYSQLND_REFRESH_GRANT		1	/* Refresh grant tables */
687 #define MYSQLND_REFRESH_LOG			2	/* Start on new log file */
688 #define MYSQLND_REFRESH_TABLES		4	/* close all tables */
689 #define MYSQLND_REFRESH_HOSTS		8	/* Flush host cache */
690 #define MYSQLND_REFRESH_STATUS		16	/* Flush status variables */
691 #define MYSQLND_REFRESH_THREADS		32	/* Flush thread cache */
692 #define MYSQLND_REFRESH_SLAVE		64	/* Reset master info and restart slave */
693 #define MYSQLND_REFRESH_MASTER		128	/* Remove all bin logs in the index */
694 #define MYSQLND_REFRESH_BACKUP_LOG	0x200000L
695 
696 
697 #define MYSQLND_STORE_PS		1
698 #define MYSQLND_STORE_NO_COPY	2
699 #define MYSQLND_STORE_COPY		4
700 
701 enum mysqlnd_buffered_type
702 {
703 	MYSQLND_BUFFERED_TYPE_ZVAL = 1,
704 	MYSQLND_BUFFERED_TYPE_C
705 };
706 
707 
708 #define MYSQLND_CLIENT_NO_FLAG				0
709 #define MYSQLND_CLIENT_KNOWS_RSET_COPY_DATA	1
710 
711 #endif	/* MYSQLND_ENUM_N_DEF_H */
712