1 /* vim:expandtab:shiftwidth=2:tabstop=2:smarttab:
5 * Copyright (C) 2011 Data Differential, http://datadifferential.com/
6 * Copyright (C) 2006-2009 Brian Aker All rights reserved.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions are
12 * * Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
15 * * Redistributions in binary form must reproduce the above
16 * copyright notice, this list of conditions and the following disclaimer
17 * in the documentation and/or other materials provided with the
20 * * The names of its contributors may not be used to endorse or
21 * promote products derived from this software without specific prior
24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
25 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
26 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
27 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
28 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
29 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
30 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
31 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
32 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
33 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
34 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
41 enum memcached_server_state_t
{
42 MEMCACHED_SERVER_STATE_NEW
, // fd == -1, no address lookup has been done
43 MEMCACHED_SERVER_STATE_ADDRINFO
, // ADDRRESS information has been gathered
44 MEMCACHED_SERVER_STATE_IN_PROGRESS
,
45 MEMCACHED_SERVER_STATE_CONNECTED
48 struct memcached_server_st
{
51 bool is_initialized
:1;
52 bool is_shutting_down
:1;
55 uint32_t number_of_hosts
;
56 uint32_t cursor_active
;
58 memcached_socket_t fd
;
59 uint32_t io_bytes_sent
; /* # bytes sent since last read */
60 uint32_t server_failure_counter
;
62 enum memcached_server_state_t state
;
67 uint8_t major_version
; // Default definition of UINT8_MAX means that it has not been set.
68 uint8_t micro_version
; // ditto
69 uint8_t minor_version
; // ditto
70 memcached_connection_t type
;
72 size_t read_buffer_length
;
73 size_t read_data_length
;
74 size_t write_buffer_offset
;
75 struct addrinfo
*address_info
;
76 struct addrinfo
*address_info_next
;
79 uint64_t limit_maxbytes
;
80 struct memcached_error_t
*error_messages
;
81 char read_buffer
[MEMCACHED_MAX_BUFFER
];
82 char write_buffer
[MEMCACHED_MAX_BUFFER
];
83 char hostname
[NI_MAXHOST
];
92 memcached_return_t
memcached_server_cursor(const memcached_st
*ptr
,
93 const memcached_server_fn
*callback
,
95 uint32_t number_of_callbacks
);
98 memcached_server_instance_st
memcached_server_by_key(const memcached_st
*ptr
,
101 memcached_return_t
*error
);
104 void memcached_server_error_reset(memcached_server_st
*ptr
);
107 void memcached_server_free(memcached_server_st
*ptr
);
110 memcached_server_st
*memcached_server_clone(memcached_server_st
*destination
,
111 const memcached_server_st
*source
);
114 memcached_server_instance_st
memcached_server_get_last_disconnect(const memcached_st
*ptr
);
118 memcached_return_t
memcached_server_add_udp(memcached_st
*ptr
,
119 const char *hostname
,
122 memcached_return_t
memcached_server_add_unix_socket(memcached_st
*ptr
,
123 const char *filename
);
125 memcached_return_t
memcached_server_add(memcached_st
*ptr
,
126 const char *hostname
, in_port_t port
);
129 memcached_return_t
memcached_server_add_parsed(memcached_st
*ptr
,
130 const char *hostname
,
131 size_t hostname_length
,
136 memcached_return_t
memcached_server_add_udp_with_weight(memcached_st
*ptr
,
137 const char *hostname
,
141 memcached_return_t
memcached_server_add_unix_socket_with_weight(memcached_st
*ptr
,
142 const char *filename
,
145 memcached_return_t
memcached_server_add_with_weight(memcached_st
*ptr
, const char *hostname
,
150 Operations on Single Servers.
153 uint32_t memcached_server_response_count(const memcached_server_instance_st self
);
156 const char *memcached_server_name(const memcached_server_instance_st self
);
159 in_port_t
memcached_server_port(const memcached_server_instance_st self
);
162 const char *memcached_server_type(const memcached_server_instance_st ptr
);
166 void __server_free(memcached_server_st
*);