protocol.cc 28.4 KB
Newer Older
monty@mashka.mysql.fi's avatar
monty@mashka.mysql.fi committed
1
/* Copyright (C) 2000-2003 MySQL AB
2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26

   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 */

/*
  Low level functions for storing data to be send to the MySQL client
  The actual communction is handled by the net_xxx functions in net_serv.cc
*/

#ifdef __GNUC__
#pragma implementation				// gcc: Class implementation
#endif

#include "mysql_priv.h"
27
#include "sp_rcontext.h"
28 29
#include <stdarg.h>

30 31
static const unsigned int PACKET_BUFFER_EXTRA_ALLOC= 1024;

hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
32 33
#ifndef EMBEDDED_LIBRARY
bool Protocol::net_store_data(const char *from, uint length)
hf@deer.(none)'s avatar
SCRUM  
hf@deer.(none) committed
34 35 36
#else
bool Protocol_prep::net_store_data(const char *from, uint length)
#endif
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
37 38
{
  ulong packet_length=packet->length();
monty@mashka.mysql.fi's avatar
monty@mashka.mysql.fi committed
39 40 41 42 43 44
  /* 
     The +9 comes from that strings of length longer than 16M require
     9 bytes to be stored (see net_store_length).
  */
  if (packet_length+9+length > packet->alloced_length() &&
      packet->realloc(packet_length+9+length))
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
45 46 47 48 49 50 51 52 53
    return 1;
  char *to=(char*) net_store_length((char*) packet->ptr()+packet_length,
				    (ulonglong) length);
  memcpy(to,from,length);
  packet->length((uint) (to+length-packet->ptr()));
  return 0;
}


54 55
	/* Send a error string to client */

56
void net_send_error(THD *thd, uint sql_errno, const char *err)
57
{
58
#ifndef EMBEDDED_LIBRARY 
59
  uint length;
60
  char buff[MYSQL_ERRMSG_SIZE+2], *pos;
61
#endif
62
  NET *net= &thd->net;
63
  DBUG_ENTER("net_send_error");
64 65 66 67
  DBUG_PRINT("enter",("sql_errno: %d  err: %s", sql_errno,
		      err ? err : net->last_error[0] ?
		      net->last_error : "NULL"));

68 69
  if (thd->spcont && thd->spcont->find_handler(sql_errno,
                                               MYSQL_ERROR::WARN_LEVEL_ERROR))
70 71 72
  {
    DBUG_VOID_RETURN;
  }
73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88
  thd->query_error=  1; // needed to catch query errors during replication
  if (!err)
  {
    if (sql_errno)
      err=ER(sql_errno);
    else
    {
      if ((err=net->last_error)[0])
	sql_errno=net->last_errno;
      else
      {
	sql_errno=ER_UNKNOWN_ERROR;
	err=ER(sql_errno);	 /* purecov: inspected */
      }
    }
  }
hf@deer.mysql.r18.ru's avatar
hf@deer.mysql.r18.ru committed
89 90 91 92

#ifdef EMBEDDED_LIBRARY
  net->last_errno= sql_errno;
  strmake(net->last_error, err, sizeof(net->last_error)-1);
93
  strmov(net->sqlstate, mysql_errno_to_sqlstate(sql_errno));
hf@deer.mysql.r18.ru's avatar
hf@deer.mysql.r18.ru committed
94 95
#else

96 97 98 99 100 101 102 103 104 105 106 107 108
  if (net->vio == 0)
  {
    if (thd->bootstrap)
    {
      /* In bootstrap it's ok to print on stderr */
      fprintf(stderr,"ERROR: %d  %s\n",sql_errno,err);
    }
    DBUG_VOID_RETURN;
  }

  if (net->return_errno)
  {				// new client code; Add errno before message
    int2store(buff,sql_errno);
109 110 111 112
    pos= buff+2;
    if (thd->client_capabilities & CLIENT_PROTOCOL_41)
    {
      /* The first # is to make the protocol backward compatible */
113
      buff[2]= '#';
114
      pos= strmov(buff+3, mysql_errno_to_sqlstate(sql_errno));
115 116
    }
    length= (uint) (strmake(pos, err, MYSQL_ERRMSG_SIZE-1) - buff);
117 118 119 120 121 122 123 124
    err=buff;
  }
  else
  {
    length=(uint) strlen(err);
    set_if_smaller(length,MYSQL_ERRMSG_SIZE-1);
  }
  VOID(net_write_command(net,(uchar) 255, "", 0, (char*) err,length));
hf@deer.mysql.r18.ru's avatar
hf@deer.mysql.r18.ru committed
125
#endif  /* EMBEDDED_LIBRARY*/
126
  thd->is_fatal_error=0;			// Error message is given
127
  thd->net.report_error= 0;
128 129

  /* Abort multi-result sets */
130
  thd->server_status&= ~SERVER_MORE_RESULTS_EXISTS;
131 132 133 134 135 136 137 138 139 140
  DBUG_VOID_RETURN;
}

/*
   Write error package and flush to client
   It's a little too low level, but I don't want to use another buffer for
   this
*/

void
141
net_printf_error(THD *thd, uint errcode, ...)
142 143 144
{
  va_list args;
  uint length,offset;
hf@deer.mysql.r18.ru's avatar
hf@deer.mysql.r18.ru committed
145 146 147
  const char *format;
#ifndef EMBEDDED_LIBRARY
  const char *text_pos;
148
  int head_length= NET_HEADER_SIZE;
hf@deer.mysql.r18.ru's avatar
hf@deer.mysql.r18.ru committed
149
#else
150
  char text_pos[1024];
hf@deer.mysql.r18.ru's avatar
hf@deer.mysql.r18.ru committed
151
#endif
152
  NET *net= &thd->net;
hf@deer.mysql.r18.ru's avatar
hf@deer.mysql.r18.ru committed
153

154
  DBUG_ENTER("net_printf_error");
155 156
  DBUG_PRINT("enter",("message: %u",errcode));

157 158
  if (thd->spcont && thd->spcont->find_handler(errcode,
                                               MYSQL_ERROR::WARN_LEVEL_ERROR))
159 160 161
  {
    DBUG_VOID_RETURN;
  }
162
  thd->query_error=  1; // needed to catch query errors during replication
hf@deer.mysql.r18.ru's avatar
hf@deer.mysql.r18.ru committed
163
#ifndef EMBEDDED_LIBRARY
164
  query_cache_abort(net);	// Safety
hf@deer.mysql.r18.ru's avatar
hf@deer.mysql.r18.ru committed
165
#endif
166 167
  va_start(args,errcode);
  /*
168 169
    The following is needed to make net_printf_error() work with 0 argument
    for errorcode and use the argument after that as the format string. This
170 171 172 173 174 175 176 177 178 179
    is useful for rare errors that are not worth the hassle to put in
    errmsg.sys, but at the same time, the message is not fixed text
  */
  if (errcode)
    format= ER(errcode);
  else
  {
    format=va_arg(args,char*);
    errcode= ER_UNKNOWN_ERROR;
  }
180 181 182
  offset= (net->return_errno ?
	   ((thd->client_capabilities & CLIENT_PROTOCOL_41) ?
	    2+SQLSTATE_LENGTH+1 : 2) : 0);
hf@deer.mysql.r18.ru's avatar
hf@deer.mysql.r18.ru committed
183
#ifndef EMBEDDED_LIBRARY
184
  text_pos=(char*) net->buff + head_length + offset + 1;
monty@mysql.com's avatar
monty@mysql.com committed
185
  length= (uint) ((char*)net->buff_end - text_pos);
serg@serg.mylan's avatar
serg@serg.mylan committed
186 187
#else
  length=sizeof(text_pos)-1;
hf@deer.mysql.r18.ru's avatar
hf@deer.mysql.r18.ru committed
188
#endif
serg@serg.mylan's avatar
serg@serg.mylan committed
189 190
  length=my_vsnprintf(my_const_cast(char*) (text_pos),
                      min(length, sizeof(net->last_error)),
serg@serg.mylan's avatar
serg@serg.mylan committed
191
                      format,args);
192 193
  va_end(args);

194 195 196 197
  /* Replication slave relies on net->last_* to see if there was error */
  net->last_errno= errcode;
  strmake(net->last_error, text_pos, sizeof(net->last_error)-1);

hf@deer.mysql.r18.ru's avatar
hf@deer.mysql.r18.ru committed
198
#ifndef EMBEDDED_LIBRARY
199 200 201 202
  if (net->vio == 0)
  {
    if (thd->bootstrap)
    {
monty@mashka.mysql.fi's avatar
monty@mashka.mysql.fi committed
203 204 205 206
      /*
	In bootstrap it's ok to print on stderr
	This may also happen when we get an error from a slave thread
      */
207
      fprintf(stderr,"ERROR: %d  %s\n",errcode,text_pos);
208
      thd->fatal_error();
209 210 211 212 213 214 215 216
    }
    DBUG_VOID_RETURN;
  }

  int3store(net->buff,length+1+offset);
  net->buff[3]= (net->compress) ? 0 : (uchar) (net->pkt_nr++);
  net->buff[head_length]=(uchar) 255;		// Error package
  if (offset)
217 218 219 220 221
  {
    uchar *pos= net->buff+head_length+1;
    int2store(pos, errcode);
    if (thd->client_capabilities & CLIENT_PROTOCOL_41)
    {
222 223
      pos[2]= '#';      /* To make the protocol backward compatible */
      memcpy(pos+3, mysql_errno_to_sqlstate(errcode), SQLSTATE_LENGTH);
224 225
    }
  }
226
  VOID(net_real_write(net,(char*) net->buff,length+head_length+1+offset));
hf@deer.mysql.r18.ru's avatar
hf@deer.mysql.r18.ru committed
227 228 229
#else
  net->last_errno= errcode;
  strmake(net->last_error, text_pos, length);
230
  strmake(net->sqlstate, mysql_errno_to_sqlstate(errcode), SQLSTATE_LENGTH);
hf@deer.mysql.r18.ru's avatar
hf@deer.mysql.r18.ru committed
231
#endif
232
  thd->is_fatal_error=0;			// Error message is given
233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261
  DBUG_VOID_RETURN;
}

/*
  Return ok to the client.

  SYNOPSIS
    send_ok()
    thd			Thread handler
    affected_rows	Number of rows changed by statement
    id			Auto_increment id for first row (if used)
    message		Message to send to the client (Used by mysql_status)

  DESCRIPTION
    The ok packet has the following structure

    0			Marker (1 byte)
    affected_rows	Stored in 1-9 bytes
    id			Stored in 1-9 bytes
    server_status	Copy of thd->server_status;  Can be used by client
			to check if we are inside an transaction
			New in 4.0 protocol
    warning_count	Stored in 2 bytes; New in 4.1 protocol
    message		Stored as packed length (1-9 bytes) + message
			Is not stored if no message

   If net->no_send_ok return without sending packet
*/    

262
#ifndef EMBEDDED_LIBRARY
263 264 265 266 267 268
void
send_ok(THD *thd, ha_rows affected_rows, ulonglong id, const char *message)
{
  NET *net= &thd->net;
  char buff[MYSQL_ERRMSG_SIZE+10],*pos;
  DBUG_ENTER("send_ok");
269 270 271 272

  if (net->no_send_ok || !net->vio)	// hack for re-parsing queries
    DBUG_VOID_RETURN;

273 274 275 276 277
  buff[0]=0;					// No fields
  pos=net_store_length(buff+1,(ulonglong) affected_rows);
  pos=net_store_length(pos, (ulonglong) id);
  if (thd->client_capabilities & CLIENT_PROTOCOL_41)
  {
278 279 280 281 282 283
    DBUG_PRINT("info",
	       ("affected_rows: %lu  id: %lu  status: %u  warning_count: %u",
		(ulong) affected_rows,		
		(ulong) id,
		(uint) (thd->server_status & 0xffff),
		(uint) thd->total_warn_count));
284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300
    int2store(pos,thd->server_status);
    pos+=2;

    /* We can only return up to 65535 warnings in two bytes */
    uint tmp= min(thd->total_warn_count, 65535);
    int2store(pos, tmp);
    pos+= 2;
  }
  else if (net->return_status)			// For 4.0 protocol
  {
    int2store(pos,thd->server_status);
    pos+=2;
  }
  if (message)
    pos=net_store_data((char*) pos, message, strlen(message));
  VOID(my_net_write(net,buff,(uint) (pos-buff)));
  VOID(net_flush(net));
301 302
  /* We can't anymore send an error to the client */
  thd->net.report_error= 0;
303 304 305
  DBUG_VOID_RETURN;
}

306
static char eof_buff[1]= { (char) 254 };        /* Marker for end of fields */
307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334

/*
  Send eof (= end of result set) to the client

  SYNOPSIS
    send_eof()
    thd			Thread handler
    no_flush		Set to 1 if there will be more data to the client,
			like in send_fields().

  DESCRIPTION
    The eof packet has the following structure

    254			Marker (1 byte)
    warning_count	Stored in 2 bytes; New in 4.1 protocol
    status_flag		Stored in 2 bytes;
			For flags like SERVER_STATUS_MORE_RESULTS

    Note that the warning count will not be sent if 'no_flush' is set as
    we don't want to report the warning count until all data is sent to the
    client.
*/    

void
send_eof(THD *thd, bool no_flush)
{
  NET *net= &thd->net;
  DBUG_ENTER("send_eof");
335
  if (net->vio != 0 && !net->no_send_eof)
336
  {
337
    if (thd->client_capabilities & CLIENT_PROTOCOL_41)
338 339 340 341 342
    {
      uchar buff[5];
      uint tmp= min(thd->total_warn_count, 65535);
      buff[0]=254;
      int2store(buff+1, tmp);
343 344 345 346 347 348
      /*
	The following test should never be true, but it's better to do it
	because if 'is_fatal_error' is set the server is not going to execute
	other queries (see the if test in dispatch_command / COM_QUERY)
      */
      if (thd->is_fatal_error)
349
	thd->server_status&= ~SERVER_MORE_RESULTS_EXISTS;
350
      int2store(buff+3, thd->server_status);
351 352 353 354 355 356 357 358 359 360 361 362
      VOID(my_net_write(net,(char*) buff,5));
      VOID(net_flush(net));
    }
    else
    {
      VOID(my_net_write(net,eof_buff,1));
      if (!no_flush)
	VOID(net_flush(net));
    }
  }
  DBUG_VOID_RETURN;
}
363 364 365 366 367 368 369 370 371 372 373 374 375 376 377

/*
    Please client to send scrambled_password in old format.
  SYNOPSYS
    send_old_password_request()
    thd thread handle
     
  RETURN VALUE
    0  ok
   !0  error
*/

bool send_old_password_request(THD *thd)
{
  NET *net= &thd->net;
378
  return my_net_write(net, eof_buff, 1) || net_flush(net);
379 380
}

hf@deer.mysql.r18.ru's avatar
hf@deer.mysql.r18.ru committed
381
#endif /* EMBEDDED_LIBRARY */
382 383

/*
384 385 386 387 388 389 390
  Faster net_store_length when we know that length is less than 65536.
  We keep a separate version for that range because it's widely used in
  libmysql.
  uint is used as agrument type because of MySQL type conventions:
  uint for 0..65536
  ulong for 0..4294967296
  ulonglong for bigger numbers.
391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447
*/

char *net_store_length(char *pkg, uint length)
{
  uchar *packet=(uchar*) pkg;
  if (length < 251)
  {
    *packet=(uchar) length;
    return (char*) packet+1;
  }
  *packet++=252;
  int2store(packet,(uint) length);
  return (char*) packet+2;
}


/****************************************************************************
  Functions used by the protocol functions (like send_ok) to store strings
  and numbers in the header result packet.
****************************************************************************/

/* The following will only be used for short strings < 65K */

char *net_store_data(char *to,const char *from, uint length)
{
  to=net_store_length(to,length);
  memcpy(to,from,length);
  return to+length;
}

char *net_store_data(char *to,int32 from)
{
  char buff[20];
  uint length=(uint) (int10_to_str(from,buff,10)-buff);
  to=net_store_length(to,length);
  memcpy(to,buff,length);
  return to+length;
}

char *net_store_data(char *to,longlong from)
{
  char buff[22];
  uint length=(uint) (longlong10_to_str(from,buff,10)-buff);
  to=net_store_length(to,length);
  memcpy(to,buff,length);
  return to+length;
}


/*****************************************************************************
  Default Protocol functions
*****************************************************************************/

void Protocol::init(THD *thd_arg)
{
  thd=thd_arg;
  packet= &thd->packet;
448
  convert= &thd->convert_buffer;
449 450 451 452 453
#ifndef DEBUG_OFF
  field_types= 0;
#endif
}

454

455 456 457 458 459 460 461 462 463
bool Protocol::flush()
{
#ifndef EMBEDDED_LIBRARY
  return net_flush(&thd->net);
#else
  return 0;
#endif
}

464 465 466 467 468 469 470 471 472 473
/*
  Send name and type of result to client.

  SYNOPSIS
    send_fields()
    THD		Thread data object
    list	List of items to send to client
    flag	Bit mask with the following functions:
		1 send number of rows
		2 send default values
474
                4 don't write eof packet
475 476 477 478 479 480 481 482 483

  DESCRIPTION
    Sum fields has table name empty and field_name.

  RETURN VALUES
    0	ok
    1	Error  (Note that in this case the error is not sent to the client)
*/

hf@deer.mysql.r18.ru's avatar
hf@deer.mysql.r18.ru committed
484
#ifndef EMBEDDED_LIBRARY
monty@mysql.com's avatar
monty@mysql.com committed
485
bool Protocol::send_fields(List<Item> *list, uint flags)
486 487 488 489
{
  List_iterator_fast<Item> it(*list);
  Item *item;
  char buff[80];
490
  String tmp((char*) buff,sizeof(buff),&my_charset_bin);
491
  Protocol_simple prot(thd);
492
  String *local_packet= prot.storage_packet();
493
  CHARSET_INFO *thd_charset= thd->variables.character_set_results;
494 495
  DBUG_ENTER("send_fields");

496
  if (flags & SEND_NUM_ROWS)
497 498 499 500 501 502 503 504 505 506 507 508 509 510
  {				// Packet with number of elements
    char *pos=net_store_length(buff, (uint) list->elements);
    (void) my_net_write(&thd->net, buff,(uint) (pos-buff));
  }

#ifndef DEBUG_OFF
  field_types= (enum_field_types*) thd->alloc(sizeof(field_types) *
					      list->elements);
  uint count= 0;
#endif

  while ((item=it++))
  {
    char *pos;
511
    CHARSET_INFO *cs= system_charset_info;
512 513 514 515 516 517
    Send_field field;
    item->make_field(&field);
    prot.prepare_for_resend();

    if (thd->client_capabilities & CLIENT_PROTOCOL_41)
    {
518
      if (prot.store("def", 3, cs, thd_charset) ||
519 520
	  prot.store(field.db_name, (uint) strlen(field.db_name),
		     cs, thd_charset) ||
521
	  prot.store(field.table_name, (uint) strlen(field.table_name),
522
		     cs, thd_charset) ||
523
	  prot.store(field.org_table_name, (uint) strlen(field.org_table_name),
524
		     cs, thd_charset) ||
525
	  prot.store(field.col_name, (uint) strlen(field.col_name),
526
		     cs, thd_charset) ||
527
	  prot.store(field.org_col_name, (uint) strlen(field.org_col_name),
528
		     cs, thd_charset) ||
529
	  local_packet->realloc(local_packet->length()+12))
530
	goto err;
531
      /* Store fixed length fields */
532
      pos= (char*) local_packet->ptr()+local_packet->length();
533
      *pos++= 12;				// Length of packed fields
534 535 536 537
      if (item->collation.collation == &my_charset_bin || thd_charset == NULL)
        int2store(pos, field.charsetnr);
      else
        int2store(pos, thd_charset->number);      
538 539 540 541
      int4store(pos+2, field.length);
      pos[6]= field.type;
      int2store(pos+7,field.flags);
      pos[9]= (char) field.decimals;
542
      pos[10]= 0;				// For the future
543 544
      pos[11]= 0;				// For the future
      pos+= 12;
545 546 547
    }
    else
    {
548
      if (prot.store(field.table_name, (uint) strlen(field.table_name),
549
		     cs, thd_charset) ||
550
	  prot.store(field.col_name, (uint) strlen(field.col_name),
551
		     cs, thd_charset) ||
552
	  local_packet->realloc(local_packet->length()+10))
553
	goto err;
554
      pos= (char*) local_packet->ptr()+local_packet->length();
555 556

#ifdef TO_BE_DELETED_IN_6
557 558 559 560 561 562 563 564 565 566 567 568
      if (!(thd->client_capabilities & CLIENT_LONG_FLAG))
      {
	pos[0]=3;
	int3store(pos+1,field.length);
	pos[4]=1;
	pos[5]=field.type;
	pos[6]=2;
	pos[7]= (char) field.flags;
	pos[8]= (char) field.decimals;
	pos+= 9;
      }
      else
569
#endif
570 571 572 573 574 575 576 577 578 579
      {
	pos[0]=3;
	int3store(pos+1,field.length);
	pos[4]=1;
	pos[5]=field.type;
	pos[6]=3;
	int2store(pos+7,field.flags);
	pos[9]= (char) field.decimals;
	pos+= 10;
      }
580
    }
581
    local_packet->length((uint) (pos - local_packet->ptr()));
582
    if (flags & SEND_DEFAULTS)
583 584 585 586 587 588 589 590
      item->send(&prot, &tmp);			// Send default value
    if (prot.write())
      break;					/* purecov: inspected */
#ifndef DEBUG_OFF
    field_types[count++]= field.type;
#endif
  }

591 592
  if (flags & SEND_EOF)
    my_net_write(&thd->net, eof_buff, 1);
593 594 595
  DBUG_RETURN(prepare_for_send(list));

err:
bell@sanja.is.com.ua's avatar
bell@sanja.is.com.ua committed
596 597
  my_message(ER_OUT_OF_RESOURCES, ER(ER_OUT_OF_RESOURCES),
             MYF(0));	/* purecov: inspected */
598 599 600
  DBUG_RETURN(1);				/* purecov: inspected */
}

601

hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
602 603 604 605 606 607 608 609 610
bool Protocol::send_records_num(List<Item> *list, ulonglong records)
{
  char *pos;
  char buff[20];
  pos=net_store_length(buff, (uint) list->elements);
  pos=net_store_length(pos, records);
  return my_net_write(&thd->net, buff,(uint) (pos-buff));
}

611

612 613 614
bool Protocol::write()
{
  DBUG_ENTER("Protocol::write");
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
615
  DBUG_RETURN(my_net_write(&thd->net, packet->ptr(), packet->length()));
616
}
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
617 618 619
#endif /* EMBEDDED_LIBRARY */


620 621 622 623 624 625 626 627 628 629 630 631 632 633 634
/*
  Send \0 end terminated string

  SYNOPSIS
    store()
    from	NullS or \0 terminated string

  NOTES
    In most cases one should use store(from, length) instead of this function

  RETURN VALUES
    0		ok
    1		error
*/

635
bool Protocol::store(const char *from, CHARSET_INFO *cs)
636 637 638 639
{
  if (!from)
    return store_null();
  uint length= strlen(from);
640
  return store(from, length, cs);
641 642 643 644 645 646 647 648 649 650
}


/*
  Send a set of strings as one long string with ',' in between
*/

bool Protocol::store(I_List<i_string>* str_list)
{
  char buf[256];
651
  String tmp(buf, sizeof(buf), &my_charset_bin);
652
  uint32 len;
653 654 655
  I_List_iterator<i_string> it(*str_list);
  i_string* s;

656
  tmp.length(0);
657 658 659
  while ((s=it++))
  {
    tmp.append(s->ptr);
660
    tmp.append(',');
661
  }
662 663
  if ((len= tmp.length()))
    len--;					// Remove last ','
664
  return store((char*) tmp.ptr(), len,  tmp.charset());
665 666 667 668 669 670 671 672 673 674 675
}


/****************************************************************************
  Functions to handle the simple (default) protocol where everything is
  This protocol is the one that is used by default between the MySQL server
  and client when you are not using prepared statements.

  All data are sent as 'packed-string-length' followed by 'string-data'
****************************************************************************/

hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
676
#ifndef EMBEDDED_LIBRARY
677 678 679 680 681 682 683 684 685 686 687 688 689 690
void Protocol_simple::prepare_for_resend()
{
  packet->length(0);
#ifndef DEBUG_OFF
  field_pos= 0;
#endif
}

bool Protocol_simple::store_null()
{
#ifndef DEBUG_OFF
  field_pos++;
#endif
  char buff[1];
691
  buff[0]= (char)251;
692
  return packet->append(buff, sizeof(buff), PACKET_BUFFER_EXTRA_ALLOC);
693
}
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
694
#endif
695

696

697 698 699 700 701 702 703 704 705 706 707 708 709
/*
  Auxilary function to convert string to the given character set
  and store in network buffer.
*/

bool Protocol::store_string_aux(const char *from, uint length,
                                CHARSET_INFO *fromcs, CHARSET_INFO *tocs)
{
  /* 'tocs' is set 0 when client issues SET character_set_results=NULL */
  if (tocs && !my_charset_same(fromcs, tocs) &&
      fromcs != &my_charset_bin &&
      tocs != &my_charset_bin)
  {
710 711
    uint dummy_errors;
    return convert->copy(from, length, fromcs, tocs, &dummy_errors) ||
712 713 714 715 716 717
           net_store_data(convert->ptr(), convert->length());
  }
  return net_store_data(from, length);
}


718 719
bool Protocol_simple::store(const char *from, uint length,
			    CHARSET_INFO *fromcs, CHARSET_INFO *tocs)
720 721 722
{
#ifndef DEBUG_OFF
  DBUG_ASSERT(field_types == 0 ||
723 724 725
	      field_types[field_pos] == MYSQL_TYPE_DECIMAL ||
	      (field_types[field_pos] >= MYSQL_TYPE_ENUM &&
	       field_types[field_pos] <= MYSQL_TYPE_GEOMETRY));
726 727
  field_pos++;
#endif
728
  return store_string_aux(from, length, fromcs, tocs);
729 730 731 732 733 734
}


bool Protocol_simple::store(const char *from, uint length,
			    CHARSET_INFO *fromcs)
{
735
  CHARSET_INFO *tocs= this->thd->variables.character_set_results;
736 737 738 739 740 741 742
#ifndef DEBUG_OFF
  DBUG_ASSERT(field_types == 0 ||
	      field_types[field_pos] == MYSQL_TYPE_DECIMAL ||
	      (field_types[field_pos] >= MYSQL_TYPE_ENUM &&
	       field_types[field_pos] <= MYSQL_TYPE_GEOMETRY));
  field_pos++;
#endif
743
  return store_string_aux(from, length, fromcs, tocs);
744 745 746 747 748 749
}


bool Protocol_simple::store_tiny(longlong from)
{
#ifndef DEBUG_OFF
750 751
  DBUG_ASSERT(field_types == 0 || field_types[field_pos] == MYSQL_TYPE_TINY);
  field_pos++;
752 753
#endif
  char buff[20];
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
754
  return net_store_data((char*) buff,
755 756 757
			(uint) (int10_to_str((int) from,buff, -10)-buff));
}

758

759 760 761 762
bool Protocol_simple::store_short(longlong from)
{
#ifndef DEBUG_OFF
  DBUG_ASSERT(field_types == 0 ||
763 764
	      field_types[field_pos] == MYSQL_TYPE_SHORT);
  field_pos++;
765 766
#endif
  char buff[20];
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
767
  return net_store_data((char*) buff,
768 769 770
			(uint) (int10_to_str((int) from,buff, -10)-buff));
}

771

772 773 774
bool Protocol_simple::store_long(longlong from)
{
#ifndef DEBUG_OFF
775 776 777 778
  DBUG_ASSERT(field_types == 0 ||
              field_types[field_pos] == MYSQL_TYPE_INT24 ||
              field_types[field_pos] == MYSQL_TYPE_LONG);
  field_pos++;
779 780
#endif
  char buff[20];
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
781
  return net_store_data((char*) buff,
782 783 784 785 786 787 788 789
			(uint) (int10_to_str((int) from,buff, -10)-buff));
}


bool Protocol_simple::store_longlong(longlong from, bool unsigned_flag)
{
#ifndef DEBUG_OFF
  DBUG_ASSERT(field_types == 0 ||
790 791
	      field_types[field_pos] == MYSQL_TYPE_LONGLONG);
  field_pos++;
792 793
#endif
  char buff[22];
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
794
  return net_store_data((char*) buff,
795 796 797 798 799 800 801 802 803 804
			(uint) (longlong10_to_str(from,buff,
						  unsigned_flag ? 10 : -10)-
				buff));
}


bool Protocol_simple::store(float from, uint32 decimals, String *buffer)
{
#ifndef DEBUG_OFF
  DBUG_ASSERT(field_types == 0 ||
805 806
	      field_types[field_pos] == MYSQL_TYPE_FLOAT);
  field_pos++;
807
#endif
808
  buffer->set((double) from, decimals, thd->charset());
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
809
  return net_store_data((char*) buffer->ptr(), buffer->length());
810 811
}

812

813 814 815 816
bool Protocol_simple::store(double from, uint32 decimals, String *buffer)
{
#ifndef DEBUG_OFF
  DBUG_ASSERT(field_types == 0 ||
817 818
	      field_types[field_pos] == MYSQL_TYPE_DOUBLE);
  field_pos++;
819
#endif
820
  buffer->set(from, decimals, thd->charset());
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
821
  return net_store_data((char*) buffer->ptr(), buffer->length());
822 823 824 825 826
}


bool Protocol_simple::store(Field *field)
{
827 828
  if (field->is_null())
    return store_null();
829 830 831 832
#ifndef DEBUG_OFF
  field_pos++;
#endif
  char buff[MAX_FIELD_WIDTH];
833
  String str(buff,sizeof(buff), &my_charset_bin);
834 835
  CHARSET_INFO *tocs= this->thd->variables.character_set_results;

836
  field->val_str(&str);
837
  return store_string_aux(str.ptr(), str.length(), str.charset(), tocs);
838 839 840
}


841 842 843 844 845 846 847
/*
   TODO:
        Second_part format ("%06") needs to change when 
        we support 0-6 decimals for time.
*/


848 849 850 851
bool Protocol_simple::store(TIME *tm)
{
#ifndef DEBUG_OFF
  DBUG_ASSERT(field_types == 0 ||
852 853 854
	      field_types[field_pos] == MYSQL_TYPE_DATETIME ||
	      field_types[field_pos] == MYSQL_TYPE_TIMESTAMP);
  field_pos++;
855 856
#endif
  char buff[40];
857 858 859 860 861 862 863 864 865 866 867
  uint length;
  length= my_sprintf(buff,(buff, "%04d-%02d-%02d %02d:%02d:%02d",
			   (int) tm->year,
			   (int) tm->month,
			   (int) tm->day,
			   (int) tm->hour,
			   (int) tm->minute,
			   (int) tm->second));
  if (tm->second_part)
    length+= my_sprintf(buff+length,(buff+length, ".%06d", (int)tm->second_part));
  return net_store_data((char*) buff, length);
868 869 870 871 872 873 874
}


bool Protocol_simple::store_date(TIME *tm)
{
#ifndef DEBUG_OFF
  DBUG_ASSERT(field_types == 0 ||
875 876
	      field_types[field_pos] == MYSQL_TYPE_DATE);
  field_pos++;
877
#endif
878 879 880
  char buff[MAX_DATE_STRING_REP_LENGTH];
  int length= my_date_to_str(tm, buff);
  return net_store_data(buff, (uint) length);
881 882 883
}


884 885 886 887 888 889
/*
   TODO:
        Second_part format ("%06") needs to change when 
        we support 0-6 decimals for time.
*/

890 891 892 893
bool Protocol_simple::store_time(TIME *tm)
{
#ifndef DEBUG_OFF
  DBUG_ASSERT(field_types == 0 ||
894 895
	      field_types[field_pos] == MYSQL_TYPE_TIME);
  field_pos++;
896 897
#endif
  char buff[40];
898
  uint length;
899
  uint day= (tm->year || tm->month) ? 0 : tm->day;
900 901 902 903 904 905 906 907
  length= my_sprintf(buff,(buff, "%s%02ld:%02d:%02d",
			   tm->neg ? "-" : "",
			   (long) day*24L+(long) tm->hour,
			   (int) tm->minute,
			   (int) tm->second));
  if (tm->second_part)
    length+= my_sprintf(buff+length,(buff+length, ".%06d", (int)tm->second_part));
  return net_store_data((char*) buff, length);
908 909 910 911 912
}


/****************************************************************************
  Functions to handle the binary protocol used with prepared statements
913 914 915

  Data format:

916 917 918 919 920 921 922 923 924 925 926 927
   [ok:1]                            reserved ok packet
   [null_field:(field_count+7+2)/8]  reserved to send null data. The size is
                                     calculated using:
                                     bit_fields= (field_count+7+2)/8; 
                                     2 bits are reserved for identifying type
				     of package.
   [[length]data]                    data field (the length applies only for 
                                     string/binary/time/timestamp fields and 
                                     rest of them are not sent as they have 
                                     the default length that client understands
                                     based on the field type
   [..]..[[length]data]              data
928 929 930 931
****************************************************************************/

bool Protocol_prep::prepare_for_send(List<Item> *item_list)
{
hf@deer.mysql.r18.ru's avatar
SCRUM  
hf@deer.mysql.r18.ru committed
932
  Protocol::prepare_for_send(item_list);
933 934
  bit_fields= (field_count+9)/8;
  if (packet->alloc(bit_fields+1))
935 936 937 938 939 940 941 942
    return 1;
  /* prepare_for_resend will be called after this one */
  return 0;
}


void Protocol_prep::prepare_for_resend()
{
943 944
  packet->length(bit_fields+1);
  bzero((char*) packet->ptr(), 1+bit_fields);
945 946 947 948
  field_pos=0;
}


949
bool Protocol_prep::store(const char *from, uint length, CHARSET_INFO *fromcs)
950
{
951
  CHARSET_INFO *tocs= thd->variables.character_set_results;
952
  field_pos++;
953
  return store_string_aux(from, length, fromcs, tocs);
954 955
}

956 957 958 959
bool Protocol_prep::store(const char *from,uint length,
			  CHARSET_INFO *fromcs, CHARSET_INFO *tocs)
{
  field_pos++;
960
  return store_string_aux(from, length, fromcs, tocs);
961 962
}

963 964
bool Protocol_prep::store_null()
{
965
  uint offset= (field_pos+2)/8+1, bit= (1 << ((field_pos+2) & 7));
966 967 968 969 970 971 972 973 974 975 976 977 978
  /* Room for this as it's allocated in prepare_for_send */
  char *to= (char*) packet->ptr()+offset;
  *to= (char) ((uchar) *to | (uchar) bit);
  field_pos++;
  return 0;
}


bool Protocol_prep::store_tiny(longlong from)
{
  char buff[1];
  field_pos++;
  buff[0]= (uchar) from;
979
  return packet->append(buff, sizeof(buff), PACKET_BUFFER_EXTRA_ALLOC);
980 981 982 983 984 985
}


bool Protocol_prep::store_short(longlong from)
{
  field_pos++;
986
  char *to= packet->prep_append(2, PACKET_BUFFER_EXTRA_ALLOC);
987 988 989 990 991 992 993 994 995 996
  if (!to)
    return 1;
  int2store(to, (int) from);
  return 0;
}


bool Protocol_prep::store_long(longlong from)
{
  field_pos++;
997
  char *to= packet->prep_append(4, PACKET_BUFFER_EXTRA_ALLOC);
998 999 1000 1001 1002 1003 1004 1005 1006 1007
  if (!to)
    return 1;
  int4store(to, from);
  return 0;
}


bool Protocol_prep::store_longlong(longlong from, bool unsigned_flag)
{
  field_pos++;
1008
  char *to= packet->prep_append(8, PACKET_BUFFER_EXTRA_ALLOC);
1009 1010 1011 1012 1013 1014 1015 1016 1017 1018
  if (!to)
    return 1;
  int8store(to, from);
  return 0;
}


bool Protocol_prep::store(float from, uint32 decimals, String *buffer)
{
  field_pos++;
1019
  char *to= packet->prep_append(4, PACKET_BUFFER_EXTRA_ALLOC);
1020 1021 1022 1023 1024 1025 1026 1027 1028 1029
  if (!to)
    return 1;
  float4store(to, from);
  return 0;
}


bool Protocol_prep::store(double from, uint32 decimals, String *buffer)
{
  field_pos++;
1030
  char *to= packet->prep_append(8, PACKET_BUFFER_EXTRA_ALLOC);
1031 1032 1033 1034 1035 1036 1037 1038 1039 1040
  if (!to)
    return 1;
  float8store(to, from);
  return 0;
}


bool Protocol_prep::store(Field *field)
{
  /*
1041
    We should not increment field_pos here as send_binary() will call another
1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055
    protocol function to do this for us
  */
  if (field->is_null())
    return store_null();
  return field->send_binary(this);
}


bool Protocol_prep::store(TIME *tm)
{
  char buff[12],*pos;
  uint length;
  field_pos++;
  pos= buff+1;
1056

1057
  int2store(pos, tm->year);
1058 1059 1060 1061 1062
  pos[2]= (uchar) tm->month;
  pos[3]= (uchar) tm->day;
  pos[4]= (uchar) tm->hour;
  pos[5]= (uchar) tm->minute;
  pos[6]= (uchar) tm->second;
1063 1064 1065 1066 1067 1068 1069 1070 1071 1072
  int4store(pos+7, tm->second_part);
  if (tm->second_part)
    length=11;
  else if (tm->hour || tm->minute || tm->second)
    length=7;
  else if (tm->year || tm->month || tm->day)
    length=4;
  else
    length=0;
  buff[0]=(char) length;			// Length is stored first
1073
  return packet->append(buff, length+1, PACKET_BUFFER_EXTRA_ALLOC);
1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085
}

bool Protocol_prep::store_date(TIME *tm)
{
  tm->hour= tm->minute= tm->second=0;
  tm->second_part= 0;
  return Protocol_prep::store(tm);
}


bool Protocol_prep::store_time(TIME *tm)
{
1086
  char buff[13], *pos;
1087 1088 1089 1090
  uint length;
  field_pos++;
  pos= buff+1;
  pos[0]= tm->neg ? 1 : 0;
1091 1092 1093 1094 1095 1096 1097
  if (tm->hour >= 24)
  {
    /* Fix if we come from Item::send */
    uint days= tm->hour/24;
    tm->hour-= days*24;
    tm->day+= days;
  }
1098
  int4store(pos+1, tm->day);
1099 1100 1101 1102
  pos[5]= (uchar) tm->hour;
  pos[6]= (uchar) tm->minute;
  pos[7]= (uchar) tm->second;
  int4store(pos+8, tm->second_part);
1103
  if (tm->second_part)
1104
    length=12;
1105
  else if (tm->hour || tm->minute || tm->second || tm->day)
1106
    length=8;
1107 1108 1109
  else
    length=0;
  buff[0]=(char) length;			// Length is stored first
1110
  return packet->append(buff, length+1, PACKET_BUFFER_EXTRA_ALLOC);
1111
}