1 /* vim:expandtab:shiftwidth=2:tabstop=2:smarttab:
5 * Copyright (C) 2011 Data Differential, http://datadifferential.com/
6 * Copyright (C) 2006-2009 Brian Aker
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions are
13 * * Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
16 * * Redistributions in binary form must reproduce the above
17 * copyright notice, this list of conditions and the following disclaimer
18 * in the documentation and/or other materials provided with the
21 * * The names of its contributors may not be used to endorse or
22 * promote products derived from this software without specific prior
25 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
26 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
27 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
28 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
29 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
30 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
31 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
32 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
33 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
34 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
35 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
40 #include <libmemcached/common.h>
42 #ifdef HAVE_SYS_SOCKET_H
43 # include <sys/socket.h>
46 void initialize_binary_request(memcached_instance_st
* server
, protocol_binary_request_header
& header
)
49 header
.request
.magic
= PROTOCOL_BINARY_REQ
;
50 header
.request
.opaque
= htons(server
->request_id
);
53 enum memc_read_or_write
{
59 * Try to fill the input buffer for a server with as much
62 * @param instance the server to pack
64 static bool repack_input_buffer(memcached_instance_st
* instance
)
66 if (instance
->read_ptr
!= instance
->read_buffer
)
68 /* Move all of the data to the beginning of the buffer so
69 ** that we can fit more data into the buffer...
71 memmove(instance
->read_buffer
, instance
->read_ptr
, instance
->read_buffer_length
);
72 instance
->read_ptr
= instance
->read_buffer
;
73 instance
->read_data_length
= instance
->read_buffer_length
;
76 /* There is room in the buffer, try to fill it! */
77 if (instance
->read_buffer_length
!= MEMCACHED_MAX_BUFFER
)
80 /* Just try a single read to grab what's available */
82 if ((nr
= ::recv(instance
->fd
,
83 instance
->read_ptr
+ instance
->read_data_length
,
84 MEMCACHED_MAX_BUFFER
- instance
->read_data_length
,
89 memcached_set_error(*instance
, MEMCACHED_CONNECTION_FAILURE
, MEMCACHED_AT
);
93 switch (get_socket_errno())
98 #if EWOULDBLOCK != EAGAIN
105 break; // No IO is fine, we can just move on
108 memcached_set_errno(*instance
, get_socket_errno(), MEMCACHED_AT
);
114 else // We read data, append to our read buffer
116 instance
->read_data_length
+= size_t(nr
);
117 instance
->read_buffer_length
+= size_t(nr
);
128 * If the we have callbacks connected to this server structure
129 * we may start process the input queue and fire the callbacks
130 * for the incomming messages. This function is _only_ called
131 * when the input buffer is full, so that we _know_ that we have
132 * at least _one_ message to process.
134 * @param instance the server to star processing iput messages for
135 * @return true if we processed anything, false otherwise
137 static bool process_input_buffer(memcached_instance_st
* instance
)
140 ** We might be able to process some of the response messages if we
141 ** have a callback set up
143 if (instance
->root
->callbacks
!= NULL
)
146 * We might have responses... try to read them out and fire
149 memcached_callback_st cb
= *instance
->root
->callbacks
;
151 memcached_set_processing_input((Memcached
*)instance
->root
, true);
153 char buffer
[MEMCACHED_DEFAULT_COMMAND_SIZE
];
154 Memcached
*root
= (Memcached
*)instance
->root
;
155 memcached_return_t error
= memcached_response(instance
, buffer
, sizeof(buffer
), &root
->result
);
157 memcached_set_processing_input(root
, false);
159 if (error
== MEMCACHED_SUCCESS
)
161 for (unsigned int x
= 0; x
< cb
.number_of_callback
; x
++)
163 error
= (*cb
.callback
[x
])(instance
->root
, &root
->result
, cb
.context
);
164 if (error
!= MEMCACHED_SUCCESS
)
170 /* @todo what should I do with the error message??? */
172 /* @todo what should I do with other error messages?? */
179 static memcached_return_t
io_wait(memcached_instance_st
* instance
,
183 ** We are going to block on write, but at least on Solaris we might block
184 ** on write if we haven't read anything from our input buffer..
185 ** Try to purge the input buffer if we don't do any flow control in the
186 ** application layer (just sending a lot of data etc)
187 ** The test is moved down in the purge function to avoid duplication of
190 if (events
& POLLOUT
)
192 if (memcached_purge(instance
) == false)
194 return MEMCACHED_FAILURE
;
199 fds
.fd
= instance
->fd
;
203 if (fds
.events
& POLLOUT
) /* write */
205 instance
->io_wait_count
.write
++;
209 instance
->io_wait_count
.read
++;
212 if (instance
->root
->poll_timeout
== 0) // Mimic 0 causes timeout behavior (not all platforms do this)
214 return memcached_set_error(*instance
, MEMCACHED_TIMEOUT
, MEMCACHED_AT
, memcached_literal_param("poll_timeout() was set to zero"));
218 while (--loop_max
) // While loop is for ERESTART or EINTR
220 int active_fd
= poll(&fds
, 1, instance
->root
->poll_timeout
);
224 assert_msg(active_fd
== 1 , "poll() returned an unexpected number of active file descriptors");
225 if (fds
.revents
& POLLIN
or fds
.revents
& POLLOUT
)
227 return MEMCACHED_SUCCESS
;
230 if (fds
.revents
& POLLHUP
)
232 return memcached_set_error(*instance
, MEMCACHED_CONNECTION_FAILURE
, MEMCACHED_AT
,
233 memcached_literal_param("poll() detected hang up"));
236 if (fds
.revents
& POLLERR
)
238 int local_errno
= EINVAL
;
240 socklen_t len
= sizeof (err
);
241 if (getsockopt(instance
->fd
, SOL_SOCKET
, SO_ERROR
, (char*)&err
, &len
) == 0)
243 if (err
== 0) // treat this as EINTR
249 memcached_quit_server(instance
, true);
250 return memcached_set_errno(*instance
, local_errno
, MEMCACHED_AT
,
251 memcached_literal_param("poll() returned POLLHUP"));
254 return memcached_set_error(*instance
, MEMCACHED_FAILURE
, MEMCACHED_AT
, memcached_literal_param("poll() returned a value that was not dealt with"));
259 return memcached_set_error(*instance
, MEMCACHED_TIMEOUT
, MEMCACHED_AT
, memcached_literal_param("No active_fd were found"));
262 // Only an error should result in this code being called.
263 int local_errno
= get_socket_errno(); // We cache in case memcached_quit_server() modifies errno
264 assert_msg(active_fd
== -1 , "poll() returned an unexpected value");
275 memcached_set_error(*instance
, MEMCACHED_MEMORY_ALLOCATION_FAILURE
, MEMCACHED_AT
);
279 memcached_set_error(*instance
, MEMCACHED_MEMORY_ALLOCATION_FAILURE
, MEMCACHED_AT
, memcached_literal_param("RLIMIT_NOFILE exceeded, or if OSX the timeout value was invalid"));
283 memcached_set_errno(*instance
, local_errno
, MEMCACHED_AT
, memcached_literal_param("poll"));
289 memcached_quit_server(instance
, true);
291 if (memcached_has_error(instance
))
293 return memcached_instance_error_return(instance
);
296 return memcached_set_error(*instance
, MEMCACHED_CONNECTION_FAILURE
, MEMCACHED_AT
,
297 memcached_literal_param("number of attempts to call io_wait() failed"));
300 static bool io_flush(memcached_instance_st
* instance
,
301 const bool with_flush
,
302 memcached_return_t
& error
)
305 ** We might want to purge the input buffer if we haven't consumed
306 ** any output yet... The test for the limits is the purge is inline
307 ** in the purge function to avoid duplicating the logic..
310 WATCHPOINT_ASSERT(instance
->fd
!= INVALID_SOCKET
);
312 if (memcached_purge(instance
) == false)
317 char *local_write_ptr
= instance
->write_buffer
;
318 size_t write_length
= instance
->write_buffer_offset
;
320 error
= MEMCACHED_SUCCESS
;
322 WATCHPOINT_ASSERT(instance
->fd
!= INVALID_SOCKET
);
324 /* Looking for memory overflows */
326 if (write_length
== MEMCACHED_MAX_BUFFER
)
327 WATCHPOINT_ASSERT(instance
->write_buffer
== local_write_ptr
);
328 WATCHPOINT_ASSERT((instance
->write_buffer
+ MEMCACHED_MAX_BUFFER
) >= (local_write_ptr
+ write_length
));
333 WATCHPOINT_ASSERT(instance
->fd
!= INVALID_SOCKET
);
334 WATCHPOINT_ASSERT(write_length
> 0);
343 flags
= MSG_NOSIGNAL
|MSG_MORE
;
346 ssize_t sent_length
= ::send(instance
->fd
, local_write_ptr
, write_length
, flags
);
347 int local_errno
= get_socket_errno(); // We cache in case memcached_quit_server() modifies errno
349 if (sent_length
== SOCKET_ERROR
)
351 #if 0 // @todo I should look at why we hit this bit of code hard frequently
352 WATCHPOINT_ERRNO(get_socket_errno());
353 WATCHPOINT_NUMBER(get_socket_errno());
355 switch (get_socket_errno())
360 #if EWOULDBLOCK != EAGAIN
366 * We may be blocked on write because the input buffer
367 * is full. Let's check if we have room in our input
368 * buffer for more data and retry the write before
371 if (repack_input_buffer(instance
) or process_input_buffer(instance
))
376 memcached_return_t rc
= io_wait(instance
, POLLOUT
);
377 if (memcached_success(rc
))
381 else if (rc
== MEMCACHED_TIMEOUT
)
386 memcached_quit_server(instance
, true);
387 error
= memcached_set_errno(*instance
, local_errno
, MEMCACHED_AT
);
393 memcached_quit_server(instance
, true);
394 error
= memcached_set_errno(*instance
, local_errno
, MEMCACHED_AT
);
395 WATCHPOINT_ASSERT(instance
->fd
== INVALID_SOCKET
);
400 instance
->io_bytes_sent
+= uint32_t(sent_length
);
402 local_write_ptr
+= sent_length
;
403 write_length
-= uint32_t(sent_length
);
406 WATCHPOINT_ASSERT(write_length
== 0);
407 instance
->write_buffer_offset
= 0;
412 memcached_return_t
memcached_io_wait_for_write(memcached_instance_st
* instance
)
414 return io_wait(instance
, POLLOUT
);
417 memcached_return_t
memcached_io_wait_for_read(memcached_instance_st
* instance
)
419 return io_wait(instance
, POLLIN
);
422 static memcached_return_t
_io_fill(memcached_instance_st
* instance
)
427 data_read
= ::recv(instance
->fd
, instance
->read_buffer
, MEMCACHED_MAX_BUFFER
, MSG_NOSIGNAL
);
428 int local_errno
= get_socket_errno(); // We cache in case memcached_quit_server() modifies errno
430 if (data_read
== SOCKET_ERROR
)
432 switch (get_socket_errno())
434 case EINTR
: // We just retry
437 case ETIMEDOUT
: // OSX
438 #if EWOULDBLOCK != EAGAIN
446 memcached_return_t io_wait_ret
;
447 if (memcached_success(io_wait_ret
= io_wait(instance
, POLLIN
)))
457 case ENOTCONN
: // Programmer Error
458 WATCHPOINT_ASSERT(0);
460 WATCHPOINT_ASSERT(0);
462 assert_msg(instance
->fd
!= INVALID_SOCKET
, "Programmer error, invalid socket");
468 memcached_quit_server(instance
, true);
469 memcached_set_errno(*instance
, local_errno
, MEMCACHED_AT
);
473 return memcached_instance_error_return(instance
);
475 else if (data_read
== 0)
478 EOF. Any data received so far is incomplete
479 so discard it. This always reads by byte in case of TCP
480 and protocol enforcement happens at memcached_response()
481 looking for '\n'. We do not care for UDB which requests 8 bytes
482 at once. Generally, this means that connection went away. Since
483 for blocking I/O we do not return 0 and for non-blocking case
484 it will return EGAIN if data is not immediatly available.
486 memcached_quit_server(instance
, true);
487 return memcached_set_error(*instance
, MEMCACHED_CONNECTION_FAILURE
, MEMCACHED_AT
,
488 memcached_literal_param("::rec() returned zero, server has disconnected"));
490 instance
->io_wait_count
._bytes_read
+= data_read
;
491 } while (data_read
<= 0);
493 instance
->io_bytes_sent
= 0;
494 instance
->read_data_length
= (size_t) data_read
;
495 instance
->read_buffer_length
= (size_t) data_read
;
496 instance
->read_ptr
= instance
->read_buffer
;
498 return MEMCACHED_SUCCESS
;
501 memcached_return_t
memcached_io_read(memcached_instance_st
* instance
,
502 void *buffer
, size_t length
, ssize_t
& nread
)
504 assert(memcached_is_udp(instance
->root
) == false);
505 assert_msg(instance
, "Programmer error, memcached_io_read() recieved an invalid Instance"); // Programmer error
506 char *buffer_ptr
= static_cast<char *>(buffer
);
508 if (instance
->fd
== INVALID_SOCKET
)
511 assert_msg(int(instance
->state
) <= int(MEMCACHED_SERVER_STATE_ADDRINFO
), "Programmer error, invalid socket state");
513 return MEMCACHED_CONNECTION_FAILURE
;
518 if (instance
->read_buffer_length
== 0)
520 memcached_return_t io_fill_ret
;
521 if (memcached_fatal(io_fill_ret
= _io_fill(instance
)))
530 size_t difference
= (length
> instance
->read_buffer_length
) ? instance
->read_buffer_length
: length
;
532 memcpy(buffer_ptr
, instance
->read_ptr
, difference
);
533 length
-= difference
;
534 instance
->read_ptr
+= difference
;
535 instance
->read_buffer_length
-= difference
;
536 buffer_ptr
+= difference
;
540 *buffer_ptr
= *instance
->read_ptr
;
541 instance
->read_ptr
++;
542 instance
->read_buffer_length
--;
548 nread
= ssize_t(buffer_ptr
- (char*)buffer
);
550 return MEMCACHED_SUCCESS
;
553 memcached_return_t
memcached_io_slurp(memcached_instance_st
* instance
)
555 assert_msg(instance
, "Programmer error, invalid Instance");
556 assert(memcached_is_udp(instance
->root
) == false);
558 if (instance
->fd
== INVALID_SOCKET
)
560 assert_msg(int(instance
->state
) <= int(MEMCACHED_SERVER_STATE_ADDRINFO
), "Invalid socket state");
561 return MEMCACHED_CONNECTION_FAILURE
;
565 char buffer
[MEMCACHED_MAX_BUFFER
];
568 data_read
= ::recv(instance
->fd
, instance
->read_buffer
, sizeof(buffer
), MSG_NOSIGNAL
);
569 if (data_read
== SOCKET_ERROR
)
571 switch (get_socket_errno())
573 case EINTR
: // We just retry
576 case ETIMEDOUT
: // OSX
577 #if EWOULDBLOCK != EAGAIN
584 if (memcached_success(io_wait(instance
, POLLIN
)))
588 return MEMCACHED_IN_PROGRESS
;
592 case ENOTCONN
: // Programmer Error
597 assert_msg(instance
->fd
!= INVALID_SOCKET
, "Invalid socket state");
603 return MEMCACHED_CONNECTION_FAILURE
; // We want this!
606 } while (data_read
> 0);
608 return MEMCACHED_CONNECTION_FAILURE
;
611 static bool _io_write(memcached_instance_st
* instance
,
612 const void *buffer
, size_t length
, bool with_flush
,
615 assert(instance
->fd
!= INVALID_SOCKET
);
616 assert(memcached_is_udp(instance
->root
) == false);
618 const char *buffer_ptr
= static_cast<const char *>(buffer
);
620 const size_t original_length
= length
;
625 size_t buffer_end
= MEMCACHED_MAX_BUFFER
;
626 size_t should_write
= buffer_end
-instance
->write_buffer_offset
;
627 should_write
= (should_write
< length
) ? should_write
: length
;
629 write_ptr
= instance
->write_buffer
+ instance
->write_buffer_offset
;
630 memcpy(write_ptr
, buffer_ptr
, should_write
);
631 instance
->write_buffer_offset
+= should_write
;
632 buffer_ptr
+= should_write
;
633 length
-= should_write
;
635 if (instance
->write_buffer_offset
== buffer_end
)
637 WATCHPOINT_ASSERT(instance
->fd
!= INVALID_SOCKET
);
639 memcached_return_t rc
;
640 if (io_flush(instance
, with_flush
, rc
) == false)
642 written
= original_length
-length
;
650 memcached_return_t rc
;
651 WATCHPOINT_ASSERT(instance
->fd
!= INVALID_SOCKET
);
652 if (io_flush(instance
, with_flush
, rc
) == false)
654 written
= original_length
-length
;
659 written
= original_length
-length
;
664 bool memcached_io_write(memcached_instance_st
* instance
)
667 return _io_write(instance
, NULL
, 0, true, written
);
670 ssize_t
memcached_io_write(memcached_instance_st
* instance
,
671 const void *buffer
, const size_t length
, const bool with_flush
)
675 if (_io_write(instance
, buffer
, length
, with_flush
, written
) == false)
680 return ssize_t(written
);
683 bool memcached_io_writev(memcached_instance_st
* instance
,
684 libmemcached_io_vector_st vector
[],
685 const size_t number_of
, const bool with_flush
)
687 ssize_t complete_total
= 0;
690 for (size_t x
= 0; x
< number_of
; x
++, vector
++)
692 complete_total
+= vector
->length
;
696 if ((_io_write(instance
, vector
->buffer
, vector
->length
, false, written
)) == false)
706 if (memcached_io_write(instance
) == false)
712 return (complete_total
== total
);
715 void memcached_instance_st::start_close_socket()
717 if (fd
!= INVALID_SOCKET
)
719 shutdown(fd
, SHUT_WR
);
720 options
.is_shutting_down
= true;
724 void memcached_instance_st::reset_socket()
726 if (fd
!= INVALID_SOCKET
)
728 (void)closesocket(fd
);
733 void memcached_instance_st::close_socket()
735 if (fd
!= INVALID_SOCKET
)
737 int shutdown_options
= SHUT_RD
;
738 if (options
.is_shutting_down
== false)
740 shutdown_options
= SHUT_RDWR
;
743 /* in case of death shutdown to avoid blocking at close() */
744 if (shutdown(fd
, shutdown_options
) == SOCKET_ERROR
and get_socket_errno() != ENOTCONN
)
746 WATCHPOINT_NUMBER(fd
);
747 WATCHPOINT_ERRNO(get_socket_errno());
748 WATCHPOINT_ASSERT(get_socket_errno());
752 state
= MEMCACHED_SERVER_STATE_NEW
;
755 state
= MEMCACHED_SERVER_STATE_NEW
;
758 write_buffer_offset
= size_t(root
and memcached_is_udp(root
) ? UDP_DATAGRAM_HEADER_LENGTH
: 0);
759 read_buffer_length
= 0;
760 read_ptr
= read_buffer
;
761 options
.is_shutting_down
= false;
762 memcached_server_response_reset(this);
764 // We reset the version so that if we end up talking to a different server
765 // we don't have stale server version information.
766 major_version
= minor_version
= micro_version
= UINT8_MAX
;
769 memcached_instance_st
* memcached_io_get_readable_server(Memcached
*memc
, memcached_return_t
&)
771 #define MAX_SERVERS_TO_POLL 100
772 struct pollfd fds
[MAX_SERVERS_TO_POLL
];
773 nfds_t host_index
= 0;
775 for (uint32_t x
= 0; x
< memcached_server_count(memc
) and host_index
< MAX_SERVERS_TO_POLL
; ++x
)
777 memcached_instance_st
* instance
= memcached_instance_fetch(memc
, x
);
779 if (instance
->read_buffer_length
> 0) /* I have data in the buffer */
784 if (instance
->response_count() > 0)
786 fds
[host_index
].events
= POLLIN
;
787 fds
[host_index
].revents
= 0;
788 fds
[host_index
].fd
= instance
->fd
;
795 /* We have 0 or 1 server with pending events.. */
796 for (uint32_t x
= 0; x
< memcached_server_count(memc
); ++x
)
798 memcached_instance_st
* instance
= memcached_instance_fetch(memc
, x
);
800 if (instance
->response_count() > 0)
809 int error
= poll(fds
, host_index
, memc
->poll_timeout
);
813 memcached_set_errno(*memc
, get_socket_errno(), MEMCACHED_AT
);
819 for (nfds_t x
= 0; x
< host_index
; ++x
)
821 if (fds
[x
].revents
& POLLIN
)
823 for (uint32_t y
= 0; y
< memcached_server_count(memc
); ++y
)
825 memcached_instance_st
* instance
= memcached_instance_fetch(memc
, y
);
827 if (instance
->fd
== fds
[x
].fd
)
840 Eventually we will just kill off the server with the problem.
842 void memcached_io_reset(memcached_instance_st
* instance
)
844 memcached_quit_server(instance
, true);
848 * Read a given number of bytes from the server and place it into a specific
849 * buffer. Reset the IO channel on this server if an error occurs.
851 memcached_return_t
memcached_safe_read(memcached_instance_st
* instance
,
856 char *data
= static_cast<char *>(dta
);
858 while (offset
< size
)
861 memcached_return_t rc
;
863 while (memcached_continue(rc
= memcached_io_read(instance
, data
+ offset
, size
- offset
, nread
))) { };
865 if (memcached_failed(rc
))
870 offset
+= size_t(nread
);
873 return MEMCACHED_SUCCESS
;
876 memcached_return_t
memcached_io_readline(memcached_instance_st
* instance
,
882 bool line_complete
= false;
884 while (line_complete
== false)
886 if (instance
->read_buffer_length
== 0)
889 * We don't have any data in the buffer, so let's fill the read
890 * buffer. Call the standard read function to avoid duplicating
894 memcached_return_t rc
= memcached_io_read(instance
, buffer_ptr
, 1, nread
);
895 if (memcached_failed(rc
) and rc
== MEMCACHED_IN_PROGRESS
)
897 memcached_quit_server(instance
, true);
898 return memcached_set_error(*instance
, rc
, MEMCACHED_AT
);
900 else if (memcached_failed(rc
))
905 if (*buffer_ptr
== '\n')
914 /* Now let's look in the buffer and copy as we go! */
915 while (instance
->read_buffer_length
and total_nr
< size
and line_complete
== false)
917 *buffer_ptr
= *instance
->read_ptr
;
918 if (*buffer_ptr
== '\n')
920 line_complete
= true;
922 --instance
->read_buffer_length
;
923 ++instance
->read_ptr
;
928 if (total_nr
== size
)
930 return MEMCACHED_PROTOCOL_ERROR
;
934 return MEMCACHED_SUCCESS
;