From 751648e3a8c17e6f5bbe223a1213b537b5708871 Mon Sep 17 00:00:00 2001 From: Brian Aker Date: Thu, 21 Jul 2011 23:59:04 -0700 Subject: [PATCH] Update man pages. --- docs/man/hashkit_clone.3 | 31 ++-- docs/man/hashkit_crc32.3 | 5 +- docs/man/hashkit_create.3 | 31 ++-- docs/man/hashkit_fnv1_32.3 | 5 +- docs/man/hashkit_fnv1_64.3 | 5 +- docs/man/hashkit_fnv1a_32.3 | 5 +- docs/man/hashkit_fnv1a_64.3 | 5 +- docs/man/hashkit_free.3 | 31 ++-- docs/man/hashkit_functions.3 | 5 +- docs/man/hashkit_hsieh.3 | 5 +- docs/man/hashkit_is_allocated.3 | 31 ++-- docs/man/hashkit_jenkins.3 | 5 +- docs/man/hashkit_md5.3 | 5 +- docs/man/hashkit_murmur.3 | 5 +- docs/man/hashkit_value.3 | 6 +- docs/man/libhashkit.3 | 4 +- docs/man/libmemcached.3 | 27 +-- docs/man/libmemcached_check_configuration.3 | 12 +- docs/man/libmemcached_configuration.3 | 12 +- docs/man/libmemcached_examples.3 | 29 +++- docs/man/libmemcachedutil.3 | 11 +- docs/man/memaslap.1 | 24 +-- docs/man/memcached.3 | 12 +- docs/man/memcached_add.3 | 69 ++++---- docs/man/memcached_add_by_key.3 | 69 ++++---- docs/man/memcached_analyze.3 | 22 +-- docs/man/memcached_append.3 | 64 +++---- docs/man/memcached_append_by_key.3 | 64 +++---- docs/man/memcached_auto.3 | 2 +- docs/man/memcached_behavior.3 | 75 +++++---- docs/man/memcached_behavior_get.3 | 75 +++++---- docs/man/memcached_behavior_set.3 | 75 +++++---- docs/man/memcached_callback.3 | 73 +++++--- docs/man/memcached_callback_get.3 | 73 +++++--- docs/man/memcached_callback_set.3 | 73 +++++--- docs/man/memcached_cas.3 | 52 +++--- docs/man/memcached_cas_by_key.3 | 52 +++--- docs/man/memcached_clone.3 | 55 +++--- docs/man/memcached_create.3 | 55 +++--- docs/man/memcached_decrement.3 | 2 +- docs/man/memcached_decrement_with_initial.3 | 2 +- docs/man/memcached_delete.3 | 11 +- docs/man/memcached_delete_by_key.3 | 11 +- docs/man/memcached_destroy_sasl_auth_data.3 | 21 ++- docs/man/memcached_dump.3 | 11 +- docs/man/memcached_fetch.3 | 128 ++------------ docs/man/memcached_fetch_execute.3 | 157 ++++++++---------- docs/man/memcached_fetch_result.3 | 157 ++++++++---------- docs/man/memcached_flush.3 | 6 +- docs/man/memcached_flush_buffers.3 | 10 +- docs/man/memcached_free.3 | 55 +++--- docs/man/memcached_generate_hash.3 | 12 +- docs/man/memcached_generate_hash_value.3 | 12 +- docs/man/memcached_get.3 | 157 ++++++++---------- docs/man/memcached_get_by_key.3 | 157 ++++++++---------- docs/man/memcached_get_memory_allocators.3 | 27 +-- docs/man/memcached_get_sasl_callbacks.3 | 21 ++- docs/man/memcached_get_user_data.3 | 17 +- docs/man/memcached_increment.3 | 2 +- docs/man/memcached_increment_with_initial.3 | 2 +- docs/man/memcached_lib_version.3 | 24 +-- docs/man/memcached_memory_allocators.3 | 27 +-- docs/man/memcached_mget.3 | 157 ++++++++---------- docs/man/memcached_mget_by_key.3 | 157 ++++++++---------- docs/man/memcached_mget_execute.3 | 157 ++++++++---------- docs/man/memcached_mget_execute_by_key.3 | 157 ++++++++---------- docs/man/memcached_pool.3 | 73 +++----- docs/man/memcached_pool_behavior_get.3 | 73 +++----- docs/man/memcached_pool_behavior_set.3 | 73 +++----- docs/man/memcached_pool_create.3 | 73 +++----- docs/man/memcached_pool_destroy.3 | 73 +++----- docs/man/memcached_pool_pop.3 | 73 +++----- docs/man/memcached_pool_push.3 | 73 +++----- docs/man/memcached_pool_st.3 | 73 +++----- docs/man/memcached_prepend.3 | 64 +++---- docs/man/memcached_prepend_by_key.3 | 64 +++---- docs/man/memcached_quit.3 | 13 +- docs/man/memcached_replace.3 | 69 ++++---- docs/man/memcached_replace_by_key.3 | 69 ++++---- docs/man/memcached_result_cas.3 | 55 +++--- docs/man/memcached_result_create.3 | 55 +++--- docs/man/memcached_result_flags.3 | 55 +++--- docs/man/memcached_result_free.3 | 55 +++--- docs/man/memcached_result_key_length.3 | 55 +++--- docs/man/memcached_result_key_value.3 | 55 +++--- docs/man/memcached_result_length.3 | 55 +++--- docs/man/memcached_result_st.3 | 55 +++--- docs/man/memcached_result_value.3 | 55 +++--- docs/man/memcached_sasl.3 | 21 ++- docs/man/memcached_sasl_set_auth_data.3 | 21 ++- docs/man/memcached_server_add.3 | 66 ++++---- docs/man/memcached_server_add_unix_socket.3 | 66 ++++---- docs/man/memcached_server_count.3 | 66 ++++---- docs/man/memcached_server_cursor.3 | 66 ++++---- docs/man/memcached_server_list.3 | 66 ++++---- docs/man/memcached_server_list_append.3 | 23 +-- docs/man/memcached_server_list_count.3 | 23 +-- docs/man/memcached_server_list_free.3 | 23 +-- docs/man/memcached_server_push.3 | 66 ++++---- docs/man/memcached_server_st.3 | 66 ++++---- docs/man/memcached_servers.3 | 66 ++++---- docs/man/memcached_servers_parse.3 | 23 +-- docs/man/memcached_servers_reset.3 | 55 +++--- docs/man/memcached_set.3 | 69 ++++---- docs/man/memcached_set_by_key.3 | 69 ++++---- docs/man/memcached_set_memory_allocators.3 | 27 +-- .../memcached_set_memory_allocators_context.3 | 27 +-- docs/man/memcached_set_sasl_callbacks.3 | 21 ++- docs/man/memcached_set_user_data.3 | 17 +- docs/man/memcached_stat.3 | 33 ++-- docs/man/memcached_stat_execute.3 | 33 ++-- docs/man/memcached_stat_get_keys.3 | 33 ++-- docs/man/memcached_stat_get_value.3 | 33 ++-- docs/man/memcached_stat_servername.3 | 33 ++-- docs/man/memcached_stats.3 | 33 ++-- docs/man/memcached_strerror.3 | 12 +- docs/man/memcached_user_data.3 | 17 +- docs/man/memcached_verbosity.3 | 14 +- docs/man/memcached_version.3 | 24 +-- docs/man/memcapable.1 | 23 ++- docs/man/memcat.1 | 34 ++-- docs/man/memcp.1 | 39 +++-- docs/man/memdump.1 | 26 +-- docs/man/memerror.1 | 28 ++-- docs/man/memflush.1 | 34 ++-- docs/man/memrm.1 | 32 ++-- docs/man/memslap.1 | 32 +++- docs/man/memstat.1 | 36 ++-- 128 files changed, 2702 insertions(+), 3068 deletions(-) diff --git a/docs/man/hashkit_clone.3 b/docs/man/hashkit_clone.3 index 6b94f0bd..fbc9e027 100644 --- a/docs/man/hashkit_clone.3 +++ b/docs/man/hashkit_clone.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_CLONE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "HASHKIT_CLONE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME hashkit_clone \- libhashkit Documentation . @@ -35,6 +35,10 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP +.B hashkit_st +.UNINDENT +.INDENT 0.0 +.TP .B hashkit_st *hashkit_create(hashkit_st *hash); .UNINDENT .INDENT 0.0 @@ -53,32 +57,35 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lhashkit .SH DESCRIPTION .sp -The hashkit_create() function initializes a hashkit object for use. If +The \fBhashkit_create()\fP function initializes a hashkit object for use. If you pass a NULL argument for hash, then the memory for the object is allocated. If you specify a pre\-allocated piece of memory, that is initialized for use. .sp -The hashkit_clone() function initializes a hashkit object much like -hashkit_create(), but instead of using default settings it will use +The \fBhashkit_clone()\fP function initializes a hashkit object much like +\fBhashkit_create()\fP, but instead of using default settings it will use the settings of the ptr hashkit object. .sp -The hashkit_free() frees any resources being consumed by the hashkit -objects that were initialized with hashkit_create() or hashkit_clone(). +The \fBhashkit_free()\fP frees any resources being consumed by the hashkit +objects that were initialized with \fBhashkit_create()\fP or \fBhashkit_clone()\fP. .sp -The hashkit_is_allocated() reports where the memory was allocated +The \fBhashkit_is_allocated()\fP reports where the memory was allocated for a hashkit object. .SH RETURN VALUE .sp -hashkit_create() and hashkit_clone() will return NULL on failure or -non\-NULL on success. +\fBhashkit_create()\fP and \fBhashkit_clone()\fP will return NULL on +failure or non\-NULL on success. .sp -hashkit_is_allocated() returns true if the memory for the hashkit -object was allocated inside of hashkit_create() or hashkit_clone(), -otherwise it is false and was user\-supplied memory. +\fBhashkit_is_allocated()\fP returns true if the memory for the hashkit +object was allocated inside of \fBhashkit_create()\fP or +\fBhashkit_clone()\fP, otherwise it is false and was user\-supplied memory. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP +.SH SEE ALSO +.sp +\fIhashkit_create(3)\fP \fIhashkit_value(3)\fP \fIhashkit_set_hash_fn(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/hashkit_crc32.3 b/docs/man/hashkit_crc32.3 index cdb91efb..689c7e27 100644 --- a/docs/man/hashkit_crc32.3 +++ b/docs/man/hashkit_crc32.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_CRC32" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "HASHKIT_CRC32" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME hashkit_crc32 \- libhashkit Documentation . @@ -94,8 +94,7 @@ To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -hashkit_create(3) hashkit_value(3) hashkit_set_hash_fn(3) -hashkit_set_continuum_hash_fn(3) +\fIhashkit_create(3)\fP \fIhashkit_value(3)\fP \fIhashkit_set_hash_fn(3)\fP \fIhashkit_set_continuum_hash_fn(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/hashkit_create.3 b/docs/man/hashkit_create.3 index b797fe2c..4514624b 100644 --- a/docs/man/hashkit_create.3 +++ b/docs/man/hashkit_create.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_CREATE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "HASHKIT_CREATE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME hashkit_create \- libhashkit Documentation . @@ -35,6 +35,10 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP +.B hashkit_st +.UNINDENT +.INDENT 0.0 +.TP .B hashkit_st *hashkit_create(hashkit_st *hash); .UNINDENT .INDENT 0.0 @@ -53,32 +57,35 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lhashkit .SH DESCRIPTION .sp -The hashkit_create() function initializes a hashkit object for use. If +The \fBhashkit_create()\fP function initializes a hashkit object for use. If you pass a NULL argument for hash, then the memory for the object is allocated. If you specify a pre\-allocated piece of memory, that is initialized for use. .sp -The hashkit_clone() function initializes a hashkit object much like -hashkit_create(), but instead of using default settings it will use +The \fBhashkit_clone()\fP function initializes a hashkit object much like +\fBhashkit_create()\fP, but instead of using default settings it will use the settings of the ptr hashkit object. .sp -The hashkit_free() frees any resources being consumed by the hashkit -objects that were initialized with hashkit_create() or hashkit_clone(). +The \fBhashkit_free()\fP frees any resources being consumed by the hashkit +objects that were initialized with \fBhashkit_create()\fP or \fBhashkit_clone()\fP. .sp -The hashkit_is_allocated() reports where the memory was allocated +The \fBhashkit_is_allocated()\fP reports where the memory was allocated for a hashkit object. .SH RETURN VALUE .sp -hashkit_create() and hashkit_clone() will return NULL on failure or -non\-NULL on success. +\fBhashkit_create()\fP and \fBhashkit_clone()\fP will return NULL on +failure or non\-NULL on success. .sp -hashkit_is_allocated() returns true if the memory for the hashkit -object was allocated inside of hashkit_create() or hashkit_clone(), -otherwise it is false and was user\-supplied memory. +\fBhashkit_is_allocated()\fP returns true if the memory for the hashkit +object was allocated inside of \fBhashkit_create()\fP or +\fBhashkit_clone()\fP, otherwise it is false and was user\-supplied memory. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP +.SH SEE ALSO +.sp +\fIhashkit_create(3)\fP \fIhashkit_value(3)\fP \fIhashkit_set_hash_fn(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/hashkit_fnv1_32.3 b/docs/man/hashkit_fnv1_32.3 index 0f1e641d..aabf1eda 100644 --- a/docs/man/hashkit_fnv1_32.3 +++ b/docs/man/hashkit_fnv1_32.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_FNV1_32" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "HASHKIT_FNV1_32" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME hashkit_fnv1_32 \- libhashkit Documentation . @@ -94,8 +94,7 @@ To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -hashkit_create(3) hashkit_value(3) hashkit_set_hash_fn(3) -hashkit_set_continuum_hash_fn(3) +\fIhashkit_create(3)\fP \fIhashkit_value(3)\fP \fIhashkit_set_hash_fn(3)\fP \fIhashkit_set_continuum_hash_fn(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/hashkit_fnv1_64.3 b/docs/man/hashkit_fnv1_64.3 index 87380b4d..cca4f6c9 100644 --- a/docs/man/hashkit_fnv1_64.3 +++ b/docs/man/hashkit_fnv1_64.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_FNV1_64" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "HASHKIT_FNV1_64" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME hashkit_fnv1_64 \- libhashkit Documentation . @@ -94,8 +94,7 @@ To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -hashkit_create(3) hashkit_value(3) hashkit_set_hash_fn(3) -hashkit_set_continuum_hash_fn(3) +\fIhashkit_create(3)\fP \fIhashkit_value(3)\fP \fIhashkit_set_hash_fn(3)\fP \fIhashkit_set_continuum_hash_fn(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/hashkit_fnv1a_32.3 b/docs/man/hashkit_fnv1a_32.3 index 383751af..1618d525 100644 --- a/docs/man/hashkit_fnv1a_32.3 +++ b/docs/man/hashkit_fnv1a_32.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_FNV1A_32" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "HASHKIT_FNV1A_32" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME hashkit_fnv1a_32 \- libhashkit Documentation . @@ -94,8 +94,7 @@ To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -hashkit_create(3) hashkit_value(3) hashkit_set_hash_fn(3) -hashkit_set_continuum_hash_fn(3) +\fIhashkit_create(3)\fP \fIhashkit_value(3)\fP \fIhashkit_set_hash_fn(3)\fP \fIhashkit_set_continuum_hash_fn(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/hashkit_fnv1a_64.3 b/docs/man/hashkit_fnv1a_64.3 index 7400c734..97f07be5 100644 --- a/docs/man/hashkit_fnv1a_64.3 +++ b/docs/man/hashkit_fnv1a_64.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_FNV1A_64" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "HASHKIT_FNV1A_64" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME hashkit_fnv1a_64 \- libhashkit Documentation . @@ -94,8 +94,7 @@ To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -hashkit_create(3) hashkit_value(3) hashkit_set_hash_fn(3) -hashkit_set_continuum_hash_fn(3) +\fIhashkit_create(3)\fP \fIhashkit_value(3)\fP \fIhashkit_set_hash_fn(3)\fP \fIhashkit_set_continuum_hash_fn(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/hashkit_free.3 b/docs/man/hashkit_free.3 index 9bac5315..2d1ebfb3 100644 --- a/docs/man/hashkit_free.3 +++ b/docs/man/hashkit_free.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_FREE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "HASHKIT_FREE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME hashkit_free \- libhashkit Documentation . @@ -35,6 +35,10 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP +.B hashkit_st +.UNINDENT +.INDENT 0.0 +.TP .B hashkit_st *hashkit_create(hashkit_st *hash); .UNINDENT .INDENT 0.0 @@ -53,32 +57,35 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lhashkit .SH DESCRIPTION .sp -The hashkit_create() function initializes a hashkit object for use. If +The \fBhashkit_create()\fP function initializes a hashkit object for use. If you pass a NULL argument for hash, then the memory for the object is allocated. If you specify a pre\-allocated piece of memory, that is initialized for use. .sp -The hashkit_clone() function initializes a hashkit object much like -hashkit_create(), but instead of using default settings it will use +The \fBhashkit_clone()\fP function initializes a hashkit object much like +\fBhashkit_create()\fP, but instead of using default settings it will use the settings of the ptr hashkit object. .sp -The hashkit_free() frees any resources being consumed by the hashkit -objects that were initialized with hashkit_create() or hashkit_clone(). +The \fBhashkit_free()\fP frees any resources being consumed by the hashkit +objects that were initialized with \fBhashkit_create()\fP or \fBhashkit_clone()\fP. .sp -The hashkit_is_allocated() reports where the memory was allocated +The \fBhashkit_is_allocated()\fP reports where the memory was allocated for a hashkit object. .SH RETURN VALUE .sp -hashkit_create() and hashkit_clone() will return NULL on failure or -non\-NULL on success. +\fBhashkit_create()\fP and \fBhashkit_clone()\fP will return NULL on +failure or non\-NULL on success. .sp -hashkit_is_allocated() returns true if the memory for the hashkit -object was allocated inside of hashkit_create() or hashkit_clone(), -otherwise it is false and was user\-supplied memory. +\fBhashkit_is_allocated()\fP returns true if the memory for the hashkit +object was allocated inside of \fBhashkit_create()\fP or +\fBhashkit_clone()\fP, otherwise it is false and was user\-supplied memory. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP +.SH SEE ALSO +.sp +\fIhashkit_create(3)\fP \fIhashkit_value(3)\fP \fIhashkit_set_hash_fn(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/hashkit_functions.3 b/docs/man/hashkit_functions.3 index 6273f95b..1702d03b 100644 --- a/docs/man/hashkit_functions.3 +++ b/docs/man/hashkit_functions.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_FUNCTIONS" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "HASHKIT_FUNCTIONS" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME hashkit_functions \- libhashkit Documentation . @@ -94,8 +94,7 @@ To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -hashkit_create(3) hashkit_value(3) hashkit_set_hash_fn(3) -hashkit_set_continuum_hash_fn(3) +\fIhashkit_create(3)\fP \fIhashkit_value(3)\fP \fIhashkit_set_hash_fn(3)\fP \fIhashkit_set_continuum_hash_fn(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/hashkit_hsieh.3 b/docs/man/hashkit_hsieh.3 index 867e56a5..aab83260 100644 --- a/docs/man/hashkit_hsieh.3 +++ b/docs/man/hashkit_hsieh.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_HSIEH" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "HASHKIT_HSIEH" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME hashkit_hsieh \- libhashkit Documentation . @@ -94,8 +94,7 @@ To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -hashkit_create(3) hashkit_value(3) hashkit_set_hash_fn(3) -hashkit_set_continuum_hash_fn(3) +\fIhashkit_create(3)\fP \fIhashkit_value(3)\fP \fIhashkit_set_hash_fn(3)\fP \fIhashkit_set_continuum_hash_fn(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/hashkit_is_allocated.3 b/docs/man/hashkit_is_allocated.3 index 71369d86..69c19e28 100644 --- a/docs/man/hashkit_is_allocated.3 +++ b/docs/man/hashkit_is_allocated.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_IS_ALLOCATED" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "HASHKIT_IS_ALLOCATED" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME hashkit_is_allocated \- libhashkit Documentation . @@ -35,6 +35,10 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP +.B hashkit_st +.UNINDENT +.INDENT 0.0 +.TP .B hashkit_st *hashkit_create(hashkit_st *hash); .UNINDENT .INDENT 0.0 @@ -53,32 +57,35 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lhashkit .SH DESCRIPTION .sp -The hashkit_create() function initializes a hashkit object for use. If +The \fBhashkit_create()\fP function initializes a hashkit object for use. If you pass a NULL argument for hash, then the memory for the object is allocated. If you specify a pre\-allocated piece of memory, that is initialized for use. .sp -The hashkit_clone() function initializes a hashkit object much like -hashkit_create(), but instead of using default settings it will use +The \fBhashkit_clone()\fP function initializes a hashkit object much like +\fBhashkit_create()\fP, but instead of using default settings it will use the settings of the ptr hashkit object. .sp -The hashkit_free() frees any resources being consumed by the hashkit -objects that were initialized with hashkit_create() or hashkit_clone(). +The \fBhashkit_free()\fP frees any resources being consumed by the hashkit +objects that were initialized with \fBhashkit_create()\fP or \fBhashkit_clone()\fP. .sp -The hashkit_is_allocated() reports where the memory was allocated +The \fBhashkit_is_allocated()\fP reports where the memory was allocated for a hashkit object. .SH RETURN VALUE .sp -hashkit_create() and hashkit_clone() will return NULL on failure or -non\-NULL on success. +\fBhashkit_create()\fP and \fBhashkit_clone()\fP will return NULL on +failure or non\-NULL on success. .sp -hashkit_is_allocated() returns true if the memory for the hashkit -object was allocated inside of hashkit_create() or hashkit_clone(), -otherwise it is false and was user\-supplied memory. +\fBhashkit_is_allocated()\fP returns true if the memory for the hashkit +object was allocated inside of \fBhashkit_create()\fP or +\fBhashkit_clone()\fP, otherwise it is false and was user\-supplied memory. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP +.SH SEE ALSO +.sp +\fIhashkit_create(3)\fP \fIhashkit_value(3)\fP \fIhashkit_set_hash_fn(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/hashkit_jenkins.3 b/docs/man/hashkit_jenkins.3 index 0d298747..41c55d4b 100644 --- a/docs/man/hashkit_jenkins.3 +++ b/docs/man/hashkit_jenkins.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_JENKINS" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "HASHKIT_JENKINS" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME hashkit_jenkins \- libhashkit Documentation . @@ -94,8 +94,7 @@ To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -hashkit_create(3) hashkit_value(3) hashkit_set_hash_fn(3) -hashkit_set_continuum_hash_fn(3) +\fIhashkit_create(3)\fP \fIhashkit_value(3)\fP \fIhashkit_set_hash_fn(3)\fP \fIhashkit_set_continuum_hash_fn(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/hashkit_md5.3 b/docs/man/hashkit_md5.3 index aca3001c..7debe441 100644 --- a/docs/man/hashkit_md5.3 +++ b/docs/man/hashkit_md5.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_MD5" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "HASHKIT_MD5" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME hashkit_md5 \- libhashkit Documentation . @@ -94,8 +94,7 @@ To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -hashkit_create(3) hashkit_value(3) hashkit_set_hash_fn(3) -hashkit_set_continuum_hash_fn(3) +\fIhashkit_create(3)\fP \fIhashkit_value(3)\fP \fIhashkit_set_hash_fn(3)\fP \fIhashkit_set_continuum_hash_fn(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/hashkit_murmur.3 b/docs/man/hashkit_murmur.3 index d29b4ccb..16ebc9f9 100644 --- a/docs/man/hashkit_murmur.3 +++ b/docs/man/hashkit_murmur.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_MURMUR" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "HASHKIT_MURMUR" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME hashkit_murmur \- libhashkit Documentation . @@ -94,8 +94,7 @@ To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -hashkit_create(3) hashkit_value(3) hashkit_set_hash_fn(3) -hashkit_set_continuum_hash_fn(3) +\fIhashkit_create(3)\fP \fIhashkit_value(3)\fP \fIhashkit_set_hash_fn(3)\fP \fIhashkit_set_continuum_hash_fn(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/hashkit_value.3 b/docs/man/hashkit_value.3 index a514ef18..c9c65766 100644 --- a/docs/man/hashkit_value.3 +++ b/docs/man/hashkit_value.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_VALUE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "HASHKIT_VALUE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME hashkit_value \- libhashkit Documentation . @@ -43,7 +43,7 @@ Generate a value for the given key Compile and link with \-lhashkit .SH DESCRIPTION .sp -The hashkit_value() function generates a 32\-bit hash value from the +The \fBhashkit_value()\fP function generates a 32\-bit hash value from the given key and key_length. The hash argument is an initialized hashkit object, and distribution type and hash function is used from this object while generating the value. @@ -56,7 +56,7 @@ To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -hashkit_create(3) hashkit_set_distribution(3) hashkit_set_hash_fn(3) +\fIhashkit_create(3)\fP \fIhashkit_set_distribution(3)\fP \fIhashkit_set_hash_fn(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/libhashkit.3 b/docs/man/libhashkit.3 index 2b2f6f00..01c25dc3 100644 --- a/docs/man/libhashkit.3 +++ b/docs/man/libhashkit.3 @@ -1,4 +1,4 @@ -.TH "LIBHASHKIT" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "LIBHASHKIT" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME libhashkit \- libhashkit Documentation . @@ -40,7 +40,7 @@ cc [ flag ... ] file ... \-lhashkit .fi .SH DESCRIPTION .sp -\fBlibhashkit\fP is a small and thread\-safe client library that provides a collection of useful hashing algorithm. libhashkit is distributed with libmemcached. +libhashkit is a small and thread\-safe client library that provides a collection of useful hashing algorithm. libhashkit is distributed with libmemcached. .SH HOME .sp To find out more information please check: diff --git a/docs/man/libmemcached.3 b/docs/man/libmemcached.3 index e0334668..a0538277 100644 --- a/docs/man/libmemcached.3 +++ b/docs/man/libmemcached.3 @@ -1,4 +1,4 @@ -.TH "LIBMEMCACHED" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "LIBMEMCACHED" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME libmemcached \- Introducing the C Client Library for memcached . @@ -35,6 +35,13 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .sp Compile and link with \-lmemcached + +.sp +.ce +---- + +.ce 0 +.sp .sp libMemcached is an open source C/C++ client library and tools for the memcached server (\fI\%http://danga.com/memcached\fP). It has been designed to be light on memory usage, thread safe, and provide full access to server side methods. .sp @@ -76,16 +83,17 @@ matched based on server order as supplied by the user). It implements a modular and consistent method of object distribution. .sp There are multiple implemented routing and hashing methods. See the -memcached_behavior_set() manpage for more information. +\fBmemcached_behavior_set()\fP manpage for more information. .sp All operations are performed against a \fBmemcached_st\fP structure. These structures can either be dynamically allocated or statically -allocated and then initialized by memcached_create(). Functions have been -written in order to encapsulate the \fBmemcached_st\fP. It is not +allocated and then initialized by \fBmemcached_create()\fP. Functions have +been written in order to encapsulate the \fBmemcached_st\fP. It is not recommended that you operate directly against the structure. .sp Nearly all functions return a \fBmemcached_return_t\fP value. -This value can be translated to a printable string with memcached_strerror(3). +This value can be translated to a printable string with +\fBmemcached_strerror()\fP. .sp Objects are stored on servers by hashing keys. The hash value maps the key to a particular server. All clients understand how this hashing works, so it is possibly to reliably both push data to a server and retrieve data from a server. .sp @@ -105,7 +113,7 @@ PKG_CHECK_MODULES(DEPS, libmemcached >= 0.8.0) AC_SUBST(DEPS_CFLAGS) AC_SUBST(DEPS_LIBS) .sp -Some features of the library must be enabled through memcached_behavior_set(). +Some features of the library must be enabled through \fBmemcached_behavior_set()\fP. .sp Hope you enjoy it! .SH CONSTANTS @@ -157,10 +165,9 @@ Hex value of the version number. "0x00048000" This can be used for comparing ver .SH THREADS AND PROCESSES .sp When using threads or forked processes it is important to keep one instance -of \fBmemcached_st\fP per process or thread. Without creating your own locking -structures you can not share a single \fBmemcached_st\fP. However, you can call -memcached_quit(3) on a \fBmemcached_st\fP and then use the resulting cloned -structure. +of \fBmemcached_st\fP per process or thread. Without creating your own +locking structures you can not share a single \fBmemcached_st\fP. However, +you can call \fBmemcached_quit()\fP on a \fBmemcached_st\fP and then use the resulting cloned structure. .SH HOME .sp To find out more information please check: diff --git a/docs/man/libmemcached_check_configuration.3 b/docs/man/libmemcached_check_configuration.3 index 76f1a3bb..7363f94a 100644 --- a/docs/man/libmemcached_check_configuration.3 +++ b/docs/man/libmemcached_check_configuration.3 @@ -1,4 +1,4 @@ -.TH "LIBMEMCACHED_CHECK_CONFIGURATION" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "LIBMEMCACHED_CHECK_CONFIGURATION" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME libmemcached_check_configuration \- libmemcached Documentation . @@ -46,7 +46,7 @@ Compile and link with \-lmemcached .SH DESCRIPTION .sp Libmemcached implements a custom language for configuring and modifying -servers. By passing in an option string you can generate a memcached_st object +servers. By passing in an option string you can generate a \fBmemcached_st\fP object that you can use in your application directly. .INDENT 0.0 .TP @@ -56,6 +56,12 @@ that you can use in your application directly. Provide a servername to be used by the client. Providing a weight will cause weighting to occur with all hosts with each server getting a default weight of 1. .INDENT 0.0 .TP +.B \-\-SOCKET=/? +.UNINDENT +.sp +Provide a filepath to a UNIX socket file. Providing a weight will cause weighting to occur with all hosts with each server getting a default weight of 1. +.INDENT 0.0 +.TP .B \-\-VERIFY\-KEY .UNINDENT .sp @@ -263,7 +269,7 @@ End configutation processing. End configutation processing and throw an error. .SH RETURN .sp -memcached() returns a pointer to the memcached_st that was +\fI\%memcached()\fP returns a pointer to the memcached_st that was created (or initialized). On an allocation failure, it returns NULL. .SH EXAMPLE .sp diff --git a/docs/man/libmemcached_configuration.3 b/docs/man/libmemcached_configuration.3 index 2e2f6c00..ed59efd0 100644 --- a/docs/man/libmemcached_configuration.3 +++ b/docs/man/libmemcached_configuration.3 @@ -1,4 +1,4 @@ -.TH "LIBMEMCACHED_CONFIGURATION" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "LIBMEMCACHED_CONFIGURATION" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME libmemcached_configuration \- libmemcached Documentation . @@ -46,7 +46,7 @@ Compile and link with \-lmemcached .SH DESCRIPTION .sp Libmemcached implements a custom language for configuring and modifying -servers. By passing in an option string you can generate a memcached_st object +servers. By passing in an option string you can generate a \fBmemcached_st\fP object that you can use in your application directly. .INDENT 0.0 .TP @@ -56,6 +56,12 @@ that you can use in your application directly. Provide a servername to be used by the client. Providing a weight will cause weighting to occur with all hosts with each server getting a default weight of 1. .INDENT 0.0 .TP +.B \-\-SOCKET=/? +.UNINDENT +.sp +Provide a filepath to a UNIX socket file. Providing a weight will cause weighting to occur with all hosts with each server getting a default weight of 1. +.INDENT 0.0 +.TP .B \-\-VERIFY\-KEY .UNINDENT .sp @@ -263,7 +269,7 @@ End configutation processing. End configutation processing and throw an error. .SH RETURN .sp -memcached() returns a pointer to the memcached_st that was +\fI\%memcached()\fP returns a pointer to the memcached_st that was created (or initialized). On an allocation failure, it returns NULL. .SH EXAMPLE .sp diff --git a/docs/man/libmemcached_examples.3 b/docs/man/libmemcached_examples.3 index 30d48097..0f69f8a9 100644 --- a/docs/man/libmemcached_examples.3 +++ b/docs/man/libmemcached_examples.3 @@ -1,4 +1,4 @@ -.TH "LIBMEMCACHED_EXAMPLES" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "LIBMEMCACHED_EXAMPLES" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME libmemcached_examples \- libmemcached Documentation . @@ -44,17 +44,26 @@ the library. const char *config_string= "\-\-SERVER=host10.example.com \-\-SERVER=host11.example.com \-\-SERVER=host10.example.com" memcached_st *memc= memcached(config_string, strlen(config_string); { - ... +\&... } -memcached_free(memc); + memcached_free(memc); .ft P .fi .sp -In the above code you create a \fBmemcached_st\fP object with three server by making use of \fImemcached_create_with_options(3)\fP. +In the above code you create a \fBmemcached_st\fP object with three server +by making use of \fBmemcached_create_with_options()\fP. .SH CREATING A POOL OF SERVERS .sp .nf .ft C + +.ft P +.fi +.sp +Creating a pool of Servers: +.sp +.nf +.ft C const char *config_string= "\-\-SERVER=host10.example.com \-\-SERVER=host11.example.com \-\-SERVER=host10.example.com"; memcached_pool_st* pool= memcached_pool(config_string, strlen(config_string)); @@ -78,14 +87,22 @@ memcached_pool_destroy(pool); .fi .sp In the above code you create a \fBmemcached_pool_st\fP object with three -server by making use of \fImemcached_pool(3)\fP. +server by making use of \fBmemcached_pool()\fP. .sp -When memcached_pool_destroy() all memory will be released that is associated +When \fBmemcached_pool_destroy()\fP all memory will be released that is associated with the pool. .SH ADDING A VALUE TO THE SERVER .sp .nf .ft C + +.ft P +.fi +.sp +Adding a value to the Server: +.sp +.nf +.ft C char *key= "foo"; char *value= "value"; diff --git a/docs/man/libmemcachedutil.3 b/docs/man/libmemcachedutil.3 index 68277933..07f5bdcb 100644 --- a/docs/man/libmemcachedutil.3 +++ b/docs/man/libmemcachedutil.3 @@ -1,4 +1,4 @@ -.TH "LIBMEMCACHEDUTIL" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "LIBMEMCACHEDUTIL" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME libmemcachedutil \- libmemcached Documentation . @@ -43,22 +43,21 @@ cc [ flag ... ] file ... \-lmemcachedutil .fi .SH DESCRIPTION .sp -\fBlibmemcachedutil\fP is a small and thread\-safe client library that provides -extra functionality built on top of \fBlibmemcached\fP. +\fBlibmemcachedutil\fP is a small and thread\-safe client library that +provides extra functionality built on top of \fBlibmemcached\fP. .SH THREADS .sp Do not try to access an instance of \fBmemcached_st\fP from multiple threads at the same time. If you want to access memcached from multiple threads you should either clone the \fBmemcached_st\fP, or use the memcached pool -implementation. see memcached_pool_create(3). +implementation. see \fBmemcached_pool_create()\fP. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -\fIlibmemcached(3)\fP -\fImemcached_pool_create(3)\fP \fImemcached_pool_destroy(3)\fP \fImemcached_pool_pop(3)\fP \fImemcached_pool_push(3)\fP +\fIlibmemcached(3)\fP \fImemcached_pool_create(3)\fP \fImemcached_pool_destroy(3)\fP \fImemcached_pool_pop(3)\fP \fImemcached_pool_push(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memaslap.1 b/docs/man/memaslap.1 index 81d9e2f6..7672fbb9 100644 --- a/docs/man/memaslap.1 +++ b/docs/man/memaslap.1 @@ -1,4 +1,4 @@ -.TH "MEMASLAP" "1" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMASLAP" "1" "July 21, 2011" "0.51" "libmemcached" .SH NAME memaslap \- libmemcached Documentation . @@ -32,27 +32,27 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] . .SH SYNOPSIS .sp -:program:: \fImemaslap\fP +memaslap [options] .INDENT 0.0 .TP .B \-\-help .UNINDENT .SH DESCRIPTION .sp -\fBmemaslap\fP is a load generation and benchmark tool for memcached(1) -servers. It generates configurable workload such as threads, concurrencies, connections, -run time, overwrite, miss rate, key size, value size, get/set proportion, -expected throughput, and so on. Furthermore, it also testss data +\fBmemaslap\fP is a load generation and benchmark tool for memcached +servers. It generates configurable workload such as threads, concurrencies, +connections, run time, overwrite, miss rate, key size, value size, get/set +proportion, expected throughput, and so on. Furthermore, it also testss data verification, expire\-time verification, UDP, binary protocol, facebook test, replication test, multi\-get and reconnection, etc. .sp -Memslap manages network connections like memcached with +Memaslap manages network connections like memcached with libevent. Each thread of memaslap is bound with a CPU core, all the threads don\(aqt communicate with each other, and there are several socket connections in each thread. Each connection keeps key size distribution, value size distribution, and command distribution by itself. .sp -You can specify servers via the \fB\-\-servers\fP option or via the +You can specify servers via the \fI\-\-servers\fP option or via the environment variable \fBMEMCACHED_SERVERS\fP. .SH FEATURES .sp @@ -163,9 +163,9 @@ layer. .sp Because each thread is self\-governed, memaslap can assign different threads to handle different memcached servers. This is just one of -the ways in which memaslap testss multiple servers. The only +the ways in which memaslap tests multiple servers. The only limitation is that the number of servers cannot be greater than the number -of threads. The other way to tests multiple servers is for replication +of threads. The other way to test multiple servers is for replication test. Each concurrency has one socket connection to each memcached server. For the implementation, memaslap can set some objects to one memcached server, and get these objects from the other servers. @@ -177,7 +177,7 @@ pack and send the commands together. Memslap testss both the ASCII protocol and binary protocol, but it runs on the ASCII protocol by default. Memslap by default runs on the TCP protocol, but it also -testss UDP. Because UDP is unreliable, dropped packages and out\-of\-order +tests UDP. Because UDP is unreliable, dropped packages and out\-of\-order packages may occur. Memslap creates a memory buffer to handle these problems. Memslap tries to read all the response data of one command from the server and reorders the response data. If some packages @@ -255,7 +255,7 @@ number of them. The default number of threads is 1; the default number of concurrency is 16. The user can use “—threads” and “\-\-concurrency” to specify these variables. .sp -If the system testss setting CPU affinity and the number of threads +If the system tests setting CPU affinity and the number of threads specified by the user is greater than 1, memaslap will try to bind each thread to a different CPU core. So if you want to get the best performance memaslap, it is better to specify the number of diff --git a/docs/man/memcached.3 b/docs/man/memcached.3 index 69e8bde4..f17a1720 100644 --- a/docs/man/memcached.3 +++ b/docs/man/memcached.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached \- libmemcached Documentation . @@ -46,7 +46,7 @@ Compile and link with \-lmemcached .SH DESCRIPTION .sp Libmemcached implements a custom language for configuring and modifying -servers. By passing in an option string you can generate a memcached_st object +servers. By passing in an option string you can generate a \fBmemcached_st\fP object that you can use in your application directly. .INDENT 0.0 .TP @@ -56,6 +56,12 @@ that you can use in your application directly. Provide a servername to be used by the client. Providing a weight will cause weighting to occur with all hosts with each server getting a default weight of 1. .INDENT 0.0 .TP +.B \-\-SOCKET=/? +.UNINDENT +.sp +Provide a filepath to a UNIX socket file. Providing a weight will cause weighting to occur with all hosts with each server getting a default weight of 1. +.INDENT 0.0 +.TP .B \-\-VERIFY\-KEY .UNINDENT .sp @@ -263,7 +269,7 @@ End configutation processing. End configutation processing and throw an error. .SH RETURN .sp -memcached() returns a pointer to the memcached_st that was +\fI\%memcached()\fP returns a pointer to the memcached_st that was created (or initialized). On an allocation failure, it returns NULL. .SH EXAMPLE .sp diff --git a/docs/man/memcached_add.3 b/docs/man/memcached_add.3 index b872cbbd..cae8e9a7 100644 --- a/docs/man/memcached_add.3 +++ b/docs/man/memcached_add.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_ADD" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_ADD" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_add \- Storing and Replacing Data . @@ -61,68 +61,57 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_set(), memcached_add(), and memcached_replace() are all used to -store information on the server. All methods take a key, and its length to -store the object. Keys are currently limited to 250 characters when using either a version of memcached(1) which is 1.4 or below, or when using the text protocol. -You must supply both a value and a length. Optionally you -may test an expiration time for the object and a 16 byte value (it is -meant to be used as a bitmap). "flags" is a 4byte space that is stored alongside of the main value. Many sub libraries make use of this field, so in most cases users should avoid making use of it. +\fBmemcached_set()\fP, \fBmemcached_add()\fP, and \fBmemcached_replace()\fP are all used to store information on the server. All methods take a key, and its length to store the object. Keys are currently limited to 250 characters when using either a version of memcached(1) which is 1.4 or below, or when using the text protocol. You must supply both a value and a length. Optionally you +store the object. Keys are currently limited to 250 characters by the +memcached(1) server. You must supply both a value and a length. Optionally you +may test an expiration time for the object and a 16 byte value (it is meant to be used as a bitmap). "flags" is a 4byte space that is stored alongside of the main value. Many sub libraries make use of this field, so in most cases users should avoid making use of it. .sp -memcached_set() will write an object to the server. If an object already -exists it will overwrite what is in the server. If the object does not exist -it will be written. If you are using the non\-blocking mode this function +\fBmemcached_set()\fP will write an object to the server. If an object +already exists it will overwrite what is in the server. If the object does not +exist it will be written. If you are using the non\-blocking mode this function will always return true unless a network error occurs. .sp -memcached_replace() replaces an object on the server. If the object is not -found on the server an error occurs. +\fBmemcached_replace()\fP replaces an object on the server. If the object is not found on the server an error occurs. .sp -memcached_add() adds an object to the server. If the object is found on the -server an error occurs, otherwise the value is stored. +\fBmemcached_add()\fP adds an object to the server. If the object is found on the server an error occurs, otherwise the value is stored. .sp -memcached_cas() overwrites data in the server as long as the "cas" value is -still the same in the server. You can get the cas value of a result by -calling memcached_result_cas() on a memcached_result_st(3) structure. At the point +\fBmemcached_cas()\fP overwrites data in the server as long as the "cas" +value is still the same in the server. You can get the cas value of a result by +calling \fBmemcached_result_cas()\fP on a memcached_result_st(3) structure. At the point that this note was written cas is still buggy in memached. Turning on tests for it in libmemcached(3) is optional. Please see memcached_set() for information on how to do this. .sp -memcached_set_by_key(), memcached_add_by_key(), and memcached_replace_by_key() -methods all behave in a similar method as the non key -methods. The difference is that they use their group_key parameter to map +\fBmemcached_set_by_key()\fP, \fBmemcached_add_by_key()\fP, and \fBmemcached_replace_by_key()\fP methods all behave in a similar method as the non +key methods. The difference is that they use their group_key parameter to map objects to particular servers. .sp -If you are looking for performance, memcached_set() with non\-blocking IO is -the fastest way to store data on the server. +If you are looking for performance, \fBmemcached_set()\fP with non\-blocking IO is the fastest way to store data on the server. .sp -All of the above functions are testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPbehavior enabled. However, when using these operations with this behavior on, there -are limits to the size of the payload being sent to the server. The reason for -these limits is that the Memcached Server does not allow multi\-datagram requests -and the current server implementation sets a datagram size to 1400 bytes. Due -to protocol overhead, the actual limit of the user supplied data is less than -1400 bytes and depends on the protocol in use as, well as the operation being -executed. When running with the binary protocol, \(ga\(ga MEMCACHED_BEHAVIOR_BINARY_PROTOCOL\(ga\(ga, -the size of the key,value, flags and expiry combined may not exceed 1368 bytes. -When running with the ASCII protocol, the exact limit fluctuates depending on -which function is being executed and whether the function is a cas operation -or not. For non\-cas ASCII set operations, there are at least 1335 bytes available -to split among the key, key_prefix, and value; for cas ASCII operations there are -at least 1318 bytes available to split among the key, key_prefix and value. If the -total size of the command, including overhead, exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fPwill be returned. +All of the above functions are testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior enabled. However, when using these operations with this behavior +on, there are limits to the size of the payload being sent to the server. +The reason for these limits is that the Memcached Server does not allow +multi\-datagram requests and the current server implementation sets a datagram +size to 1400 bytes. Due to protocol overhead, the actual limit of the user supplied data is less than 1400 bytes and depends on the protocol in use as, well as the operation being +executed. When running with the binary protocol, \fBMEMCACHED_BEHAVIOR_BINARY_PROTOCOL\fP, the size of the key,value, flags and expiry combined may not +exceed 1368 bytes. When running with the ASCII protocol, the exact limit fluctuates depending on which function is being executed and whether the function is a cas operation or not. For non\-cas ASCII set operations, there are at least +1335 bytes available to split among the key, key_prefix, and value; for cas +ASCII operations there are at least 1318 bytes available to split among the key, key_prefix and value. If the total size of the command, including overhead, +exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fP will be returned. .SH RETURN .sp All methods return a value of type \fBmemcached_return_t\fP. On success the value will be \fBMEMCACHED_SUCCESS\fP. -Use memcached_strerror() to translate this value to a printable string. +Use \fBmemcached_strerror()\fP to translate this value to a printable string. .sp -For memcached_replace() and memcached_add(), \fBMEMCACHED_NOTSTORED\fP is a -legitmate error in the case of a collision. +For \fBmemcached_replace()\fP and \fBmemcached_add()\fP, \fBMEMCACHED_NOTSTORED\fP is a legitmate error in the case of a collision. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemached(3) memcached_strerror(3) memcached_prepend(3) memcached_cas(3) memcached_append(3) +\fImemcached(1)\fP \fIlibmemached(3)\fP \fImemcached_strerror(3)\fP \fImemcached_prepend(3)\fP \fImemcached_cas(3)\fP \fImemcached_append(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_add_by_key.3 b/docs/man/memcached_add_by_key.3 index f0d62d45..32c9d737 100644 --- a/docs/man/memcached_add_by_key.3 +++ b/docs/man/memcached_add_by_key.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_ADD_BY_KEY" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_ADD_BY_KEY" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_add_by_key \- Storing and Replacing Data . @@ -61,68 +61,57 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_set(), memcached_add(), and memcached_replace() are all used to -store information on the server. All methods take a key, and its length to -store the object. Keys are currently limited to 250 characters when using either a version of memcached(1) which is 1.4 or below, or when using the text protocol. -You must supply both a value and a length. Optionally you -may test an expiration time for the object and a 16 byte value (it is -meant to be used as a bitmap). "flags" is a 4byte space that is stored alongside of the main value. Many sub libraries make use of this field, so in most cases users should avoid making use of it. +\fBmemcached_set()\fP, \fBmemcached_add()\fP, and \fBmemcached_replace()\fP are all used to store information on the server. All methods take a key, and its length to store the object. Keys are currently limited to 250 characters when using either a version of memcached(1) which is 1.4 or below, or when using the text protocol. You must supply both a value and a length. Optionally you +store the object. Keys are currently limited to 250 characters by the +memcached(1) server. You must supply both a value and a length. Optionally you +may test an expiration time for the object and a 16 byte value (it is meant to be used as a bitmap). "flags" is a 4byte space that is stored alongside of the main value. Many sub libraries make use of this field, so in most cases users should avoid making use of it. .sp -memcached_set() will write an object to the server. If an object already -exists it will overwrite what is in the server. If the object does not exist -it will be written. If you are using the non\-blocking mode this function +\fBmemcached_set()\fP will write an object to the server. If an object +already exists it will overwrite what is in the server. If the object does not +exist it will be written. If you are using the non\-blocking mode this function will always return true unless a network error occurs. .sp -memcached_replace() replaces an object on the server. If the object is not -found on the server an error occurs. +\fBmemcached_replace()\fP replaces an object on the server. If the object is not found on the server an error occurs. .sp -memcached_add() adds an object to the server. If the object is found on the -server an error occurs, otherwise the value is stored. +\fBmemcached_add()\fP adds an object to the server. If the object is found on the server an error occurs, otherwise the value is stored. .sp -memcached_cas() overwrites data in the server as long as the "cas" value is -still the same in the server. You can get the cas value of a result by -calling memcached_result_cas() on a memcached_result_st(3) structure. At the point +\fBmemcached_cas()\fP overwrites data in the server as long as the "cas" +value is still the same in the server. You can get the cas value of a result by +calling \fBmemcached_result_cas()\fP on a memcached_result_st(3) structure. At the point that this note was written cas is still buggy in memached. Turning on tests for it in libmemcached(3) is optional. Please see memcached_set() for information on how to do this. .sp -memcached_set_by_key(), memcached_add_by_key(), and memcached_replace_by_key() -methods all behave in a similar method as the non key -methods. The difference is that they use their group_key parameter to map +\fBmemcached_set_by_key()\fP, \fBmemcached_add_by_key()\fP, and \fBmemcached_replace_by_key()\fP methods all behave in a similar method as the non +key methods. The difference is that they use their group_key parameter to map objects to particular servers. .sp -If you are looking for performance, memcached_set() with non\-blocking IO is -the fastest way to store data on the server. +If you are looking for performance, \fBmemcached_set()\fP with non\-blocking IO is the fastest way to store data on the server. .sp -All of the above functions are testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPbehavior enabled. However, when using these operations with this behavior on, there -are limits to the size of the payload being sent to the server. The reason for -these limits is that the Memcached Server does not allow multi\-datagram requests -and the current server implementation sets a datagram size to 1400 bytes. Due -to protocol overhead, the actual limit of the user supplied data is less than -1400 bytes and depends on the protocol in use as, well as the operation being -executed. When running with the binary protocol, \(ga\(ga MEMCACHED_BEHAVIOR_BINARY_PROTOCOL\(ga\(ga, -the size of the key,value, flags and expiry combined may not exceed 1368 bytes. -When running with the ASCII protocol, the exact limit fluctuates depending on -which function is being executed and whether the function is a cas operation -or not. For non\-cas ASCII set operations, there are at least 1335 bytes available -to split among the key, key_prefix, and value; for cas ASCII operations there are -at least 1318 bytes available to split among the key, key_prefix and value. If the -total size of the command, including overhead, exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fPwill be returned. +All of the above functions are testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior enabled. However, when using these operations with this behavior +on, there are limits to the size of the payload being sent to the server. +The reason for these limits is that the Memcached Server does not allow +multi\-datagram requests and the current server implementation sets a datagram +size to 1400 bytes. Due to protocol overhead, the actual limit of the user supplied data is less than 1400 bytes and depends on the protocol in use as, well as the operation being +executed. When running with the binary protocol, \fBMEMCACHED_BEHAVIOR_BINARY_PROTOCOL\fP, the size of the key,value, flags and expiry combined may not +exceed 1368 bytes. When running with the ASCII protocol, the exact limit fluctuates depending on which function is being executed and whether the function is a cas operation or not. For non\-cas ASCII set operations, there are at least +1335 bytes available to split among the key, key_prefix, and value; for cas +ASCII operations there are at least 1318 bytes available to split among the key, key_prefix and value. If the total size of the command, including overhead, +exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fP will be returned. .SH RETURN .sp All methods return a value of type \fBmemcached_return_t\fP. On success the value will be \fBMEMCACHED_SUCCESS\fP. -Use memcached_strerror() to translate this value to a printable string. +Use \fBmemcached_strerror()\fP to translate this value to a printable string. .sp -For memcached_replace() and memcached_add(), \fBMEMCACHED_NOTSTORED\fP is a -legitmate error in the case of a collision. +For \fBmemcached_replace()\fP and \fBmemcached_add()\fP, \fBMEMCACHED_NOTSTORED\fP is a legitmate error in the case of a collision. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemached(3) memcached_strerror(3) memcached_prepend(3) memcached_cas(3) memcached_append(3) +\fImemcached(1)\fP \fIlibmemached(3)\fP \fImemcached_strerror(3)\fP \fImemcached_prepend(3)\fP \fImemcached_cas(3)\fP \fImemcached_append(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_analyze.3 b/docs/man/memcached_analyze.3 index 24954b38..f6cb2285 100644 --- a/docs/man/memcached_analyze.3 +++ b/docs/man/memcached_analyze.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_ANALYZE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_ANALYZE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_analyze \- libmemcached Documentation . @@ -43,21 +43,21 @@ Analyze server information Compile and link with \-lmemcached .SH DESCRIPTION .sp -libmemcached(3) has the ability to query a memcached server (or collection -of servers) for their current state. Queries to find state return a +\fBlibmemcached\fP has the ability to query a memcached server (or +collection of servers) for their current state. Queries to find state return a \fBmemcached_analysis_st\fP structure. You are responsible for freeing this structure. .sp -memcached_analyze() analyzes useful information based on the provided servers -and sets the result to the \fBmemcached_analysis_st\fP structure. The return value -must be freed by the calling application. +\fBmemcached_analyze()\fP analyzes useful information based on the +provided servers and sets the result to the \fBmemcached_analysis_st\fP +structure. The return value must be freed by the calling application. .sp -A command line tool, memstat(1) with the option \-\-analyze, is provided so that -you do not have to write an application to use this method. +A command line tool, \fBmemstat()\fP with the option \fI\-\-analyze\fP, +is provided so that you do not have to write an application to use this method. .SH RETURN .sp -A pointer to the allocated \fBmemcached_analysis_st\fP structure on success and -a NULL pointer on failure. You may inspect the error detail by checking the -\fBmemcached_return_t\fP value. +A pointer to the allocated \fBmemcached_analysis_st\fP structure on +success and a NULL pointer on failure. You may inspect the error detail by +checking the \fBmemcached_return_t\fP value. .sp Any method returning a \fBmemcached_analysis_st\fP expects you to free the memory allocated for it. diff --git a/docs/man/memcached_append.3 b/docs/man/memcached_append.3 index 10d0e6f1..7f013f3b 100644 --- a/docs/man/memcached_append.3 +++ b/docs/man/memcached_append.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_APPEND" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_APPEND" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_append \- Appending to or Prepending to data on the server . @@ -55,53 +55,61 @@ Appending or Prepending to data on the server Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_prepend() and memcached_append are used to +\fI\%memcached_prepend()\fP and memcached_append are used to modify information on a server. All methods take a key, and its length to -store the object. Keys are currently limited to 250 characters when using either a version of memcached(1) which is 1.4 or below, or when using the text protocol. -You must supply both a value and a length. Optionally you +store the object. Keys are currently limited to 250 characters when using +either a version of memcached which is 1.4 or below, or when using the text +protocol. You must supply both a value and a length. Optionally you may test an expiration time for the object and a 16 byte value (it is -meant to be used as a bitmap). "flags" is a 4byte space that is stored alongside of the main value. Many sub libraries make use of this field, so in most cases users should avoid making use of it. +meant to be used as a bitmap). "flags" is a 4byte space that is stored +alongside of the main value. Many sub libraries make use of this field, +so in most cases users should avoid making use of it. .sp -memcached_prepend() places a segment of data before the last piece of data -stored. Currently expiration and key are not used in the server. +\fI\%memcached_prepend()\fP places a segment of data before the last piece +of data stored. Currently expiration and key are not used in the server. .sp -memcached_append() places a segment of data at the end of the last piece of -data stored. Currently expiration and key are not used in the server. +\fI\%memcached_append()\fP places a segment of data at the end of the last +piece of data stored. Currently expiration and key are not used in the server. .sp -memcached_prepend_by_key() and memcached_append_by_key_by_key(, -methods both behave in a similar method as the non key -methods. The difference is that they use their group_key parameter to map -objects to particular servers. +\fBmemcached_prepend_by_key()\fP and +\fBmemcached_append_by_key_by_key()\fP methods both behave in a similar +method as the non key methods. The difference is that they use their +group_key parameter to map objects to particular servers. .sp -If you are looking for performance, memcached_set() with non\-blocking IO is -the fastest way to store data on the server. +If you are looking for performance, \fBmemcached_set()\fP with non\-blocking +IO is the fastest way to store data on the server. .sp -All of the above functions are testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPbehavior enabled. However, when using these operations with this behavior on, there -are limits to the size of the payload being sent to the server. The reason for -these limits is that the Memcached Server does not allow multi\-datagram requests +All of the above functions are testsed with the +\fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior enabled. However, when using +these operations with this behavior on, there are limits to the size of the +payload being sent to the server. The reason for these limits is that the +Memcached Server does not allow multi\-datagram requests and the current server implementation sets a datagram size to 1400 bytes. Due to protocol overhead, the actual limit of the user supplied data is less than 1400 bytes and depends on the protocol in use as, well as the operation being -executed. When running with the binary protocol, \(ga\(ga MEMCACHED_BEHAVIOR_BINARY_PROTOCOL\(ga\(ga, -the size of the key,value, flags and expiry combined may not exceed 1368 bytes. -When running with the ASCII protocol, the exact limit fluctuates depending on -which function is being executed and whether the function is a cas operation -or not. For non\-cas ASCII set operations, there are at least 1335 bytes available -to split among the key, key_prefix, and value; for cas ASCII operations there are -at least 1318 bytes available to split among the key, key_prefix and value. If the -total size of the command, including overhead, exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fPwill be returned. +executed. When running with the binary protocol, +\fBMEMCACHED_BEHAVIOR_BINARY_PROTOCOL\fP, the size of the key,value, +flags and expiry combined may not exceed 1368 bytes. When running with the +ASCII protocol, the exact limit fluctuates depending on which function is +being executed and whether the function is a cas operation or not. For +non\-cas ASCII set operations, there are at least 1335 bytes available +to split among the key, key_prefix, and value; for cas ASCII operations +there are at least 1318 bytes available to split among the key, key_prefix +and value. If the total size of the command, including overhead, exceeds +1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fP will be returned. .SH RETURN .sp All methods return a value of type \fBmemcached_return_t\fP. On success the value will be \fBMEMCACHED_SUCCESS\fP. -Use memcached_strerror() to translate this value to a printable string. +Use \fBmemcached_strerror()\fP to translate this value to a printable +string. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemached(3) memcached_strerror(3) memcached_set(3) memcached_add(3) memcached_cas(3) memcached_replace(3) +\fImemcached(1)\fP \fIlibmemached(3)\fP \fImemcached_strerror(3)\fP \fImemcached_set(3)\fP \fImemcached_add(3)\fP \fImemcached_cas(3)\fP \fImemcached_replace(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_append_by_key.3 b/docs/man/memcached_append_by_key.3 index a6489868..8edb875c 100644 --- a/docs/man/memcached_append_by_key.3 +++ b/docs/man/memcached_append_by_key.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_APPEND_BY_KEY" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_APPEND_BY_KEY" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_append_by_key \- Appending to or Prepending to data on the server . @@ -55,53 +55,61 @@ Appending or Prepending to data on the server Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_prepend() and memcached_append are used to +\fI\%memcached_prepend()\fP and memcached_append are used to modify information on a server. All methods take a key, and its length to -store the object. Keys are currently limited to 250 characters when using either a version of memcached(1) which is 1.4 or below, or when using the text protocol. -You must supply both a value and a length. Optionally you +store the object. Keys are currently limited to 250 characters when using +either a version of memcached which is 1.4 or below, or when using the text +protocol. You must supply both a value and a length. Optionally you may test an expiration time for the object and a 16 byte value (it is -meant to be used as a bitmap). "flags" is a 4byte space that is stored alongside of the main value. Many sub libraries make use of this field, so in most cases users should avoid making use of it. +meant to be used as a bitmap). "flags" is a 4byte space that is stored +alongside of the main value. Many sub libraries make use of this field, +so in most cases users should avoid making use of it. .sp -memcached_prepend() places a segment of data before the last piece of data -stored. Currently expiration and key are not used in the server. +\fI\%memcached_prepend()\fP places a segment of data before the last piece +of data stored. Currently expiration and key are not used in the server. .sp -memcached_append() places a segment of data at the end of the last piece of -data stored. Currently expiration and key are not used in the server. +\fI\%memcached_append()\fP places a segment of data at the end of the last +piece of data stored. Currently expiration and key are not used in the server. .sp -memcached_prepend_by_key() and memcached_append_by_key_by_key(, -methods both behave in a similar method as the non key -methods. The difference is that they use their group_key parameter to map -objects to particular servers. +\fBmemcached_prepend_by_key()\fP and +\fBmemcached_append_by_key_by_key()\fP methods both behave in a similar +method as the non key methods. The difference is that they use their +group_key parameter to map objects to particular servers. .sp -If you are looking for performance, memcached_set() with non\-blocking IO is -the fastest way to store data on the server. +If you are looking for performance, \fBmemcached_set()\fP with non\-blocking +IO is the fastest way to store data on the server. .sp -All of the above functions are testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPbehavior enabled. However, when using these operations with this behavior on, there -are limits to the size of the payload being sent to the server. The reason for -these limits is that the Memcached Server does not allow multi\-datagram requests +All of the above functions are testsed with the +\fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior enabled. However, when using +these operations with this behavior on, there are limits to the size of the +payload being sent to the server. The reason for these limits is that the +Memcached Server does not allow multi\-datagram requests and the current server implementation sets a datagram size to 1400 bytes. Due to protocol overhead, the actual limit of the user supplied data is less than 1400 bytes and depends on the protocol in use as, well as the operation being -executed. When running with the binary protocol, \(ga\(ga MEMCACHED_BEHAVIOR_BINARY_PROTOCOL\(ga\(ga, -the size of the key,value, flags and expiry combined may not exceed 1368 bytes. -When running with the ASCII protocol, the exact limit fluctuates depending on -which function is being executed and whether the function is a cas operation -or not. For non\-cas ASCII set operations, there are at least 1335 bytes available -to split among the key, key_prefix, and value; for cas ASCII operations there are -at least 1318 bytes available to split among the key, key_prefix and value. If the -total size of the command, including overhead, exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fPwill be returned. +executed. When running with the binary protocol, +\fBMEMCACHED_BEHAVIOR_BINARY_PROTOCOL\fP, the size of the key,value, +flags and expiry combined may not exceed 1368 bytes. When running with the +ASCII protocol, the exact limit fluctuates depending on which function is +being executed and whether the function is a cas operation or not. For +non\-cas ASCII set operations, there are at least 1335 bytes available +to split among the key, key_prefix, and value; for cas ASCII operations +there are at least 1318 bytes available to split among the key, key_prefix +and value. If the total size of the command, including overhead, exceeds +1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fP will be returned. .SH RETURN .sp All methods return a value of type \fBmemcached_return_t\fP. On success the value will be \fBMEMCACHED_SUCCESS\fP. -Use memcached_strerror() to translate this value to a printable string. +Use \fBmemcached_strerror()\fP to translate this value to a printable +string. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemached(3) memcached_strerror(3) memcached_set(3) memcached_add(3) memcached_cas(3) memcached_replace(3) +\fImemcached(1)\fP \fIlibmemached(3)\fP \fImemcached_strerror(3)\fP \fImemcached_set(3)\fP \fImemcached_add(3)\fP \fImemcached_cas(3)\fP \fImemcached_replace(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_auto.3 b/docs/man/memcached_auto.3 index 744b8148..1cf0e85d 100644 --- a/docs/man/memcached_auto.3 +++ b/docs/man/memcached_auto.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_AUTO" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_AUTO" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_auto \- Incrementing and Decrementing Values . diff --git a/docs/man/memcached_behavior.3 b/docs/man/memcached_behavior.3 index f1fbaf4c..920ac629 100644 --- a/docs/man/memcached_behavior.3 +++ b/docs/man/memcached_behavior.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_BEHAVIOR" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_BEHAVIOR" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_behavior \- libmemcached Documentation . @@ -47,19 +47,17 @@ Manipulate the behavior of a memcached_st structure. Compile and link with \-lmemcached .SH DESCRIPTION .sp -\fIlibmemcached(3)\fP behavior can be modified by use memcached_behavior_set(). -Default behavior is the library strives to be quick and accurate. Some -behavior, while being faster, can also result in not entirely accurate -behavior (for instance, memcached_set() will always respond with -\fBMEMCACHED_SUCCESS\fP). +\fIlibmemcached(3)\fP behavior can be modified by using \fBmemcached_behavior_set()\fP. Default behavior is the library strives to be quick and +accurate. Some behavior, while being faster, can also result in not entirely +accurate behavior (for instance, \fBmemcached_set()\fP will always respond +with \fBMEMCACHED_SUCCESS\fP). .sp -memcached_behavior_get() takes a behavior flag and returns whether or not -that behavior is currently enabled in the client. +\fBmemcached_behavior_get()\fP takes a behavior flag and returns whether or not that behavior is currently enabled in the client. .sp -memcached_behavior_set() changes the value of a particular option of the -client. It takes both a flag (listed below) and a value. For simple on or -off options you just need to pass in a value of 1. Calls to -memcached_behavior_set() will flush and reset all connections. +\fBmemcached_behavior_set()\fP changes the value of a particular option +of the client. It takes both a flag (listed below) and a value. For simple +on or off options you just need to pass in a value of 1. Calls to +\fBmemcached_behavior_set()\fP will flush and reset all connections. .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_USE_UDP @@ -68,27 +66,24 @@ memcached_behavior_set() will flush and reset all connections. Causes \fIlibmemcached(3)\fP to use the UDP transport when communicating with a memcached server. Not all I/O operations are testsed when this behavior is enababled. The following operations will return -\fBMEMCACHED_NOT_SUPPORTED\fP when executed with the MEMCACHED_BEHAVIOR_USE_UDP -enabled: memcached_version(), memcached_stat(), memcached_get(), -memcached_get_by_key(), memcached_mget(), memcached_mget_by_key(), -memcached_fetch(), memcached_fetch_result(), memcached_value_fetch(). +\fBMEMCACHED_NOT_SUPPORTED\fP when executed with the \fI\%MEMCACHED_BEHAVIOR_USE_UDP\fP enabled: \fBmemcached_version()\fP, \fBmemcached_stat()\fP, \fBmemcached_get()\fP, \fBmemcached_get_by_key()\fP, \fBmemcached_mget()\fP, \fBmemcached_mget_by_key()\fP, \fBmemcached_fetch()\fP, \fBmemcached_fetch_result()\fP, \fBmemcached_value_fetch()\fP. .sp All other operations are testsed but are executed in a \(aqfire\-and\-forget\(aq mode, in which once the client has executed the operation, no attempt will be made to ensure the operation has been received and acted on by the server. .sp -\fIlibmemcached(3)\fP does not allow TCP and UDP servers to be shared within -the same libmemached(3) client \(aqinstance\(aq. An attempt to add a TCP server -when this behavior is enabled will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP, -as will attempting to add a UDP server when this behavior has not been enabled. +\fIlibmemcached(3)\fP does not allow TCP and UDP servers to be shared +within the same libmemached(3) client \(aqinstance\(aq. An attempt to add a TCP +server when this behavior is enabled will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP, as will attempting to add a UDP server when this behavior has +not been enabled. .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_NO_BLOCK .UNINDENT .sp -Causes \fIlibmemcached(3)\fP to use asychronous IO. This is the fastest transport -available for storage functions. +Causes \fIlibmemcached(3)\fP to use asychronous IO. This is the fastest +transport available for storage functions. .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_SND_TIMEOUT @@ -115,11 +110,12 @@ environments). .B MEMCACHED_BEHAVIOR_HASH .UNINDENT .sp -Makes the default hashing algorithm for keys use MD5. The value can be set to either MEMCACHED_HASH_DEFAULT, MEMCACHED_HASH_MD5, MEMCACHED_HASH_CRC, MEMCACHED_HASH_FNV1_64, MEMCACHED_HASH_FNV1A_64, MEMCACHED_HASH_FNV1_32, MEMCACHED_HASH_FNV1A_32, MEMCACHED_HASH_JENKINS, MEMCACHED_HASH_HSIEH, and MEMCACHED_HASH_MURMUR. +Makes the default hashing algorithm for keys use MD5. The value can be set to either \fBMEMCACHED_HASH_DEFAULT\fP, \fBMEMCACHED_HASH_MD5\fP, \fBMEMCACHED_HASH_CRC\fP, \fBMEMCACHED_HASH_FNV1_64\fP, \fBMEMCACHED_HASH_FNV1A_64\fP, \fBMEMCACHED_HASH_FNV1_32\fP, \fBMEMCACHED_HASH_FNV1A_32\fP, \fBMEMCACHED_HASH_JENKINS\fP, \fBMEMCACHED_HASH_HSIEH\fP, and \fBMEMCACHED_HASH_MURMUR\fP. .sp -Each hash has it\(aqs advantages and it\(aqs weaknesses. If you don\(aqt know or don\(aqt care, just go with the default. +Each hash has it\(aqs advantages and it\(aqs weaknesses. If you don\(aqt know or don\(aqt +care, just go with the default. .sp -Support for MEMCACHED_HASH_HSIEH is a compile time option that is disabled by default. To enable tests for this hashing algorithm, configure and build libmemcached with the \-\-enable\-hash_hsieh. +Support for \fBMEMCACHED_HASH_HSIEH\fP is a compile time option that is disabled by default. To enable tests for this hashing algorithm, configure and build libmemcached with the \-\-enable\-hash_hsieh. .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_DISTRIBUTION @@ -133,7 +129,10 @@ The default method is MEMCACHED_DISTRIBUTION_MODULA. You can enable consistent h .B MEMCACHED_BEHAVIOR_CACHE_LOOKUPS .UNINDENT .sp -DEPRECATED. Memcached can cache named lookups so that DNS lookups are made only once. +Deprecated since version 0.46(?): DNS lookups are now always cached until an error occurs with the server. +.sp +Memcached can cache named lookups so that DNS lookups are made only once. + .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_SUPPORT_CAS @@ -149,9 +148,9 @@ Sets the default distribution to MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA and th .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_KETAMA_WEIGHTED -.UNINDENT -.sp +. Sets the default distribution to MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA with the weighted tests. and the hash to MEMCACHED_HASH_MD5. +.UNINDENT .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_KETAMA_HASH @@ -175,7 +174,7 @@ Modify the timeout value that is used by poll(). The default value is \-1. An si .B MEMCACHED_BEHAVIOR_USER_DATA .UNINDENT .sp -DEPRECATED +Deprecated since version <: 0.30 .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_BUFFER_REQUESTS @@ -283,19 +282,25 @@ Find the current size of SO_RCVBUF. A value of 0 means either an error occured o .B MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT .UNINDENT .sp -DEPRECATED, please see MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS. This number of times a host can have an error before it is disabled. +Deprecated since version 0.48: See \fI\%MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS\fP +.sp +This number of times a host can have an error before it is disabled. + .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_AUTO_EJECT_HOSTS .UNINDENT .sp -DEPRECATED, please see MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS. If enabled any hosts which have been flagged as disabled will be removed from the list of servers in the memcached_st structure. This must be used in combination with MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT. +Deprecated since version 0.48: See \fI\%MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS\fP +.sp +If enabled any hosts which have been flagged as disabled will be removed from the list of servers in the memcached_st structure. This must be used in combination with MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT. + .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS -.UNINDENT -.sp +. If enabled any hosts which have been flagged as disabled will be removed from the list of servers in the memcached_st structure. +.UNINDENT .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_RETRY_TIMEOUT @@ -307,7 +312,9 @@ When enabled a host which is problematic will only be checked for usage based on .B MEMCACHED_BEHAVIOR_HASH_WITH_PREFIX_KEY .UNINDENT .sp -When enabled the prefix key will be added to the key when determining server by hash. +When enabled the prefix key will be added to the key when determining server +by hash. See \fBMEMCACHED_CALLBACK_NAMESPACE\fP for additional +information. .SH RETURN .sp memcached_behavior_get() returns either the current value of the get, or 0 diff --git a/docs/man/memcached_behavior_get.3 b/docs/man/memcached_behavior_get.3 index 6f8fcf1e..0e01cf99 100644 --- a/docs/man/memcached_behavior_get.3 +++ b/docs/man/memcached_behavior_get.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_BEHAVIOR_GET" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_BEHAVIOR_GET" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_behavior_get \- libmemcached Documentation . @@ -47,19 +47,17 @@ Manipulate the behavior of a memcached_st structure. Compile and link with \-lmemcached .SH DESCRIPTION .sp -\fIlibmemcached(3)\fP behavior can be modified by use memcached_behavior_set(). -Default behavior is the library strives to be quick and accurate. Some -behavior, while being faster, can also result in not entirely accurate -behavior (for instance, memcached_set() will always respond with -\fBMEMCACHED_SUCCESS\fP). +\fIlibmemcached(3)\fP behavior can be modified by using \fBmemcached_behavior_set()\fP. Default behavior is the library strives to be quick and +accurate. Some behavior, while being faster, can also result in not entirely +accurate behavior (for instance, \fBmemcached_set()\fP will always respond +with \fBMEMCACHED_SUCCESS\fP). .sp -memcached_behavior_get() takes a behavior flag and returns whether or not -that behavior is currently enabled in the client. +\fBmemcached_behavior_get()\fP takes a behavior flag and returns whether or not that behavior is currently enabled in the client. .sp -memcached_behavior_set() changes the value of a particular option of the -client. It takes both a flag (listed below) and a value. For simple on or -off options you just need to pass in a value of 1. Calls to -memcached_behavior_set() will flush and reset all connections. +\fBmemcached_behavior_set()\fP changes the value of a particular option +of the client. It takes both a flag (listed below) and a value. For simple +on or off options you just need to pass in a value of 1. Calls to +\fBmemcached_behavior_set()\fP will flush and reset all connections. .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_USE_UDP @@ -68,27 +66,24 @@ memcached_behavior_set() will flush and reset all connections. Causes \fIlibmemcached(3)\fP to use the UDP transport when communicating with a memcached server. Not all I/O operations are testsed when this behavior is enababled. The following operations will return -\fBMEMCACHED_NOT_SUPPORTED\fP when executed with the MEMCACHED_BEHAVIOR_USE_UDP -enabled: memcached_version(), memcached_stat(), memcached_get(), -memcached_get_by_key(), memcached_mget(), memcached_mget_by_key(), -memcached_fetch(), memcached_fetch_result(), memcached_value_fetch(). +\fBMEMCACHED_NOT_SUPPORTED\fP when executed with the \fI\%MEMCACHED_BEHAVIOR_USE_UDP\fP enabled: \fBmemcached_version()\fP, \fBmemcached_stat()\fP, \fBmemcached_get()\fP, \fBmemcached_get_by_key()\fP, \fBmemcached_mget()\fP, \fBmemcached_mget_by_key()\fP, \fBmemcached_fetch()\fP, \fBmemcached_fetch_result()\fP, \fBmemcached_value_fetch()\fP. .sp All other operations are testsed but are executed in a \(aqfire\-and\-forget\(aq mode, in which once the client has executed the operation, no attempt will be made to ensure the operation has been received and acted on by the server. .sp -\fIlibmemcached(3)\fP does not allow TCP and UDP servers to be shared within -the same libmemached(3) client \(aqinstance\(aq. An attempt to add a TCP server -when this behavior is enabled will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP, -as will attempting to add a UDP server when this behavior has not been enabled. +\fIlibmemcached(3)\fP does not allow TCP and UDP servers to be shared +within the same libmemached(3) client \(aqinstance\(aq. An attempt to add a TCP +server when this behavior is enabled will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP, as will attempting to add a UDP server when this behavior has +not been enabled. .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_NO_BLOCK .UNINDENT .sp -Causes \fIlibmemcached(3)\fP to use asychronous IO. This is the fastest transport -available for storage functions. +Causes \fIlibmemcached(3)\fP to use asychronous IO. This is the fastest +transport available for storage functions. .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_SND_TIMEOUT @@ -115,11 +110,12 @@ environments). .B MEMCACHED_BEHAVIOR_HASH .UNINDENT .sp -Makes the default hashing algorithm for keys use MD5. The value can be set to either MEMCACHED_HASH_DEFAULT, MEMCACHED_HASH_MD5, MEMCACHED_HASH_CRC, MEMCACHED_HASH_FNV1_64, MEMCACHED_HASH_FNV1A_64, MEMCACHED_HASH_FNV1_32, MEMCACHED_HASH_FNV1A_32, MEMCACHED_HASH_JENKINS, MEMCACHED_HASH_HSIEH, and MEMCACHED_HASH_MURMUR. +Makes the default hashing algorithm for keys use MD5. The value can be set to either \fBMEMCACHED_HASH_DEFAULT\fP, \fBMEMCACHED_HASH_MD5\fP, \fBMEMCACHED_HASH_CRC\fP, \fBMEMCACHED_HASH_FNV1_64\fP, \fBMEMCACHED_HASH_FNV1A_64\fP, \fBMEMCACHED_HASH_FNV1_32\fP, \fBMEMCACHED_HASH_FNV1A_32\fP, \fBMEMCACHED_HASH_JENKINS\fP, \fBMEMCACHED_HASH_HSIEH\fP, and \fBMEMCACHED_HASH_MURMUR\fP. .sp -Each hash has it\(aqs advantages and it\(aqs weaknesses. If you don\(aqt know or don\(aqt care, just go with the default. +Each hash has it\(aqs advantages and it\(aqs weaknesses. If you don\(aqt know or don\(aqt +care, just go with the default. .sp -Support for MEMCACHED_HASH_HSIEH is a compile time option that is disabled by default. To enable tests for this hashing algorithm, configure and build libmemcached with the \-\-enable\-hash_hsieh. +Support for \fBMEMCACHED_HASH_HSIEH\fP is a compile time option that is disabled by default. To enable tests for this hashing algorithm, configure and build libmemcached with the \-\-enable\-hash_hsieh. .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_DISTRIBUTION @@ -133,7 +129,10 @@ The default method is MEMCACHED_DISTRIBUTION_MODULA. You can enable consistent h .B MEMCACHED_BEHAVIOR_CACHE_LOOKUPS .UNINDENT .sp -DEPRECATED. Memcached can cache named lookups so that DNS lookups are made only once. +Deprecated since version 0.46(?): DNS lookups are now always cached until an error occurs with the server. +.sp +Memcached can cache named lookups so that DNS lookups are made only once. + .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_SUPPORT_CAS @@ -149,9 +148,9 @@ Sets the default distribution to MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA and th .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_KETAMA_WEIGHTED -.UNINDENT -.sp +. Sets the default distribution to MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA with the weighted tests. and the hash to MEMCACHED_HASH_MD5. +.UNINDENT .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_KETAMA_HASH @@ -175,7 +174,7 @@ Modify the timeout value that is used by poll(). The default value is \-1. An si .B MEMCACHED_BEHAVIOR_USER_DATA .UNINDENT .sp -DEPRECATED +Deprecated since version <: 0.30 .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_BUFFER_REQUESTS @@ -283,19 +282,25 @@ Find the current size of SO_RCVBUF. A value of 0 means either an error occured o .B MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT .UNINDENT .sp -DEPRECATED, please see MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS. This number of times a host can have an error before it is disabled. +Deprecated since version 0.48: See \fI\%MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS\fP +.sp +This number of times a host can have an error before it is disabled. + .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_AUTO_EJECT_HOSTS .UNINDENT .sp -DEPRECATED, please see MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS. If enabled any hosts which have been flagged as disabled will be removed from the list of servers in the memcached_st structure. This must be used in combination with MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT. +Deprecated since version 0.48: See \fI\%MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS\fP +.sp +If enabled any hosts which have been flagged as disabled will be removed from the list of servers in the memcached_st structure. This must be used in combination with MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT. + .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS -.UNINDENT -.sp +. If enabled any hosts which have been flagged as disabled will be removed from the list of servers in the memcached_st structure. +.UNINDENT .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_RETRY_TIMEOUT @@ -307,7 +312,9 @@ When enabled a host which is problematic will only be checked for usage based on .B MEMCACHED_BEHAVIOR_HASH_WITH_PREFIX_KEY .UNINDENT .sp -When enabled the prefix key will be added to the key when determining server by hash. +When enabled the prefix key will be added to the key when determining server +by hash. See \fBMEMCACHED_CALLBACK_NAMESPACE\fP for additional +information. .SH RETURN .sp memcached_behavior_get() returns either the current value of the get, or 0 diff --git a/docs/man/memcached_behavior_set.3 b/docs/man/memcached_behavior_set.3 index a3d4b720..7d246199 100644 --- a/docs/man/memcached_behavior_set.3 +++ b/docs/man/memcached_behavior_set.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_BEHAVIOR_SET" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_BEHAVIOR_SET" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_behavior_set \- libmemcached Documentation . @@ -47,19 +47,17 @@ Manipulate the behavior of a memcached_st structure. Compile and link with \-lmemcached .SH DESCRIPTION .sp -\fIlibmemcached(3)\fP behavior can be modified by use memcached_behavior_set(). -Default behavior is the library strives to be quick and accurate. Some -behavior, while being faster, can also result in not entirely accurate -behavior (for instance, memcached_set() will always respond with -\fBMEMCACHED_SUCCESS\fP). +\fIlibmemcached(3)\fP behavior can be modified by using \fBmemcached_behavior_set()\fP. Default behavior is the library strives to be quick and +accurate. Some behavior, while being faster, can also result in not entirely +accurate behavior (for instance, \fBmemcached_set()\fP will always respond +with \fBMEMCACHED_SUCCESS\fP). .sp -memcached_behavior_get() takes a behavior flag and returns whether or not -that behavior is currently enabled in the client. +\fBmemcached_behavior_get()\fP takes a behavior flag and returns whether or not that behavior is currently enabled in the client. .sp -memcached_behavior_set() changes the value of a particular option of the -client. It takes both a flag (listed below) and a value. For simple on or -off options you just need to pass in a value of 1. Calls to -memcached_behavior_set() will flush and reset all connections. +\fBmemcached_behavior_set()\fP changes the value of a particular option +of the client. It takes both a flag (listed below) and a value. For simple +on or off options you just need to pass in a value of 1. Calls to +\fBmemcached_behavior_set()\fP will flush and reset all connections. .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_USE_UDP @@ -68,27 +66,24 @@ memcached_behavior_set() will flush and reset all connections. Causes \fIlibmemcached(3)\fP to use the UDP transport when communicating with a memcached server. Not all I/O operations are testsed when this behavior is enababled. The following operations will return -\fBMEMCACHED_NOT_SUPPORTED\fP when executed with the MEMCACHED_BEHAVIOR_USE_UDP -enabled: memcached_version(), memcached_stat(), memcached_get(), -memcached_get_by_key(), memcached_mget(), memcached_mget_by_key(), -memcached_fetch(), memcached_fetch_result(), memcached_value_fetch(). +\fBMEMCACHED_NOT_SUPPORTED\fP when executed with the \fI\%MEMCACHED_BEHAVIOR_USE_UDP\fP enabled: \fBmemcached_version()\fP, \fBmemcached_stat()\fP, \fBmemcached_get()\fP, \fBmemcached_get_by_key()\fP, \fBmemcached_mget()\fP, \fBmemcached_mget_by_key()\fP, \fBmemcached_fetch()\fP, \fBmemcached_fetch_result()\fP, \fBmemcached_value_fetch()\fP. .sp All other operations are testsed but are executed in a \(aqfire\-and\-forget\(aq mode, in which once the client has executed the operation, no attempt will be made to ensure the operation has been received and acted on by the server. .sp -\fIlibmemcached(3)\fP does not allow TCP and UDP servers to be shared within -the same libmemached(3) client \(aqinstance\(aq. An attempt to add a TCP server -when this behavior is enabled will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP, -as will attempting to add a UDP server when this behavior has not been enabled. +\fIlibmemcached(3)\fP does not allow TCP and UDP servers to be shared +within the same libmemached(3) client \(aqinstance\(aq. An attempt to add a TCP +server when this behavior is enabled will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP, as will attempting to add a UDP server when this behavior has +not been enabled. .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_NO_BLOCK .UNINDENT .sp -Causes \fIlibmemcached(3)\fP to use asychronous IO. This is the fastest transport -available for storage functions. +Causes \fIlibmemcached(3)\fP to use asychronous IO. This is the fastest +transport available for storage functions. .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_SND_TIMEOUT @@ -115,11 +110,12 @@ environments). .B MEMCACHED_BEHAVIOR_HASH .UNINDENT .sp -Makes the default hashing algorithm for keys use MD5. The value can be set to either MEMCACHED_HASH_DEFAULT, MEMCACHED_HASH_MD5, MEMCACHED_HASH_CRC, MEMCACHED_HASH_FNV1_64, MEMCACHED_HASH_FNV1A_64, MEMCACHED_HASH_FNV1_32, MEMCACHED_HASH_FNV1A_32, MEMCACHED_HASH_JENKINS, MEMCACHED_HASH_HSIEH, and MEMCACHED_HASH_MURMUR. +Makes the default hashing algorithm for keys use MD5. The value can be set to either \fBMEMCACHED_HASH_DEFAULT\fP, \fBMEMCACHED_HASH_MD5\fP, \fBMEMCACHED_HASH_CRC\fP, \fBMEMCACHED_HASH_FNV1_64\fP, \fBMEMCACHED_HASH_FNV1A_64\fP, \fBMEMCACHED_HASH_FNV1_32\fP, \fBMEMCACHED_HASH_FNV1A_32\fP, \fBMEMCACHED_HASH_JENKINS\fP, \fBMEMCACHED_HASH_HSIEH\fP, and \fBMEMCACHED_HASH_MURMUR\fP. .sp -Each hash has it\(aqs advantages and it\(aqs weaknesses. If you don\(aqt know or don\(aqt care, just go with the default. +Each hash has it\(aqs advantages and it\(aqs weaknesses. If you don\(aqt know or don\(aqt +care, just go with the default. .sp -Support for MEMCACHED_HASH_HSIEH is a compile time option that is disabled by default. To enable tests for this hashing algorithm, configure and build libmemcached with the \-\-enable\-hash_hsieh. +Support for \fBMEMCACHED_HASH_HSIEH\fP is a compile time option that is disabled by default. To enable tests for this hashing algorithm, configure and build libmemcached with the \-\-enable\-hash_hsieh. .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_DISTRIBUTION @@ -133,7 +129,10 @@ The default method is MEMCACHED_DISTRIBUTION_MODULA. You can enable consistent h .B MEMCACHED_BEHAVIOR_CACHE_LOOKUPS .UNINDENT .sp -DEPRECATED. Memcached can cache named lookups so that DNS lookups are made only once. +Deprecated since version 0.46(?): DNS lookups are now always cached until an error occurs with the server. +.sp +Memcached can cache named lookups so that DNS lookups are made only once. + .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_SUPPORT_CAS @@ -149,9 +148,9 @@ Sets the default distribution to MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA and th .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_KETAMA_WEIGHTED -.UNINDENT -.sp +. Sets the default distribution to MEMCACHED_DISTRIBUTION_CONSISTENT_KETAMA with the weighted tests. and the hash to MEMCACHED_HASH_MD5. +.UNINDENT .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_KETAMA_HASH @@ -175,7 +174,7 @@ Modify the timeout value that is used by poll(). The default value is \-1. An si .B MEMCACHED_BEHAVIOR_USER_DATA .UNINDENT .sp -DEPRECATED +Deprecated since version <: 0.30 .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_BUFFER_REQUESTS @@ -283,19 +282,25 @@ Find the current size of SO_RCVBUF. A value of 0 means either an error occured o .B MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT .UNINDENT .sp -DEPRECATED, please see MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS. This number of times a host can have an error before it is disabled. +Deprecated since version 0.48: See \fI\%MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS\fP +.sp +This number of times a host can have an error before it is disabled. + .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_AUTO_EJECT_HOSTS .UNINDENT .sp -DEPRECATED, please see MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS. If enabled any hosts which have been flagged as disabled will be removed from the list of servers in the memcached_st structure. This must be used in combination with MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT. +Deprecated since version 0.48: See \fI\%MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS\fP +.sp +If enabled any hosts which have been flagged as disabled will be removed from the list of servers in the memcached_st structure. This must be used in combination with MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT. + .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS -.UNINDENT -.sp +. If enabled any hosts which have been flagged as disabled will be removed from the list of servers in the memcached_st structure. +.UNINDENT .INDENT 0.0 .TP .B MEMCACHED_BEHAVIOR_RETRY_TIMEOUT @@ -307,7 +312,9 @@ When enabled a host which is problematic will only be checked for usage based on .B MEMCACHED_BEHAVIOR_HASH_WITH_PREFIX_KEY .UNINDENT .sp -When enabled the prefix key will be added to the key when determining server by hash. +When enabled the prefix key will be added to the key when determining server +by hash. See \fBMEMCACHED_CALLBACK_NAMESPACE\fP for additional +information. .SH RETURN .sp memcached_behavior_get() returns either the current value of the get, or 0 diff --git a/docs/man/memcached_callback.3 b/docs/man/memcached_callback.3 index 4b4492cc..863a19ed 100644 --- a/docs/man/memcached_callback.3 +++ b/docs/man/memcached_callback.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_CALLBACK" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_CALLBACK" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_callback \- libmemcached Documentation . @@ -37,7 +37,7 @@ Get and set a callback #include .INDENT 0.0 .TP -.B memcached_return_t memcached_callback_set (memcached_st *ptr, memcached_callback_t flag, void *data); +.B memcached_return_t memcached_callback_set (memcached_st *ptr, memcached_callback_t flag, const void *data); .UNINDENT .INDENT 0.0 .TP @@ -51,35 +51,47 @@ libmemcached(3) can have callbacks set key execution points. These either provide function calls at points in the code, or return pointers to structures for particular usages. .sp -memcached_callback_get() takes a callback flag and returns the structure or -function set by memcached_callback_set(). +\fBmemcached_callback_get()\fP takes a callback flag and returns the +structure or function set by \fBmemcached_callback_set()\fP. .sp -memcached_callback_set() changes the function/structure assigned by a +\fBmemcached_callback_set()\fP changes the function/structure assigned by a callback flag. No connections are reset. .sp -You can use MEMCACHED_CALLBACK_USER_DATA to provide custom context if required for any of the callbacks. +You can use \fI\%MEMCACHED_CALLBACK_USER_DATA\fP to provide custom context +if required for any of the callbacks. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_CLEANUP_FUNCTION .UNINDENT .sp -When memcached_delete() is called this function will be excuted. At the point of its execution all connections are closed. +When \fBmemcached_delete()\fP is called this function will be excuted. At +the point of its execution all connections are closed. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_CLONE_FUNCTION .UNINDENT .sp -When memcached_delete() is called this function will be excuted. At the -point of its execution all connections are closed. +When \fBmemcached_delete()\fP is called this function will be excuted. +At the point of its execution all connections are closed. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_PREFIX_KEY +. +See \fI\%MEMCACHED_CALLBACK_NAMESPACE\fP +.UNINDENT +.INDENT 0.0 +.TP +.B MEMCACHED_CALLBACK_NAMESPACE .UNINDENT .sp You can set a value which will be used to create a domain for your keys. -The value specified here will be prefixed to each of your keys. The value can not be greater then MEMCACHED_PREFIX_KEY_MAX_SIZE \- 1 and will reduce MEMCACHED_MAX_KEY by the value of your key. +The value specified here will be prefixed to each of your keys. The value can +not be greater then \fBMEMCACHED_PREFIX_KEY_MAX_SIZE \- 1\fP and will +reduce \fBMEMCACHED_MAX_KEY\fP by the value of your key. .sp -The prefix key is only applied to the primary key, not the master key. MEMCACHED_FAILURE will be returned if no key is set. In the case of a key which is too long, MEMCACHED_BAD_KEY_PROVIDED will be returned. +The prefix key is only applied to the primary key, not the master key. +\fBMEMCACHED_FAILURE\fP will be returned if no key is set. In the case of +a key which is too long, \fBMEMCACHED_BAD_KEY_PROVIDED\fP will be returned. .sp If you set a value with the value being NULL then the prefix key is disabled. .INDENT 0.0 @@ -88,26 +100,26 @@ If you set a value with the value being NULL then the prefix key is disabled. .UNINDENT .sp This allows you to store a pointer to a specifc piece of data. This can be -retrieved from inside of memcached_fetch_execute(). Cloning a memcached_st -will copy the pointer to the clone. +retrieved from inside of \fBmemcached_fetch_execute()\fP. Cloning a +\fBmemcached_st\fP will copy the pointer to the clone. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_MALLOC_FUNCTION .UNINDENT .sp -DEPRECATED: use memcached_set_memory_allocators instead. +Deprecated since version <0.32: Use \fBmemcached_set_memory_allocators\fP instead. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_REALLOC_FUNCTION .UNINDENT .sp -DEPRECATED: use memcached_set_memory_allocators instead. +Deprecated since version <0.32: Use \fBmemcached_set_memory_allocators\fP instead. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_FREE_FUNCTION .UNINDENT .sp -DEPRECATED: use memcached_set_memory_allocators instead. +Deprecated since version <0.32: Use \fBmemcached_set_memory_allocators\fP instead. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_GET_FAILURE @@ -117,13 +129,18 @@ This function implements the read through cache behavior. On failure of retrieva .sp You are responsible for populating the result object provided. This result object will then be stored in the server and returned to the calling process. .sp -You must clone the memcached_st in order to +You must clone the \fBmemcached_st\fP in order to make use of it. The value will be stored only if you return -MEMCACHED_SUCCESS or MEMCACHED_BUFFERED. Returning MEMCACHED_BUFFERED will -cause the object to be buffered and not sent immediatly (if this is the default behavior based on your connection setup this will happen automatically). +\fBMEMCACHED_SUCCESS\fP or \fBMEMCACHED_BUFFERED\fP. Returning +\fBMEMCACHED_BUFFERED\fP will cause the object to be buffered and not sent +immediatly (if this is the default behavior based on your connection setup +this will happen automatically). .sp The prototype for this is: -memcached_return_t (*memcached_trigger_key)(memcached_st *ptr, char *key, size_t key_length, memcached_result_st *result); +.INDENT 0.0 +.TP +.B memcached_return_t (*memcached_trigger_key)(memcached_st *ptr, char *key, size_t key_length, memcached_result_st *result); +.UNINDENT .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_DELETE_TRIGGER @@ -131,15 +148,19 @@ memcached_return_t (*memcached_trigger_key)(memcached_st *ptr, char *key, size_t .sp This function implements a trigger upon successful deletion of a key. The memcached_st structure will need to be cloned in order to make use of it. .sp -The prototype for this is: typedef memcached_return_t (*memcached_trigger_delete_key)(memcached_st *ptr, char *key, size_t key_length); +The prototype for this is: +.INDENT 0.0 +.TP +.B typedef memcached_return_t (*memcached_trigger_delete_key)(memcached_st *ptr, char *key, size_t key_length); +.UNINDENT .SH RETURN .sp -memcached_callback_get() return the function or structure that was provided. -Upon error, nothing is set, null is returned, and the memcached_return_t -argument is set to MEMCACHED_FAILURE. +\fBmemcached_callback_get()\fP return the function or structure that was +provided. Upon error, nothing is set, null is returned, and the +\fBmemcached_return_t\fP argument is set to \fBMEMCACHED_FAILURE\fP. .sp -memcached_callback_set() returns MEMCACHED_SUCCESS upon successful setting, -otherwise MEMCACHED_FAILURE on error. +\fBmemcached_callback_set()\fP returns \fBMEMCACHED_SUCCESS\fP upon +successful setting, otherwise \fBMEMCACHED_FAILURE\fP on error. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_callback_get.3 b/docs/man/memcached_callback_get.3 index adf9b50c..8cc2fa0a 100644 --- a/docs/man/memcached_callback_get.3 +++ b/docs/man/memcached_callback_get.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_CALLBACK_GET" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_CALLBACK_GET" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_callback_get \- libmemcached Documentation . @@ -37,7 +37,7 @@ Get and set a callback #include .INDENT 0.0 .TP -.B memcached_return_t memcached_callback_set (memcached_st *ptr, memcached_callback_t flag, void *data); +.B memcached_return_t memcached_callback_set (memcached_st *ptr, memcached_callback_t flag, const void *data); .UNINDENT .INDENT 0.0 .TP @@ -51,35 +51,47 @@ libmemcached(3) can have callbacks set key execution points. These either provide function calls at points in the code, or return pointers to structures for particular usages. .sp -memcached_callback_get() takes a callback flag and returns the structure or -function set by memcached_callback_set(). +\fBmemcached_callback_get()\fP takes a callback flag and returns the +structure or function set by \fBmemcached_callback_set()\fP. .sp -memcached_callback_set() changes the function/structure assigned by a +\fBmemcached_callback_set()\fP changes the function/structure assigned by a callback flag. No connections are reset. .sp -You can use MEMCACHED_CALLBACK_USER_DATA to provide custom context if required for any of the callbacks. +You can use \fI\%MEMCACHED_CALLBACK_USER_DATA\fP to provide custom context +if required for any of the callbacks. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_CLEANUP_FUNCTION .UNINDENT .sp -When memcached_delete() is called this function will be excuted. At the point of its execution all connections are closed. +When \fBmemcached_delete()\fP is called this function will be excuted. At +the point of its execution all connections are closed. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_CLONE_FUNCTION .UNINDENT .sp -When memcached_delete() is called this function will be excuted. At the -point of its execution all connections are closed. +When \fBmemcached_delete()\fP is called this function will be excuted. +At the point of its execution all connections are closed. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_PREFIX_KEY +. +See \fI\%MEMCACHED_CALLBACK_NAMESPACE\fP +.UNINDENT +.INDENT 0.0 +.TP +.B MEMCACHED_CALLBACK_NAMESPACE .UNINDENT .sp You can set a value which will be used to create a domain for your keys. -The value specified here will be prefixed to each of your keys. The value can not be greater then MEMCACHED_PREFIX_KEY_MAX_SIZE \- 1 and will reduce MEMCACHED_MAX_KEY by the value of your key. +The value specified here will be prefixed to each of your keys. The value can +not be greater then \fBMEMCACHED_PREFIX_KEY_MAX_SIZE \- 1\fP and will +reduce \fBMEMCACHED_MAX_KEY\fP by the value of your key. .sp -The prefix key is only applied to the primary key, not the master key. MEMCACHED_FAILURE will be returned if no key is set. In the case of a key which is too long, MEMCACHED_BAD_KEY_PROVIDED will be returned. +The prefix key is only applied to the primary key, not the master key. +\fBMEMCACHED_FAILURE\fP will be returned if no key is set. In the case of +a key which is too long, \fBMEMCACHED_BAD_KEY_PROVIDED\fP will be returned. .sp If you set a value with the value being NULL then the prefix key is disabled. .INDENT 0.0 @@ -88,26 +100,26 @@ If you set a value with the value being NULL then the prefix key is disabled. .UNINDENT .sp This allows you to store a pointer to a specifc piece of data. This can be -retrieved from inside of memcached_fetch_execute(). Cloning a memcached_st -will copy the pointer to the clone. +retrieved from inside of \fBmemcached_fetch_execute()\fP. Cloning a +\fBmemcached_st\fP will copy the pointer to the clone. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_MALLOC_FUNCTION .UNINDENT .sp -DEPRECATED: use memcached_set_memory_allocators instead. +Deprecated since version <0.32: Use \fBmemcached_set_memory_allocators\fP instead. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_REALLOC_FUNCTION .UNINDENT .sp -DEPRECATED: use memcached_set_memory_allocators instead. +Deprecated since version <0.32: Use \fBmemcached_set_memory_allocators\fP instead. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_FREE_FUNCTION .UNINDENT .sp -DEPRECATED: use memcached_set_memory_allocators instead. +Deprecated since version <0.32: Use \fBmemcached_set_memory_allocators\fP instead. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_GET_FAILURE @@ -117,13 +129,18 @@ This function implements the read through cache behavior. On failure of retrieva .sp You are responsible for populating the result object provided. This result object will then be stored in the server and returned to the calling process. .sp -You must clone the memcached_st in order to +You must clone the \fBmemcached_st\fP in order to make use of it. The value will be stored only if you return -MEMCACHED_SUCCESS or MEMCACHED_BUFFERED. Returning MEMCACHED_BUFFERED will -cause the object to be buffered and not sent immediatly (if this is the default behavior based on your connection setup this will happen automatically). +\fBMEMCACHED_SUCCESS\fP or \fBMEMCACHED_BUFFERED\fP. Returning +\fBMEMCACHED_BUFFERED\fP will cause the object to be buffered and not sent +immediatly (if this is the default behavior based on your connection setup +this will happen automatically). .sp The prototype for this is: -memcached_return_t (*memcached_trigger_key)(memcached_st *ptr, char *key, size_t key_length, memcached_result_st *result); +.INDENT 0.0 +.TP +.B memcached_return_t (*memcached_trigger_key)(memcached_st *ptr, char *key, size_t key_length, memcached_result_st *result); +.UNINDENT .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_DELETE_TRIGGER @@ -131,15 +148,19 @@ memcached_return_t (*memcached_trigger_key)(memcached_st *ptr, char *key, size_t .sp This function implements a trigger upon successful deletion of a key. The memcached_st structure will need to be cloned in order to make use of it. .sp -The prototype for this is: typedef memcached_return_t (*memcached_trigger_delete_key)(memcached_st *ptr, char *key, size_t key_length); +The prototype for this is: +.INDENT 0.0 +.TP +.B typedef memcached_return_t (*memcached_trigger_delete_key)(memcached_st *ptr, char *key, size_t key_length); +.UNINDENT .SH RETURN .sp -memcached_callback_get() return the function or structure that was provided. -Upon error, nothing is set, null is returned, and the memcached_return_t -argument is set to MEMCACHED_FAILURE. +\fBmemcached_callback_get()\fP return the function or structure that was +provided. Upon error, nothing is set, null is returned, and the +\fBmemcached_return_t\fP argument is set to \fBMEMCACHED_FAILURE\fP. .sp -memcached_callback_set() returns MEMCACHED_SUCCESS upon successful setting, -otherwise MEMCACHED_FAILURE on error. +\fBmemcached_callback_set()\fP returns \fBMEMCACHED_SUCCESS\fP upon +successful setting, otherwise \fBMEMCACHED_FAILURE\fP on error. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_callback_set.3 b/docs/man/memcached_callback_set.3 index 13abec7e..c02a52a7 100644 --- a/docs/man/memcached_callback_set.3 +++ b/docs/man/memcached_callback_set.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_CALLBACK_SET" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_CALLBACK_SET" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_callback_set \- libmemcached Documentation . @@ -37,7 +37,7 @@ Get and set a callback #include .INDENT 0.0 .TP -.B memcached_return_t memcached_callback_set (memcached_st *ptr, memcached_callback_t flag, void *data); +.B memcached_return_t memcached_callback_set (memcached_st *ptr, memcached_callback_t flag, const void *data); .UNINDENT .INDENT 0.0 .TP @@ -51,35 +51,47 @@ libmemcached(3) can have callbacks set key execution points. These either provide function calls at points in the code, or return pointers to structures for particular usages. .sp -memcached_callback_get() takes a callback flag and returns the structure or -function set by memcached_callback_set(). +\fBmemcached_callback_get()\fP takes a callback flag and returns the +structure or function set by \fBmemcached_callback_set()\fP. .sp -memcached_callback_set() changes the function/structure assigned by a +\fBmemcached_callback_set()\fP changes the function/structure assigned by a callback flag. No connections are reset. .sp -You can use MEMCACHED_CALLBACK_USER_DATA to provide custom context if required for any of the callbacks. +You can use \fI\%MEMCACHED_CALLBACK_USER_DATA\fP to provide custom context +if required for any of the callbacks. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_CLEANUP_FUNCTION .UNINDENT .sp -When memcached_delete() is called this function will be excuted. At the point of its execution all connections are closed. +When \fBmemcached_delete()\fP is called this function will be excuted. At +the point of its execution all connections are closed. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_CLONE_FUNCTION .UNINDENT .sp -When memcached_delete() is called this function will be excuted. At the -point of its execution all connections are closed. +When \fBmemcached_delete()\fP is called this function will be excuted. +At the point of its execution all connections are closed. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_PREFIX_KEY +. +See \fI\%MEMCACHED_CALLBACK_NAMESPACE\fP +.UNINDENT +.INDENT 0.0 +.TP +.B MEMCACHED_CALLBACK_NAMESPACE .UNINDENT .sp You can set a value which will be used to create a domain for your keys. -The value specified here will be prefixed to each of your keys. The value can not be greater then MEMCACHED_PREFIX_KEY_MAX_SIZE \- 1 and will reduce MEMCACHED_MAX_KEY by the value of your key. +The value specified here will be prefixed to each of your keys. The value can +not be greater then \fBMEMCACHED_PREFIX_KEY_MAX_SIZE \- 1\fP and will +reduce \fBMEMCACHED_MAX_KEY\fP by the value of your key. .sp -The prefix key is only applied to the primary key, not the master key. MEMCACHED_FAILURE will be returned if no key is set. In the case of a key which is too long, MEMCACHED_BAD_KEY_PROVIDED will be returned. +The prefix key is only applied to the primary key, not the master key. +\fBMEMCACHED_FAILURE\fP will be returned if no key is set. In the case of +a key which is too long, \fBMEMCACHED_BAD_KEY_PROVIDED\fP will be returned. .sp If you set a value with the value being NULL then the prefix key is disabled. .INDENT 0.0 @@ -88,26 +100,26 @@ If you set a value with the value being NULL then the prefix key is disabled. .UNINDENT .sp This allows you to store a pointer to a specifc piece of data. This can be -retrieved from inside of memcached_fetch_execute(). Cloning a memcached_st -will copy the pointer to the clone. +retrieved from inside of \fBmemcached_fetch_execute()\fP. Cloning a +\fBmemcached_st\fP will copy the pointer to the clone. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_MALLOC_FUNCTION .UNINDENT .sp -DEPRECATED: use memcached_set_memory_allocators instead. +Deprecated since version <0.32: Use \fBmemcached_set_memory_allocators\fP instead. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_REALLOC_FUNCTION .UNINDENT .sp -DEPRECATED: use memcached_set_memory_allocators instead. +Deprecated since version <0.32: Use \fBmemcached_set_memory_allocators\fP instead. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_FREE_FUNCTION .UNINDENT .sp -DEPRECATED: use memcached_set_memory_allocators instead. +Deprecated since version <0.32: Use \fBmemcached_set_memory_allocators\fP instead. .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_GET_FAILURE @@ -117,13 +129,18 @@ This function implements the read through cache behavior. On failure of retrieva .sp You are responsible for populating the result object provided. This result object will then be stored in the server and returned to the calling process. .sp -You must clone the memcached_st in order to +You must clone the \fBmemcached_st\fP in order to make use of it. The value will be stored only if you return -MEMCACHED_SUCCESS or MEMCACHED_BUFFERED. Returning MEMCACHED_BUFFERED will -cause the object to be buffered and not sent immediatly (if this is the default behavior based on your connection setup this will happen automatically). +\fBMEMCACHED_SUCCESS\fP or \fBMEMCACHED_BUFFERED\fP. Returning +\fBMEMCACHED_BUFFERED\fP will cause the object to be buffered and not sent +immediatly (if this is the default behavior based on your connection setup +this will happen automatically). .sp The prototype for this is: -memcached_return_t (*memcached_trigger_key)(memcached_st *ptr, char *key, size_t key_length, memcached_result_st *result); +.INDENT 0.0 +.TP +.B memcached_return_t (*memcached_trigger_key)(memcached_st *ptr, char *key, size_t key_length, memcached_result_st *result); +.UNINDENT .INDENT 0.0 .TP .B MEMCACHED_CALLBACK_DELETE_TRIGGER @@ -131,15 +148,19 @@ memcached_return_t (*memcached_trigger_key)(memcached_st *ptr, char *key, size_t .sp This function implements a trigger upon successful deletion of a key. The memcached_st structure will need to be cloned in order to make use of it. .sp -The prototype for this is: typedef memcached_return_t (*memcached_trigger_delete_key)(memcached_st *ptr, char *key, size_t key_length); +The prototype for this is: +.INDENT 0.0 +.TP +.B typedef memcached_return_t (*memcached_trigger_delete_key)(memcached_st *ptr, char *key, size_t key_length); +.UNINDENT .SH RETURN .sp -memcached_callback_get() return the function or structure that was provided. -Upon error, nothing is set, null is returned, and the memcached_return_t -argument is set to MEMCACHED_FAILURE. +\fBmemcached_callback_get()\fP return the function or structure that was +provided. Upon error, nothing is set, null is returned, and the +\fBmemcached_return_t\fP argument is set to \fBMEMCACHED_FAILURE\fP. .sp -memcached_callback_set() returns MEMCACHED_SUCCESS upon successful setting, -otherwise MEMCACHED_FAILURE on error. +\fBmemcached_callback_set()\fP returns \fBMEMCACHED_SUCCESS\fP upon +successful setting, otherwise \fBMEMCACHED_FAILURE\fP on error. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_cas.3 b/docs/man/memcached_cas.3 index 2f3554e9..28035f58 100644 --- a/docs/man/memcached_cas.3 +++ b/docs/man/memcached_cas.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_CAS" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_CAS" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_cas \- Working with data on the server in an atomic fashion . @@ -45,43 +45,43 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_cas() overwrites data in the server as long as the "cas" value is -still the same in the server. You can get the cas value of a result by -calling memcached_result_cas() on a memcached_result_st(3) structure. At the point -that this note was written cas is still buggy in memached. Turning on tests -for it in libmemcached(3) is optional. Please see memcached_set() for -information on how to do this. +\fBmemcached_cas()\fP overwrites data in the server as long as the "cas" +value is still the same in the server. You can get the cas value of a result +by calling \fBmemcached_result_cas()\fP on a memcached_result_st(3) +structure. At the point that this note was written cas is still buggy in memached. Turning on tests for it in libmemcached(3) is optional. Please see +\fBmemcached_set()\fP for information on how to do this. .sp -memcached_cas_by_key() method behaves in a similar method as the non key -methods. The difference is that it uses the group_key parameter to map -objects to particular servers. +\fBmemcached_cas_by_key()\fP method behaves in a similar method as the non +key methods. The difference is that it uses the \fBgroup_key\fP parameter +to map objects to particular servers. .sp -memcached_cas() is testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPbehavior enabled. However, when using these operations with this behavior on, there -are limits to the size of the payload being sent to the server. The reason for -these limits is that the Memcached Server does not allow multi\-datagram requests -and the current server implementation sets a datagram size to 1400 bytes. Due -to protocol overhead, the actual limit of the user supplied data is less than -1400 bytes and depends on the protocol in use as, well as the operation being -executed. When running with the binary protocol, \(ga\(ga MEMCACHED_BEHAVIOR_BINARY_PROTOCOL\(ga\(ga, -the size of the key,value, flags and expiry combined may not exceed 1368 bytes. -When running with the ASCII protocol, the exact limit fluctuates depending on -which function is being executed and whether the function is a cas operation -or not. For non\-cas ASCII set operations, there are at least 1335 bytes available -to split among the key, key_prefix, and value; for cas ASCII operations there are -at least 1318 bytes available to split among the key, key_prefix and value. If the -total size of the command, including overhead, exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fPwill be returned. +\fBmemcached_cas()\fP is testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior enabled. However, when using these operations with this behavior +on, there are limits to the size of the payload being sent to the server. The +reason for these limits is that the Memcached Server does not allow +multi\-datagram requests and the current server implementation sets a datagram +size to 1400 bytes. Due to protocol overhead, the actual limit of the user +supplied data is less than 1400 bytes and depends on the protocol in use as, +well as the operation being executed. When running with the binary protocol, +\fBMEMCACHED_BEHAVIOR_BINARY_PROTOCOL\fP, the size of the key,value, +flags and expiry combined may not exceed 1368 bytes. When running with the +ASCII protocol, the exact limit fluctuates depending on which function is +being executed and whether the function is a cas operation or not. For +non\-cas ASCII set operations, there are at least 1335 bytes available to +split among the key, key_prefix, and value; for cas ASCII operations there +are at least 1318 bytes available to split among the key, key_prefix and value. If the total size of the command, including overhead, exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fP will be returned. .SH RETURN .sp All methods return a value of type \fBmemcached_return_t\fP. On success the value will be \fBMEMCACHED_SUCCESS\fP. -Use memcached_strerror() to translate this value to a printable string. +Use \fBmemcached_strerror()\fP to translate this value to a printable +string. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemached(3) memcached_strerror(3) memcached_set(3) memcached_append(3) memcached_add(3) memcached_prepend(3) memcached_replace(3) +\fImemcached(1)\fP \fIlibmemached(3)\fP \fImemcached_strerror(3)\fP \fImemcached_set(3)\fP \fImemcached_append(3)\fP \fImemcached_add(3)\fP \fImemcached_prepend(3)\fP \fImemcached_replace(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_cas_by_key.3 b/docs/man/memcached_cas_by_key.3 index 34ca232a..d58fb299 100644 --- a/docs/man/memcached_cas_by_key.3 +++ b/docs/man/memcached_cas_by_key.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_CAS_BY_KEY" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_CAS_BY_KEY" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_cas_by_key \- Storing and Replacing Data . @@ -45,43 +45,43 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_cas() overwrites data in the server as long as the "cas" value is -still the same in the server. You can get the cas value of a result by -calling memcached_result_cas() on a memcached_result_st(3) structure. At the point -that this note was written cas is still buggy in memached. Turning on tests -for it in libmemcached(3) is optional. Please see memcached_set() for -information on how to do this. +\fBmemcached_cas()\fP overwrites data in the server as long as the "cas" +value is still the same in the server. You can get the cas value of a result +by calling \fBmemcached_result_cas()\fP on a memcached_result_st(3) +structure. At the point that this note was written cas is still buggy in memached. Turning on tests for it in libmemcached(3) is optional. Please see +\fBmemcached_set()\fP for information on how to do this. .sp -memcached_cas_by_key() method behaves in a similar method as the non key -methods. The difference is that it uses the group_key parameter to map -objects to particular servers. +\fBmemcached_cas_by_key()\fP method behaves in a similar method as the non +key methods. The difference is that it uses the \fBgroup_key\fP parameter +to map objects to particular servers. .sp -memcached_cas() is testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPbehavior enabled. However, when using these operations with this behavior on, there -are limits to the size of the payload being sent to the server. The reason for -these limits is that the Memcached Server does not allow multi\-datagram requests -and the current server implementation sets a datagram size to 1400 bytes. Due -to protocol overhead, the actual limit of the user supplied data is less than -1400 bytes and depends on the protocol in use as, well as the operation being -executed. When running with the binary protocol, \(ga\(ga MEMCACHED_BEHAVIOR_BINARY_PROTOCOL\(ga\(ga, -the size of the key,value, flags and expiry combined may not exceed 1368 bytes. -When running with the ASCII protocol, the exact limit fluctuates depending on -which function is being executed and whether the function is a cas operation -or not. For non\-cas ASCII set operations, there are at least 1335 bytes available -to split among the key, key_prefix, and value; for cas ASCII operations there are -at least 1318 bytes available to split among the key, key_prefix and value. If the -total size of the command, including overhead, exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fPwill be returned. +\fBmemcached_cas()\fP is testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior enabled. However, when using these operations with this behavior +on, there are limits to the size of the payload being sent to the server. The +reason for these limits is that the Memcached Server does not allow +multi\-datagram requests and the current server implementation sets a datagram +size to 1400 bytes. Due to protocol overhead, the actual limit of the user +supplied data is less than 1400 bytes and depends on the protocol in use as, +well as the operation being executed. When running with the binary protocol, +\fBMEMCACHED_BEHAVIOR_BINARY_PROTOCOL\fP, the size of the key,value, +flags and expiry combined may not exceed 1368 bytes. When running with the +ASCII protocol, the exact limit fluctuates depending on which function is +being executed and whether the function is a cas operation or not. For +non\-cas ASCII set operations, there are at least 1335 bytes available to +split among the key, key_prefix, and value; for cas ASCII operations there +are at least 1318 bytes available to split among the key, key_prefix and value. If the total size of the command, including overhead, exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fP will be returned. .SH RETURN .sp All methods return a value of type \fBmemcached_return_t\fP. On success the value will be \fBMEMCACHED_SUCCESS\fP. -Use memcached_strerror() to translate this value to a printable string. +Use \fBmemcached_strerror()\fP to translate this value to a printable +string. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemached(3) memcached_strerror(3) memcached_set(3) memcached_append(3) memcached_add(3) memcached_prepend(3) memcached_replace(3) +\fImemcached(1)\fP \fIlibmemached(3)\fP \fImemcached_strerror(3)\fP \fImemcached_set(3)\fP \fImemcached_append(3)\fP \fImemcached_add(3)\fP \fImemcached_prepend(3)\fP \fImemcached_replace(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_clone.3 b/docs/man/memcached_clone.3 index 088c1ded..3361f7b4 100644 --- a/docs/man/memcached_clone.3 +++ b/docs/man/memcached_clone.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_CLONE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_CLONE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_clone \- libmemcached Documentation . @@ -35,54 +35,63 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_st *memcached_create (memcached_st *ptr); +.B memcachd_st .UNINDENT .INDENT 0.0 .TP -.B void memcached_free (memcached_st *ptr); +.B memcached_st* memcached_create(memcached_st\fI\ *ptr\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st *memcached_clone (memcached_st *destination, memcached_st *source); +.B void memcached_free(memcached_st\fI\ *ptr\fP) .UNINDENT .INDENT 0.0 .TP -.B void memcached_servers_reset(memcached_st); +.B memcached_st* memcached_clone(memcached_st\fI\ *destination\fP, memcached_st\fI\ *source\fP) +.UNINDENT +.INDENT 0.0 +.TP +.B void memcached_servers_reset(memcached_st) .UNINDENT .sp Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_create() is used to create a \fBmemcached_st\fP structure that will then -be used by other libmemcached(3) functions to communicate with the server. You -should either pass a statically declared \fBmemcached_st\fP to memcached_create() or +\fI\%memcached_create()\fP is used to create a \fBmemcached_st\fP +structure that will then be used by other libmemcached(3) functions to +communicate with the server. You should either pass a statically declared +\fBmemcached_st\fP to \fI\%memcached_create()\fP or a NULL. If a NULL passed in then a structure is allocated for you. .sp -Please note, when you write new application use memcached_create_with_options() over memcached_create(). +Please note, when you write new application use +\fBmemcached_create_with_options()\fP over +\fI\%memcached_create()\fP. .sp -memcached_clone() is similar to memcached_create(3) but it copies the -defaults and list of servers from the source \fBmemcached_st\fP. If you pass a null as -the argument for the source to clone, it is the same as a call to memcached_create(). -If the destination argument is NULL a \fBmemcached_st\fP will be allocated for you. +\fI\%memcached_clone()\fP is similar to \fI\%memcached_create()\fP but +it copies the defaults and list of servers from the source +\fBmemcached_st\fP. If you pass a null as the argument for the source +to clone, it is the same as a call to \fI\%memcached_create()\fP. +If the destination argument is NULL a \fBmemcached_st\fP will be allocated +for you. .sp -memcached_servers_reset() allows you to zero out the list of servers that -the memcached_st has. +\fI\%memcached_servers_reset()\fP allows you to zero out the list of +servers that the \fBmemcached_st\fP has. .sp -To clean up memory associated with a \fBmemcached_st\fP structure you should pass -it to memcached_free() when you are finished using it. memcached_free() is -the only way to make sure all memory is deallocated when you finish using -the structure. +To clean up memory associated with a \fBmemcached_st\fP structure you +should pass it to \fI\%memcached_free()\fP when you are finished using it. +\fI\%memcached_free()\fP is the only way to make sure all memory is +deallocated when you finish using the structure. .sp You may wish to avoid using memcached_create(3) or memcached_clone(3) with a stack based allocation. The most common issues related to ABI safety involve heap allocated structures. .SH RETURN .sp -memcached_create() returns a pointer to the memcached_st that was created -(or initialized). On an allocation failure, it returns NULL. +\fI\%memcached_create()\fP returns a pointer to the \fBmemcached_st\fP +that was created (or initialized). On an allocation failure, it returns NULL. .sp -memcached_clone() returns a pointer to the memcached_st that was created -(or initialized). On an allocation failure, it returns NULL. +\fI\%memcached_clone()\fP returns a pointer to the \fBmemcached_st\fP +that was created (or initialized). On an allocation failure, it returns NULL. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_create.3 b/docs/man/memcached_create.3 index 3fdbbf94..ec8f823e 100644 --- a/docs/man/memcached_create.3 +++ b/docs/man/memcached_create.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_CREATE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_CREATE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_create \- libmemcached Documentation . @@ -35,54 +35,63 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_st *memcached_create (memcached_st *ptr); +.B memcachd_st .UNINDENT .INDENT 0.0 .TP -.B void memcached_free (memcached_st *ptr); +.B memcached_st* memcached_create(memcached_st\fI\ *ptr\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st *memcached_clone (memcached_st *destination, memcached_st *source); +.B void memcached_free(memcached_st\fI\ *ptr\fP) .UNINDENT .INDENT 0.0 .TP -.B void memcached_servers_reset(memcached_st); +.B memcached_st* memcached_clone(memcached_st\fI\ *destination\fP, memcached_st\fI\ *source\fP) +.UNINDENT +.INDENT 0.0 +.TP +.B void memcached_servers_reset(memcached_st) .UNINDENT .sp Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_create() is used to create a \fBmemcached_st\fP structure that will then -be used by other libmemcached(3) functions to communicate with the server. You -should either pass a statically declared \fBmemcached_st\fP to memcached_create() or +\fI\%memcached_create()\fP is used to create a \fBmemcached_st\fP +structure that will then be used by other libmemcached(3) functions to +communicate with the server. You should either pass a statically declared +\fBmemcached_st\fP to \fI\%memcached_create()\fP or a NULL. If a NULL passed in then a structure is allocated for you. .sp -Please note, when you write new application use memcached_create_with_options() over memcached_create(). +Please note, when you write new application use +\fBmemcached_create_with_options()\fP over +\fI\%memcached_create()\fP. .sp -memcached_clone() is similar to memcached_create(3) but it copies the -defaults and list of servers from the source \fBmemcached_st\fP. If you pass a null as -the argument for the source to clone, it is the same as a call to memcached_create(). -If the destination argument is NULL a \fBmemcached_st\fP will be allocated for you. +\fI\%memcached_clone()\fP is similar to \fI\%memcached_create()\fP but +it copies the defaults and list of servers from the source +\fBmemcached_st\fP. If you pass a null as the argument for the source +to clone, it is the same as a call to \fI\%memcached_create()\fP. +If the destination argument is NULL a \fBmemcached_st\fP will be allocated +for you. .sp -memcached_servers_reset() allows you to zero out the list of servers that -the memcached_st has. +\fI\%memcached_servers_reset()\fP allows you to zero out the list of +servers that the \fBmemcached_st\fP has. .sp -To clean up memory associated with a \fBmemcached_st\fP structure you should pass -it to memcached_free() when you are finished using it. memcached_free() is -the only way to make sure all memory is deallocated when you finish using -the structure. +To clean up memory associated with a \fBmemcached_st\fP structure you +should pass it to \fI\%memcached_free()\fP when you are finished using it. +\fI\%memcached_free()\fP is the only way to make sure all memory is +deallocated when you finish using the structure. .sp You may wish to avoid using memcached_create(3) or memcached_clone(3) with a stack based allocation. The most common issues related to ABI safety involve heap allocated structures. .SH RETURN .sp -memcached_create() returns a pointer to the memcached_st that was created -(or initialized). On an allocation failure, it returns NULL. +\fI\%memcached_create()\fP returns a pointer to the \fBmemcached_st\fP +that was created (or initialized). On an allocation failure, it returns NULL. .sp -memcached_clone() returns a pointer to the memcached_st that was created -(or initialized). On an allocation failure, it returns NULL. +\fI\%memcached_clone()\fP returns a pointer to the \fBmemcached_st\fP +that was created (or initialized). On an allocation failure, it returns NULL. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_decrement.3 b/docs/man/memcached_decrement.3 index f4a849f4..f7968e6b 100644 --- a/docs/man/memcached_decrement.3 +++ b/docs/man/memcached_decrement.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_DECREMENT" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_DECREMENT" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_decrement \- Incrementing and Decrementing Values . diff --git a/docs/man/memcached_decrement_with_initial.3 b/docs/man/memcached_decrement_with_initial.3 index 290cca35..abcc2088 100644 --- a/docs/man/memcached_decrement_with_initial.3 +++ b/docs/man/memcached_decrement_with_initial.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_DECREMENT_WITH_INITIAL" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_DECREMENT_WITH_INITIAL" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_decrement_with_initial \- Incrementing and Decrementing Values . diff --git a/docs/man/memcached_delete.3 b/docs/man/memcached_delete.3 index 7b08bad0..09895b27 100644 --- a/docs/man/memcached_delete.3 +++ b/docs/man/memcached_delete.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_DELETE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_DELETE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_delete \- libmemcached Documentation . @@ -45,9 +45,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_delete() is used to delete a particular key. -memcached_delete_by_key() works the same, but it takes a master key to -find the given value. +\fBmemcached_delete()\fP is used to delete a particular key. +\fBmemcached_delete_by_key()\fP works the same, but it takes a master key +to find the given value. .sp Expiration works by placing the item into a delete queue, which means that it won\(aqt be possible to retrieve it by the "get" command. The "add" and @@ -60,7 +60,8 @@ the 1.4 version. .sp A value of type \fBmemcached_return_t\fP is returned On success that value will be \fBMEMCACHED_SUCCESS\fP. -Use memcached_strerror() to translate this value to a printable string. +Use \fBmemcached_strerror()\fP to translate this value to a printable +string. .sp If you are using the non\-blocking mode of the library, success only means that the message was queued for delivery. diff --git a/docs/man/memcached_delete_by_key.3 b/docs/man/memcached_delete_by_key.3 index 705922a7..5009a838 100644 --- a/docs/man/memcached_delete_by_key.3 +++ b/docs/man/memcached_delete_by_key.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_DELETE_BY_KEY" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_DELETE_BY_KEY" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_delete_by_key \- libmemcached Documentation . @@ -45,9 +45,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_delete() is used to delete a particular key. -memcached_delete_by_key() works the same, but it takes a master key to -find the given value. +\fBmemcached_delete()\fP is used to delete a particular key. +\fBmemcached_delete_by_key()\fP works the same, but it takes a master key +to find the given value. .sp Expiration works by placing the item into a delete queue, which means that it won\(aqt be possible to retrieve it by the "get" command. The "add" and @@ -60,7 +60,8 @@ the 1.4 version. .sp A value of type \fBmemcached_return_t\fP is returned On success that value will be \fBMEMCACHED_SUCCESS\fP. -Use memcached_strerror() to translate this value to a printable string. +Use \fBmemcached_strerror()\fP to translate this value to a printable +string. .sp If you are using the non\-blocking mode of the library, success only means that the message was queued for delivery. diff --git a/docs/man/memcached_destroy_sasl_auth_data.3 b/docs/man/memcached_destroy_sasl_auth_data.3 index 7e57b62e..b70ec61a 100644 --- a/docs/man/memcached_destroy_sasl_auth_data.3 +++ b/docs/man/memcached_destroy_sasl_auth_data.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_DESTROY_SASL_AUTH_DATA" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_DESTROY_SASL_AUTH_DATA" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_destroy_sasl_auth_data \- libmemcached Documentation . @@ -59,21 +59,20 @@ libsasl to perform SASL authentication. Please note that SASL requires the memcached binary protocol, and you have to specify the callbacks before you connect to the server. .sp -memcached_set_sasl_auth_data() is a helper function defining +\fI\%memcached_set_sasl_auth_data()\fP is a helper function defining the basic functionality for you, but it will store the username and password in memory. If you choose to use this method you have to call -memcached_destroy_sasl_auth_data before calling memcached_free to avoid -a memory leak. You should NOT call memcached_destroy_sasl_auth_data if you -specify your own callback function with memcached_set_sasl_callbacks(). +\fI\%memcached_destroy_sasl_auth_data\fP before calling +\fBmemcached_free\fP to avoid a memory leak. You should NOT call +\fI\%memcached_destroy_sasl_auth_data\fP if you specify your own callback +function with \fI\%memcached_set_sasl_callbacks()\fP. .sp -You as a client user have to initialize libsasl by using sasl_client_init -before enabling it in libmemcached, and you have to shut down libsasl by -calling sasl_done() when you are done using SASL from libmemcached. +You as a client user have to initialize libsasl by using \fBsasl_client_init\fP before enabling it in libmemcached, and you have to shut down libsasl by +calling \fBsasl_done()\fP when you are done using SASL from libmemcached. .SH RETURN .sp -memcached_get_sasl_callbacks() returns the callbacks currently used -by this memcached handle. -memcached_get_sasl_set_auth_data() returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_get_sasl_callbacks()\fP returns the callbacks currently used +by this memcached handle. \fBmemcached_get_sasl_set_auth_data()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_dump.3 b/docs/man/memcached_dump.3 index 4a0f41e8..dfa5d92f 100644 --- a/docs/man/memcached_dump.3 +++ b/docs/man/memcached_dump.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_DUMP" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_DUMP" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_dump \- libmemcached Documentation . @@ -47,9 +47,9 @@ Get a list of keys found on memcached servers Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_dump() is used to get a list of keys found in memcached(1) servers. -Because memcached(1) does not guarentee to dump all keys you can not assume -you have fetched all keys from the server. The function takes an array +\fBmemcached_dump()\fP is used to get a list of keys found in memcached(1) +servers. Because memcached(1) does not guarentee to dump all keys you can not +assume you have fetched all keys from the server. The function takes an array of callbacks that it will use to execute on keys as they are found. .sp Currently the binary protocol is not testsed. @@ -57,7 +57,8 @@ Currently the binary protocol is not testsed. .sp A value of type \fBmemcached_return_t\fP is returned On success that value will be \fBMEMCACHED_SUCCESS\fP. -Use memcached_strerror() to translate this value to a printable string. +Use \fBmemcached_strerror()\fP to translate this value to a printable +string. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_fetch.3 b/docs/man/memcached_fetch.3 index de9e5242..879ee35b 100644 --- a/docs/man/memcached_fetch.3 +++ b/docs/man/memcached_fetch.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_FETCH" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_FETCH" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_fetch \- Retrieving data from the server . @@ -35,128 +35,34 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_result_st * memcached_fetch_result (memcached_st *ptr, memcached_result_st *result, memcached_return_t *error); -.UNINDENT -.INDENT 0.0 -.TP -.B char * memcached_get (memcached_st *ptr, const char *key, size_t key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); -.UNINDENT -.INDENT 0.0 -.TP -.B memcached_return_t memcached_mget (memcached_st *ptr, const char * const *keys, const size_t *key_length, size_t number_of_keys); -.UNINDENT -.INDENT 0.0 -.TP -.B char * memcached_get_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char *key, size_t key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); -.UNINDENT -.INDENT 0.0 -.TP -.B memcached_return_t memcached_mget_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char * const *keys, const size_t *key_length, size_t number_of_keys); -.UNINDENT -.INDENT 0.0 -.TP -.B char * memcached_fetch (memcached_st *ptr, char *key, size_t *key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); -.UNINDENT -.INDENT 0.0 -.TP -.B memcached_return_t memcached_fetch_execute (memcached_st *ptr, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); -.UNINDENT -.INDENT 0.0 -.TP -.B memcached_return_t memcached_mget_execute (memcached_st *ptr, const char * const *keys, const size_t *key_length, size_t number_of_keys, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); -.UNINDENT -.INDENT 0.0 -.TP -.B memcached_return_t memcached_mget_execute_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char * const *keys, const size_t *key_length, size_t number_of_keys, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); +.B char *memcached_fetch(memcached_st\fI\ *ptr\fP, char\fI\ *key\fP, size_t\fI\ *key_length\fP, size_t\fI\ *value_length\fP, uint32_t\fI\ *flags\fP, memcached_return_t\fI\ *error\fP) +.sp +Deprecated since version 0.50: Use \fBmemcached_fetch_result()\fP instead. .UNINDENT .sp Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_get() is used to fetch an individual value from the server. You -must pass in a key and its length to fetch the object. You must supply +\fI\%memcached_fetch()\fP is used to fetch an individual value from the server. \fBmemcached_mget()\fP must always be called before using this method. +You must pass in a key and its length to fetch the object. You must supply three pointer variables which will give you the state of the returned -object. A uint32_t pointer to contain whatever flags you stored with the value, -a size_t pointer which will be filled with size of of the object, and a -memcached_return_t pointer to hold any error. The object will be returned -upon success and NULL will be returned on failure. Any object returned by -memcached_get() must be released by the caller application. +object. A \fBuint32_t\fP pointer to contain whatever flags you stored with the value, a \fBsize_t\fP pointer which will be filled with size of of the +object, and a \fBmemcached_return_t\fP pointer to hold any error. The +object will be returned upon success and NULL will be returned on failure. \fBMEMCACHD_END\fP is returned by the *error value when all objects that have been found are returned. The final value upon \fBMEMCACHED_END\fP is null. .sp -memcached_mget() is used to select multiple keys at once. For multiple key -operations it is always faster to use this function. This function always -works asynchronously. memcached_fetch() is then used to retrieve any keys -found. No error is given on keys that are not found. You must call either -memcached_fetch() or memcached_fetch_result() after a successful call to -memcached_mget(). You should continue to call these functions until they -return NULL (aka no more values). If you need to quit in the middle of a -memcached_get() call, execute a memcached_quit(). After you do this, you can -issue new queries against the server. +Values returned by \fI\%memcached_fetch()\fP must be freed by the caller. .sp -memcached_fetch() is used to fetch an individual value from the server. -memcached_mget() must always be called before using this method. You -must pass in a key and its length to fetch the object. You must supply -three pointer variables which will give you the state of the returned -object. A uint32_t pointer to contain whatever flags you stored with the value, -a size_t pointer which will be filled with size of of the object, and a -memcached_return_t pointer to hold any error. The object will be returned -upon success and NULL will be returned on failure. \fBMEMCACHD_END\fP is -returned by the *error value when all objects that have been found are -returned. The final value upon \fBMEMCACHED_END\fP is null. Values -returned by memcached_fetch() must be freed by the caller. memcached_fetch() -will be DEPRECATED in the near future, memcached_fetch_result() should be -used instead. -.sp -memcached_fetch_result() is used to return a memcached_result_st(3) structure -from a memcached server. The result object is forward compatible with changes -to the server. For more information please refer to the memcached_result_st(3) -help. This function will dynamically allocate a result structure for you -if you do not pass one to the function. -.sp -memcached_fetch_execute() is a callback function for result sets. Instead -of returning the results to you for processing, it passes each of the -result sets to the list of functions you provide. It passes to the function -a memcached_st that can be cloned for use in the called function (it can not -be used directly). It also passes a result set which does not need to be freed. -Finally it passes a "context". This is just a pointer to a memory reference -you supply the calling function. Currently only one value is being passed -to each function call. In the future there will be an option to allow this -to be an array. -.sp -memcached_mget_execute() and memcached_mget_execute_by_key() is -similar to memcached_mget(), but it may trigger the supplied callbacks -with result sets while sending out the queries. If you try to perform -a really large multiget with memcached_mget() you may encounter a -deadlock in the OS kernel (it will fail to write data to the socket because -the input buffer is full). memcached_mget_execute() solves this -problem by processing some of the results before continuing sending -out requests. Please note that this function is only available in the -binary protocol. -.sp -memcached_get_by_key() and memcached_mget_by_key() behave in a similar nature -as memcached_get() and memcached_mget(). The difference is that they take -a master key that is used for determining which server an object was stored -if key partitioning was used for storage. -.sp -All of the above functions are not tested when the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPhas been set. Executing any of these functions with this behavior on will result in -\fBMEMCACHED_NOT_SUPPORTED\fP being returned, or for those functions which do not return -a \fBmemcached_return_t\fP, the error function parameter will be set to -\fBMEMCACHED_NOT_SUPPORTED\fP. +All of the above functions are not tested when the +\fBMEMCACHED_BEHAVIOR_USE_UDP\fP has been set. Executing any of these +functions with this behavior on will result in \fBMEMCACHED_NOT_SUPPORTED\fP being returned, or for those functions which do not return a \fBmemcached_return_t\fP, the error function parameter will be set to \fBMEMCACHED_NOT_SUPPORTED\fP. .SH RETURN .sp -All objects returned must be freed by the calling application. -memcached_get() and memcached_fetch() will return NULL on error. You must -look at the value of error to determine what the actual error was. -.sp -\fBmemcached_fetch_execute()\fP return \fBMEMCACHED_SUCCESS\fP if -all keys were successful. \fBMEMCACHED_NOTFOUND\fP will be return if no -keys at all were found. -.sp -\fBmemcached_fetch()\fP and \fBmemcached_fetch_result()\fP set error +\fI\%memcached_fetch()\fP sets error to to \fBMEMCACHED_END\fP upon successful conclusion. \fBMEMCACHED_NOTFOUND\fP will be return if no keys at all were found. .sp -MEMCACHED_KEY_TOO_BIG is set to error whenever memcached_fetch() was used -and the key was set larger then MEMCACHED_MAX_KEY, which was the largest +\fBMEMCACHED_KEY_TOO_BIG\fP is set to error whenever :c:\fBmemcached_fetch()\fP was used +and the key was set larger then \fBMEMCACHED_MAX_KEY\fP, which was the largest key allowed for the original memcached ascii server. .SH HOME .sp @@ -164,7 +70,7 @@ To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP \fImemcached_fetch_result(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_fetch_execute.3 b/docs/man/memcached_fetch_execute.3 index 0325e89a..4cd32156 100644 --- a/docs/man/memcached_fetch_execute.3 +++ b/docs/man/memcached_fetch_execute.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_FETCH_EXECUTE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_FETCH_EXECUTE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_fetch_execute \- Retrieving data from the server . @@ -35,129 +35,112 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_result_st * memcached_fetch_result (memcached_st *ptr, memcached_result_st *result, memcached_return_t *error); +.B memcached_result_st * memcached_fetch_result(memcached_st\fI\ *ptr\fP, memcached_result_st\fI\ *result\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_get (memcached_st *ptr, const char *key, size_t key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B char * memcached_get(memcached_st\fI\ *ptr\fP, const char\fI\ *key\fP, size_t\fI\ key_length\fP, size_t\fI\ *value_length\fP, uint32_t\fI\ *flags\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget (memcached_st *ptr, const char * const *keys, const size_t *key_length, size_t number_of_keys); +.B memcached_return_t memcached_mget(memcached_st\fI\ *ptr\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_get_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char *key, size_t key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B char * memcached_get_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char\fI\ *key\fP, size_t\fI\ key_length\fP, size_t\fI\ *value_length\fP, uint32_t\fI\ *flags\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char * const *keys, const size_t *key_length, size_t number_of_keys); +.B memcached_return_t memcached_mget_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_fetch (memcached_st *ptr, char *key, size_t *key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B memcached_return_t memcached_fetch_execute(memcached_st\fI\ *ptr\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_fetch_execute (memcached_st *ptr, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); +.B memcached_return_t memcached_mget_execute(memcached_st\fI\ *ptr\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget_execute (memcached_st *ptr, const char * const *keys, const size_t *key_length, size_t number_of_keys, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); -.UNINDENT -.INDENT 0.0 -.TP -.B memcached_return_t memcached_mget_execute_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char * const *keys, const size_t *key_length, size_t number_of_keys, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); +.B memcached_return_t memcached_mget_execute_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .sp Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_get() is used to fetch an individual value from the server. You -must pass in a key and its length to fetch the object. You must supply +\fI\%memcached_get()\fP is used to fetch an individual value from the server. +You must pass in a key and its length to fetch the object. You must supply three pointer variables which will give you the state of the returned -object. A uint32_t pointer to contain whatever flags you stored with the value, -a size_t pointer which will be filled with size of of the object, and a -memcached_return_t pointer to hold any error. The object will be returned -upon success and NULL will be returned on failure. Any object returned by -memcached_get() must be released by the caller application. -.sp -memcached_mget() is used to select multiple keys at once. For multiple key -operations it is always faster to use this function. This function always -works asynchronously. memcached_fetch() is then used to retrieve any keys -found. No error is given on keys that are not found. You must call either -memcached_fetch() or memcached_fetch_result() after a successful call to -memcached_mget(). You should continue to call these functions until they -return NULL (aka no more values). If you need to quit in the middle of a -memcached_get() call, execute a memcached_quit(). After you do this, you can -issue new queries against the server. -.sp -memcached_fetch() is used to fetch an individual value from the server. -memcached_mget() must always be called before using this method. You -must pass in a key and its length to fetch the object. You must supply +object. A \fBuint32_t\fP pointer to contain whatever flags you stored with the value, a \fBsize_t\fP pointer which will be filled with size of of +the object, and a \fBmemcached_return_t\fP pointer to hold any error. The +object will be returned upon success and NULL will be returned on failure. Any +object returned by \fI\%memcached_get()\fP must be released by the caller +application. +.sp +\fI\%memcached_mget()\fP is used to select multiple keys at once. For +multiple key operations it is always faster to use this function. This function always works asynchronously. +.sp +To retrieve data after a successful execution of \fI\%memcached_mget()\fP, you will need to +call \fI\%memcached_fetch_result()\fP. You should continue to call this function until +it returns a NULL (i.e. no more values). If you need to quit in the middle of a +\fI\%memcached_mget()\fP call, you can execute a \fBmemcached_quit()\fP, those this is not required. +.sp +\fI\%memcached_fetch_result()\fP is used to fetch an individual value from the server. \fI\%memcached_mget()\fP must always be called before using this method. +You must pass in a key and its length to fetch the object. You must supply three pointer variables which will give you the state of the returned -object. A uint32_t pointer to contain whatever flags you stored with the value, -a size_t pointer which will be filled with size of of the object, and a -memcached_return_t pointer to hold any error. The object will be returned -upon success and NULL will be returned on failure. \fBMEMCACHD_END\fP is -returned by the *error value when all objects that have been found are -returned. The final value upon \fBMEMCACHED_END\fP is null. Values -returned by memcached_fetch() must be freed by the caller. memcached_fetch() -will be DEPRECATED in the near future, memcached_fetch_result() should be -used instead. -.sp -memcached_fetch_result() is used to return a memcached_result_st(3) structure -from a memcached server. The result object is forward compatible with changes -to the server. For more information please refer to the memcached_result_st(3) -help. This function will dynamically allocate a result structure for you -if you do not pass one to the function. -.sp -memcached_fetch_execute() is a callback function for result sets. Instead -of returning the results to you for processing, it passes each of the +object. A \fBuint32_t\fP pointer to contain whatever flags you stored with the value, a \fBsize_t\fP pointer which will be filled with size of of the +object, and a \fBmemcached_return_t\fP pointer to hold any error. The +object will be returned upon success and NULL will be returned on failure. \fBMEMCACHD_END\fP is returned by the *error value when all objects that have been found are returned. The final value upon \fBMEMCACHED_END\fP is null. +.sp +\fI\%memcached_fetch_result()\fP is used to return a \fBmemcached_result_st\fP structure from a memcached server. The result object is forward compatible +with changes to the server. For more information please refer to the +\fBmemcached_result_st\fP help. This function will dynamically allocate a +result structure for you if you do not pass one to the function. +.sp +\fI\%memcached_fetch_execute()\fP is a callback function for result sets. +Instead of returning the results to you for processing, it passes each of the result sets to the list of functions you provide. It passes to the function -a memcached_st that can be cloned for use in the called function (it can not -be used directly). It also passes a result set which does not need to be freed. -Finally it passes a "context". This is just a pointer to a memory reference -you supply the calling function. Currently only one value is being passed -to each function call. In the future there will be an option to allow this -to be an array. -.sp -memcached_mget_execute() and memcached_mget_execute_by_key() is -similar to memcached_mget(), but it may trigger the supplied callbacks -with result sets while sending out the queries. If you try to perform -a really large multiget with memcached_mget() you may encounter a -deadlock in the OS kernel (it will fail to write data to the socket because -the input buffer is full). memcached_mget_execute() solves this -problem by processing some of the results before continuing sending -out requests. Please note that this function is only available in the -binary protocol. -.sp -memcached_get_by_key() and memcached_mget_by_key() behave in a similar nature -as memcached_get() and memcached_mget(). The difference is that they take -a master key that is used for determining which server an object was stored -if key partitioning was used for storage. -.sp -All of the above functions are not tested when the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPhas been set. Executing any of these functions with this behavior on will result in -\fBMEMCACHED_NOT_SUPPORTED\fP being returned, or for those functions which do not return -a \fBmemcached_return_t\fP, the error function parameter will be set to -\fBMEMCACHED_NOT_SUPPORTED\fP. +a \fBmemcached_st\fP that can be cloned for use in the called +function (it can not be used directly). It also passes a result set which does +not need to be freed. Finally it passes a "context". This is just a pointer to +a memory reference you supply the calling function. Currently only one value +is being passed to each function call. In the future there will be an option +to allow this to be an array. +.sp +\fI\%memcached_mget_execute()\fP and \fI\%memcached_mget_execute_by_key()\fP +is similar to \fI\%memcached_mget()\fP, but it may trigger the supplied +callbacks with result sets while sending out the queries. If you try to +perform a really large multiget with \fI\%memcached_mget()\fP you may +encounter a deadlock in the OS kernel (it will fail to write data to the +socket because the input buffer is full). \fI\%memcached_mget_execute()\fP +solves this problem by processing some of the results before continuing +sending out requests. Please note that this function is only available in +the binary protocol. +.sp +\fI\%memcached_get_by_key()\fP and \fI\%memcached_mget_by_key()\fP behave +in a similar nature as \fI\%memcached_get()\fP and \fI\%memcached_mget()\fP. +The difference is that they take a master key that is used for determining +which server an object was stored if key partitioning was used for storage. +.sp +All of the above functions are not tested when the +\fBMEMCACHED_BEHAVIOR_USE_UDP\fP has been set. Executing any of these +functions with this behavior on will result in \fBMEMCACHED_NOT_SUPPORTED\fP being returned, or for those functions which do not return a \fBmemcached_return_t\fP, the error function parameter will be set to \fBMEMCACHED_NOT_SUPPORTED\fP. .SH RETURN .sp -All objects returned must be freed by the calling application. -memcached_get() and memcached_fetch() will return NULL on error. You must -look at the value of error to determine what the actual error was. +All objects retrieved via \fI\%memcached_get()\fP or \fI\%memcached_get_by_key()\fP must be freed with \fIfree(3)\fP. +.sp +\fI\%memcached_get()\fP will return NULL on +error. You must look at the value of error to determine what the actual error +was. .sp -\fBmemcached_fetch_execute()\fP return \fBMEMCACHED_SUCCESS\fP if +\fI\%memcached_fetch_execute()\fP return \fBMEMCACHED_SUCCESS\fP if all keys were successful. \fBMEMCACHED_NOTFOUND\fP will be return if no keys at all were found. .sp -\fBmemcached_fetch()\fP and \fBmemcached_fetch_result()\fP set error +\fI\%memcached_fetch_result()\fP sets error to \fBMEMCACHED_END\fP upon successful conclusion. \fBMEMCACHED_NOTFOUND\fP will be return if no keys at all were found. -.sp -MEMCACHED_KEY_TOO_BIG is set to error whenever memcached_fetch() was used -and the key was set larger then MEMCACHED_MAX_KEY, which was the largest -key allowed for the original memcached ascii server. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_fetch_result.3 b/docs/man/memcached_fetch_result.3 index 3b878db0..f44287a1 100644 --- a/docs/man/memcached_fetch_result.3 +++ b/docs/man/memcached_fetch_result.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_FETCH_RESULT" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_FETCH_RESULT" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_fetch_result \- Retrieving data from the server . @@ -35,129 +35,112 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_result_st * memcached_fetch_result (memcached_st *ptr, memcached_result_st *result, memcached_return_t *error); +.B memcached_result_st * memcached_fetch_result(memcached_st\fI\ *ptr\fP, memcached_result_st\fI\ *result\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_get (memcached_st *ptr, const char *key, size_t key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B char * memcached_get(memcached_st\fI\ *ptr\fP, const char\fI\ *key\fP, size_t\fI\ key_length\fP, size_t\fI\ *value_length\fP, uint32_t\fI\ *flags\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget (memcached_st *ptr, const char * const *keys, const size_t *key_length, size_t number_of_keys); +.B memcached_return_t memcached_mget(memcached_st\fI\ *ptr\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_get_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char *key, size_t key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B char * memcached_get_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char\fI\ *key\fP, size_t\fI\ key_length\fP, size_t\fI\ *value_length\fP, uint32_t\fI\ *flags\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char * const *keys, const size_t *key_length, size_t number_of_keys); +.B memcached_return_t memcached_mget_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_fetch (memcached_st *ptr, char *key, size_t *key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B memcached_return_t memcached_fetch_execute(memcached_st\fI\ *ptr\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_fetch_execute (memcached_st *ptr, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); +.B memcached_return_t memcached_mget_execute(memcached_st\fI\ *ptr\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget_execute (memcached_st *ptr, const char * const *keys, const size_t *key_length, size_t number_of_keys, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); -.UNINDENT -.INDENT 0.0 -.TP -.B memcached_return_t memcached_mget_execute_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char * const *keys, const size_t *key_length, size_t number_of_keys, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); +.B memcached_return_t memcached_mget_execute_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .sp Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_get() is used to fetch an individual value from the server. You -must pass in a key and its length to fetch the object. You must supply +\fI\%memcached_get()\fP is used to fetch an individual value from the server. +You must pass in a key and its length to fetch the object. You must supply three pointer variables which will give you the state of the returned -object. A uint32_t pointer to contain whatever flags you stored with the value, -a size_t pointer which will be filled with size of of the object, and a -memcached_return_t pointer to hold any error. The object will be returned -upon success and NULL will be returned on failure. Any object returned by -memcached_get() must be released by the caller application. -.sp -memcached_mget() is used to select multiple keys at once. For multiple key -operations it is always faster to use this function. This function always -works asynchronously. memcached_fetch() is then used to retrieve any keys -found. No error is given on keys that are not found. You must call either -memcached_fetch() or memcached_fetch_result() after a successful call to -memcached_mget(). You should continue to call these functions until they -return NULL (aka no more values). If you need to quit in the middle of a -memcached_get() call, execute a memcached_quit(). After you do this, you can -issue new queries against the server. -.sp -memcached_fetch() is used to fetch an individual value from the server. -memcached_mget() must always be called before using this method. You -must pass in a key and its length to fetch the object. You must supply +object. A \fBuint32_t\fP pointer to contain whatever flags you stored with the value, a \fBsize_t\fP pointer which will be filled with size of of +the object, and a \fBmemcached_return_t\fP pointer to hold any error. The +object will be returned upon success and NULL will be returned on failure. Any +object returned by \fI\%memcached_get()\fP must be released by the caller +application. +.sp +\fI\%memcached_mget()\fP is used to select multiple keys at once. For +multiple key operations it is always faster to use this function. This function always works asynchronously. +.sp +To retrieve data after a successful execution of \fI\%memcached_mget()\fP, you will need to +call \fI\%memcached_fetch_result()\fP. You should continue to call this function until +it returns a NULL (i.e. no more values). If you need to quit in the middle of a +\fI\%memcached_mget()\fP call, you can execute a \fBmemcached_quit()\fP, those this is not required. +.sp +\fI\%memcached_fetch_result()\fP is used to fetch an individual value from the server. \fI\%memcached_mget()\fP must always be called before using this method. +You must pass in a key and its length to fetch the object. You must supply three pointer variables which will give you the state of the returned -object. A uint32_t pointer to contain whatever flags you stored with the value, -a size_t pointer which will be filled with size of of the object, and a -memcached_return_t pointer to hold any error. The object will be returned -upon success and NULL will be returned on failure. \fBMEMCACHD_END\fP is -returned by the *error value when all objects that have been found are -returned. The final value upon \fBMEMCACHED_END\fP is null. Values -returned by memcached_fetch() must be freed by the caller. memcached_fetch() -will be DEPRECATED in the near future, memcached_fetch_result() should be -used instead. -.sp -memcached_fetch_result() is used to return a memcached_result_st(3) structure -from a memcached server. The result object is forward compatible with changes -to the server. For more information please refer to the memcached_result_st(3) -help. This function will dynamically allocate a result structure for you -if you do not pass one to the function. -.sp -memcached_fetch_execute() is a callback function for result sets. Instead -of returning the results to you for processing, it passes each of the +object. A \fBuint32_t\fP pointer to contain whatever flags you stored with the value, a \fBsize_t\fP pointer which will be filled with size of of the +object, and a \fBmemcached_return_t\fP pointer to hold any error. The +object will be returned upon success and NULL will be returned on failure. \fBMEMCACHD_END\fP is returned by the *error value when all objects that have been found are returned. The final value upon \fBMEMCACHED_END\fP is null. +.sp +\fI\%memcached_fetch_result()\fP is used to return a \fBmemcached_result_st\fP structure from a memcached server. The result object is forward compatible +with changes to the server. For more information please refer to the +\fBmemcached_result_st\fP help. This function will dynamically allocate a +result structure for you if you do not pass one to the function. +.sp +\fI\%memcached_fetch_execute()\fP is a callback function for result sets. +Instead of returning the results to you for processing, it passes each of the result sets to the list of functions you provide. It passes to the function -a memcached_st that can be cloned for use in the called function (it can not -be used directly). It also passes a result set which does not need to be freed. -Finally it passes a "context". This is just a pointer to a memory reference -you supply the calling function. Currently only one value is being passed -to each function call. In the future there will be an option to allow this -to be an array. -.sp -memcached_mget_execute() and memcached_mget_execute_by_key() is -similar to memcached_mget(), but it may trigger the supplied callbacks -with result sets while sending out the queries. If you try to perform -a really large multiget with memcached_mget() you may encounter a -deadlock in the OS kernel (it will fail to write data to the socket because -the input buffer is full). memcached_mget_execute() solves this -problem by processing some of the results before continuing sending -out requests. Please note that this function is only available in the -binary protocol. -.sp -memcached_get_by_key() and memcached_mget_by_key() behave in a similar nature -as memcached_get() and memcached_mget(). The difference is that they take -a master key that is used for determining which server an object was stored -if key partitioning was used for storage. -.sp -All of the above functions are not tested when the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPhas been set. Executing any of these functions with this behavior on will result in -\fBMEMCACHED_NOT_SUPPORTED\fP being returned, or for those functions which do not return -a \fBmemcached_return_t\fP, the error function parameter will be set to -\fBMEMCACHED_NOT_SUPPORTED\fP. +a \fBmemcached_st\fP that can be cloned for use in the called +function (it can not be used directly). It also passes a result set which does +not need to be freed. Finally it passes a "context". This is just a pointer to +a memory reference you supply the calling function. Currently only one value +is being passed to each function call. In the future there will be an option +to allow this to be an array. +.sp +\fI\%memcached_mget_execute()\fP and \fI\%memcached_mget_execute_by_key()\fP +is similar to \fI\%memcached_mget()\fP, but it may trigger the supplied +callbacks with result sets while sending out the queries. If you try to +perform a really large multiget with \fI\%memcached_mget()\fP you may +encounter a deadlock in the OS kernel (it will fail to write data to the +socket because the input buffer is full). \fI\%memcached_mget_execute()\fP +solves this problem by processing some of the results before continuing +sending out requests. Please note that this function is only available in +the binary protocol. +.sp +\fI\%memcached_get_by_key()\fP and \fI\%memcached_mget_by_key()\fP behave +in a similar nature as \fI\%memcached_get()\fP and \fI\%memcached_mget()\fP. +The difference is that they take a master key that is used for determining +which server an object was stored if key partitioning was used for storage. +.sp +All of the above functions are not tested when the +\fBMEMCACHED_BEHAVIOR_USE_UDP\fP has been set. Executing any of these +functions with this behavior on will result in \fBMEMCACHED_NOT_SUPPORTED\fP being returned, or for those functions which do not return a \fBmemcached_return_t\fP, the error function parameter will be set to \fBMEMCACHED_NOT_SUPPORTED\fP. .SH RETURN .sp -All objects returned must be freed by the calling application. -memcached_get() and memcached_fetch() will return NULL on error. You must -look at the value of error to determine what the actual error was. +All objects retrieved via \fI\%memcached_get()\fP or \fI\%memcached_get_by_key()\fP must be freed with \fIfree(3)\fP. +.sp +\fI\%memcached_get()\fP will return NULL on +error. You must look at the value of error to determine what the actual error +was. .sp -\fBmemcached_fetch_execute()\fP return \fBMEMCACHED_SUCCESS\fP if +\fI\%memcached_fetch_execute()\fP return \fBMEMCACHED_SUCCESS\fP if all keys were successful. \fBMEMCACHED_NOTFOUND\fP will be return if no keys at all were found. .sp -\fBmemcached_fetch()\fP and \fBmemcached_fetch_result()\fP set error +\fI\%memcached_fetch_result()\fP sets error to \fBMEMCACHED_END\fP upon successful conclusion. \fBMEMCACHED_NOTFOUND\fP will be return if no keys at all were found. -.sp -MEMCACHED_KEY_TOO_BIG is set to error whenever memcached_fetch() was used -and the key was set larger then MEMCACHED_MAX_KEY, which was the largest -key allowed for the original memcached ascii server. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_flush.3 b/docs/man/memcached_flush.3 index 71b5c4a4..49537423 100644 --- a/docs/man/memcached_flush.3 +++ b/docs/man/memcached_flush.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_FLUSH" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_FLUSH" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_flush \- libmemcached Documentation . @@ -43,7 +43,7 @@ Wipe contents of memcached servers Compile and link with \-lmemcached .SH DESCRIPTION .sp -:c:func::\fImemcached_flush()\fP is used to wipe clean the contents of memcached(1) servers. +:c:func::\fImemcached_flush()\fP is used to wipe clean the contents of \fBmemcached\fP servers. It will either do this immediately or expire the content based on the expiration time passed to the method (a value of zero causes an immediate flush). The operation is not atomic to multiple servers, just atomic to a @@ -51,7 +51,7 @@ single server. That is, it will flush the servers in the order that they were added. .SH RETURN .sp -A value of type \fBmemcached_return_t\fP is returned +A value of type \fBmemcached_return_t\fP is returned On success that value will be \fBMEMCACHED_SUCCESS\fP. Use \fBmemcached_strerror()\fP to translate this value to a printable string. .SH HOME diff --git a/docs/man/memcached_flush_buffers.3 b/docs/man/memcached_flush_buffers.3 index fd653296..696b302a 100644 --- a/docs/man/memcached_flush_buffers.3 +++ b/docs/man/memcached_flush_buffers.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_FLUSH_BUFFERS" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_FLUSH_BUFFERS" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_flush_buffers \- libmemcached Documentation . @@ -43,14 +43,14 @@ Flush and senf buffered commands Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_flush_buffers() is used in conjunction with -MEMCACHED_BEHAVIOR_BUFFER_REQUESTS (see memcached_behavior(3)) to flush -all buffers by sending the buffered commands to the server for processing. +\fBmemcached_flush_buffers()\fP is used in conjunction with +\fBMEMCACHED_BEHAVIOR_BUFFER_REQUESTS\fP (see memcached_behavior(3)) to flush all buffers by sending the buffered commands to the server for processing. .SH RETURN .sp A value of type \fBmemcached_return_t\fP is returned On success that value will be \fBMEMCACHED_SUCCESS\fP. -Use memcached_strerror() to translate this value to a printable string. +Use \fBmemcached_strerror()\fP to translate this value to a printable +string. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_free.3 b/docs/man/memcached_free.3 index 82c10f4d..036d8fad 100644 --- a/docs/man/memcached_free.3 +++ b/docs/man/memcached_free.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_FREE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_FREE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_free \- libmemcached Documentation . @@ -35,54 +35,63 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_st *memcached_create (memcached_st *ptr); +.B memcachd_st .UNINDENT .INDENT 0.0 .TP -.B void memcached_free (memcached_st *ptr); +.B memcached_st* memcached_create(memcached_st\fI\ *ptr\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st *memcached_clone (memcached_st *destination, memcached_st *source); +.B void memcached_free(memcached_st\fI\ *ptr\fP) .UNINDENT .INDENT 0.0 .TP -.B void memcached_servers_reset(memcached_st); +.B memcached_st* memcached_clone(memcached_st\fI\ *destination\fP, memcached_st\fI\ *source\fP) +.UNINDENT +.INDENT 0.0 +.TP +.B void memcached_servers_reset(memcached_st) .UNINDENT .sp Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_create() is used to create a \fBmemcached_st\fP structure that will then -be used by other libmemcached(3) functions to communicate with the server. You -should either pass a statically declared \fBmemcached_st\fP to memcached_create() or +\fI\%memcached_create()\fP is used to create a \fBmemcached_st\fP +structure that will then be used by other libmemcached(3) functions to +communicate with the server. You should either pass a statically declared +\fBmemcached_st\fP to \fI\%memcached_create()\fP or a NULL. If a NULL passed in then a structure is allocated for you. .sp -Please note, when you write new application use memcached_create_with_options() over memcached_create(). +Please note, when you write new application use +\fBmemcached_create_with_options()\fP over +\fI\%memcached_create()\fP. .sp -memcached_clone() is similar to memcached_create(3) but it copies the -defaults and list of servers from the source \fBmemcached_st\fP. If you pass a null as -the argument for the source to clone, it is the same as a call to memcached_create(). -If the destination argument is NULL a \fBmemcached_st\fP will be allocated for you. +\fI\%memcached_clone()\fP is similar to \fI\%memcached_create()\fP but +it copies the defaults and list of servers from the source +\fBmemcached_st\fP. If you pass a null as the argument for the source +to clone, it is the same as a call to \fI\%memcached_create()\fP. +If the destination argument is NULL a \fBmemcached_st\fP will be allocated +for you. .sp -memcached_servers_reset() allows you to zero out the list of servers that -the memcached_st has. +\fI\%memcached_servers_reset()\fP allows you to zero out the list of +servers that the \fBmemcached_st\fP has. .sp -To clean up memory associated with a \fBmemcached_st\fP structure you should pass -it to memcached_free() when you are finished using it. memcached_free() is -the only way to make sure all memory is deallocated when you finish using -the structure. +To clean up memory associated with a \fBmemcached_st\fP structure you +should pass it to \fI\%memcached_free()\fP when you are finished using it. +\fI\%memcached_free()\fP is the only way to make sure all memory is +deallocated when you finish using the structure. .sp You may wish to avoid using memcached_create(3) or memcached_clone(3) with a stack based allocation. The most common issues related to ABI safety involve heap allocated structures. .SH RETURN .sp -memcached_create() returns a pointer to the memcached_st that was created -(or initialized). On an allocation failure, it returns NULL. +\fI\%memcached_create()\fP returns a pointer to the \fBmemcached_st\fP +that was created (or initialized). On an allocation failure, it returns NULL. .sp -memcached_clone() returns a pointer to the memcached_st that was created -(or initialized). On an allocation failure, it returns NULL. +\fI\%memcached_clone()\fP returns a pointer to the \fBmemcached_st\fP +that was created (or initialized). On an allocation failure, it returns NULL. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_generate_hash.3 b/docs/man/memcached_generate_hash.3 index 3db8e4c6..0b95c6ca 100644 --- a/docs/man/memcached_generate_hash.3 +++ b/docs/man/memcached_generate_hash.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_GENERATE_HASH" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_GENERATE_HASH" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_generate_hash \- Generating hash values directly . @@ -47,17 +47,17 @@ Hash a key value Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -memcached_generate_hash_value() allows you to hash a key using one of +\fBmemcached_generate_hash_value()\fP allows you to hash a key using one of the hash functions defined in the library. This method is provided for the convenience of higher\-level language bindings and is not necessary for normal memcache operations. .sp The allowed hash algorithm constants are listed in the manpage for -memcached_behavior_set(). +\fBmemcached_behavior_set()\fP. .sp -memcached_generate_hash() takes a memcached_st struture and produces -the hash value that would have been generated based on the defaults -of the memcached_st structure. +\fBmemcached_generate_hash()\fP takes a \fBmemcached_st\fP struture +and produces the hash value that would have been generated based on the +defaults of the \fBmemcached_st structure\fP. .sp As of version 0.36 all hash methods have been placed into the library libhashkit(3) which is linked with libmemcached(3). For more information please see its documentation. diff --git a/docs/man/memcached_generate_hash_value.3 b/docs/man/memcached_generate_hash_value.3 index c167ed92..aa7ac740 100644 --- a/docs/man/memcached_generate_hash_value.3 +++ b/docs/man/memcached_generate_hash_value.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_GENERATE_HASH_VALUE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_GENERATE_HASH_VALUE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_generate_hash_value \- Generating hash values directly . @@ -47,17 +47,17 @@ Hash a key value Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -memcached_generate_hash_value() allows you to hash a key using one of +\fBmemcached_generate_hash_value()\fP allows you to hash a key using one of the hash functions defined in the library. This method is provided for the convenience of higher\-level language bindings and is not necessary for normal memcache operations. .sp The allowed hash algorithm constants are listed in the manpage for -memcached_behavior_set(). +\fBmemcached_behavior_set()\fP. .sp -memcached_generate_hash() takes a memcached_st struture and produces -the hash value that would have been generated based on the defaults -of the memcached_st structure. +\fBmemcached_generate_hash()\fP takes a \fBmemcached_st\fP struture +and produces the hash value that would have been generated based on the +defaults of the \fBmemcached_st structure\fP. .sp As of version 0.36 all hash methods have been placed into the library libhashkit(3) which is linked with libmemcached(3). For more information please see its documentation. diff --git a/docs/man/memcached_get.3 b/docs/man/memcached_get.3 index 990e37fe..4a5a7684 100644 --- a/docs/man/memcached_get.3 +++ b/docs/man/memcached_get.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_GET" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_GET" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_get \- Retrieving data from the server . @@ -35,129 +35,112 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_result_st * memcached_fetch_result (memcached_st *ptr, memcached_result_st *result, memcached_return_t *error); +.B memcached_result_st * memcached_fetch_result(memcached_st\fI\ *ptr\fP, memcached_result_st\fI\ *result\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_get (memcached_st *ptr, const char *key, size_t key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B char * memcached_get(memcached_st\fI\ *ptr\fP, const char\fI\ *key\fP, size_t\fI\ key_length\fP, size_t\fI\ *value_length\fP, uint32_t\fI\ *flags\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget (memcached_st *ptr, const char * const *keys, const size_t *key_length, size_t number_of_keys); +.B memcached_return_t memcached_mget(memcached_st\fI\ *ptr\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_get_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char *key, size_t key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B char * memcached_get_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char\fI\ *key\fP, size_t\fI\ key_length\fP, size_t\fI\ *value_length\fP, uint32_t\fI\ *flags\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char * const *keys, const size_t *key_length, size_t number_of_keys); +.B memcached_return_t memcached_mget_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_fetch (memcached_st *ptr, char *key, size_t *key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B memcached_return_t memcached_fetch_execute(memcached_st\fI\ *ptr\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_fetch_execute (memcached_st *ptr, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); +.B memcached_return_t memcached_mget_execute(memcached_st\fI\ *ptr\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget_execute (memcached_st *ptr, const char * const *keys, const size_t *key_length, size_t number_of_keys, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); -.UNINDENT -.INDENT 0.0 -.TP -.B memcached_return_t memcached_mget_execute_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char * const *keys, const size_t *key_length, size_t number_of_keys, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); +.B memcached_return_t memcached_mget_execute_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .sp Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_get() is used to fetch an individual value from the server. You -must pass in a key and its length to fetch the object. You must supply +\fI\%memcached_get()\fP is used to fetch an individual value from the server. +You must pass in a key and its length to fetch the object. You must supply three pointer variables which will give you the state of the returned -object. A uint32_t pointer to contain whatever flags you stored with the value, -a size_t pointer which will be filled with size of of the object, and a -memcached_return_t pointer to hold any error. The object will be returned -upon success and NULL will be returned on failure. Any object returned by -memcached_get() must be released by the caller application. -.sp -memcached_mget() is used to select multiple keys at once. For multiple key -operations it is always faster to use this function. This function always -works asynchronously. memcached_fetch() is then used to retrieve any keys -found. No error is given on keys that are not found. You must call either -memcached_fetch() or memcached_fetch_result() after a successful call to -memcached_mget(). You should continue to call these functions until they -return NULL (aka no more values). If you need to quit in the middle of a -memcached_get() call, execute a memcached_quit(). After you do this, you can -issue new queries against the server. -.sp -memcached_fetch() is used to fetch an individual value from the server. -memcached_mget() must always be called before using this method. You -must pass in a key and its length to fetch the object. You must supply +object. A \fBuint32_t\fP pointer to contain whatever flags you stored with the value, a \fBsize_t\fP pointer which will be filled with size of of +the object, and a \fBmemcached_return_t\fP pointer to hold any error. The +object will be returned upon success and NULL will be returned on failure. Any +object returned by \fI\%memcached_get()\fP must be released by the caller +application. +.sp +\fI\%memcached_mget()\fP is used to select multiple keys at once. For +multiple key operations it is always faster to use this function. This function always works asynchronously. +.sp +To retrieve data after a successful execution of \fI\%memcached_mget()\fP, you will need to +call \fI\%memcached_fetch_result()\fP. You should continue to call this function until +it returns a NULL (i.e. no more values). If you need to quit in the middle of a +\fI\%memcached_mget()\fP call, you can execute a \fBmemcached_quit()\fP, those this is not required. +.sp +\fI\%memcached_fetch_result()\fP is used to fetch an individual value from the server. \fI\%memcached_mget()\fP must always be called before using this method. +You must pass in a key and its length to fetch the object. You must supply three pointer variables which will give you the state of the returned -object. A uint32_t pointer to contain whatever flags you stored with the value, -a size_t pointer which will be filled with size of of the object, and a -memcached_return_t pointer to hold any error. The object will be returned -upon success and NULL will be returned on failure. \fBMEMCACHD_END\fP is -returned by the *error value when all objects that have been found are -returned. The final value upon \fBMEMCACHED_END\fP is null. Values -returned by memcached_fetch() must be freed by the caller. memcached_fetch() -will be DEPRECATED in the near future, memcached_fetch_result() should be -used instead. -.sp -memcached_fetch_result() is used to return a memcached_result_st(3) structure -from a memcached server. The result object is forward compatible with changes -to the server. For more information please refer to the memcached_result_st(3) -help. This function will dynamically allocate a result structure for you -if you do not pass one to the function. -.sp -memcached_fetch_execute() is a callback function for result sets. Instead -of returning the results to you for processing, it passes each of the +object. A \fBuint32_t\fP pointer to contain whatever flags you stored with the value, a \fBsize_t\fP pointer which will be filled with size of of the +object, and a \fBmemcached_return_t\fP pointer to hold any error. The +object will be returned upon success and NULL will be returned on failure. \fBMEMCACHD_END\fP is returned by the *error value when all objects that have been found are returned. The final value upon \fBMEMCACHED_END\fP is null. +.sp +\fI\%memcached_fetch_result()\fP is used to return a \fBmemcached_result_st\fP structure from a memcached server. The result object is forward compatible +with changes to the server. For more information please refer to the +\fBmemcached_result_st\fP help. This function will dynamically allocate a +result structure for you if you do not pass one to the function. +.sp +\fI\%memcached_fetch_execute()\fP is a callback function for result sets. +Instead of returning the results to you for processing, it passes each of the result sets to the list of functions you provide. It passes to the function -a memcached_st that can be cloned for use in the called function (it can not -be used directly). It also passes a result set which does not need to be freed. -Finally it passes a "context". This is just a pointer to a memory reference -you supply the calling function. Currently only one value is being passed -to each function call. In the future there will be an option to allow this -to be an array. -.sp -memcached_mget_execute() and memcached_mget_execute_by_key() is -similar to memcached_mget(), but it may trigger the supplied callbacks -with result sets while sending out the queries. If you try to perform -a really large multiget with memcached_mget() you may encounter a -deadlock in the OS kernel (it will fail to write data to the socket because -the input buffer is full). memcached_mget_execute() solves this -problem by processing some of the results before continuing sending -out requests. Please note that this function is only available in the -binary protocol. -.sp -memcached_get_by_key() and memcached_mget_by_key() behave in a similar nature -as memcached_get() and memcached_mget(). The difference is that they take -a master key that is used for determining which server an object was stored -if key partitioning was used for storage. -.sp -All of the above functions are not tested when the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPhas been set. Executing any of these functions with this behavior on will result in -\fBMEMCACHED_NOT_SUPPORTED\fP being returned, or for those functions which do not return -a \fBmemcached_return_t\fP, the error function parameter will be set to -\fBMEMCACHED_NOT_SUPPORTED\fP. +a \fBmemcached_st\fP that can be cloned for use in the called +function (it can not be used directly). It also passes a result set which does +not need to be freed. Finally it passes a "context". This is just a pointer to +a memory reference you supply the calling function. Currently only one value +is being passed to each function call. In the future there will be an option +to allow this to be an array. +.sp +\fI\%memcached_mget_execute()\fP and \fI\%memcached_mget_execute_by_key()\fP +is similar to \fI\%memcached_mget()\fP, but it may trigger the supplied +callbacks with result sets while sending out the queries. If you try to +perform a really large multiget with \fI\%memcached_mget()\fP you may +encounter a deadlock in the OS kernel (it will fail to write data to the +socket because the input buffer is full). \fI\%memcached_mget_execute()\fP +solves this problem by processing some of the results before continuing +sending out requests. Please note that this function is only available in +the binary protocol. +.sp +\fI\%memcached_get_by_key()\fP and \fI\%memcached_mget_by_key()\fP behave +in a similar nature as \fI\%memcached_get()\fP and \fI\%memcached_mget()\fP. +The difference is that they take a master key that is used for determining +which server an object was stored if key partitioning was used for storage. +.sp +All of the above functions are not tested when the +\fBMEMCACHED_BEHAVIOR_USE_UDP\fP has been set. Executing any of these +functions with this behavior on will result in \fBMEMCACHED_NOT_SUPPORTED\fP being returned, or for those functions which do not return a \fBmemcached_return_t\fP, the error function parameter will be set to \fBMEMCACHED_NOT_SUPPORTED\fP. .SH RETURN .sp -All objects returned must be freed by the calling application. -memcached_get() and memcached_fetch() will return NULL on error. You must -look at the value of error to determine what the actual error was. +All objects retrieved via \fI\%memcached_get()\fP or \fI\%memcached_get_by_key()\fP must be freed with \fIfree(3)\fP. +.sp +\fI\%memcached_get()\fP will return NULL on +error. You must look at the value of error to determine what the actual error +was. .sp -\fBmemcached_fetch_execute()\fP return \fBMEMCACHED_SUCCESS\fP if +\fI\%memcached_fetch_execute()\fP return \fBMEMCACHED_SUCCESS\fP if all keys were successful. \fBMEMCACHED_NOTFOUND\fP will be return if no keys at all were found. .sp -\fBmemcached_fetch()\fP and \fBmemcached_fetch_result()\fP set error +\fI\%memcached_fetch_result()\fP sets error to \fBMEMCACHED_END\fP upon successful conclusion. \fBMEMCACHED_NOTFOUND\fP will be return if no keys at all were found. -.sp -MEMCACHED_KEY_TOO_BIG is set to error whenever memcached_fetch() was used -and the key was set larger then MEMCACHED_MAX_KEY, which was the largest -key allowed for the original memcached ascii server. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_get_by_key.3 b/docs/man/memcached_get_by_key.3 index e9b21362..be1742d3 100644 --- a/docs/man/memcached_get_by_key.3 +++ b/docs/man/memcached_get_by_key.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_GET_BY_KEY" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_GET_BY_KEY" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_get_by_key \- Retrieving data from the server . @@ -35,129 +35,112 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_result_st * memcached_fetch_result (memcached_st *ptr, memcached_result_st *result, memcached_return_t *error); +.B memcached_result_st * memcached_fetch_result(memcached_st\fI\ *ptr\fP, memcached_result_st\fI\ *result\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_get (memcached_st *ptr, const char *key, size_t key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B char * memcached_get(memcached_st\fI\ *ptr\fP, const char\fI\ *key\fP, size_t\fI\ key_length\fP, size_t\fI\ *value_length\fP, uint32_t\fI\ *flags\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget (memcached_st *ptr, const char * const *keys, const size_t *key_length, size_t number_of_keys); +.B memcached_return_t memcached_mget(memcached_st\fI\ *ptr\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_get_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char *key, size_t key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B char * memcached_get_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char\fI\ *key\fP, size_t\fI\ key_length\fP, size_t\fI\ *value_length\fP, uint32_t\fI\ *flags\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char * const *keys, const size_t *key_length, size_t number_of_keys); +.B memcached_return_t memcached_mget_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_fetch (memcached_st *ptr, char *key, size_t *key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B memcached_return_t memcached_fetch_execute(memcached_st\fI\ *ptr\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_fetch_execute (memcached_st *ptr, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); +.B memcached_return_t memcached_mget_execute(memcached_st\fI\ *ptr\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget_execute (memcached_st *ptr, const char * const *keys, const size_t *key_length, size_t number_of_keys, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); -.UNINDENT -.INDENT 0.0 -.TP -.B memcached_return_t memcached_mget_execute_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char * const *keys, const size_t *key_length, size_t number_of_keys, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); +.B memcached_return_t memcached_mget_execute_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .sp Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_get() is used to fetch an individual value from the server. You -must pass in a key and its length to fetch the object. You must supply +\fI\%memcached_get()\fP is used to fetch an individual value from the server. +You must pass in a key and its length to fetch the object. You must supply three pointer variables which will give you the state of the returned -object. A uint32_t pointer to contain whatever flags you stored with the value, -a size_t pointer which will be filled with size of of the object, and a -memcached_return_t pointer to hold any error. The object will be returned -upon success and NULL will be returned on failure. Any object returned by -memcached_get() must be released by the caller application. -.sp -memcached_mget() is used to select multiple keys at once. For multiple key -operations it is always faster to use this function. This function always -works asynchronously. memcached_fetch() is then used to retrieve any keys -found. No error is given on keys that are not found. You must call either -memcached_fetch() or memcached_fetch_result() after a successful call to -memcached_mget(). You should continue to call these functions until they -return NULL (aka no more values). If you need to quit in the middle of a -memcached_get() call, execute a memcached_quit(). After you do this, you can -issue new queries against the server. -.sp -memcached_fetch() is used to fetch an individual value from the server. -memcached_mget() must always be called before using this method. You -must pass in a key and its length to fetch the object. You must supply +object. A \fBuint32_t\fP pointer to contain whatever flags you stored with the value, a \fBsize_t\fP pointer which will be filled with size of of +the object, and a \fBmemcached_return_t\fP pointer to hold any error. The +object will be returned upon success and NULL will be returned on failure. Any +object returned by \fI\%memcached_get()\fP must be released by the caller +application. +.sp +\fI\%memcached_mget()\fP is used to select multiple keys at once. For +multiple key operations it is always faster to use this function. This function always works asynchronously. +.sp +To retrieve data after a successful execution of \fI\%memcached_mget()\fP, you will need to +call \fI\%memcached_fetch_result()\fP. You should continue to call this function until +it returns a NULL (i.e. no more values). If you need to quit in the middle of a +\fI\%memcached_mget()\fP call, you can execute a \fBmemcached_quit()\fP, those this is not required. +.sp +\fI\%memcached_fetch_result()\fP is used to fetch an individual value from the server. \fI\%memcached_mget()\fP must always be called before using this method. +You must pass in a key and its length to fetch the object. You must supply three pointer variables which will give you the state of the returned -object. A uint32_t pointer to contain whatever flags you stored with the value, -a size_t pointer which will be filled with size of of the object, and a -memcached_return_t pointer to hold any error. The object will be returned -upon success and NULL will be returned on failure. \fBMEMCACHD_END\fP is -returned by the *error value when all objects that have been found are -returned. The final value upon \fBMEMCACHED_END\fP is null. Values -returned by memcached_fetch() must be freed by the caller. memcached_fetch() -will be DEPRECATED in the near future, memcached_fetch_result() should be -used instead. -.sp -memcached_fetch_result() is used to return a memcached_result_st(3) structure -from a memcached server. The result object is forward compatible with changes -to the server. For more information please refer to the memcached_result_st(3) -help. This function will dynamically allocate a result structure for you -if you do not pass one to the function. -.sp -memcached_fetch_execute() is a callback function for result sets. Instead -of returning the results to you for processing, it passes each of the +object. A \fBuint32_t\fP pointer to contain whatever flags you stored with the value, a \fBsize_t\fP pointer which will be filled with size of of the +object, and a \fBmemcached_return_t\fP pointer to hold any error. The +object will be returned upon success and NULL will be returned on failure. \fBMEMCACHD_END\fP is returned by the *error value when all objects that have been found are returned. The final value upon \fBMEMCACHED_END\fP is null. +.sp +\fI\%memcached_fetch_result()\fP is used to return a \fBmemcached_result_st\fP structure from a memcached server. The result object is forward compatible +with changes to the server. For more information please refer to the +\fBmemcached_result_st\fP help. This function will dynamically allocate a +result structure for you if you do not pass one to the function. +.sp +\fI\%memcached_fetch_execute()\fP is a callback function for result sets. +Instead of returning the results to you for processing, it passes each of the result sets to the list of functions you provide. It passes to the function -a memcached_st that can be cloned for use in the called function (it can not -be used directly). It also passes a result set which does not need to be freed. -Finally it passes a "context". This is just a pointer to a memory reference -you supply the calling function. Currently only one value is being passed -to each function call. In the future there will be an option to allow this -to be an array. -.sp -memcached_mget_execute() and memcached_mget_execute_by_key() is -similar to memcached_mget(), but it may trigger the supplied callbacks -with result sets while sending out the queries. If you try to perform -a really large multiget with memcached_mget() you may encounter a -deadlock in the OS kernel (it will fail to write data to the socket because -the input buffer is full). memcached_mget_execute() solves this -problem by processing some of the results before continuing sending -out requests. Please note that this function is only available in the -binary protocol. -.sp -memcached_get_by_key() and memcached_mget_by_key() behave in a similar nature -as memcached_get() and memcached_mget(). The difference is that they take -a master key that is used for determining which server an object was stored -if key partitioning was used for storage. -.sp -All of the above functions are not tested when the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPhas been set. Executing any of these functions with this behavior on will result in -\fBMEMCACHED_NOT_SUPPORTED\fP being returned, or for those functions which do not return -a \fBmemcached_return_t\fP, the error function parameter will be set to -\fBMEMCACHED_NOT_SUPPORTED\fP. +a \fBmemcached_st\fP that can be cloned for use in the called +function (it can not be used directly). It also passes a result set which does +not need to be freed. Finally it passes a "context". This is just a pointer to +a memory reference you supply the calling function. Currently only one value +is being passed to each function call. In the future there will be an option +to allow this to be an array. +.sp +\fI\%memcached_mget_execute()\fP and \fI\%memcached_mget_execute_by_key()\fP +is similar to \fI\%memcached_mget()\fP, but it may trigger the supplied +callbacks with result sets while sending out the queries. If you try to +perform a really large multiget with \fI\%memcached_mget()\fP you may +encounter a deadlock in the OS kernel (it will fail to write data to the +socket because the input buffer is full). \fI\%memcached_mget_execute()\fP +solves this problem by processing some of the results before continuing +sending out requests. Please note that this function is only available in +the binary protocol. +.sp +\fI\%memcached_get_by_key()\fP and \fI\%memcached_mget_by_key()\fP behave +in a similar nature as \fI\%memcached_get()\fP and \fI\%memcached_mget()\fP. +The difference is that they take a master key that is used for determining +which server an object was stored if key partitioning was used for storage. +.sp +All of the above functions are not tested when the +\fBMEMCACHED_BEHAVIOR_USE_UDP\fP has been set. Executing any of these +functions with this behavior on will result in \fBMEMCACHED_NOT_SUPPORTED\fP being returned, or for those functions which do not return a \fBmemcached_return_t\fP, the error function parameter will be set to \fBMEMCACHED_NOT_SUPPORTED\fP. .SH RETURN .sp -All objects returned must be freed by the calling application. -memcached_get() and memcached_fetch() will return NULL on error. You must -look at the value of error to determine what the actual error was. +All objects retrieved via \fI\%memcached_get()\fP or \fI\%memcached_get_by_key()\fP must be freed with \fIfree(3)\fP. +.sp +\fI\%memcached_get()\fP will return NULL on +error. You must look at the value of error to determine what the actual error +was. .sp -\fBmemcached_fetch_execute()\fP return \fBMEMCACHED_SUCCESS\fP if +\fI\%memcached_fetch_execute()\fP return \fBMEMCACHED_SUCCESS\fP if all keys were successful. \fBMEMCACHED_NOTFOUND\fP will be return if no keys at all were found. .sp -\fBmemcached_fetch()\fP and \fBmemcached_fetch_result()\fP set error +\fI\%memcached_fetch_result()\fP sets error to \fBMEMCACHED_END\fP upon successful conclusion. \fBMEMCACHED_NOTFOUND\fP will be return if no keys at all were found. -.sp -MEMCACHED_KEY_TOO_BIG is set to error whenever memcached_fetch() was used -and the key was set larger then MEMCACHED_MAX_KEY, which was the largest -key allowed for the original memcached ascii server. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_get_memory_allocators.3 b/docs/man/memcached_get_memory_allocators.3 index 228e977b..da7f0435 100644 --- a/docs/man/memcached_get_memory_allocators.3 +++ b/docs/man/memcached_get_memory_allocators.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_GET_MEMORY_ALLOCATORS" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_GET_MEMORY_ALLOCATORS" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_get_memory_allocators \- libmemcached Documentation . @@ -70,18 +70,18 @@ Compile and link with \-lmemcached libmemcached(3) allows you to specify your own memory allocators, optimized for your application. This enables libmemcached to be used inside of applications that have their own malloc implementation. .sp -memcached_set_memory_allocators() is used to set the memory allocators used -by the memcached instance specified by ptr. Please note that you cannot -override only one of the memory allocators, you have to specify a complete -new set if you want to override one of them. All of the memory allocation -functions should behave as specified in the C99 standard. Specify NULL as -all functions to reset them to the default values. +\fBmemcached_set_memory_allocators()\fP is used to set the memory +allocators used by the memcached instance specified by ptr. Please note that +you cannot override only one of the memory allocators, you have to specify a +complete new set if you want to override one of them. All of the memory +allocation functions should behave as specified in the C99 standard. Specify +NULL as all functions to reset them to the default values. .sp -memcached_get_memory_allocators() is used to get the currently used memory -allocators by a mamcached handle. +\fBmemcached_get_memory_allocators()\fP is used to get the currently used +memory allocators by a mamcached handle. .sp -memcached_get_memory_allocators_context() returns the void * that was -passed in during the call to memcached_set_memory_allocators(). +\fBmemcached_get_memory_allocators_context()\fP returns the void * that +was passed in during the call to \fBmemcached_set_memory_allocators()\fP. .sp The first argument to the memory allocator functions is a pointer to a memcached structure, the is passed as const and you will need to clone @@ -93,8 +93,9 @@ passed to them. This was so that customer allocators could have their own space for memory. .SH RETURN .sp -memcached_set_memory_allocators() return MEMCACHED_SUCCESS upon success, -and MEMCACHED_FAILURE if you don\(aqt pass a complete set of function pointers. +\fBmemcached_set_memory_allocators()\fP return \fBMEMCACHED_SUCCESS\fP +upon success, and \fBMEMCACHED_FAILURE\fP if you don\(aqt pass a complete set +of function pointers. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_get_sasl_callbacks.3 b/docs/man/memcached_get_sasl_callbacks.3 index 047908f3..ac028b94 100644 --- a/docs/man/memcached_get_sasl_callbacks.3 +++ b/docs/man/memcached_get_sasl_callbacks.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_GET_SASL_CALLBACKS" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_GET_SASL_CALLBACKS" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_get_sasl_callbacks \- libmemcached Documentation . @@ -59,21 +59,20 @@ libsasl to perform SASL authentication. Please note that SASL requires the memcached binary protocol, and you have to specify the callbacks before you connect to the server. .sp -memcached_set_sasl_auth_data() is a helper function defining +\fI\%memcached_set_sasl_auth_data()\fP is a helper function defining the basic functionality for you, but it will store the username and password in memory. If you choose to use this method you have to call -memcached_destroy_sasl_auth_data before calling memcached_free to avoid -a memory leak. You should NOT call memcached_destroy_sasl_auth_data if you -specify your own callback function with memcached_set_sasl_callbacks(). +\fI\%memcached_destroy_sasl_auth_data\fP before calling +\fBmemcached_free\fP to avoid a memory leak. You should NOT call +\fI\%memcached_destroy_sasl_auth_data\fP if you specify your own callback +function with \fI\%memcached_set_sasl_callbacks()\fP. .sp -You as a client user have to initialize libsasl by using sasl_client_init -before enabling it in libmemcached, and you have to shut down libsasl by -calling sasl_done() when you are done using SASL from libmemcached. +You as a client user have to initialize libsasl by using \fBsasl_client_init\fP before enabling it in libmemcached, and you have to shut down libsasl by +calling \fBsasl_done()\fP when you are done using SASL from libmemcached. .SH RETURN .sp -memcached_get_sasl_callbacks() returns the callbacks currently used -by this memcached handle. -memcached_get_sasl_set_auth_data() returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_get_sasl_callbacks()\fP returns the callbacks currently used +by this memcached handle. \fBmemcached_get_sasl_set_auth_data()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_get_user_data.3 b/docs/man/memcached_get_user_data.3 index 7a698dd0..35fb5ba5 100644 --- a/docs/man/memcached_get_user_data.3 +++ b/docs/man/memcached_get_user_data.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_GET_USER_DATA" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_GET_USER_DATA" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_get_user_data \- libmemcached Documentation . @@ -51,25 +51,22 @@ void *memcached_set_user_data (memcached_st *ptr, void *data); libmemcached(3) allows you to store a pointer to a user specific data inside the memcached_st structure. .sp -memcached_set_user_data() is used to set the user specific data in the -memcached_st structure. +\fBmemcached_set_user_data()\fP is used to set the user specific data in the +\fBmemcached_st\fP structure. .sp -memcached_get_user_data() is used to retrieve the user specific data in -the memcached_st structure. +\fBmemcached_get_user_data()\fP is used to retrieve the user specific data in the \fBmemcached_st\fP structure. .SH RETURN .sp -memcached_set_user_data() returns the previous value of the user specific -data. +\fBmemcached_set_user_data()\fP returns the previous value of the user specific data. .sp -memcached_get_user_data() returns the current value uf the user specific -data. +\fBmemcached_get_user_data()\fP returns the current value uf the user specific data. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemcached(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_increment.3 b/docs/man/memcached_increment.3 index 7b101fa8..b082f7ce 100644 --- a/docs/man/memcached_increment.3 +++ b/docs/man/memcached_increment.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_INCREMENT" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_INCREMENT" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_increment \- Incrementing and Decrementing Values . diff --git a/docs/man/memcached_increment_with_initial.3 b/docs/man/memcached_increment_with_initial.3 index 0212086a..6a0e917e 100644 --- a/docs/man/memcached_increment_with_initial.3 +++ b/docs/man/memcached_increment_with_initial.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_INCREMENT_WITH_INITIAL" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_INCREMENT_WITH_INITIAL" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_increment_with_initial \- Incrementing and Decrementing Values . diff --git a/docs/man/memcached_lib_version.3 b/docs/man/memcached_lib_version.3 index f7ea222a..29f1325d 100644 --- a/docs/man/memcached_lib_version.3 +++ b/docs/man/memcached_lib_version.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_LIB_VERSION" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_LIB_VERSION" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_lib_version \- libmemcached Documentation . @@ -45,20 +45,20 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_lib_version() is used to return a simple version string representing -the libmemcached version (client library version, not server version) +\fI\%memcached_lib_version()\fP is used to return a simple version string representing the libmemcached version (client library version, not server version) .sp -memcached_version() is used to set the major, minor, and micro versions of each -memcached server being used by the memcached_st connection structure. It returns the -memcached server return code. +\fI\%memcached_version()\fP is used to set the major, minor, and micro versions of each memcached server being used by the memcached_st connection structure. It returns the memcached server return code. .SH RETURN .sp -A string with the version of libmemcached driver is returned from -memcached_lib_version() +\fI\%memcached_lib_version()\fP returns a string with the version of the libmemcached driver. .sp -A value of type \fBmemcached_return_t\fP is returned from memcached_version() -On success that value will be \fBMEMCACHED_SUCCESS\fP. If called with the -\fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set, the value \fBMEMCACHED_NOT_SUPPORTED\fPwill be returned. Use memcached_strerror() to translate this value to +A value of \fBmemcached_return_t\fP is returned from :c:func:\(aqmemcached_version()\(aq +.sp +On success that value will be \fBMEMCACHED_SUCCESS\fP. +.sp +If called with the \fBMEMCACHED_BEHAVIOR_USE_UDP()\fP behavior set, the value \fBMEMCACHED_NOT_SUPPORTED\fP will be returned. +.sp +Use \fBmemcached_strerror()\fP to translate this value to a printable string. .SH HOME .sp @@ -66,7 +66,7 @@ To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemcached(3) memcached_strerror(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_memory_allocators.3 b/docs/man/memcached_memory_allocators.3 index e6f95a39..fbd707dc 100644 --- a/docs/man/memcached_memory_allocators.3 +++ b/docs/man/memcached_memory_allocators.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_MEMORY_ALLOCATORS" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_MEMORY_ALLOCATORS" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_memory_allocators \- libmemcached Documentation . @@ -70,18 +70,18 @@ Compile and link with \-lmemcached libmemcached(3) allows you to specify your own memory allocators, optimized for your application. This enables libmemcached to be used inside of applications that have their own malloc implementation. .sp -memcached_set_memory_allocators() is used to set the memory allocators used -by the memcached instance specified by ptr. Please note that you cannot -override only one of the memory allocators, you have to specify a complete -new set if you want to override one of them. All of the memory allocation -functions should behave as specified in the C99 standard. Specify NULL as -all functions to reset them to the default values. +\fBmemcached_set_memory_allocators()\fP is used to set the memory +allocators used by the memcached instance specified by ptr. Please note that +you cannot override only one of the memory allocators, you have to specify a +complete new set if you want to override one of them. All of the memory +allocation functions should behave as specified in the C99 standard. Specify +NULL as all functions to reset them to the default values. .sp -memcached_get_memory_allocators() is used to get the currently used memory -allocators by a mamcached handle. +\fBmemcached_get_memory_allocators()\fP is used to get the currently used +memory allocators by a mamcached handle. .sp -memcached_get_memory_allocators_context() returns the void * that was -passed in during the call to memcached_set_memory_allocators(). +\fBmemcached_get_memory_allocators_context()\fP returns the void * that +was passed in during the call to \fBmemcached_set_memory_allocators()\fP. .sp The first argument to the memory allocator functions is a pointer to a memcached structure, the is passed as const and you will need to clone @@ -93,8 +93,9 @@ passed to them. This was so that customer allocators could have their own space for memory. .SH RETURN .sp -memcached_set_memory_allocators() return MEMCACHED_SUCCESS upon success, -and MEMCACHED_FAILURE if you don\(aqt pass a complete set of function pointers. +\fBmemcached_set_memory_allocators()\fP return \fBMEMCACHED_SUCCESS\fP +upon success, and \fBMEMCACHED_FAILURE\fP if you don\(aqt pass a complete set +of function pointers. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_mget.3 b/docs/man/memcached_mget.3 index 0573e8c9..2a8d4c88 100644 --- a/docs/man/memcached_mget.3 +++ b/docs/man/memcached_mget.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_MGET" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_MGET" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_mget \- Retrieving data from the server . @@ -35,129 +35,112 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_result_st * memcached_fetch_result (memcached_st *ptr, memcached_result_st *result, memcached_return_t *error); +.B memcached_result_st * memcached_fetch_result(memcached_st\fI\ *ptr\fP, memcached_result_st\fI\ *result\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_get (memcached_st *ptr, const char *key, size_t key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B char * memcached_get(memcached_st\fI\ *ptr\fP, const char\fI\ *key\fP, size_t\fI\ key_length\fP, size_t\fI\ *value_length\fP, uint32_t\fI\ *flags\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget (memcached_st *ptr, const char * const *keys, const size_t *key_length, size_t number_of_keys); +.B memcached_return_t memcached_mget(memcached_st\fI\ *ptr\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_get_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char *key, size_t key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B char * memcached_get_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char\fI\ *key\fP, size_t\fI\ key_length\fP, size_t\fI\ *value_length\fP, uint32_t\fI\ *flags\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char * const *keys, const size_t *key_length, size_t number_of_keys); +.B memcached_return_t memcached_mget_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_fetch (memcached_st *ptr, char *key, size_t *key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B memcached_return_t memcached_fetch_execute(memcached_st\fI\ *ptr\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_fetch_execute (memcached_st *ptr, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); +.B memcached_return_t memcached_mget_execute(memcached_st\fI\ *ptr\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget_execute (memcached_st *ptr, const char * const *keys, const size_t *key_length, size_t number_of_keys, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); -.UNINDENT -.INDENT 0.0 -.TP -.B memcached_return_t memcached_mget_execute_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char * const *keys, const size_t *key_length, size_t number_of_keys, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); +.B memcached_return_t memcached_mget_execute_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .sp Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_get() is used to fetch an individual value from the server. You -must pass in a key and its length to fetch the object. You must supply +\fI\%memcached_get()\fP is used to fetch an individual value from the server. +You must pass in a key and its length to fetch the object. You must supply three pointer variables which will give you the state of the returned -object. A uint32_t pointer to contain whatever flags you stored with the value, -a size_t pointer which will be filled with size of of the object, and a -memcached_return_t pointer to hold any error. The object will be returned -upon success and NULL will be returned on failure. Any object returned by -memcached_get() must be released by the caller application. -.sp -memcached_mget() is used to select multiple keys at once. For multiple key -operations it is always faster to use this function. This function always -works asynchronously. memcached_fetch() is then used to retrieve any keys -found. No error is given on keys that are not found. You must call either -memcached_fetch() or memcached_fetch_result() after a successful call to -memcached_mget(). You should continue to call these functions until they -return NULL (aka no more values). If you need to quit in the middle of a -memcached_get() call, execute a memcached_quit(). After you do this, you can -issue new queries against the server. -.sp -memcached_fetch() is used to fetch an individual value from the server. -memcached_mget() must always be called before using this method. You -must pass in a key and its length to fetch the object. You must supply +object. A \fBuint32_t\fP pointer to contain whatever flags you stored with the value, a \fBsize_t\fP pointer which will be filled with size of of +the object, and a \fBmemcached_return_t\fP pointer to hold any error. The +object will be returned upon success and NULL will be returned on failure. Any +object returned by \fI\%memcached_get()\fP must be released by the caller +application. +.sp +\fI\%memcached_mget()\fP is used to select multiple keys at once. For +multiple key operations it is always faster to use this function. This function always works asynchronously. +.sp +To retrieve data after a successful execution of \fI\%memcached_mget()\fP, you will need to +call \fI\%memcached_fetch_result()\fP. You should continue to call this function until +it returns a NULL (i.e. no more values). If you need to quit in the middle of a +\fI\%memcached_mget()\fP call, you can execute a \fBmemcached_quit()\fP, those this is not required. +.sp +\fI\%memcached_fetch_result()\fP is used to fetch an individual value from the server. \fI\%memcached_mget()\fP must always be called before using this method. +You must pass in a key and its length to fetch the object. You must supply three pointer variables which will give you the state of the returned -object. A uint32_t pointer to contain whatever flags you stored with the value, -a size_t pointer which will be filled with size of of the object, and a -memcached_return_t pointer to hold any error. The object will be returned -upon success and NULL will be returned on failure. \fBMEMCACHD_END\fP is -returned by the *error value when all objects that have been found are -returned. The final value upon \fBMEMCACHED_END\fP is null. Values -returned by memcached_fetch() must be freed by the caller. memcached_fetch() -will be DEPRECATED in the near future, memcached_fetch_result() should be -used instead. -.sp -memcached_fetch_result() is used to return a memcached_result_st(3) structure -from a memcached server. The result object is forward compatible with changes -to the server. For more information please refer to the memcached_result_st(3) -help. This function will dynamically allocate a result structure for you -if you do not pass one to the function. -.sp -memcached_fetch_execute() is a callback function for result sets. Instead -of returning the results to you for processing, it passes each of the +object. A \fBuint32_t\fP pointer to contain whatever flags you stored with the value, a \fBsize_t\fP pointer which will be filled with size of of the +object, and a \fBmemcached_return_t\fP pointer to hold any error. The +object will be returned upon success and NULL will be returned on failure. \fBMEMCACHD_END\fP is returned by the *error value when all objects that have been found are returned. The final value upon \fBMEMCACHED_END\fP is null. +.sp +\fI\%memcached_fetch_result()\fP is used to return a \fBmemcached_result_st\fP structure from a memcached server. The result object is forward compatible +with changes to the server. For more information please refer to the +\fBmemcached_result_st\fP help. This function will dynamically allocate a +result structure for you if you do not pass one to the function. +.sp +\fI\%memcached_fetch_execute()\fP is a callback function for result sets. +Instead of returning the results to you for processing, it passes each of the result sets to the list of functions you provide. It passes to the function -a memcached_st that can be cloned for use in the called function (it can not -be used directly). It also passes a result set which does not need to be freed. -Finally it passes a "context". This is just a pointer to a memory reference -you supply the calling function. Currently only one value is being passed -to each function call. In the future there will be an option to allow this -to be an array. -.sp -memcached_mget_execute() and memcached_mget_execute_by_key() is -similar to memcached_mget(), but it may trigger the supplied callbacks -with result sets while sending out the queries. If you try to perform -a really large multiget with memcached_mget() you may encounter a -deadlock in the OS kernel (it will fail to write data to the socket because -the input buffer is full). memcached_mget_execute() solves this -problem by processing some of the results before continuing sending -out requests. Please note that this function is only available in the -binary protocol. -.sp -memcached_get_by_key() and memcached_mget_by_key() behave in a similar nature -as memcached_get() and memcached_mget(). The difference is that they take -a master key that is used for determining which server an object was stored -if key partitioning was used for storage. -.sp -All of the above functions are not tested when the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPhas been set. Executing any of these functions with this behavior on will result in -\fBMEMCACHED_NOT_SUPPORTED\fP being returned, or for those functions which do not return -a \fBmemcached_return_t\fP, the error function parameter will be set to -\fBMEMCACHED_NOT_SUPPORTED\fP. +a \fBmemcached_st\fP that can be cloned for use in the called +function (it can not be used directly). It also passes a result set which does +not need to be freed. Finally it passes a "context". This is just a pointer to +a memory reference you supply the calling function. Currently only one value +is being passed to each function call. In the future there will be an option +to allow this to be an array. +.sp +\fI\%memcached_mget_execute()\fP and \fI\%memcached_mget_execute_by_key()\fP +is similar to \fI\%memcached_mget()\fP, but it may trigger the supplied +callbacks with result sets while sending out the queries. If you try to +perform a really large multiget with \fI\%memcached_mget()\fP you may +encounter a deadlock in the OS kernel (it will fail to write data to the +socket because the input buffer is full). \fI\%memcached_mget_execute()\fP +solves this problem by processing some of the results before continuing +sending out requests. Please note that this function is only available in +the binary protocol. +.sp +\fI\%memcached_get_by_key()\fP and \fI\%memcached_mget_by_key()\fP behave +in a similar nature as \fI\%memcached_get()\fP and \fI\%memcached_mget()\fP. +The difference is that they take a master key that is used for determining +which server an object was stored if key partitioning was used for storage. +.sp +All of the above functions are not tested when the +\fBMEMCACHED_BEHAVIOR_USE_UDP\fP has been set. Executing any of these +functions with this behavior on will result in \fBMEMCACHED_NOT_SUPPORTED\fP being returned, or for those functions which do not return a \fBmemcached_return_t\fP, the error function parameter will be set to \fBMEMCACHED_NOT_SUPPORTED\fP. .SH RETURN .sp -All objects returned must be freed by the calling application. -memcached_get() and memcached_fetch() will return NULL on error. You must -look at the value of error to determine what the actual error was. +All objects retrieved via \fI\%memcached_get()\fP or \fI\%memcached_get_by_key()\fP must be freed with \fIfree(3)\fP. +.sp +\fI\%memcached_get()\fP will return NULL on +error. You must look at the value of error to determine what the actual error +was. .sp -\fBmemcached_fetch_execute()\fP return \fBMEMCACHED_SUCCESS\fP if +\fI\%memcached_fetch_execute()\fP return \fBMEMCACHED_SUCCESS\fP if all keys were successful. \fBMEMCACHED_NOTFOUND\fP will be return if no keys at all were found. .sp -\fBmemcached_fetch()\fP and \fBmemcached_fetch_result()\fP set error +\fI\%memcached_fetch_result()\fP sets error to \fBMEMCACHED_END\fP upon successful conclusion. \fBMEMCACHED_NOTFOUND\fP will be return if no keys at all were found. -.sp -MEMCACHED_KEY_TOO_BIG is set to error whenever memcached_fetch() was used -and the key was set larger then MEMCACHED_MAX_KEY, which was the largest -key allowed for the original memcached ascii server. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_mget_by_key.3 b/docs/man/memcached_mget_by_key.3 index e0ae450f..5ca886d1 100644 --- a/docs/man/memcached_mget_by_key.3 +++ b/docs/man/memcached_mget_by_key.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_MGET_BY_KEY" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_MGET_BY_KEY" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_mget_by_key \- Retrieving data from the server . @@ -35,129 +35,112 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_result_st * memcached_fetch_result (memcached_st *ptr, memcached_result_st *result, memcached_return_t *error); +.B memcached_result_st * memcached_fetch_result(memcached_st\fI\ *ptr\fP, memcached_result_st\fI\ *result\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_get (memcached_st *ptr, const char *key, size_t key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B char * memcached_get(memcached_st\fI\ *ptr\fP, const char\fI\ *key\fP, size_t\fI\ key_length\fP, size_t\fI\ *value_length\fP, uint32_t\fI\ *flags\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget (memcached_st *ptr, const char * const *keys, const size_t *key_length, size_t number_of_keys); +.B memcached_return_t memcached_mget(memcached_st\fI\ *ptr\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_get_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char *key, size_t key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B char * memcached_get_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char\fI\ *key\fP, size_t\fI\ key_length\fP, size_t\fI\ *value_length\fP, uint32_t\fI\ *flags\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char * const *keys, const size_t *key_length, size_t number_of_keys); +.B memcached_return_t memcached_mget_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_fetch (memcached_st *ptr, char *key, size_t *key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B memcached_return_t memcached_fetch_execute(memcached_st\fI\ *ptr\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_fetch_execute (memcached_st *ptr, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); +.B memcached_return_t memcached_mget_execute(memcached_st\fI\ *ptr\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget_execute (memcached_st *ptr, const char * const *keys, const size_t *key_length, size_t number_of_keys, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); -.UNINDENT -.INDENT 0.0 -.TP -.B memcached_return_t memcached_mget_execute_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char * const *keys, const size_t *key_length, size_t number_of_keys, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); +.B memcached_return_t memcached_mget_execute_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .sp Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_get() is used to fetch an individual value from the server. You -must pass in a key and its length to fetch the object. You must supply +\fI\%memcached_get()\fP is used to fetch an individual value from the server. +You must pass in a key and its length to fetch the object. You must supply three pointer variables which will give you the state of the returned -object. A uint32_t pointer to contain whatever flags you stored with the value, -a size_t pointer which will be filled with size of of the object, and a -memcached_return_t pointer to hold any error. The object will be returned -upon success and NULL will be returned on failure. Any object returned by -memcached_get() must be released by the caller application. -.sp -memcached_mget() is used to select multiple keys at once. For multiple key -operations it is always faster to use this function. This function always -works asynchronously. memcached_fetch() is then used to retrieve any keys -found. No error is given on keys that are not found. You must call either -memcached_fetch() or memcached_fetch_result() after a successful call to -memcached_mget(). You should continue to call these functions until they -return NULL (aka no more values). If you need to quit in the middle of a -memcached_get() call, execute a memcached_quit(). After you do this, you can -issue new queries against the server. -.sp -memcached_fetch() is used to fetch an individual value from the server. -memcached_mget() must always be called before using this method. You -must pass in a key and its length to fetch the object. You must supply +object. A \fBuint32_t\fP pointer to contain whatever flags you stored with the value, a \fBsize_t\fP pointer which will be filled with size of of +the object, and a \fBmemcached_return_t\fP pointer to hold any error. The +object will be returned upon success and NULL will be returned on failure. Any +object returned by \fI\%memcached_get()\fP must be released by the caller +application. +.sp +\fI\%memcached_mget()\fP is used to select multiple keys at once. For +multiple key operations it is always faster to use this function. This function always works asynchronously. +.sp +To retrieve data after a successful execution of \fI\%memcached_mget()\fP, you will need to +call \fI\%memcached_fetch_result()\fP. You should continue to call this function until +it returns a NULL (i.e. no more values). If you need to quit in the middle of a +\fI\%memcached_mget()\fP call, you can execute a \fBmemcached_quit()\fP, those this is not required. +.sp +\fI\%memcached_fetch_result()\fP is used to fetch an individual value from the server. \fI\%memcached_mget()\fP must always be called before using this method. +You must pass in a key and its length to fetch the object. You must supply three pointer variables which will give you the state of the returned -object. A uint32_t pointer to contain whatever flags you stored with the value, -a size_t pointer which will be filled with size of of the object, and a -memcached_return_t pointer to hold any error. The object will be returned -upon success and NULL will be returned on failure. \fBMEMCACHD_END\fP is -returned by the *error value when all objects that have been found are -returned. The final value upon \fBMEMCACHED_END\fP is null. Values -returned by memcached_fetch() must be freed by the caller. memcached_fetch() -will be DEPRECATED in the near future, memcached_fetch_result() should be -used instead. -.sp -memcached_fetch_result() is used to return a memcached_result_st(3) structure -from a memcached server. The result object is forward compatible with changes -to the server. For more information please refer to the memcached_result_st(3) -help. This function will dynamically allocate a result structure for you -if you do not pass one to the function. -.sp -memcached_fetch_execute() is a callback function for result sets. Instead -of returning the results to you for processing, it passes each of the +object. A \fBuint32_t\fP pointer to contain whatever flags you stored with the value, a \fBsize_t\fP pointer which will be filled with size of of the +object, and a \fBmemcached_return_t\fP pointer to hold any error. The +object will be returned upon success and NULL will be returned on failure. \fBMEMCACHD_END\fP is returned by the *error value when all objects that have been found are returned. The final value upon \fBMEMCACHED_END\fP is null. +.sp +\fI\%memcached_fetch_result()\fP is used to return a \fBmemcached_result_st\fP structure from a memcached server. The result object is forward compatible +with changes to the server. For more information please refer to the +\fBmemcached_result_st\fP help. This function will dynamically allocate a +result structure for you if you do not pass one to the function. +.sp +\fI\%memcached_fetch_execute()\fP is a callback function for result sets. +Instead of returning the results to you for processing, it passes each of the result sets to the list of functions you provide. It passes to the function -a memcached_st that can be cloned for use in the called function (it can not -be used directly). It also passes a result set which does not need to be freed. -Finally it passes a "context". This is just a pointer to a memory reference -you supply the calling function. Currently only one value is being passed -to each function call. In the future there will be an option to allow this -to be an array. -.sp -memcached_mget_execute() and memcached_mget_execute_by_key() is -similar to memcached_mget(), but it may trigger the supplied callbacks -with result sets while sending out the queries. If you try to perform -a really large multiget with memcached_mget() you may encounter a -deadlock in the OS kernel (it will fail to write data to the socket because -the input buffer is full). memcached_mget_execute() solves this -problem by processing some of the results before continuing sending -out requests. Please note that this function is only available in the -binary protocol. -.sp -memcached_get_by_key() and memcached_mget_by_key() behave in a similar nature -as memcached_get() and memcached_mget(). The difference is that they take -a master key that is used for determining which server an object was stored -if key partitioning was used for storage. -.sp -All of the above functions are not tested when the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPhas been set. Executing any of these functions with this behavior on will result in -\fBMEMCACHED_NOT_SUPPORTED\fP being returned, or for those functions which do not return -a \fBmemcached_return_t\fP, the error function parameter will be set to -\fBMEMCACHED_NOT_SUPPORTED\fP. +a \fBmemcached_st\fP that can be cloned for use in the called +function (it can not be used directly). It also passes a result set which does +not need to be freed. Finally it passes a "context". This is just a pointer to +a memory reference you supply the calling function. Currently only one value +is being passed to each function call. In the future there will be an option +to allow this to be an array. +.sp +\fI\%memcached_mget_execute()\fP and \fI\%memcached_mget_execute_by_key()\fP +is similar to \fI\%memcached_mget()\fP, but it may trigger the supplied +callbacks with result sets while sending out the queries. If you try to +perform a really large multiget with \fI\%memcached_mget()\fP you may +encounter a deadlock in the OS kernel (it will fail to write data to the +socket because the input buffer is full). \fI\%memcached_mget_execute()\fP +solves this problem by processing some of the results before continuing +sending out requests. Please note that this function is only available in +the binary protocol. +.sp +\fI\%memcached_get_by_key()\fP and \fI\%memcached_mget_by_key()\fP behave +in a similar nature as \fI\%memcached_get()\fP and \fI\%memcached_mget()\fP. +The difference is that they take a master key that is used for determining +which server an object was stored if key partitioning was used for storage. +.sp +All of the above functions are not tested when the +\fBMEMCACHED_BEHAVIOR_USE_UDP\fP has been set. Executing any of these +functions with this behavior on will result in \fBMEMCACHED_NOT_SUPPORTED\fP being returned, or for those functions which do not return a \fBmemcached_return_t\fP, the error function parameter will be set to \fBMEMCACHED_NOT_SUPPORTED\fP. .SH RETURN .sp -All objects returned must be freed by the calling application. -memcached_get() and memcached_fetch() will return NULL on error. You must -look at the value of error to determine what the actual error was. +All objects retrieved via \fI\%memcached_get()\fP or \fI\%memcached_get_by_key()\fP must be freed with \fIfree(3)\fP. +.sp +\fI\%memcached_get()\fP will return NULL on +error. You must look at the value of error to determine what the actual error +was. .sp -\fBmemcached_fetch_execute()\fP return \fBMEMCACHED_SUCCESS\fP if +\fI\%memcached_fetch_execute()\fP return \fBMEMCACHED_SUCCESS\fP if all keys were successful. \fBMEMCACHED_NOTFOUND\fP will be return if no keys at all were found. .sp -\fBmemcached_fetch()\fP and \fBmemcached_fetch_result()\fP set error +\fI\%memcached_fetch_result()\fP sets error to \fBMEMCACHED_END\fP upon successful conclusion. \fBMEMCACHED_NOTFOUND\fP will be return if no keys at all were found. -.sp -MEMCACHED_KEY_TOO_BIG is set to error whenever memcached_fetch() was used -and the key was set larger then MEMCACHED_MAX_KEY, which was the largest -key allowed for the original memcached ascii server. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_mget_execute.3 b/docs/man/memcached_mget_execute.3 index 459d149b..9086d138 100644 --- a/docs/man/memcached_mget_execute.3 +++ b/docs/man/memcached_mget_execute.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_MGET_EXECUTE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_MGET_EXECUTE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_mget_execute \- Retrieving data from the server . @@ -35,129 +35,112 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_result_st * memcached_fetch_result (memcached_st *ptr, memcached_result_st *result, memcached_return_t *error); +.B memcached_result_st * memcached_fetch_result(memcached_st\fI\ *ptr\fP, memcached_result_st\fI\ *result\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_get (memcached_st *ptr, const char *key, size_t key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B char * memcached_get(memcached_st\fI\ *ptr\fP, const char\fI\ *key\fP, size_t\fI\ key_length\fP, size_t\fI\ *value_length\fP, uint32_t\fI\ *flags\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget (memcached_st *ptr, const char * const *keys, const size_t *key_length, size_t number_of_keys); +.B memcached_return_t memcached_mget(memcached_st\fI\ *ptr\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_get_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char *key, size_t key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B char * memcached_get_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char\fI\ *key\fP, size_t\fI\ key_length\fP, size_t\fI\ *value_length\fP, uint32_t\fI\ *flags\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char * const *keys, const size_t *key_length, size_t number_of_keys); +.B memcached_return_t memcached_mget_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_fetch (memcached_st *ptr, char *key, size_t *key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B memcached_return_t memcached_fetch_execute(memcached_st\fI\ *ptr\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_fetch_execute (memcached_st *ptr, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); +.B memcached_return_t memcached_mget_execute(memcached_st\fI\ *ptr\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget_execute (memcached_st *ptr, const char * const *keys, const size_t *key_length, size_t number_of_keys, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); -.UNINDENT -.INDENT 0.0 -.TP -.B memcached_return_t memcached_mget_execute_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char * const *keys, const size_t *key_length, size_t number_of_keys, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); +.B memcached_return_t memcached_mget_execute_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .sp Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_get() is used to fetch an individual value from the server. You -must pass in a key and its length to fetch the object. You must supply +\fI\%memcached_get()\fP is used to fetch an individual value from the server. +You must pass in a key and its length to fetch the object. You must supply three pointer variables which will give you the state of the returned -object. A uint32_t pointer to contain whatever flags you stored with the value, -a size_t pointer which will be filled with size of of the object, and a -memcached_return_t pointer to hold any error. The object will be returned -upon success and NULL will be returned on failure. Any object returned by -memcached_get() must be released by the caller application. -.sp -memcached_mget() is used to select multiple keys at once. For multiple key -operations it is always faster to use this function. This function always -works asynchronously. memcached_fetch() is then used to retrieve any keys -found. No error is given on keys that are not found. You must call either -memcached_fetch() or memcached_fetch_result() after a successful call to -memcached_mget(). You should continue to call these functions until they -return NULL (aka no more values). If you need to quit in the middle of a -memcached_get() call, execute a memcached_quit(). After you do this, you can -issue new queries against the server. -.sp -memcached_fetch() is used to fetch an individual value from the server. -memcached_mget() must always be called before using this method. You -must pass in a key and its length to fetch the object. You must supply +object. A \fBuint32_t\fP pointer to contain whatever flags you stored with the value, a \fBsize_t\fP pointer which will be filled with size of of +the object, and a \fBmemcached_return_t\fP pointer to hold any error. The +object will be returned upon success and NULL will be returned on failure. Any +object returned by \fI\%memcached_get()\fP must be released by the caller +application. +.sp +\fI\%memcached_mget()\fP is used to select multiple keys at once. For +multiple key operations it is always faster to use this function. This function always works asynchronously. +.sp +To retrieve data after a successful execution of \fI\%memcached_mget()\fP, you will need to +call \fI\%memcached_fetch_result()\fP. You should continue to call this function until +it returns a NULL (i.e. no more values). If you need to quit in the middle of a +\fI\%memcached_mget()\fP call, you can execute a \fBmemcached_quit()\fP, those this is not required. +.sp +\fI\%memcached_fetch_result()\fP is used to fetch an individual value from the server. \fI\%memcached_mget()\fP must always be called before using this method. +You must pass in a key and its length to fetch the object. You must supply three pointer variables which will give you the state of the returned -object. A uint32_t pointer to contain whatever flags you stored with the value, -a size_t pointer which will be filled with size of of the object, and a -memcached_return_t pointer to hold any error. The object will be returned -upon success and NULL will be returned on failure. \fBMEMCACHD_END\fP is -returned by the *error value when all objects that have been found are -returned. The final value upon \fBMEMCACHED_END\fP is null. Values -returned by memcached_fetch() must be freed by the caller. memcached_fetch() -will be DEPRECATED in the near future, memcached_fetch_result() should be -used instead. -.sp -memcached_fetch_result() is used to return a memcached_result_st(3) structure -from a memcached server. The result object is forward compatible with changes -to the server. For more information please refer to the memcached_result_st(3) -help. This function will dynamically allocate a result structure for you -if you do not pass one to the function. -.sp -memcached_fetch_execute() is a callback function for result sets. Instead -of returning the results to you for processing, it passes each of the +object. A \fBuint32_t\fP pointer to contain whatever flags you stored with the value, a \fBsize_t\fP pointer which will be filled with size of of the +object, and a \fBmemcached_return_t\fP pointer to hold any error. The +object will be returned upon success and NULL will be returned on failure. \fBMEMCACHD_END\fP is returned by the *error value when all objects that have been found are returned. The final value upon \fBMEMCACHED_END\fP is null. +.sp +\fI\%memcached_fetch_result()\fP is used to return a \fBmemcached_result_st\fP structure from a memcached server. The result object is forward compatible +with changes to the server. For more information please refer to the +\fBmemcached_result_st\fP help. This function will dynamically allocate a +result structure for you if you do not pass one to the function. +.sp +\fI\%memcached_fetch_execute()\fP is a callback function for result sets. +Instead of returning the results to you for processing, it passes each of the result sets to the list of functions you provide. It passes to the function -a memcached_st that can be cloned for use in the called function (it can not -be used directly). It also passes a result set which does not need to be freed. -Finally it passes a "context". This is just a pointer to a memory reference -you supply the calling function. Currently only one value is being passed -to each function call. In the future there will be an option to allow this -to be an array. -.sp -memcached_mget_execute() and memcached_mget_execute_by_key() is -similar to memcached_mget(), but it may trigger the supplied callbacks -with result sets while sending out the queries. If you try to perform -a really large multiget with memcached_mget() you may encounter a -deadlock in the OS kernel (it will fail to write data to the socket because -the input buffer is full). memcached_mget_execute() solves this -problem by processing some of the results before continuing sending -out requests. Please note that this function is only available in the -binary protocol. -.sp -memcached_get_by_key() and memcached_mget_by_key() behave in a similar nature -as memcached_get() and memcached_mget(). The difference is that they take -a master key that is used for determining which server an object was stored -if key partitioning was used for storage. -.sp -All of the above functions are not tested when the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPhas been set. Executing any of these functions with this behavior on will result in -\fBMEMCACHED_NOT_SUPPORTED\fP being returned, or for those functions which do not return -a \fBmemcached_return_t\fP, the error function parameter will be set to -\fBMEMCACHED_NOT_SUPPORTED\fP. +a \fBmemcached_st\fP that can be cloned for use in the called +function (it can not be used directly). It also passes a result set which does +not need to be freed. Finally it passes a "context". This is just a pointer to +a memory reference you supply the calling function. Currently only one value +is being passed to each function call. In the future there will be an option +to allow this to be an array. +.sp +\fI\%memcached_mget_execute()\fP and \fI\%memcached_mget_execute_by_key()\fP +is similar to \fI\%memcached_mget()\fP, but it may trigger the supplied +callbacks with result sets while sending out the queries. If you try to +perform a really large multiget with \fI\%memcached_mget()\fP you may +encounter a deadlock in the OS kernel (it will fail to write data to the +socket because the input buffer is full). \fI\%memcached_mget_execute()\fP +solves this problem by processing some of the results before continuing +sending out requests. Please note that this function is only available in +the binary protocol. +.sp +\fI\%memcached_get_by_key()\fP and \fI\%memcached_mget_by_key()\fP behave +in a similar nature as \fI\%memcached_get()\fP and \fI\%memcached_mget()\fP. +The difference is that they take a master key that is used for determining +which server an object was stored if key partitioning was used for storage. +.sp +All of the above functions are not tested when the +\fBMEMCACHED_BEHAVIOR_USE_UDP\fP has been set. Executing any of these +functions with this behavior on will result in \fBMEMCACHED_NOT_SUPPORTED\fP being returned, or for those functions which do not return a \fBmemcached_return_t\fP, the error function parameter will be set to \fBMEMCACHED_NOT_SUPPORTED\fP. .SH RETURN .sp -All objects returned must be freed by the calling application. -memcached_get() and memcached_fetch() will return NULL on error. You must -look at the value of error to determine what the actual error was. +All objects retrieved via \fI\%memcached_get()\fP or \fI\%memcached_get_by_key()\fP must be freed with \fIfree(3)\fP. +.sp +\fI\%memcached_get()\fP will return NULL on +error. You must look at the value of error to determine what the actual error +was. .sp -\fBmemcached_fetch_execute()\fP return \fBMEMCACHED_SUCCESS\fP if +\fI\%memcached_fetch_execute()\fP return \fBMEMCACHED_SUCCESS\fP if all keys were successful. \fBMEMCACHED_NOTFOUND\fP will be return if no keys at all were found. .sp -\fBmemcached_fetch()\fP and \fBmemcached_fetch_result()\fP set error +\fI\%memcached_fetch_result()\fP sets error to \fBMEMCACHED_END\fP upon successful conclusion. \fBMEMCACHED_NOTFOUND\fP will be return if no keys at all were found. -.sp -MEMCACHED_KEY_TOO_BIG is set to error whenever memcached_fetch() was used -and the key was set larger then MEMCACHED_MAX_KEY, which was the largest -key allowed for the original memcached ascii server. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_mget_execute_by_key.3 b/docs/man/memcached_mget_execute_by_key.3 index 610e43eb..4aaedc52 100644 --- a/docs/man/memcached_mget_execute_by_key.3 +++ b/docs/man/memcached_mget_execute_by_key.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_MGET_EXECUTE_BY_KEY" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_MGET_EXECUTE_BY_KEY" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_mget_execute_by_key \- Retrieving data from the server . @@ -35,129 +35,112 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_result_st * memcached_fetch_result (memcached_st *ptr, memcached_result_st *result, memcached_return_t *error); +.B memcached_result_st * memcached_fetch_result(memcached_st\fI\ *ptr\fP, memcached_result_st\fI\ *result\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_get (memcached_st *ptr, const char *key, size_t key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B char * memcached_get(memcached_st\fI\ *ptr\fP, const char\fI\ *key\fP, size_t\fI\ key_length\fP, size_t\fI\ *value_length\fP, uint32_t\fI\ *flags\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget (memcached_st *ptr, const char * const *keys, const size_t *key_length, size_t number_of_keys); +.B memcached_return_t memcached_mget(memcached_st\fI\ *ptr\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_get_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char *key, size_t key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B char * memcached_get_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char\fI\ *key\fP, size_t\fI\ key_length\fP, size_t\fI\ *value_length\fP, uint32_t\fI\ *flags\fP, memcached_return_t\fI\ *error\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char * const *keys, const size_t *key_length, size_t number_of_keys); +.B memcached_return_t memcached_mget_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP) .UNINDENT .INDENT 0.0 .TP -.B char * memcached_fetch (memcached_st *ptr, char *key, size_t *key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error); +.B memcached_return_t memcached_fetch_execute(memcached_st\fI\ *ptr\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_fetch_execute (memcached_st *ptr, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); +.B memcached_return_t memcached_mget_execute(memcached_st\fI\ *ptr\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_mget_execute (memcached_st *ptr, const char * const *keys, const size_t *key_length, size_t number_of_keys, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); -.UNINDENT -.INDENT 0.0 -.TP -.B memcached_return_t memcached_mget_execute_by_key (memcached_st *ptr, const char *group_key, size_t group_key_length, const char * const *keys, const size_t *key_length, size_t number_of_keys, memcached_execute_fn *callback, void *context, uint32_t number_of_callbacks); +.B memcached_return_t memcached_mget_execute_by_key(memcached_st\fI\ *ptr\fP, const char\fI\ *group_key\fP, size_t\fI\ group_key_length\fP, const char * const\fI\ *keys\fP, const size_t\fI\ *key_length\fP, size_t\fI\ number_of_keys\fP, memcached_execute_fn\fI\ *callback\fP, void\fI\ *context\fP, uint32_t\fI\ number_of_callbacks\fP) .UNINDENT .sp Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_get() is used to fetch an individual value from the server. You -must pass in a key and its length to fetch the object. You must supply +\fI\%memcached_get()\fP is used to fetch an individual value from the server. +You must pass in a key and its length to fetch the object. You must supply three pointer variables which will give you the state of the returned -object. A uint32_t pointer to contain whatever flags you stored with the value, -a size_t pointer which will be filled with size of of the object, and a -memcached_return_t pointer to hold any error. The object will be returned -upon success and NULL will be returned on failure. Any object returned by -memcached_get() must be released by the caller application. -.sp -memcached_mget() is used to select multiple keys at once. For multiple key -operations it is always faster to use this function. This function always -works asynchronously. memcached_fetch() is then used to retrieve any keys -found. No error is given on keys that are not found. You must call either -memcached_fetch() or memcached_fetch_result() after a successful call to -memcached_mget(). You should continue to call these functions until they -return NULL (aka no more values). If you need to quit in the middle of a -memcached_get() call, execute a memcached_quit(). After you do this, you can -issue new queries against the server. -.sp -memcached_fetch() is used to fetch an individual value from the server. -memcached_mget() must always be called before using this method. You -must pass in a key and its length to fetch the object. You must supply +object. A \fBuint32_t\fP pointer to contain whatever flags you stored with the value, a \fBsize_t\fP pointer which will be filled with size of of +the object, and a \fBmemcached_return_t\fP pointer to hold any error. The +object will be returned upon success and NULL will be returned on failure. Any +object returned by \fI\%memcached_get()\fP must be released by the caller +application. +.sp +\fI\%memcached_mget()\fP is used to select multiple keys at once. For +multiple key operations it is always faster to use this function. This function always works asynchronously. +.sp +To retrieve data after a successful execution of \fI\%memcached_mget()\fP, you will need to +call \fI\%memcached_fetch_result()\fP. You should continue to call this function until +it returns a NULL (i.e. no more values). If you need to quit in the middle of a +\fI\%memcached_mget()\fP call, you can execute a \fBmemcached_quit()\fP, those this is not required. +.sp +\fI\%memcached_fetch_result()\fP is used to fetch an individual value from the server. \fI\%memcached_mget()\fP must always be called before using this method. +You must pass in a key and its length to fetch the object. You must supply three pointer variables which will give you the state of the returned -object. A uint32_t pointer to contain whatever flags you stored with the value, -a size_t pointer which will be filled with size of of the object, and a -memcached_return_t pointer to hold any error. The object will be returned -upon success and NULL will be returned on failure. \fBMEMCACHD_END\fP is -returned by the *error value when all objects that have been found are -returned. The final value upon \fBMEMCACHED_END\fP is null. Values -returned by memcached_fetch() must be freed by the caller. memcached_fetch() -will be DEPRECATED in the near future, memcached_fetch_result() should be -used instead. -.sp -memcached_fetch_result() is used to return a memcached_result_st(3) structure -from a memcached server. The result object is forward compatible with changes -to the server. For more information please refer to the memcached_result_st(3) -help. This function will dynamically allocate a result structure for you -if you do not pass one to the function. -.sp -memcached_fetch_execute() is a callback function for result sets. Instead -of returning the results to you for processing, it passes each of the +object. A \fBuint32_t\fP pointer to contain whatever flags you stored with the value, a \fBsize_t\fP pointer which will be filled with size of of the +object, and a \fBmemcached_return_t\fP pointer to hold any error. The +object will be returned upon success and NULL will be returned on failure. \fBMEMCACHD_END\fP is returned by the *error value when all objects that have been found are returned. The final value upon \fBMEMCACHED_END\fP is null. +.sp +\fI\%memcached_fetch_result()\fP is used to return a \fBmemcached_result_st\fP structure from a memcached server. The result object is forward compatible +with changes to the server. For more information please refer to the +\fBmemcached_result_st\fP help. This function will dynamically allocate a +result structure for you if you do not pass one to the function. +.sp +\fI\%memcached_fetch_execute()\fP is a callback function for result sets. +Instead of returning the results to you for processing, it passes each of the result sets to the list of functions you provide. It passes to the function -a memcached_st that can be cloned for use in the called function (it can not -be used directly). It also passes a result set which does not need to be freed. -Finally it passes a "context". This is just a pointer to a memory reference -you supply the calling function. Currently only one value is being passed -to each function call. In the future there will be an option to allow this -to be an array. -.sp -memcached_mget_execute() and memcached_mget_execute_by_key() is -similar to memcached_mget(), but it may trigger the supplied callbacks -with result sets while sending out the queries. If you try to perform -a really large multiget with memcached_mget() you may encounter a -deadlock in the OS kernel (it will fail to write data to the socket because -the input buffer is full). memcached_mget_execute() solves this -problem by processing some of the results before continuing sending -out requests. Please note that this function is only available in the -binary protocol. -.sp -memcached_get_by_key() and memcached_mget_by_key() behave in a similar nature -as memcached_get() and memcached_mget(). The difference is that they take -a master key that is used for determining which server an object was stored -if key partitioning was used for storage. -.sp -All of the above functions are not tested when the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPhas been set. Executing any of these functions with this behavior on will result in -\fBMEMCACHED_NOT_SUPPORTED\fP being returned, or for those functions which do not return -a \fBmemcached_return_t\fP, the error function parameter will be set to -\fBMEMCACHED_NOT_SUPPORTED\fP. +a \fBmemcached_st\fP that can be cloned for use in the called +function (it can not be used directly). It also passes a result set which does +not need to be freed. Finally it passes a "context". This is just a pointer to +a memory reference you supply the calling function. Currently only one value +is being passed to each function call. In the future there will be an option +to allow this to be an array. +.sp +\fI\%memcached_mget_execute()\fP and \fI\%memcached_mget_execute_by_key()\fP +is similar to \fI\%memcached_mget()\fP, but it may trigger the supplied +callbacks with result sets while sending out the queries. If you try to +perform a really large multiget with \fI\%memcached_mget()\fP you may +encounter a deadlock in the OS kernel (it will fail to write data to the +socket because the input buffer is full). \fI\%memcached_mget_execute()\fP +solves this problem by processing some of the results before continuing +sending out requests. Please note that this function is only available in +the binary protocol. +.sp +\fI\%memcached_get_by_key()\fP and \fI\%memcached_mget_by_key()\fP behave +in a similar nature as \fI\%memcached_get()\fP and \fI\%memcached_mget()\fP. +The difference is that they take a master key that is used for determining +which server an object was stored if key partitioning was used for storage. +.sp +All of the above functions are not tested when the +\fBMEMCACHED_BEHAVIOR_USE_UDP\fP has been set. Executing any of these +functions with this behavior on will result in \fBMEMCACHED_NOT_SUPPORTED\fP being returned, or for those functions which do not return a \fBmemcached_return_t\fP, the error function parameter will be set to \fBMEMCACHED_NOT_SUPPORTED\fP. .SH RETURN .sp -All objects returned must be freed by the calling application. -memcached_get() and memcached_fetch() will return NULL on error. You must -look at the value of error to determine what the actual error was. +All objects retrieved via \fI\%memcached_get()\fP or \fI\%memcached_get_by_key()\fP must be freed with \fIfree(3)\fP. +.sp +\fI\%memcached_get()\fP will return NULL on +error. You must look at the value of error to determine what the actual error +was. .sp -\fBmemcached_fetch_execute()\fP return \fBMEMCACHED_SUCCESS\fP if +\fI\%memcached_fetch_execute()\fP return \fBMEMCACHED_SUCCESS\fP if all keys were successful. \fBMEMCACHED_NOTFOUND\fP will be return if no keys at all were found. .sp -\fBmemcached_fetch()\fP and \fBmemcached_fetch_result()\fP set error +\fI\%memcached_fetch_result()\fP sets error to \fBMEMCACHED_END\fP upon successful conclusion. \fBMEMCACHED_NOTFOUND\fP will be return if no keys at all were found. -.sp -MEMCACHED_KEY_TOO_BIG is set to error whenever memcached_fetch() was used -and the key was set larger then MEMCACHED_MAX_KEY, which was the largest -key allowed for the original memcached ascii server. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_pool.3 b/docs/man/memcached_pool.3 index e0d16a8e..88ab12bc 100644 --- a/docs/man/memcached_pool.3 +++ b/docs/man/memcached_pool.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_POOL" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_POOL" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_pool \- libmemcached Documentation . @@ -35,89 +35,68 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_pool_st *memcached_pool(const char *option_string, size_t option_string_length); +.B memcached_pool_st .UNINDENT .INDENT 0.0 .TP -.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); DEPRECATED +.B \fI\%memcached_pool_st\fP* memcached_pool(const char\fI\ *option_string\fP, size_t\fI\ option_string_length\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st * memcached_pool_destroy(memcached_pool_st* pool); +.B \fI\%memcached_pool_st\fP* memcached_pool_create(memcached_st*\fI\ mmc\fP, int\fI\ initial\fP, int\fI\ max\fP) .UNINDENT +.sp +Deprecated since version 0.46: Use \fI\%memcached_pool()\fP instead. .INDENT 0.0 .TP -.B memcached_st * memcached_pool_pop (memcached_pool_st* pool, bool block, memcached_return_t *rc); +.B memcached_st* memcached_pool_destroy(\fI\%memcached_pool_st\fP*\fI\ pool\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_push(memcached_pool_st* pool, memcached_st *mmc); +.B memcached_st* memcached_pool_pop(\fI\%memcached_pool_st\fP*\fI\ pool\fP, bool\fI\ block\fP, memcached_return_t\fI\ *rc\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st *memcached_create (memcached_st *ptr); +.B memcached_return_t memcached_pool_push(\fI\%memcached_pool_st\fP*\fI\ pool\fP, memcached_st\fI\ *mmc\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_behavior_set(memcached_pool_st\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ data\fP) +.B memcached_return_t memcached_pool_behavior_set(\fI\%memcached_pool_st\fP\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ data\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_behavior_get(memcached_pool_st\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ *value\fP) +.B memcached_return_t memcached_pool_behavior_get(\fI\%memcached_pool_st\fP\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ *value\fP) .UNINDENT .sp Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -memcached_pool() is used to create a connection pool of objects you may use -to remove the overhead of using memcached_clone for short lived -\fBmemcached_st\fPobjects. Please see \fIlibmemcached_configuration\fP for details on the format of the configuration string. -.sp -DEPRECATED memcached_pool_create() is used to create a connection pool of -objects you may use to remove the overhead of using memcached_clone for -short lived \fBmemcached_st\fPobjects. The mmc argument should be an -initialised \fBmemcached_st\fPstructure, and a successfull invocation of -memcached_pool_create takes full ownership of the variable (until it is -released by memcached_pool_destroy). The \fBinitial\fP argument specifies -the initial size of the connection pool, and the \fBmax\fPargument -specifies the maximum size the connection pool should grow to. Please note -that the library will allocate a fixed size buffer scaled to the max size of -the connection pool, so you should not pass MAXINT or some other large -number here. -.sp -memcached_pool_destroy() is used to destroy the connection pool -created with memcached_pool_create() and release all allocated +\fI\%memcached_pool()\fP is used to create a connection pool of objects you +may use to remove the overhead of using memcached_clone for short lived +\fBmemcached_st\fP objects. Please see \fBlibmemcached_configuration\fP for details on the format of the configuration string. +.sp +\fI\%memcached_pool_destroy()\fP is used to destroy the connection pool +created with \fI\%memcached_pool_create()\fP and release all allocated resources. It will return the pointer to the \fBmemcached_st\fP structure -passed as an argument to memcached_pool_create(), and returns the ownership -of the pointer to the caller when created with memcached_pool_create, -otherwise NULL is returned.. +passed as an argument to \fI\%memcached_pool_create()\fP, and returns the ownership of the pointer to the caller when created with \fI\%memcached_pool_create()\fP, otherwise NULL is returned.. .sp -memcached_pool_pop() is used to grab a connection structure from the +\fI\%memcached_pool_pop()\fP is used to grab a connection structure from the connection pool. The block argument specifies if the function should block and wait for a connection structure to be available if we try to exceed the maximum size. .sp -memcached_pool_push() is used to return a connection structure back to the pool. +\fI\%memcached_pool_push()\fP is used to return a connection structure back to the pool. .sp -memcached_pool_behavior_set() and memcached_pool_behagior_get() is -used to get/set behavior flags on all connections in the pool. +\fI\%memcached_pool_behavior_get()\fP and \fI\%memcached_pool_behavior_set()\fP is used to get/set behavior flags on all connections in the pool. .SH RETURN .sp -memcached_pool_create() returns a pointer to the newly created -memcached_pool_st structure. On an allocation failure, it returns -NULL. -.sp -memcached_pool_destroy() returns the pointer (and ownership) to the -memcached_st structure used to create the pool. If connections are in -use it returns NULL. +\fI\%memcached_pool_destroy()\fP returns the pointer (and ownership) to the \fBmemcached_st\fP structure used to create the pool. If connections are in use it returns NULL. .sp -memcached_pool_pop() returns a pointer to a memcached_st structure -from the pool (or NULL if an allocation cannot be satisfied). +\fI\%memcached_pool_pop()\fP returns a pointer to a \fBmemcached_st\fP structure from the pool (or NULL if an allocation cannot be satisfied). .sp -memcached_pool_push() returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_pool_push()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .sp -memcached_pool_behavior_get() and memcached_pool_behavior_get() -returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_pool_behavior_get()\fP and \fI\%memcached_pool_behavior_get()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .SH HOME .sp To find out more information please check: @@ -129,7 +108,7 @@ Brian Aker, <\fI\%brian@tangent.org\fP> Trond Norbye, <\fI\%trond.norbye@gmail.com\fP> .SH SEE ALSO .sp -\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP \fIlibmemcached_configuration(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_pool_behavior_get.3 b/docs/man/memcached_pool_behavior_get.3 index 201c99cc..443c691a 100644 --- a/docs/man/memcached_pool_behavior_get.3 +++ b/docs/man/memcached_pool_behavior_get.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_POOL_BEHAVIOR_GET" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_POOL_BEHAVIOR_GET" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_pool_behavior_get \- libmemcached Documentation . @@ -35,89 +35,68 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_pool_st *memcached_pool(const char *option_string, size_t option_string_length); +.B memcached_pool_st .UNINDENT .INDENT 0.0 .TP -.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); DEPRECATED +.B \fI\%memcached_pool_st\fP* memcached_pool(const char\fI\ *option_string\fP, size_t\fI\ option_string_length\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st * memcached_pool_destroy(memcached_pool_st* pool); +.B \fI\%memcached_pool_st\fP* memcached_pool_create(memcached_st*\fI\ mmc\fP, int\fI\ initial\fP, int\fI\ max\fP) .UNINDENT +.sp +Deprecated since version 0.46: Use \fI\%memcached_pool()\fP instead. .INDENT 0.0 .TP -.B memcached_st * memcached_pool_pop (memcached_pool_st* pool, bool block, memcached_return_t *rc); +.B memcached_st* memcached_pool_destroy(\fI\%memcached_pool_st\fP*\fI\ pool\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_push(memcached_pool_st* pool, memcached_st *mmc); +.B memcached_st* memcached_pool_pop(\fI\%memcached_pool_st\fP*\fI\ pool\fP, bool\fI\ block\fP, memcached_return_t\fI\ *rc\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st *memcached_create (memcached_st *ptr); +.B memcached_return_t memcached_pool_push(\fI\%memcached_pool_st\fP*\fI\ pool\fP, memcached_st\fI\ *mmc\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_behavior_set(memcached_pool_st\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ data\fP) +.B memcached_return_t memcached_pool_behavior_set(\fI\%memcached_pool_st\fP\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ data\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_behavior_get(memcached_pool_st\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ *value\fP) +.B memcached_return_t memcached_pool_behavior_get(\fI\%memcached_pool_st\fP\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ *value\fP) .UNINDENT .sp Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -memcached_pool() is used to create a connection pool of objects you may use -to remove the overhead of using memcached_clone for short lived -\fBmemcached_st\fPobjects. Please see \fIlibmemcached_configuration\fP for details on the format of the configuration string. -.sp -DEPRECATED memcached_pool_create() is used to create a connection pool of -objects you may use to remove the overhead of using memcached_clone for -short lived \fBmemcached_st\fPobjects. The mmc argument should be an -initialised \fBmemcached_st\fPstructure, and a successfull invocation of -memcached_pool_create takes full ownership of the variable (until it is -released by memcached_pool_destroy). The \fBinitial\fP argument specifies -the initial size of the connection pool, and the \fBmax\fPargument -specifies the maximum size the connection pool should grow to. Please note -that the library will allocate a fixed size buffer scaled to the max size of -the connection pool, so you should not pass MAXINT or some other large -number here. -.sp -memcached_pool_destroy() is used to destroy the connection pool -created with memcached_pool_create() and release all allocated +\fI\%memcached_pool()\fP is used to create a connection pool of objects you +may use to remove the overhead of using memcached_clone for short lived +\fBmemcached_st\fP objects. Please see \fBlibmemcached_configuration\fP for details on the format of the configuration string. +.sp +\fI\%memcached_pool_destroy()\fP is used to destroy the connection pool +created with \fI\%memcached_pool_create()\fP and release all allocated resources. It will return the pointer to the \fBmemcached_st\fP structure -passed as an argument to memcached_pool_create(), and returns the ownership -of the pointer to the caller when created with memcached_pool_create, -otherwise NULL is returned.. +passed as an argument to \fI\%memcached_pool_create()\fP, and returns the ownership of the pointer to the caller when created with \fI\%memcached_pool_create()\fP, otherwise NULL is returned.. .sp -memcached_pool_pop() is used to grab a connection structure from the +\fI\%memcached_pool_pop()\fP is used to grab a connection structure from the connection pool. The block argument specifies if the function should block and wait for a connection structure to be available if we try to exceed the maximum size. .sp -memcached_pool_push() is used to return a connection structure back to the pool. +\fI\%memcached_pool_push()\fP is used to return a connection structure back to the pool. .sp -memcached_pool_behavior_set() and memcached_pool_behagior_get() is -used to get/set behavior flags on all connections in the pool. +\fI\%memcached_pool_behavior_get()\fP and \fI\%memcached_pool_behavior_set()\fP is used to get/set behavior flags on all connections in the pool. .SH RETURN .sp -memcached_pool_create() returns a pointer to the newly created -memcached_pool_st structure. On an allocation failure, it returns -NULL. -.sp -memcached_pool_destroy() returns the pointer (and ownership) to the -memcached_st structure used to create the pool. If connections are in -use it returns NULL. +\fI\%memcached_pool_destroy()\fP returns the pointer (and ownership) to the \fBmemcached_st\fP structure used to create the pool. If connections are in use it returns NULL. .sp -memcached_pool_pop() returns a pointer to a memcached_st structure -from the pool (or NULL if an allocation cannot be satisfied). +\fI\%memcached_pool_pop()\fP returns a pointer to a \fBmemcached_st\fP structure from the pool (or NULL if an allocation cannot be satisfied). .sp -memcached_pool_push() returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_pool_push()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .sp -memcached_pool_behavior_get() and memcached_pool_behavior_get() -returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_pool_behavior_get()\fP and \fI\%memcached_pool_behavior_get()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .SH HOME .sp To find out more information please check: @@ -129,7 +108,7 @@ Brian Aker, <\fI\%brian@tangent.org\fP> Trond Norbye, <\fI\%trond.norbye@gmail.com\fP> .SH SEE ALSO .sp -\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP \fIlibmemcached_configuration(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_pool_behavior_set.3 b/docs/man/memcached_pool_behavior_set.3 index 0151cfdd..a024e039 100644 --- a/docs/man/memcached_pool_behavior_set.3 +++ b/docs/man/memcached_pool_behavior_set.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_POOL_BEHAVIOR_SET" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_POOL_BEHAVIOR_SET" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_pool_behavior_set \- libmemcached Documentation . @@ -35,89 +35,68 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_pool_st *memcached_pool(const char *option_string, size_t option_string_length); +.B memcached_pool_st .UNINDENT .INDENT 0.0 .TP -.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); DEPRECATED +.B \fI\%memcached_pool_st\fP* memcached_pool(const char\fI\ *option_string\fP, size_t\fI\ option_string_length\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st * memcached_pool_destroy(memcached_pool_st* pool); +.B \fI\%memcached_pool_st\fP* memcached_pool_create(memcached_st*\fI\ mmc\fP, int\fI\ initial\fP, int\fI\ max\fP) .UNINDENT +.sp +Deprecated since version 0.46: Use \fI\%memcached_pool()\fP instead. .INDENT 0.0 .TP -.B memcached_st * memcached_pool_pop (memcached_pool_st* pool, bool block, memcached_return_t *rc); +.B memcached_st* memcached_pool_destroy(\fI\%memcached_pool_st\fP*\fI\ pool\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_push(memcached_pool_st* pool, memcached_st *mmc); +.B memcached_st* memcached_pool_pop(\fI\%memcached_pool_st\fP*\fI\ pool\fP, bool\fI\ block\fP, memcached_return_t\fI\ *rc\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st *memcached_create (memcached_st *ptr); +.B memcached_return_t memcached_pool_push(\fI\%memcached_pool_st\fP*\fI\ pool\fP, memcached_st\fI\ *mmc\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_behavior_set(memcached_pool_st\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ data\fP) +.B memcached_return_t memcached_pool_behavior_set(\fI\%memcached_pool_st\fP\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ data\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_behavior_get(memcached_pool_st\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ *value\fP) +.B memcached_return_t memcached_pool_behavior_get(\fI\%memcached_pool_st\fP\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ *value\fP) .UNINDENT .sp Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -memcached_pool() is used to create a connection pool of objects you may use -to remove the overhead of using memcached_clone for short lived -\fBmemcached_st\fPobjects. Please see \fIlibmemcached_configuration\fP for details on the format of the configuration string. -.sp -DEPRECATED memcached_pool_create() is used to create a connection pool of -objects you may use to remove the overhead of using memcached_clone for -short lived \fBmemcached_st\fPobjects. The mmc argument should be an -initialised \fBmemcached_st\fPstructure, and a successfull invocation of -memcached_pool_create takes full ownership of the variable (until it is -released by memcached_pool_destroy). The \fBinitial\fP argument specifies -the initial size of the connection pool, and the \fBmax\fPargument -specifies the maximum size the connection pool should grow to. Please note -that the library will allocate a fixed size buffer scaled to the max size of -the connection pool, so you should not pass MAXINT or some other large -number here. -.sp -memcached_pool_destroy() is used to destroy the connection pool -created with memcached_pool_create() and release all allocated +\fI\%memcached_pool()\fP is used to create a connection pool of objects you +may use to remove the overhead of using memcached_clone for short lived +\fBmemcached_st\fP objects. Please see \fBlibmemcached_configuration\fP for details on the format of the configuration string. +.sp +\fI\%memcached_pool_destroy()\fP is used to destroy the connection pool +created with \fI\%memcached_pool_create()\fP and release all allocated resources. It will return the pointer to the \fBmemcached_st\fP structure -passed as an argument to memcached_pool_create(), and returns the ownership -of the pointer to the caller when created with memcached_pool_create, -otherwise NULL is returned.. +passed as an argument to \fI\%memcached_pool_create()\fP, and returns the ownership of the pointer to the caller when created with \fI\%memcached_pool_create()\fP, otherwise NULL is returned.. .sp -memcached_pool_pop() is used to grab a connection structure from the +\fI\%memcached_pool_pop()\fP is used to grab a connection structure from the connection pool. The block argument specifies if the function should block and wait for a connection structure to be available if we try to exceed the maximum size. .sp -memcached_pool_push() is used to return a connection structure back to the pool. +\fI\%memcached_pool_push()\fP is used to return a connection structure back to the pool. .sp -memcached_pool_behavior_set() and memcached_pool_behagior_get() is -used to get/set behavior flags on all connections in the pool. +\fI\%memcached_pool_behavior_get()\fP and \fI\%memcached_pool_behavior_set()\fP is used to get/set behavior flags on all connections in the pool. .SH RETURN .sp -memcached_pool_create() returns a pointer to the newly created -memcached_pool_st structure. On an allocation failure, it returns -NULL. -.sp -memcached_pool_destroy() returns the pointer (and ownership) to the -memcached_st structure used to create the pool. If connections are in -use it returns NULL. +\fI\%memcached_pool_destroy()\fP returns the pointer (and ownership) to the \fBmemcached_st\fP structure used to create the pool. If connections are in use it returns NULL. .sp -memcached_pool_pop() returns a pointer to a memcached_st structure -from the pool (or NULL if an allocation cannot be satisfied). +\fI\%memcached_pool_pop()\fP returns a pointer to a \fBmemcached_st\fP structure from the pool (or NULL if an allocation cannot be satisfied). .sp -memcached_pool_push() returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_pool_push()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .sp -memcached_pool_behavior_get() and memcached_pool_behavior_get() -returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_pool_behavior_get()\fP and \fI\%memcached_pool_behavior_get()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .SH HOME .sp To find out more information please check: @@ -129,7 +108,7 @@ Brian Aker, <\fI\%brian@tangent.org\fP> Trond Norbye, <\fI\%trond.norbye@gmail.com\fP> .SH SEE ALSO .sp -\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP \fIlibmemcached_configuration(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_pool_create.3 b/docs/man/memcached_pool_create.3 index a13ab938..53a86bc8 100644 --- a/docs/man/memcached_pool_create.3 +++ b/docs/man/memcached_pool_create.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_POOL_CREATE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_POOL_CREATE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_pool_create \- libmemcached Documentation . @@ -35,89 +35,68 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_pool_st *memcached_pool(const char *option_string, size_t option_string_length); +.B memcached_pool_st .UNINDENT .INDENT 0.0 .TP -.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); DEPRECATED +.B \fI\%memcached_pool_st\fP* memcached_pool(const char\fI\ *option_string\fP, size_t\fI\ option_string_length\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st * memcached_pool_destroy(memcached_pool_st* pool); +.B \fI\%memcached_pool_st\fP* memcached_pool_create(memcached_st*\fI\ mmc\fP, int\fI\ initial\fP, int\fI\ max\fP) .UNINDENT +.sp +Deprecated since version 0.46: Use \fI\%memcached_pool()\fP instead. .INDENT 0.0 .TP -.B memcached_st * memcached_pool_pop (memcached_pool_st* pool, bool block, memcached_return_t *rc); +.B memcached_st* memcached_pool_destroy(\fI\%memcached_pool_st\fP*\fI\ pool\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_push(memcached_pool_st* pool, memcached_st *mmc); +.B memcached_st* memcached_pool_pop(\fI\%memcached_pool_st\fP*\fI\ pool\fP, bool\fI\ block\fP, memcached_return_t\fI\ *rc\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st *memcached_create (memcached_st *ptr); +.B memcached_return_t memcached_pool_push(\fI\%memcached_pool_st\fP*\fI\ pool\fP, memcached_st\fI\ *mmc\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_behavior_set(memcached_pool_st\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ data\fP) +.B memcached_return_t memcached_pool_behavior_set(\fI\%memcached_pool_st\fP\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ data\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_behavior_get(memcached_pool_st\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ *value\fP) +.B memcached_return_t memcached_pool_behavior_get(\fI\%memcached_pool_st\fP\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ *value\fP) .UNINDENT .sp Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -memcached_pool() is used to create a connection pool of objects you may use -to remove the overhead of using memcached_clone for short lived -\fBmemcached_st\fPobjects. Please see \fIlibmemcached_configuration\fP for details on the format of the configuration string. -.sp -DEPRECATED memcached_pool_create() is used to create a connection pool of -objects you may use to remove the overhead of using memcached_clone for -short lived \fBmemcached_st\fPobjects. The mmc argument should be an -initialised \fBmemcached_st\fPstructure, and a successfull invocation of -memcached_pool_create takes full ownership of the variable (until it is -released by memcached_pool_destroy). The \fBinitial\fP argument specifies -the initial size of the connection pool, and the \fBmax\fPargument -specifies the maximum size the connection pool should grow to. Please note -that the library will allocate a fixed size buffer scaled to the max size of -the connection pool, so you should not pass MAXINT or some other large -number here. -.sp -memcached_pool_destroy() is used to destroy the connection pool -created with memcached_pool_create() and release all allocated +\fI\%memcached_pool()\fP is used to create a connection pool of objects you +may use to remove the overhead of using memcached_clone for short lived +\fBmemcached_st\fP objects. Please see \fBlibmemcached_configuration\fP for details on the format of the configuration string. +.sp +\fI\%memcached_pool_destroy()\fP is used to destroy the connection pool +created with \fI\%memcached_pool_create()\fP and release all allocated resources. It will return the pointer to the \fBmemcached_st\fP structure -passed as an argument to memcached_pool_create(), and returns the ownership -of the pointer to the caller when created with memcached_pool_create, -otherwise NULL is returned.. +passed as an argument to \fI\%memcached_pool_create()\fP, and returns the ownership of the pointer to the caller when created with \fI\%memcached_pool_create()\fP, otherwise NULL is returned.. .sp -memcached_pool_pop() is used to grab a connection structure from the +\fI\%memcached_pool_pop()\fP is used to grab a connection structure from the connection pool. The block argument specifies if the function should block and wait for a connection structure to be available if we try to exceed the maximum size. .sp -memcached_pool_push() is used to return a connection structure back to the pool. +\fI\%memcached_pool_push()\fP is used to return a connection structure back to the pool. .sp -memcached_pool_behavior_set() and memcached_pool_behagior_get() is -used to get/set behavior flags on all connections in the pool. +\fI\%memcached_pool_behavior_get()\fP and \fI\%memcached_pool_behavior_set()\fP is used to get/set behavior flags on all connections in the pool. .SH RETURN .sp -memcached_pool_create() returns a pointer to the newly created -memcached_pool_st structure. On an allocation failure, it returns -NULL. -.sp -memcached_pool_destroy() returns the pointer (and ownership) to the -memcached_st structure used to create the pool. If connections are in -use it returns NULL. +\fI\%memcached_pool_destroy()\fP returns the pointer (and ownership) to the \fBmemcached_st\fP structure used to create the pool. If connections are in use it returns NULL. .sp -memcached_pool_pop() returns a pointer to a memcached_st structure -from the pool (or NULL if an allocation cannot be satisfied). +\fI\%memcached_pool_pop()\fP returns a pointer to a \fBmemcached_st\fP structure from the pool (or NULL if an allocation cannot be satisfied). .sp -memcached_pool_push() returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_pool_push()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .sp -memcached_pool_behavior_get() and memcached_pool_behavior_get() -returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_pool_behavior_get()\fP and \fI\%memcached_pool_behavior_get()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .SH HOME .sp To find out more information please check: @@ -129,7 +108,7 @@ Brian Aker, <\fI\%brian@tangent.org\fP> Trond Norbye, <\fI\%trond.norbye@gmail.com\fP> .SH SEE ALSO .sp -\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP \fIlibmemcached_configuration(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_pool_destroy.3 b/docs/man/memcached_pool_destroy.3 index 96e66110..6855f1a0 100644 --- a/docs/man/memcached_pool_destroy.3 +++ b/docs/man/memcached_pool_destroy.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_POOL_DESTROY" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_POOL_DESTROY" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_pool_destroy \- libmemcached Documentation . @@ -35,89 +35,68 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_pool_st *memcached_pool(const char *option_string, size_t option_string_length); +.B memcached_pool_st .UNINDENT .INDENT 0.0 .TP -.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); DEPRECATED +.B \fI\%memcached_pool_st\fP* memcached_pool(const char\fI\ *option_string\fP, size_t\fI\ option_string_length\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st * memcached_pool_destroy(memcached_pool_st* pool); +.B \fI\%memcached_pool_st\fP* memcached_pool_create(memcached_st*\fI\ mmc\fP, int\fI\ initial\fP, int\fI\ max\fP) .UNINDENT +.sp +Deprecated since version 0.46: Use \fI\%memcached_pool()\fP instead. .INDENT 0.0 .TP -.B memcached_st * memcached_pool_pop (memcached_pool_st* pool, bool block, memcached_return_t *rc); +.B memcached_st* memcached_pool_destroy(\fI\%memcached_pool_st\fP*\fI\ pool\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_push(memcached_pool_st* pool, memcached_st *mmc); +.B memcached_st* memcached_pool_pop(\fI\%memcached_pool_st\fP*\fI\ pool\fP, bool\fI\ block\fP, memcached_return_t\fI\ *rc\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st *memcached_create (memcached_st *ptr); +.B memcached_return_t memcached_pool_push(\fI\%memcached_pool_st\fP*\fI\ pool\fP, memcached_st\fI\ *mmc\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_behavior_set(memcached_pool_st\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ data\fP) +.B memcached_return_t memcached_pool_behavior_set(\fI\%memcached_pool_st\fP\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ data\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_behavior_get(memcached_pool_st\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ *value\fP) +.B memcached_return_t memcached_pool_behavior_get(\fI\%memcached_pool_st\fP\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ *value\fP) .UNINDENT .sp Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -memcached_pool() is used to create a connection pool of objects you may use -to remove the overhead of using memcached_clone for short lived -\fBmemcached_st\fPobjects. Please see \fIlibmemcached_configuration\fP for details on the format of the configuration string. -.sp -DEPRECATED memcached_pool_create() is used to create a connection pool of -objects you may use to remove the overhead of using memcached_clone for -short lived \fBmemcached_st\fPobjects. The mmc argument should be an -initialised \fBmemcached_st\fPstructure, and a successfull invocation of -memcached_pool_create takes full ownership of the variable (until it is -released by memcached_pool_destroy). The \fBinitial\fP argument specifies -the initial size of the connection pool, and the \fBmax\fPargument -specifies the maximum size the connection pool should grow to. Please note -that the library will allocate a fixed size buffer scaled to the max size of -the connection pool, so you should not pass MAXINT or some other large -number here. -.sp -memcached_pool_destroy() is used to destroy the connection pool -created with memcached_pool_create() and release all allocated +\fI\%memcached_pool()\fP is used to create a connection pool of objects you +may use to remove the overhead of using memcached_clone for short lived +\fBmemcached_st\fP objects. Please see \fBlibmemcached_configuration\fP for details on the format of the configuration string. +.sp +\fI\%memcached_pool_destroy()\fP is used to destroy the connection pool +created with \fI\%memcached_pool_create()\fP and release all allocated resources. It will return the pointer to the \fBmemcached_st\fP structure -passed as an argument to memcached_pool_create(), and returns the ownership -of the pointer to the caller when created with memcached_pool_create, -otherwise NULL is returned.. +passed as an argument to \fI\%memcached_pool_create()\fP, and returns the ownership of the pointer to the caller when created with \fI\%memcached_pool_create()\fP, otherwise NULL is returned.. .sp -memcached_pool_pop() is used to grab a connection structure from the +\fI\%memcached_pool_pop()\fP is used to grab a connection structure from the connection pool. The block argument specifies if the function should block and wait for a connection structure to be available if we try to exceed the maximum size. .sp -memcached_pool_push() is used to return a connection structure back to the pool. +\fI\%memcached_pool_push()\fP is used to return a connection structure back to the pool. .sp -memcached_pool_behavior_set() and memcached_pool_behagior_get() is -used to get/set behavior flags on all connections in the pool. +\fI\%memcached_pool_behavior_get()\fP and \fI\%memcached_pool_behavior_set()\fP is used to get/set behavior flags on all connections in the pool. .SH RETURN .sp -memcached_pool_create() returns a pointer to the newly created -memcached_pool_st structure. On an allocation failure, it returns -NULL. -.sp -memcached_pool_destroy() returns the pointer (and ownership) to the -memcached_st structure used to create the pool. If connections are in -use it returns NULL. +\fI\%memcached_pool_destroy()\fP returns the pointer (and ownership) to the \fBmemcached_st\fP structure used to create the pool. If connections are in use it returns NULL. .sp -memcached_pool_pop() returns a pointer to a memcached_st structure -from the pool (or NULL if an allocation cannot be satisfied). +\fI\%memcached_pool_pop()\fP returns a pointer to a \fBmemcached_st\fP structure from the pool (or NULL if an allocation cannot be satisfied). .sp -memcached_pool_push() returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_pool_push()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .sp -memcached_pool_behavior_get() and memcached_pool_behavior_get() -returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_pool_behavior_get()\fP and \fI\%memcached_pool_behavior_get()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .SH HOME .sp To find out more information please check: @@ -129,7 +108,7 @@ Brian Aker, <\fI\%brian@tangent.org\fP> Trond Norbye, <\fI\%trond.norbye@gmail.com\fP> .SH SEE ALSO .sp -\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP \fIlibmemcached_configuration(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_pool_pop.3 b/docs/man/memcached_pool_pop.3 index cd50dcbb..9828527c 100644 --- a/docs/man/memcached_pool_pop.3 +++ b/docs/man/memcached_pool_pop.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_POOL_POP" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_POOL_POP" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_pool_pop \- libmemcached Documentation . @@ -35,89 +35,68 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_pool_st *memcached_pool(const char *option_string, size_t option_string_length); +.B memcached_pool_st .UNINDENT .INDENT 0.0 .TP -.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); DEPRECATED +.B \fI\%memcached_pool_st\fP* memcached_pool(const char\fI\ *option_string\fP, size_t\fI\ option_string_length\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st * memcached_pool_destroy(memcached_pool_st* pool); +.B \fI\%memcached_pool_st\fP* memcached_pool_create(memcached_st*\fI\ mmc\fP, int\fI\ initial\fP, int\fI\ max\fP) .UNINDENT +.sp +Deprecated since version 0.46: Use \fI\%memcached_pool()\fP instead. .INDENT 0.0 .TP -.B memcached_st * memcached_pool_pop (memcached_pool_st* pool, bool block, memcached_return_t *rc); +.B memcached_st* memcached_pool_destroy(\fI\%memcached_pool_st\fP*\fI\ pool\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_push(memcached_pool_st* pool, memcached_st *mmc); +.B memcached_st* memcached_pool_pop(\fI\%memcached_pool_st\fP*\fI\ pool\fP, bool\fI\ block\fP, memcached_return_t\fI\ *rc\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st *memcached_create (memcached_st *ptr); +.B memcached_return_t memcached_pool_push(\fI\%memcached_pool_st\fP*\fI\ pool\fP, memcached_st\fI\ *mmc\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_behavior_set(memcached_pool_st\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ data\fP) +.B memcached_return_t memcached_pool_behavior_set(\fI\%memcached_pool_st\fP\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ data\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_behavior_get(memcached_pool_st\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ *value\fP) +.B memcached_return_t memcached_pool_behavior_get(\fI\%memcached_pool_st\fP\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ *value\fP) .UNINDENT .sp Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -memcached_pool() is used to create a connection pool of objects you may use -to remove the overhead of using memcached_clone for short lived -\fBmemcached_st\fPobjects. Please see \fIlibmemcached_configuration\fP for details on the format of the configuration string. -.sp -DEPRECATED memcached_pool_create() is used to create a connection pool of -objects you may use to remove the overhead of using memcached_clone for -short lived \fBmemcached_st\fPobjects. The mmc argument should be an -initialised \fBmemcached_st\fPstructure, and a successfull invocation of -memcached_pool_create takes full ownership of the variable (until it is -released by memcached_pool_destroy). The \fBinitial\fP argument specifies -the initial size of the connection pool, and the \fBmax\fPargument -specifies the maximum size the connection pool should grow to. Please note -that the library will allocate a fixed size buffer scaled to the max size of -the connection pool, so you should not pass MAXINT or some other large -number here. -.sp -memcached_pool_destroy() is used to destroy the connection pool -created with memcached_pool_create() and release all allocated +\fI\%memcached_pool()\fP is used to create a connection pool of objects you +may use to remove the overhead of using memcached_clone for short lived +\fBmemcached_st\fP objects. Please see \fBlibmemcached_configuration\fP for details on the format of the configuration string. +.sp +\fI\%memcached_pool_destroy()\fP is used to destroy the connection pool +created with \fI\%memcached_pool_create()\fP and release all allocated resources. It will return the pointer to the \fBmemcached_st\fP structure -passed as an argument to memcached_pool_create(), and returns the ownership -of the pointer to the caller when created with memcached_pool_create, -otherwise NULL is returned.. +passed as an argument to \fI\%memcached_pool_create()\fP, and returns the ownership of the pointer to the caller when created with \fI\%memcached_pool_create()\fP, otherwise NULL is returned.. .sp -memcached_pool_pop() is used to grab a connection structure from the +\fI\%memcached_pool_pop()\fP is used to grab a connection structure from the connection pool. The block argument specifies if the function should block and wait for a connection structure to be available if we try to exceed the maximum size. .sp -memcached_pool_push() is used to return a connection structure back to the pool. +\fI\%memcached_pool_push()\fP is used to return a connection structure back to the pool. .sp -memcached_pool_behavior_set() and memcached_pool_behagior_get() is -used to get/set behavior flags on all connections in the pool. +\fI\%memcached_pool_behavior_get()\fP and \fI\%memcached_pool_behavior_set()\fP is used to get/set behavior flags on all connections in the pool. .SH RETURN .sp -memcached_pool_create() returns a pointer to the newly created -memcached_pool_st structure. On an allocation failure, it returns -NULL. -.sp -memcached_pool_destroy() returns the pointer (and ownership) to the -memcached_st structure used to create the pool. If connections are in -use it returns NULL. +\fI\%memcached_pool_destroy()\fP returns the pointer (and ownership) to the \fBmemcached_st\fP structure used to create the pool. If connections are in use it returns NULL. .sp -memcached_pool_pop() returns a pointer to a memcached_st structure -from the pool (or NULL if an allocation cannot be satisfied). +\fI\%memcached_pool_pop()\fP returns a pointer to a \fBmemcached_st\fP structure from the pool (or NULL if an allocation cannot be satisfied). .sp -memcached_pool_push() returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_pool_push()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .sp -memcached_pool_behavior_get() and memcached_pool_behavior_get() -returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_pool_behavior_get()\fP and \fI\%memcached_pool_behavior_get()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .SH HOME .sp To find out more information please check: @@ -129,7 +108,7 @@ Brian Aker, <\fI\%brian@tangent.org\fP> Trond Norbye, <\fI\%trond.norbye@gmail.com\fP> .SH SEE ALSO .sp -\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP \fIlibmemcached_configuration(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_pool_push.3 b/docs/man/memcached_pool_push.3 index 638766cd..6d085af6 100644 --- a/docs/man/memcached_pool_push.3 +++ b/docs/man/memcached_pool_push.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_POOL_PUSH" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_POOL_PUSH" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_pool_push \- libmemcached Documentation . @@ -35,89 +35,68 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_pool_st *memcached_pool(const char *option_string, size_t option_string_length); +.B memcached_pool_st .UNINDENT .INDENT 0.0 .TP -.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); DEPRECATED +.B \fI\%memcached_pool_st\fP* memcached_pool(const char\fI\ *option_string\fP, size_t\fI\ option_string_length\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st * memcached_pool_destroy(memcached_pool_st* pool); +.B \fI\%memcached_pool_st\fP* memcached_pool_create(memcached_st*\fI\ mmc\fP, int\fI\ initial\fP, int\fI\ max\fP) .UNINDENT +.sp +Deprecated since version 0.46: Use \fI\%memcached_pool()\fP instead. .INDENT 0.0 .TP -.B memcached_st * memcached_pool_pop (memcached_pool_st* pool, bool block, memcached_return_t *rc); +.B memcached_st* memcached_pool_destroy(\fI\%memcached_pool_st\fP*\fI\ pool\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_push(memcached_pool_st* pool, memcached_st *mmc); +.B memcached_st* memcached_pool_pop(\fI\%memcached_pool_st\fP*\fI\ pool\fP, bool\fI\ block\fP, memcached_return_t\fI\ *rc\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st *memcached_create (memcached_st *ptr); +.B memcached_return_t memcached_pool_push(\fI\%memcached_pool_st\fP*\fI\ pool\fP, memcached_st\fI\ *mmc\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_behavior_set(memcached_pool_st\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ data\fP) +.B memcached_return_t memcached_pool_behavior_set(\fI\%memcached_pool_st\fP\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ data\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_behavior_get(memcached_pool_st\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ *value\fP) +.B memcached_return_t memcached_pool_behavior_get(\fI\%memcached_pool_st\fP\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ *value\fP) .UNINDENT .sp Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -memcached_pool() is used to create a connection pool of objects you may use -to remove the overhead of using memcached_clone for short lived -\fBmemcached_st\fPobjects. Please see \fIlibmemcached_configuration\fP for details on the format of the configuration string. -.sp -DEPRECATED memcached_pool_create() is used to create a connection pool of -objects you may use to remove the overhead of using memcached_clone for -short lived \fBmemcached_st\fPobjects. The mmc argument should be an -initialised \fBmemcached_st\fPstructure, and a successfull invocation of -memcached_pool_create takes full ownership of the variable (until it is -released by memcached_pool_destroy). The \fBinitial\fP argument specifies -the initial size of the connection pool, and the \fBmax\fPargument -specifies the maximum size the connection pool should grow to. Please note -that the library will allocate a fixed size buffer scaled to the max size of -the connection pool, so you should not pass MAXINT or some other large -number here. -.sp -memcached_pool_destroy() is used to destroy the connection pool -created with memcached_pool_create() and release all allocated +\fI\%memcached_pool()\fP is used to create a connection pool of objects you +may use to remove the overhead of using memcached_clone for short lived +\fBmemcached_st\fP objects. Please see \fBlibmemcached_configuration\fP for details on the format of the configuration string. +.sp +\fI\%memcached_pool_destroy()\fP is used to destroy the connection pool +created with \fI\%memcached_pool_create()\fP and release all allocated resources. It will return the pointer to the \fBmemcached_st\fP structure -passed as an argument to memcached_pool_create(), and returns the ownership -of the pointer to the caller when created with memcached_pool_create, -otherwise NULL is returned.. +passed as an argument to \fI\%memcached_pool_create()\fP, and returns the ownership of the pointer to the caller when created with \fI\%memcached_pool_create()\fP, otherwise NULL is returned.. .sp -memcached_pool_pop() is used to grab a connection structure from the +\fI\%memcached_pool_pop()\fP is used to grab a connection structure from the connection pool. The block argument specifies if the function should block and wait for a connection structure to be available if we try to exceed the maximum size. .sp -memcached_pool_push() is used to return a connection structure back to the pool. +\fI\%memcached_pool_push()\fP is used to return a connection structure back to the pool. .sp -memcached_pool_behavior_set() and memcached_pool_behagior_get() is -used to get/set behavior flags on all connections in the pool. +\fI\%memcached_pool_behavior_get()\fP and \fI\%memcached_pool_behavior_set()\fP is used to get/set behavior flags on all connections in the pool. .SH RETURN .sp -memcached_pool_create() returns a pointer to the newly created -memcached_pool_st structure. On an allocation failure, it returns -NULL. -.sp -memcached_pool_destroy() returns the pointer (and ownership) to the -memcached_st structure used to create the pool. If connections are in -use it returns NULL. +\fI\%memcached_pool_destroy()\fP returns the pointer (and ownership) to the \fBmemcached_st\fP structure used to create the pool. If connections are in use it returns NULL. .sp -memcached_pool_pop() returns a pointer to a memcached_st structure -from the pool (or NULL if an allocation cannot be satisfied). +\fI\%memcached_pool_pop()\fP returns a pointer to a \fBmemcached_st\fP structure from the pool (or NULL if an allocation cannot be satisfied). .sp -memcached_pool_push() returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_pool_push()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .sp -memcached_pool_behavior_get() and memcached_pool_behavior_get() -returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_pool_behavior_get()\fP and \fI\%memcached_pool_behavior_get()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .SH HOME .sp To find out more information please check: @@ -129,7 +108,7 @@ Brian Aker, <\fI\%brian@tangent.org\fP> Trond Norbye, <\fI\%trond.norbye@gmail.com\fP> .SH SEE ALSO .sp -\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP \fIlibmemcached_configuration(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_pool_st.3 b/docs/man/memcached_pool_st.3 index 46624876..b3e4fd8c 100644 --- a/docs/man/memcached_pool_st.3 +++ b/docs/man/memcached_pool_st.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_POOL_ST" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_POOL_ST" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_pool_st \- libmemcached Documentation . @@ -35,89 +35,68 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_pool_st *memcached_pool(const char *option_string, size_t option_string_length); +.B memcached_pool_st .UNINDENT .INDENT 0.0 .TP -.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); DEPRECATED +.B \fI\%memcached_pool_st\fP* memcached_pool(const char\fI\ *option_string\fP, size_t\fI\ option_string_length\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st * memcached_pool_destroy(memcached_pool_st* pool); +.B \fI\%memcached_pool_st\fP* memcached_pool_create(memcached_st*\fI\ mmc\fP, int\fI\ initial\fP, int\fI\ max\fP) .UNINDENT +.sp +Deprecated since version 0.46: Use \fI\%memcached_pool()\fP instead. .INDENT 0.0 .TP -.B memcached_st * memcached_pool_pop (memcached_pool_st* pool, bool block, memcached_return_t *rc); +.B memcached_st* memcached_pool_destroy(\fI\%memcached_pool_st\fP*\fI\ pool\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_push(memcached_pool_st* pool, memcached_st *mmc); +.B memcached_st* memcached_pool_pop(\fI\%memcached_pool_st\fP*\fI\ pool\fP, bool\fI\ block\fP, memcached_return_t\fI\ *rc\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st *memcached_create (memcached_st *ptr); +.B memcached_return_t memcached_pool_push(\fI\%memcached_pool_st\fP*\fI\ pool\fP, memcached_st\fI\ *mmc\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_behavior_set(memcached_pool_st\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ data\fP) +.B memcached_return_t memcached_pool_behavior_set(\fI\%memcached_pool_st\fP\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ data\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_return_t memcached_pool_behavior_get(memcached_pool_st\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ *value\fP) +.B memcached_return_t memcached_pool_behavior_get(\fI\%memcached_pool_st\fP\fI\ *pool\fP, memcached_behavior_t\fI\ flag\fP, uint64_t\fI\ *value\fP) .UNINDENT .sp Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -memcached_pool() is used to create a connection pool of objects you may use -to remove the overhead of using memcached_clone for short lived -\fBmemcached_st\fPobjects. Please see \fIlibmemcached_configuration\fP for details on the format of the configuration string. -.sp -DEPRECATED memcached_pool_create() is used to create a connection pool of -objects you may use to remove the overhead of using memcached_clone for -short lived \fBmemcached_st\fPobjects. The mmc argument should be an -initialised \fBmemcached_st\fPstructure, and a successfull invocation of -memcached_pool_create takes full ownership of the variable (until it is -released by memcached_pool_destroy). The \fBinitial\fP argument specifies -the initial size of the connection pool, and the \fBmax\fPargument -specifies the maximum size the connection pool should grow to. Please note -that the library will allocate a fixed size buffer scaled to the max size of -the connection pool, so you should not pass MAXINT or some other large -number here. -.sp -memcached_pool_destroy() is used to destroy the connection pool -created with memcached_pool_create() and release all allocated +\fI\%memcached_pool()\fP is used to create a connection pool of objects you +may use to remove the overhead of using memcached_clone for short lived +\fBmemcached_st\fP objects. Please see \fBlibmemcached_configuration\fP for details on the format of the configuration string. +.sp +\fI\%memcached_pool_destroy()\fP is used to destroy the connection pool +created with \fI\%memcached_pool_create()\fP and release all allocated resources. It will return the pointer to the \fBmemcached_st\fP structure -passed as an argument to memcached_pool_create(), and returns the ownership -of the pointer to the caller when created with memcached_pool_create, -otherwise NULL is returned.. +passed as an argument to \fI\%memcached_pool_create()\fP, and returns the ownership of the pointer to the caller when created with \fI\%memcached_pool_create()\fP, otherwise NULL is returned.. .sp -memcached_pool_pop() is used to grab a connection structure from the +\fI\%memcached_pool_pop()\fP is used to grab a connection structure from the connection pool. The block argument specifies if the function should block and wait for a connection structure to be available if we try to exceed the maximum size. .sp -memcached_pool_push() is used to return a connection structure back to the pool. +\fI\%memcached_pool_push()\fP is used to return a connection structure back to the pool. .sp -memcached_pool_behavior_set() and memcached_pool_behagior_get() is -used to get/set behavior flags on all connections in the pool. +\fI\%memcached_pool_behavior_get()\fP and \fI\%memcached_pool_behavior_set()\fP is used to get/set behavior flags on all connections in the pool. .SH RETURN .sp -memcached_pool_create() returns a pointer to the newly created -memcached_pool_st structure. On an allocation failure, it returns -NULL. -.sp -memcached_pool_destroy() returns the pointer (and ownership) to the -memcached_st structure used to create the pool. If connections are in -use it returns NULL. +\fI\%memcached_pool_destroy()\fP returns the pointer (and ownership) to the \fBmemcached_st\fP structure used to create the pool. If connections are in use it returns NULL. .sp -memcached_pool_pop() returns a pointer to a memcached_st structure -from the pool (or NULL if an allocation cannot be satisfied). +\fI\%memcached_pool_pop()\fP returns a pointer to a \fBmemcached_st\fP structure from the pool (or NULL if an allocation cannot be satisfied). .sp -memcached_pool_push() returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_pool_push()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .sp -memcached_pool_behavior_get() and memcached_pool_behavior_get() -returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_pool_behavior_get()\fP and \fI\%memcached_pool_behavior_get()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .SH HOME .sp To find out more information please check: @@ -129,7 +108,7 @@ Brian Aker, <\fI\%brian@tangent.org\fP> Trond Norbye, <\fI\%trond.norbye@gmail.com\fP> .SH SEE ALSO .sp -\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP \fIlibmemcached_configuration(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_prepend.3 b/docs/man/memcached_prepend.3 index b0c6561e..257bf831 100644 --- a/docs/man/memcached_prepend.3 +++ b/docs/man/memcached_prepend.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_PREPEND" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_PREPEND" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_prepend \- Appending to or Prepending to data on the server . @@ -55,53 +55,61 @@ Appending or Prepending to data on the server Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_prepend() and memcached_append are used to +\fI\%memcached_prepend()\fP and memcached_append are used to modify information on a server. All methods take a key, and its length to -store the object. Keys are currently limited to 250 characters when using either a version of memcached(1) which is 1.4 or below, or when using the text protocol. -You must supply both a value and a length. Optionally you +store the object. Keys are currently limited to 250 characters when using +either a version of memcached which is 1.4 or below, or when using the text +protocol. You must supply both a value and a length. Optionally you may test an expiration time for the object and a 16 byte value (it is -meant to be used as a bitmap). "flags" is a 4byte space that is stored alongside of the main value. Many sub libraries make use of this field, so in most cases users should avoid making use of it. +meant to be used as a bitmap). "flags" is a 4byte space that is stored +alongside of the main value. Many sub libraries make use of this field, +so in most cases users should avoid making use of it. .sp -memcached_prepend() places a segment of data before the last piece of data -stored. Currently expiration and key are not used in the server. +\fI\%memcached_prepend()\fP places a segment of data before the last piece +of data stored. Currently expiration and key are not used in the server. .sp -memcached_append() places a segment of data at the end of the last piece of -data stored. Currently expiration and key are not used in the server. +\fI\%memcached_append()\fP places a segment of data at the end of the last +piece of data stored. Currently expiration and key are not used in the server. .sp -memcached_prepend_by_key() and memcached_append_by_key_by_key(, -methods both behave in a similar method as the non key -methods. The difference is that they use their group_key parameter to map -objects to particular servers. +\fBmemcached_prepend_by_key()\fP and +\fBmemcached_append_by_key_by_key()\fP methods both behave in a similar +method as the non key methods. The difference is that they use their +group_key parameter to map objects to particular servers. .sp -If you are looking for performance, memcached_set() with non\-blocking IO is -the fastest way to store data on the server. +If you are looking for performance, \fBmemcached_set()\fP with non\-blocking +IO is the fastest way to store data on the server. .sp -All of the above functions are testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPbehavior enabled. However, when using these operations with this behavior on, there -are limits to the size of the payload being sent to the server. The reason for -these limits is that the Memcached Server does not allow multi\-datagram requests +All of the above functions are testsed with the +\fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior enabled. However, when using +these operations with this behavior on, there are limits to the size of the +payload being sent to the server. The reason for these limits is that the +Memcached Server does not allow multi\-datagram requests and the current server implementation sets a datagram size to 1400 bytes. Due to protocol overhead, the actual limit of the user supplied data is less than 1400 bytes and depends on the protocol in use as, well as the operation being -executed. When running with the binary protocol, \(ga\(ga MEMCACHED_BEHAVIOR_BINARY_PROTOCOL\(ga\(ga, -the size of the key,value, flags and expiry combined may not exceed 1368 bytes. -When running with the ASCII protocol, the exact limit fluctuates depending on -which function is being executed and whether the function is a cas operation -or not. For non\-cas ASCII set operations, there are at least 1335 bytes available -to split among the key, key_prefix, and value; for cas ASCII operations there are -at least 1318 bytes available to split among the key, key_prefix and value. If the -total size of the command, including overhead, exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fPwill be returned. +executed. When running with the binary protocol, +\fBMEMCACHED_BEHAVIOR_BINARY_PROTOCOL\fP, the size of the key,value, +flags and expiry combined may not exceed 1368 bytes. When running with the +ASCII protocol, the exact limit fluctuates depending on which function is +being executed and whether the function is a cas operation or not. For +non\-cas ASCII set operations, there are at least 1335 bytes available +to split among the key, key_prefix, and value; for cas ASCII operations +there are at least 1318 bytes available to split among the key, key_prefix +and value. If the total size of the command, including overhead, exceeds +1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fP will be returned. .SH RETURN .sp All methods return a value of type \fBmemcached_return_t\fP. On success the value will be \fBMEMCACHED_SUCCESS\fP. -Use memcached_strerror() to translate this value to a printable string. +Use \fBmemcached_strerror()\fP to translate this value to a printable +string. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemached(3) memcached_strerror(3) memcached_set(3) memcached_add(3) memcached_cas(3) memcached_replace(3) +\fImemcached(1)\fP \fIlibmemached(3)\fP \fImemcached_strerror(3)\fP \fImemcached_set(3)\fP \fImemcached_add(3)\fP \fImemcached_cas(3)\fP \fImemcached_replace(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_prepend_by_key.3 b/docs/man/memcached_prepend_by_key.3 index b7026f28..d449b4a9 100644 --- a/docs/man/memcached_prepend_by_key.3 +++ b/docs/man/memcached_prepend_by_key.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_PREPEND_BY_KEY" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_PREPEND_BY_KEY" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_prepend_by_key \- Appending to or Prepending to data on the server . @@ -55,53 +55,61 @@ Appending or Prepending to data on the server Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_prepend() and memcached_append are used to +\fI\%memcached_prepend()\fP and memcached_append are used to modify information on a server. All methods take a key, and its length to -store the object. Keys are currently limited to 250 characters when using either a version of memcached(1) which is 1.4 or below, or when using the text protocol. -You must supply both a value and a length. Optionally you +store the object. Keys are currently limited to 250 characters when using +either a version of memcached which is 1.4 or below, or when using the text +protocol. You must supply both a value and a length. Optionally you may test an expiration time for the object and a 16 byte value (it is -meant to be used as a bitmap). "flags" is a 4byte space that is stored alongside of the main value. Many sub libraries make use of this field, so in most cases users should avoid making use of it. +meant to be used as a bitmap). "flags" is a 4byte space that is stored +alongside of the main value. Many sub libraries make use of this field, +so in most cases users should avoid making use of it. .sp -memcached_prepend() places a segment of data before the last piece of data -stored. Currently expiration and key are not used in the server. +\fI\%memcached_prepend()\fP places a segment of data before the last piece +of data stored. Currently expiration and key are not used in the server. .sp -memcached_append() places a segment of data at the end of the last piece of -data stored. Currently expiration and key are not used in the server. +\fI\%memcached_append()\fP places a segment of data at the end of the last +piece of data stored. Currently expiration and key are not used in the server. .sp -memcached_prepend_by_key() and memcached_append_by_key_by_key(, -methods both behave in a similar method as the non key -methods. The difference is that they use their group_key parameter to map -objects to particular servers. +\fBmemcached_prepend_by_key()\fP and +\fBmemcached_append_by_key_by_key()\fP methods both behave in a similar +method as the non key methods. The difference is that they use their +group_key parameter to map objects to particular servers. .sp -If you are looking for performance, memcached_set() with non\-blocking IO is -the fastest way to store data on the server. +If you are looking for performance, \fBmemcached_set()\fP with non\-blocking +IO is the fastest way to store data on the server. .sp -All of the above functions are testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPbehavior enabled. However, when using these operations with this behavior on, there -are limits to the size of the payload being sent to the server. The reason for -these limits is that the Memcached Server does not allow multi\-datagram requests +All of the above functions are testsed with the +\fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior enabled. However, when using +these operations with this behavior on, there are limits to the size of the +payload being sent to the server. The reason for these limits is that the +Memcached Server does not allow multi\-datagram requests and the current server implementation sets a datagram size to 1400 bytes. Due to protocol overhead, the actual limit of the user supplied data is less than 1400 bytes and depends on the protocol in use as, well as the operation being -executed. When running with the binary protocol, \(ga\(ga MEMCACHED_BEHAVIOR_BINARY_PROTOCOL\(ga\(ga, -the size of the key,value, flags and expiry combined may not exceed 1368 bytes. -When running with the ASCII protocol, the exact limit fluctuates depending on -which function is being executed and whether the function is a cas operation -or not. For non\-cas ASCII set operations, there are at least 1335 bytes available -to split among the key, key_prefix, and value; for cas ASCII operations there are -at least 1318 bytes available to split among the key, key_prefix and value. If the -total size of the command, including overhead, exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fPwill be returned. +executed. When running with the binary protocol, +\fBMEMCACHED_BEHAVIOR_BINARY_PROTOCOL\fP, the size of the key,value, +flags and expiry combined may not exceed 1368 bytes. When running with the +ASCII protocol, the exact limit fluctuates depending on which function is +being executed and whether the function is a cas operation or not. For +non\-cas ASCII set operations, there are at least 1335 bytes available +to split among the key, key_prefix, and value; for cas ASCII operations +there are at least 1318 bytes available to split among the key, key_prefix +and value. If the total size of the command, including overhead, exceeds +1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fP will be returned. .SH RETURN .sp All methods return a value of type \fBmemcached_return_t\fP. On success the value will be \fBMEMCACHED_SUCCESS\fP. -Use memcached_strerror() to translate this value to a printable string. +Use \fBmemcached_strerror()\fP to translate this value to a printable +string. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemached(3) memcached_strerror(3) memcached_set(3) memcached_add(3) memcached_cas(3) memcached_replace(3) +\fImemcached(1)\fP \fIlibmemached(3)\fP \fImemcached_strerror(3)\fP \fImemcached_set(3)\fP \fImemcached_add(3)\fP \fImemcached_cas(3)\fP \fImemcached_replace(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_quit.3 b/docs/man/memcached_quit.3 index 40e47e6d..eeb649ff 100644 --- a/docs/man/memcached_quit.3 +++ b/docs/man/memcached_quit.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_QUIT" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_QUIT" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_quit \- libmemcached Documentation . @@ -41,20 +41,19 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_quit() will disconnect you from all currently connected servers. -It will also reset the state of the connection (ie, any memcached_fetch() you -are in the middle of will be terminated). This function is called -automatically when you call memcached_free() on the \fBmemcached_st\fP structure. +\fBmemcached_quit()\fP will disconnect you from all currently connected +servers. It will also reset the state of the connection (ie, any \fBmemcached_fetch()\fP you are in the middle of will be terminated). This function is +called automatically when you call \fBmemcached_free()\fP on the \fBmemcached_st\fP structure. .sp You do not need to call this on your own. All operations to change server hashes and parameters will handle connections to the server for you. This function is provided mainly so that you can timeout your connections or -reset connections during the middle of a memcached_fetch(). +reset connections during the middle of a \fBmemcached_fetch()\fP. .SH RETURN .sp A value of type \fBmemcached_return\fP is returned On success that value will be \fBMEMCACHED_SUCCESS\fP. -Use memcached_strerror() to translate this value to a printable string. +Use \fBmemcached_strerror()\fP to translate this value to a printable string. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_replace.3 b/docs/man/memcached_replace.3 index 8d189341..bb9d27ec 100644 --- a/docs/man/memcached_replace.3 +++ b/docs/man/memcached_replace.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_REPLACE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_REPLACE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_replace \- Storing and Replacing Data . @@ -61,68 +61,57 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_set(), memcached_add(), and memcached_replace() are all used to -store information on the server. All methods take a key, and its length to -store the object. Keys are currently limited to 250 characters when using either a version of memcached(1) which is 1.4 or below, or when using the text protocol. -You must supply both a value and a length. Optionally you -may test an expiration time for the object and a 16 byte value (it is -meant to be used as a bitmap). "flags" is a 4byte space that is stored alongside of the main value. Many sub libraries make use of this field, so in most cases users should avoid making use of it. +\fBmemcached_set()\fP, \fBmemcached_add()\fP, and \fBmemcached_replace()\fP are all used to store information on the server. All methods take a key, and its length to store the object. Keys are currently limited to 250 characters when using either a version of memcached(1) which is 1.4 or below, or when using the text protocol. You must supply both a value and a length. Optionally you +store the object. Keys are currently limited to 250 characters by the +memcached(1) server. You must supply both a value and a length. Optionally you +may test an expiration time for the object and a 16 byte value (it is meant to be used as a bitmap). "flags" is a 4byte space that is stored alongside of the main value. Many sub libraries make use of this field, so in most cases users should avoid making use of it. .sp -memcached_set() will write an object to the server. If an object already -exists it will overwrite what is in the server. If the object does not exist -it will be written. If you are using the non\-blocking mode this function +\fBmemcached_set()\fP will write an object to the server. If an object +already exists it will overwrite what is in the server. If the object does not +exist it will be written. If you are using the non\-blocking mode this function will always return true unless a network error occurs. .sp -memcached_replace() replaces an object on the server. If the object is not -found on the server an error occurs. +\fBmemcached_replace()\fP replaces an object on the server. If the object is not found on the server an error occurs. .sp -memcached_add() adds an object to the server. If the object is found on the -server an error occurs, otherwise the value is stored. +\fBmemcached_add()\fP adds an object to the server. If the object is found on the server an error occurs, otherwise the value is stored. .sp -memcached_cas() overwrites data in the server as long as the "cas" value is -still the same in the server. You can get the cas value of a result by -calling memcached_result_cas() on a memcached_result_st(3) structure. At the point +\fBmemcached_cas()\fP overwrites data in the server as long as the "cas" +value is still the same in the server. You can get the cas value of a result by +calling \fBmemcached_result_cas()\fP on a memcached_result_st(3) structure. At the point that this note was written cas is still buggy in memached. Turning on tests for it in libmemcached(3) is optional. Please see memcached_set() for information on how to do this. .sp -memcached_set_by_key(), memcached_add_by_key(), and memcached_replace_by_key() -methods all behave in a similar method as the non key -methods. The difference is that they use their group_key parameter to map +\fBmemcached_set_by_key()\fP, \fBmemcached_add_by_key()\fP, and \fBmemcached_replace_by_key()\fP methods all behave in a similar method as the non +key methods. The difference is that they use their group_key parameter to map objects to particular servers. .sp -If you are looking for performance, memcached_set() with non\-blocking IO is -the fastest way to store data on the server. +If you are looking for performance, \fBmemcached_set()\fP with non\-blocking IO is the fastest way to store data on the server. .sp -All of the above functions are testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPbehavior enabled. However, when using these operations with this behavior on, there -are limits to the size of the payload being sent to the server. The reason for -these limits is that the Memcached Server does not allow multi\-datagram requests -and the current server implementation sets a datagram size to 1400 bytes. Due -to protocol overhead, the actual limit of the user supplied data is less than -1400 bytes and depends on the protocol in use as, well as the operation being -executed. When running with the binary protocol, \(ga\(ga MEMCACHED_BEHAVIOR_BINARY_PROTOCOL\(ga\(ga, -the size of the key,value, flags and expiry combined may not exceed 1368 bytes. -When running with the ASCII protocol, the exact limit fluctuates depending on -which function is being executed and whether the function is a cas operation -or not. For non\-cas ASCII set operations, there are at least 1335 bytes available -to split among the key, key_prefix, and value; for cas ASCII operations there are -at least 1318 bytes available to split among the key, key_prefix and value. If the -total size of the command, including overhead, exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fPwill be returned. +All of the above functions are testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior enabled. However, when using these operations with this behavior +on, there are limits to the size of the payload being sent to the server. +The reason for these limits is that the Memcached Server does not allow +multi\-datagram requests and the current server implementation sets a datagram +size to 1400 bytes. Due to protocol overhead, the actual limit of the user supplied data is less than 1400 bytes and depends on the protocol in use as, well as the operation being +executed. When running with the binary protocol, \fBMEMCACHED_BEHAVIOR_BINARY_PROTOCOL\fP, the size of the key,value, flags and expiry combined may not +exceed 1368 bytes. When running with the ASCII protocol, the exact limit fluctuates depending on which function is being executed and whether the function is a cas operation or not. For non\-cas ASCII set operations, there are at least +1335 bytes available to split among the key, key_prefix, and value; for cas +ASCII operations there are at least 1318 bytes available to split among the key, key_prefix and value. If the total size of the command, including overhead, +exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fP will be returned. .SH RETURN .sp All methods return a value of type \fBmemcached_return_t\fP. On success the value will be \fBMEMCACHED_SUCCESS\fP. -Use memcached_strerror() to translate this value to a printable string. +Use \fBmemcached_strerror()\fP to translate this value to a printable string. .sp -For memcached_replace() and memcached_add(), \fBMEMCACHED_NOTSTORED\fP is a -legitmate error in the case of a collision. +For \fBmemcached_replace()\fP and \fBmemcached_add()\fP, \fBMEMCACHED_NOTSTORED\fP is a legitmate error in the case of a collision. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemached(3) memcached_strerror(3) memcached_prepend(3) memcached_cas(3) memcached_append(3) +\fImemcached(1)\fP \fIlibmemached(3)\fP \fImemcached_strerror(3)\fP \fImemcached_prepend(3)\fP \fImemcached_cas(3)\fP \fImemcached_append(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_replace_by_key.3 b/docs/man/memcached_replace_by_key.3 index bf3a444a..d4efc972 100644 --- a/docs/man/memcached_replace_by_key.3 +++ b/docs/man/memcached_replace_by_key.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_REPLACE_BY_KEY" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_REPLACE_BY_KEY" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_replace_by_key \- Storing and Replacing Data . @@ -61,68 +61,57 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_set(), memcached_add(), and memcached_replace() are all used to -store information on the server. All methods take a key, and its length to -store the object. Keys are currently limited to 250 characters when using either a version of memcached(1) which is 1.4 or below, or when using the text protocol. -You must supply both a value and a length. Optionally you -may test an expiration time for the object and a 16 byte value (it is -meant to be used as a bitmap). "flags" is a 4byte space that is stored alongside of the main value. Many sub libraries make use of this field, so in most cases users should avoid making use of it. +\fBmemcached_set()\fP, \fBmemcached_add()\fP, and \fBmemcached_replace()\fP are all used to store information on the server. All methods take a key, and its length to store the object. Keys are currently limited to 250 characters when using either a version of memcached(1) which is 1.4 or below, or when using the text protocol. You must supply both a value and a length. Optionally you +store the object. Keys are currently limited to 250 characters by the +memcached(1) server. You must supply both a value and a length. Optionally you +may test an expiration time for the object and a 16 byte value (it is meant to be used as a bitmap). "flags" is a 4byte space that is stored alongside of the main value. Many sub libraries make use of this field, so in most cases users should avoid making use of it. .sp -memcached_set() will write an object to the server. If an object already -exists it will overwrite what is in the server. If the object does not exist -it will be written. If you are using the non\-blocking mode this function +\fBmemcached_set()\fP will write an object to the server. If an object +already exists it will overwrite what is in the server. If the object does not +exist it will be written. If you are using the non\-blocking mode this function will always return true unless a network error occurs. .sp -memcached_replace() replaces an object on the server. If the object is not -found on the server an error occurs. +\fBmemcached_replace()\fP replaces an object on the server. If the object is not found on the server an error occurs. .sp -memcached_add() adds an object to the server. If the object is found on the -server an error occurs, otherwise the value is stored. +\fBmemcached_add()\fP adds an object to the server. If the object is found on the server an error occurs, otherwise the value is stored. .sp -memcached_cas() overwrites data in the server as long as the "cas" value is -still the same in the server. You can get the cas value of a result by -calling memcached_result_cas() on a memcached_result_st(3) structure. At the point +\fBmemcached_cas()\fP overwrites data in the server as long as the "cas" +value is still the same in the server. You can get the cas value of a result by +calling \fBmemcached_result_cas()\fP on a memcached_result_st(3) structure. At the point that this note was written cas is still buggy in memached. Turning on tests for it in libmemcached(3) is optional. Please see memcached_set() for information on how to do this. .sp -memcached_set_by_key(), memcached_add_by_key(), and memcached_replace_by_key() -methods all behave in a similar method as the non key -methods. The difference is that they use their group_key parameter to map +\fBmemcached_set_by_key()\fP, \fBmemcached_add_by_key()\fP, and \fBmemcached_replace_by_key()\fP methods all behave in a similar method as the non +key methods. The difference is that they use their group_key parameter to map objects to particular servers. .sp -If you are looking for performance, memcached_set() with non\-blocking IO is -the fastest way to store data on the server. +If you are looking for performance, \fBmemcached_set()\fP with non\-blocking IO is the fastest way to store data on the server. .sp -All of the above functions are testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPbehavior enabled. However, when using these operations with this behavior on, there -are limits to the size of the payload being sent to the server. The reason for -these limits is that the Memcached Server does not allow multi\-datagram requests -and the current server implementation sets a datagram size to 1400 bytes. Due -to protocol overhead, the actual limit of the user supplied data is less than -1400 bytes and depends on the protocol in use as, well as the operation being -executed. When running with the binary protocol, \(ga\(ga MEMCACHED_BEHAVIOR_BINARY_PROTOCOL\(ga\(ga, -the size of the key,value, flags and expiry combined may not exceed 1368 bytes. -When running with the ASCII protocol, the exact limit fluctuates depending on -which function is being executed and whether the function is a cas operation -or not. For non\-cas ASCII set operations, there are at least 1335 bytes available -to split among the key, key_prefix, and value; for cas ASCII operations there are -at least 1318 bytes available to split among the key, key_prefix and value. If the -total size of the command, including overhead, exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fPwill be returned. +All of the above functions are testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior enabled. However, when using these operations with this behavior +on, there are limits to the size of the payload being sent to the server. +The reason for these limits is that the Memcached Server does not allow +multi\-datagram requests and the current server implementation sets a datagram +size to 1400 bytes. Due to protocol overhead, the actual limit of the user supplied data is less than 1400 bytes and depends on the protocol in use as, well as the operation being +executed. When running with the binary protocol, \fBMEMCACHED_BEHAVIOR_BINARY_PROTOCOL\fP, the size of the key,value, flags and expiry combined may not +exceed 1368 bytes. When running with the ASCII protocol, the exact limit fluctuates depending on which function is being executed and whether the function is a cas operation or not. For non\-cas ASCII set operations, there are at least +1335 bytes available to split among the key, key_prefix, and value; for cas +ASCII operations there are at least 1318 bytes available to split among the key, key_prefix and value. If the total size of the command, including overhead, +exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fP will be returned. .SH RETURN .sp All methods return a value of type \fBmemcached_return_t\fP. On success the value will be \fBMEMCACHED_SUCCESS\fP. -Use memcached_strerror() to translate this value to a printable string. +Use \fBmemcached_strerror()\fP to translate this value to a printable string. .sp -For memcached_replace() and memcached_add(), \fBMEMCACHED_NOTSTORED\fP is a -legitmate error in the case of a collision. +For \fBmemcached_replace()\fP and \fBmemcached_add()\fP, \fBMEMCACHED_NOTSTORED\fP is a legitmate error in the case of a collision. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemached(3) memcached_strerror(3) memcached_prepend(3) memcached_cas(3) memcached_append(3) +\fImemcached(1)\fP \fIlibmemached(3)\fP \fImemcached_strerror(3)\fP \fImemcached_prepend(3)\fP \fImemcached_cas(3)\fP \fImemcached_append(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_result_cas.3 b/docs/man/memcached_result_cas.3 index 6e254c70..51d025f9 100644 --- a/docs/man/memcached_result_cas.3 +++ b/docs/man/memcached_result_cas.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_RESULT_CAS" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_RESULT_CAS" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_result_cas \- Working with result sets . @@ -85,51 +85,50 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -libmemcached(3) can optionally return a memcached_result_st which acts as a -result object. The result objects have added benefits over the character -pointer returns, in that they are forward compatible with new return items -that future memcached servers may implement (the best current example of -this is the CAS return item). The structures can also be reused, which will -save on calls to malloc(3). It is suggested that you use result objects over -char * return functions. +libmemcached(3) can optionally return a \fI\%memcached_result_st\fP which +acts as a result object. The result objects have added benefits over the +character pointer returns, in that they are forward compatible with new +return items that future memcached servers may implement (the best current +example of this is the CAS return item). The structures can also be reused, +which will save on calls to malloc(3). It is suggested that you use result +objects over char * return functions. .sp -The structure of memcached_result_st has been encapsulated, you should not -write code to directly access members of the structure. +The structure of \fI\%memcached_result_st\fP has been encapsulated, you should +not write code to directly access members of the structure. .sp -memcached_result_create() will either allocate memory for a -memcached_result_st or will initialize a structure passed to it. +\fBmemcached_result_create()\fP will either allocate memory for a +\fI\%memcached_result_st\fP or will initialize a structure passed to it. .sp -memcached_result_free() will deallocate any memory attached to the +\fBmemcached_result_free()\fP will deallocate any memory attached to the structure. If the structure was also allocated, it will deallocate it. .sp -memcached_result_key_value() returns the key value associated with the +\fBmemcached_result_key_value()\fP returns the key value associated with the current result object. .sp -memcached_result_key_length() returns the key length associated with the -current result object. +\fBmemcached_result_key_length()\fP returns the key length associated with +the current result object. .sp -memcached_result_value() returns the result value associated with the +\fBmemcached_result_value()\fP returns the result value associated with the current result object. .sp -memcached_result_length() returns the result length associated with the -current result object. +\fBmemcached_result_length()\fP returns the result length associated with +the current result object. .sp -memcached_result_flags() returns the flags associated with the +\fI\%memcached_result_flags()\fP returns the flags associated with the current result object. .sp -memcached_result_cas() returns the cas associated with the +\fBmemcached_result_cas()\fP returns the cas associated with the current result object. This value will only be available if the server tests it. .sp -memcached_result_set_value() takes a byte array and a size and sets +\fI\%memcached_result_set_value()\fP takes a byte array and a size and sets the result to this value. This function is used for trigger responses. .sp -void memcached_result_set_flags() takes a result structure and stores +\fBvoid memcached_result_set_flags()\fP takes a result structure and stores a new value for the flags field. .sp -void memcached_result_set_expiration(A) takes a result structure and stores -a new value for the expiration field (this is only used by read through -triggers). +\fBvoid memcached_result_set_expiration(A)()\fP takes a result structure and stores a new value for the expiration field (this is only used by read +through triggers). .sp You may wish to avoid using memcached_result_create(3) with a stack based allocation. The most common issues related to ABI safety involve @@ -137,8 +136,8 @@ heap allocated structures. .SH RETURN .sp Varies, see particular functions. All structures must have -memcached_result_free() called on them for cleanup purposes. Failure to -do this will result in leaked memory. +\fBmemcached_result_free()\fP called on them for cleanup purposes. Failure +to do this will result in leaked memory. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_result_create.3 b/docs/man/memcached_result_create.3 index 98453d55..b0a34f22 100644 --- a/docs/man/memcached_result_create.3 +++ b/docs/man/memcached_result_create.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_RESULT_CREATE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_RESULT_CREATE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_result_create \- Working with result sets . @@ -85,51 +85,50 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -libmemcached(3) can optionally return a memcached_result_st which acts as a -result object. The result objects have added benefits over the character -pointer returns, in that they are forward compatible with new return items -that future memcached servers may implement (the best current example of -this is the CAS return item). The structures can also be reused, which will -save on calls to malloc(3). It is suggested that you use result objects over -char * return functions. +libmemcached(3) can optionally return a \fI\%memcached_result_st\fP which +acts as a result object. The result objects have added benefits over the +character pointer returns, in that they are forward compatible with new +return items that future memcached servers may implement (the best current +example of this is the CAS return item). The structures can also be reused, +which will save on calls to malloc(3). It is suggested that you use result +objects over char * return functions. .sp -The structure of memcached_result_st has been encapsulated, you should not -write code to directly access members of the structure. +The structure of \fI\%memcached_result_st\fP has been encapsulated, you should +not write code to directly access members of the structure. .sp -memcached_result_create() will either allocate memory for a -memcached_result_st or will initialize a structure passed to it. +\fBmemcached_result_create()\fP will either allocate memory for a +\fI\%memcached_result_st\fP or will initialize a structure passed to it. .sp -memcached_result_free() will deallocate any memory attached to the +\fBmemcached_result_free()\fP will deallocate any memory attached to the structure. If the structure was also allocated, it will deallocate it. .sp -memcached_result_key_value() returns the key value associated with the +\fBmemcached_result_key_value()\fP returns the key value associated with the current result object. .sp -memcached_result_key_length() returns the key length associated with the -current result object. +\fBmemcached_result_key_length()\fP returns the key length associated with +the current result object. .sp -memcached_result_value() returns the result value associated with the +\fBmemcached_result_value()\fP returns the result value associated with the current result object. .sp -memcached_result_length() returns the result length associated with the -current result object. +\fBmemcached_result_length()\fP returns the result length associated with +the current result object. .sp -memcached_result_flags() returns the flags associated with the +\fI\%memcached_result_flags()\fP returns the flags associated with the current result object. .sp -memcached_result_cas() returns the cas associated with the +\fBmemcached_result_cas()\fP returns the cas associated with the current result object. This value will only be available if the server tests it. .sp -memcached_result_set_value() takes a byte array and a size and sets +\fI\%memcached_result_set_value()\fP takes a byte array and a size and sets the result to this value. This function is used for trigger responses. .sp -void memcached_result_set_flags() takes a result structure and stores +\fBvoid memcached_result_set_flags()\fP takes a result structure and stores a new value for the flags field. .sp -void memcached_result_set_expiration(A) takes a result structure and stores -a new value for the expiration field (this is only used by read through -triggers). +\fBvoid memcached_result_set_expiration(A)()\fP takes a result structure and stores a new value for the expiration field (this is only used by read +through triggers). .sp You may wish to avoid using memcached_result_create(3) with a stack based allocation. The most common issues related to ABI safety involve @@ -137,8 +136,8 @@ heap allocated structures. .SH RETURN .sp Varies, see particular functions. All structures must have -memcached_result_free() called on them for cleanup purposes. Failure to -do this will result in leaked memory. +\fBmemcached_result_free()\fP called on them for cleanup purposes. Failure +to do this will result in leaked memory. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_result_flags.3 b/docs/man/memcached_result_flags.3 index 9713347b..b12f4db7 100644 --- a/docs/man/memcached_result_flags.3 +++ b/docs/man/memcached_result_flags.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_RESULT_FLAGS" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_RESULT_FLAGS" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_result_flags \- Working with result sets . @@ -85,51 +85,50 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -libmemcached(3) can optionally return a memcached_result_st which acts as a -result object. The result objects have added benefits over the character -pointer returns, in that they are forward compatible with new return items -that future memcached servers may implement (the best current example of -this is the CAS return item). The structures can also be reused, which will -save on calls to malloc(3). It is suggested that you use result objects over -char * return functions. +libmemcached(3) can optionally return a \fI\%memcached_result_st\fP which +acts as a result object. The result objects have added benefits over the +character pointer returns, in that they are forward compatible with new +return items that future memcached servers may implement (the best current +example of this is the CAS return item). The structures can also be reused, +which will save on calls to malloc(3). It is suggested that you use result +objects over char * return functions. .sp -The structure of memcached_result_st has been encapsulated, you should not -write code to directly access members of the structure. +The structure of \fI\%memcached_result_st\fP has been encapsulated, you should +not write code to directly access members of the structure. .sp -memcached_result_create() will either allocate memory for a -memcached_result_st or will initialize a structure passed to it. +\fBmemcached_result_create()\fP will either allocate memory for a +\fI\%memcached_result_st\fP or will initialize a structure passed to it. .sp -memcached_result_free() will deallocate any memory attached to the +\fBmemcached_result_free()\fP will deallocate any memory attached to the structure. If the structure was also allocated, it will deallocate it. .sp -memcached_result_key_value() returns the key value associated with the +\fBmemcached_result_key_value()\fP returns the key value associated with the current result object. .sp -memcached_result_key_length() returns the key length associated with the -current result object. +\fBmemcached_result_key_length()\fP returns the key length associated with +the current result object. .sp -memcached_result_value() returns the result value associated with the +\fBmemcached_result_value()\fP returns the result value associated with the current result object. .sp -memcached_result_length() returns the result length associated with the -current result object. +\fBmemcached_result_length()\fP returns the result length associated with +the current result object. .sp -memcached_result_flags() returns the flags associated with the +\fI\%memcached_result_flags()\fP returns the flags associated with the current result object. .sp -memcached_result_cas() returns the cas associated with the +\fBmemcached_result_cas()\fP returns the cas associated with the current result object. This value will only be available if the server tests it. .sp -memcached_result_set_value() takes a byte array and a size and sets +\fI\%memcached_result_set_value()\fP takes a byte array and a size and sets the result to this value. This function is used for trigger responses. .sp -void memcached_result_set_flags() takes a result structure and stores +\fBvoid memcached_result_set_flags()\fP takes a result structure and stores a new value for the flags field. .sp -void memcached_result_set_expiration(A) takes a result structure and stores -a new value for the expiration field (this is only used by read through -triggers). +\fBvoid memcached_result_set_expiration(A)()\fP takes a result structure and stores a new value for the expiration field (this is only used by read +through triggers). .sp You may wish to avoid using memcached_result_create(3) with a stack based allocation. The most common issues related to ABI safety involve @@ -137,8 +136,8 @@ heap allocated structures. .SH RETURN .sp Varies, see particular functions. All structures must have -memcached_result_free() called on them for cleanup purposes. Failure to -do this will result in leaked memory. +\fBmemcached_result_free()\fP called on them for cleanup purposes. Failure +to do this will result in leaked memory. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_result_free.3 b/docs/man/memcached_result_free.3 index fce830dd..14d120f4 100644 --- a/docs/man/memcached_result_free.3 +++ b/docs/man/memcached_result_free.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_RESULT_FREE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_RESULT_FREE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_result_free \- Working with result sets . @@ -85,51 +85,50 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -libmemcached(3) can optionally return a memcached_result_st which acts as a -result object. The result objects have added benefits over the character -pointer returns, in that they are forward compatible with new return items -that future memcached servers may implement (the best current example of -this is the CAS return item). The structures can also be reused, which will -save on calls to malloc(3). It is suggested that you use result objects over -char * return functions. +libmemcached(3) can optionally return a \fI\%memcached_result_st\fP which +acts as a result object. The result objects have added benefits over the +character pointer returns, in that they are forward compatible with new +return items that future memcached servers may implement (the best current +example of this is the CAS return item). The structures can also be reused, +which will save on calls to malloc(3). It is suggested that you use result +objects over char * return functions. .sp -The structure of memcached_result_st has been encapsulated, you should not -write code to directly access members of the structure. +The structure of \fI\%memcached_result_st\fP has been encapsulated, you should +not write code to directly access members of the structure. .sp -memcached_result_create() will either allocate memory for a -memcached_result_st or will initialize a structure passed to it. +\fBmemcached_result_create()\fP will either allocate memory for a +\fI\%memcached_result_st\fP or will initialize a structure passed to it. .sp -memcached_result_free() will deallocate any memory attached to the +\fBmemcached_result_free()\fP will deallocate any memory attached to the structure. If the structure was also allocated, it will deallocate it. .sp -memcached_result_key_value() returns the key value associated with the +\fBmemcached_result_key_value()\fP returns the key value associated with the current result object. .sp -memcached_result_key_length() returns the key length associated with the -current result object. +\fBmemcached_result_key_length()\fP returns the key length associated with +the current result object. .sp -memcached_result_value() returns the result value associated with the +\fBmemcached_result_value()\fP returns the result value associated with the current result object. .sp -memcached_result_length() returns the result length associated with the -current result object. +\fBmemcached_result_length()\fP returns the result length associated with +the current result object. .sp -memcached_result_flags() returns the flags associated with the +\fI\%memcached_result_flags()\fP returns the flags associated with the current result object. .sp -memcached_result_cas() returns the cas associated with the +\fBmemcached_result_cas()\fP returns the cas associated with the current result object. This value will only be available if the server tests it. .sp -memcached_result_set_value() takes a byte array and a size and sets +\fI\%memcached_result_set_value()\fP takes a byte array and a size and sets the result to this value. This function is used for trigger responses. .sp -void memcached_result_set_flags() takes a result structure and stores +\fBvoid memcached_result_set_flags()\fP takes a result structure and stores a new value for the flags field. .sp -void memcached_result_set_expiration(A) takes a result structure and stores -a new value for the expiration field (this is only used by read through -triggers). +\fBvoid memcached_result_set_expiration(A)()\fP takes a result structure and stores a new value for the expiration field (this is only used by read +through triggers). .sp You may wish to avoid using memcached_result_create(3) with a stack based allocation. The most common issues related to ABI safety involve @@ -137,8 +136,8 @@ heap allocated structures. .SH RETURN .sp Varies, see particular functions. All structures must have -memcached_result_free() called on them for cleanup purposes. Failure to -do this will result in leaked memory. +\fBmemcached_result_free()\fP called on them for cleanup purposes. Failure +to do this will result in leaked memory. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_result_key_length.3 b/docs/man/memcached_result_key_length.3 index 2a3f2ba6..eb05598c 100644 --- a/docs/man/memcached_result_key_length.3 +++ b/docs/man/memcached_result_key_length.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_RESULT_KEY_LENGTH" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_RESULT_KEY_LENGTH" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_result_key_length \- Working with result sets . @@ -85,51 +85,50 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -libmemcached(3) can optionally return a memcached_result_st which acts as a -result object. The result objects have added benefits over the character -pointer returns, in that they are forward compatible with new return items -that future memcached servers may implement (the best current example of -this is the CAS return item). The structures can also be reused, which will -save on calls to malloc(3). It is suggested that you use result objects over -char * return functions. +libmemcached(3) can optionally return a \fI\%memcached_result_st\fP which +acts as a result object. The result objects have added benefits over the +character pointer returns, in that they are forward compatible with new +return items that future memcached servers may implement (the best current +example of this is the CAS return item). The structures can also be reused, +which will save on calls to malloc(3). It is suggested that you use result +objects over char * return functions. .sp -The structure of memcached_result_st has been encapsulated, you should not -write code to directly access members of the structure. +The structure of \fI\%memcached_result_st\fP has been encapsulated, you should +not write code to directly access members of the structure. .sp -memcached_result_create() will either allocate memory for a -memcached_result_st or will initialize a structure passed to it. +\fBmemcached_result_create()\fP will either allocate memory for a +\fI\%memcached_result_st\fP or will initialize a structure passed to it. .sp -memcached_result_free() will deallocate any memory attached to the +\fBmemcached_result_free()\fP will deallocate any memory attached to the structure. If the structure was also allocated, it will deallocate it. .sp -memcached_result_key_value() returns the key value associated with the +\fBmemcached_result_key_value()\fP returns the key value associated with the current result object. .sp -memcached_result_key_length() returns the key length associated with the -current result object. +\fBmemcached_result_key_length()\fP returns the key length associated with +the current result object. .sp -memcached_result_value() returns the result value associated with the +\fBmemcached_result_value()\fP returns the result value associated with the current result object. .sp -memcached_result_length() returns the result length associated with the -current result object. +\fBmemcached_result_length()\fP returns the result length associated with +the current result object. .sp -memcached_result_flags() returns the flags associated with the +\fI\%memcached_result_flags()\fP returns the flags associated with the current result object. .sp -memcached_result_cas() returns the cas associated with the +\fBmemcached_result_cas()\fP returns the cas associated with the current result object. This value will only be available if the server tests it. .sp -memcached_result_set_value() takes a byte array and a size and sets +\fI\%memcached_result_set_value()\fP takes a byte array and a size and sets the result to this value. This function is used for trigger responses. .sp -void memcached_result_set_flags() takes a result structure and stores +\fBvoid memcached_result_set_flags()\fP takes a result structure and stores a new value for the flags field. .sp -void memcached_result_set_expiration(A) takes a result structure and stores -a new value for the expiration field (this is only used by read through -triggers). +\fBvoid memcached_result_set_expiration(A)()\fP takes a result structure and stores a new value for the expiration field (this is only used by read +through triggers). .sp You may wish to avoid using memcached_result_create(3) with a stack based allocation. The most common issues related to ABI safety involve @@ -137,8 +136,8 @@ heap allocated structures. .SH RETURN .sp Varies, see particular functions. All structures must have -memcached_result_free() called on them for cleanup purposes. Failure to -do this will result in leaked memory. +\fBmemcached_result_free()\fP called on them for cleanup purposes. Failure +to do this will result in leaked memory. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_result_key_value.3 b/docs/man/memcached_result_key_value.3 index 55802208..ff1b99d5 100644 --- a/docs/man/memcached_result_key_value.3 +++ b/docs/man/memcached_result_key_value.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_RESULT_KEY_VALUE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_RESULT_KEY_VALUE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_result_key_value \- Working with result sets . @@ -85,51 +85,50 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -libmemcached(3) can optionally return a memcached_result_st which acts as a -result object. The result objects have added benefits over the character -pointer returns, in that they are forward compatible with new return items -that future memcached servers may implement (the best current example of -this is the CAS return item). The structures can also be reused, which will -save on calls to malloc(3). It is suggested that you use result objects over -char * return functions. +libmemcached(3) can optionally return a \fI\%memcached_result_st\fP which +acts as a result object. The result objects have added benefits over the +character pointer returns, in that they are forward compatible with new +return items that future memcached servers may implement (the best current +example of this is the CAS return item). The structures can also be reused, +which will save on calls to malloc(3). It is suggested that you use result +objects over char * return functions. .sp -The structure of memcached_result_st has been encapsulated, you should not -write code to directly access members of the structure. +The structure of \fI\%memcached_result_st\fP has been encapsulated, you should +not write code to directly access members of the structure. .sp -memcached_result_create() will either allocate memory for a -memcached_result_st or will initialize a structure passed to it. +\fBmemcached_result_create()\fP will either allocate memory for a +\fI\%memcached_result_st\fP or will initialize a structure passed to it. .sp -memcached_result_free() will deallocate any memory attached to the +\fBmemcached_result_free()\fP will deallocate any memory attached to the structure. If the structure was also allocated, it will deallocate it. .sp -memcached_result_key_value() returns the key value associated with the +\fBmemcached_result_key_value()\fP returns the key value associated with the current result object. .sp -memcached_result_key_length() returns the key length associated with the -current result object. +\fBmemcached_result_key_length()\fP returns the key length associated with +the current result object. .sp -memcached_result_value() returns the result value associated with the +\fBmemcached_result_value()\fP returns the result value associated with the current result object. .sp -memcached_result_length() returns the result length associated with the -current result object. +\fBmemcached_result_length()\fP returns the result length associated with +the current result object. .sp -memcached_result_flags() returns the flags associated with the +\fI\%memcached_result_flags()\fP returns the flags associated with the current result object. .sp -memcached_result_cas() returns the cas associated with the +\fBmemcached_result_cas()\fP returns the cas associated with the current result object. This value will only be available if the server tests it. .sp -memcached_result_set_value() takes a byte array and a size and sets +\fI\%memcached_result_set_value()\fP takes a byte array and a size and sets the result to this value. This function is used for trigger responses. .sp -void memcached_result_set_flags() takes a result structure and stores +\fBvoid memcached_result_set_flags()\fP takes a result structure and stores a new value for the flags field. .sp -void memcached_result_set_expiration(A) takes a result structure and stores -a new value for the expiration field (this is only used by read through -triggers). +\fBvoid memcached_result_set_expiration(A)()\fP takes a result structure and stores a new value for the expiration field (this is only used by read +through triggers). .sp You may wish to avoid using memcached_result_create(3) with a stack based allocation. The most common issues related to ABI safety involve @@ -137,8 +136,8 @@ heap allocated structures. .SH RETURN .sp Varies, see particular functions. All structures must have -memcached_result_free() called on them for cleanup purposes. Failure to -do this will result in leaked memory. +\fBmemcached_result_free()\fP called on them for cleanup purposes. Failure +to do this will result in leaked memory. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_result_length.3 b/docs/man/memcached_result_length.3 index 9d3e4b3b..fffdd35a 100644 --- a/docs/man/memcached_result_length.3 +++ b/docs/man/memcached_result_length.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_RESULT_LENGTH" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_RESULT_LENGTH" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_result_length \- Working with result sets . @@ -85,51 +85,50 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -libmemcached(3) can optionally return a memcached_result_st which acts as a -result object. The result objects have added benefits over the character -pointer returns, in that they are forward compatible with new return items -that future memcached servers may implement (the best current example of -this is the CAS return item). The structures can also be reused, which will -save on calls to malloc(3). It is suggested that you use result objects over -char * return functions. +libmemcached(3) can optionally return a \fI\%memcached_result_st\fP which +acts as a result object. The result objects have added benefits over the +character pointer returns, in that they are forward compatible with new +return items that future memcached servers may implement (the best current +example of this is the CAS return item). The structures can also be reused, +which will save on calls to malloc(3). It is suggested that you use result +objects over char * return functions. .sp -The structure of memcached_result_st has been encapsulated, you should not -write code to directly access members of the structure. +The structure of \fI\%memcached_result_st\fP has been encapsulated, you should +not write code to directly access members of the structure. .sp -memcached_result_create() will either allocate memory for a -memcached_result_st or will initialize a structure passed to it. +\fBmemcached_result_create()\fP will either allocate memory for a +\fI\%memcached_result_st\fP or will initialize a structure passed to it. .sp -memcached_result_free() will deallocate any memory attached to the +\fBmemcached_result_free()\fP will deallocate any memory attached to the structure. If the structure was also allocated, it will deallocate it. .sp -memcached_result_key_value() returns the key value associated with the +\fBmemcached_result_key_value()\fP returns the key value associated with the current result object. .sp -memcached_result_key_length() returns the key length associated with the -current result object. +\fBmemcached_result_key_length()\fP returns the key length associated with +the current result object. .sp -memcached_result_value() returns the result value associated with the +\fBmemcached_result_value()\fP returns the result value associated with the current result object. .sp -memcached_result_length() returns the result length associated with the -current result object. +\fBmemcached_result_length()\fP returns the result length associated with +the current result object. .sp -memcached_result_flags() returns the flags associated with the +\fI\%memcached_result_flags()\fP returns the flags associated with the current result object. .sp -memcached_result_cas() returns the cas associated with the +\fBmemcached_result_cas()\fP returns the cas associated with the current result object. This value will only be available if the server tests it. .sp -memcached_result_set_value() takes a byte array and a size and sets +\fI\%memcached_result_set_value()\fP takes a byte array and a size and sets the result to this value. This function is used for trigger responses. .sp -void memcached_result_set_flags() takes a result structure and stores +\fBvoid memcached_result_set_flags()\fP takes a result structure and stores a new value for the flags field. .sp -void memcached_result_set_expiration(A) takes a result structure and stores -a new value for the expiration field (this is only used by read through -triggers). +\fBvoid memcached_result_set_expiration(A)()\fP takes a result structure and stores a new value for the expiration field (this is only used by read +through triggers). .sp You may wish to avoid using memcached_result_create(3) with a stack based allocation. The most common issues related to ABI safety involve @@ -137,8 +136,8 @@ heap allocated structures. .SH RETURN .sp Varies, see particular functions. All structures must have -memcached_result_free() called on them for cleanup purposes. Failure to -do this will result in leaked memory. +\fBmemcached_result_free()\fP called on them for cleanup purposes. Failure +to do this will result in leaked memory. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_result_st.3 b/docs/man/memcached_result_st.3 index 839c0072..7b170288 100644 --- a/docs/man/memcached_result_st.3 +++ b/docs/man/memcached_result_st.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_RESULT_ST" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_RESULT_ST" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_result_st \- Working with result sets . @@ -85,51 +85,50 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -libmemcached(3) can optionally return a memcached_result_st which acts as a -result object. The result objects have added benefits over the character -pointer returns, in that they are forward compatible with new return items -that future memcached servers may implement (the best current example of -this is the CAS return item). The structures can also be reused, which will -save on calls to malloc(3). It is suggested that you use result objects over -char * return functions. +libmemcached(3) can optionally return a \fI\%memcached_result_st\fP which +acts as a result object. The result objects have added benefits over the +character pointer returns, in that they are forward compatible with new +return items that future memcached servers may implement (the best current +example of this is the CAS return item). The structures can also be reused, +which will save on calls to malloc(3). It is suggested that you use result +objects over char * return functions. .sp -The structure of memcached_result_st has been encapsulated, you should not -write code to directly access members of the structure. +The structure of \fI\%memcached_result_st\fP has been encapsulated, you should +not write code to directly access members of the structure. .sp -memcached_result_create() will either allocate memory for a -memcached_result_st or will initialize a structure passed to it. +\fBmemcached_result_create()\fP will either allocate memory for a +\fI\%memcached_result_st\fP or will initialize a structure passed to it. .sp -memcached_result_free() will deallocate any memory attached to the +\fBmemcached_result_free()\fP will deallocate any memory attached to the structure. If the structure was also allocated, it will deallocate it. .sp -memcached_result_key_value() returns the key value associated with the +\fBmemcached_result_key_value()\fP returns the key value associated with the current result object. .sp -memcached_result_key_length() returns the key length associated with the -current result object. +\fBmemcached_result_key_length()\fP returns the key length associated with +the current result object. .sp -memcached_result_value() returns the result value associated with the +\fBmemcached_result_value()\fP returns the result value associated with the current result object. .sp -memcached_result_length() returns the result length associated with the -current result object. +\fBmemcached_result_length()\fP returns the result length associated with +the current result object. .sp -memcached_result_flags() returns the flags associated with the +\fI\%memcached_result_flags()\fP returns the flags associated with the current result object. .sp -memcached_result_cas() returns the cas associated with the +\fBmemcached_result_cas()\fP returns the cas associated with the current result object. This value will only be available if the server tests it. .sp -memcached_result_set_value() takes a byte array and a size and sets +\fI\%memcached_result_set_value()\fP takes a byte array and a size and sets the result to this value. This function is used for trigger responses. .sp -void memcached_result_set_flags() takes a result structure and stores +\fBvoid memcached_result_set_flags()\fP takes a result structure and stores a new value for the flags field. .sp -void memcached_result_set_expiration(A) takes a result structure and stores -a new value for the expiration field (this is only used by read through -triggers). +\fBvoid memcached_result_set_expiration(A)()\fP takes a result structure and stores a new value for the expiration field (this is only used by read +through triggers). .sp You may wish to avoid using memcached_result_create(3) with a stack based allocation. The most common issues related to ABI safety involve @@ -137,8 +136,8 @@ heap allocated structures. .SH RETURN .sp Varies, see particular functions. All structures must have -memcached_result_free() called on them for cleanup purposes. Failure to -do this will result in leaked memory. +\fBmemcached_result_free()\fP called on them for cleanup purposes. Failure +to do this will result in leaked memory. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_result_value.3 b/docs/man/memcached_result_value.3 index 25a6d2d1..af2aaf78 100644 --- a/docs/man/memcached_result_value.3 +++ b/docs/man/memcached_result_value.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_RESULT_VALUE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_RESULT_VALUE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_result_value \- Working with result sets . @@ -85,51 +85,50 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -libmemcached(3) can optionally return a memcached_result_st which acts as a -result object. The result objects have added benefits over the character -pointer returns, in that they are forward compatible with new return items -that future memcached servers may implement (the best current example of -this is the CAS return item). The structures can also be reused, which will -save on calls to malloc(3). It is suggested that you use result objects over -char * return functions. +libmemcached(3) can optionally return a \fI\%memcached_result_st\fP which +acts as a result object. The result objects have added benefits over the +character pointer returns, in that they are forward compatible with new +return items that future memcached servers may implement (the best current +example of this is the CAS return item). The structures can also be reused, +which will save on calls to malloc(3). It is suggested that you use result +objects over char * return functions. .sp -The structure of memcached_result_st has been encapsulated, you should not -write code to directly access members of the structure. +The structure of \fI\%memcached_result_st\fP has been encapsulated, you should +not write code to directly access members of the structure. .sp -memcached_result_create() will either allocate memory for a -memcached_result_st or will initialize a structure passed to it. +\fBmemcached_result_create()\fP will either allocate memory for a +\fI\%memcached_result_st\fP or will initialize a structure passed to it. .sp -memcached_result_free() will deallocate any memory attached to the +\fBmemcached_result_free()\fP will deallocate any memory attached to the structure. If the structure was also allocated, it will deallocate it. .sp -memcached_result_key_value() returns the key value associated with the +\fBmemcached_result_key_value()\fP returns the key value associated with the current result object. .sp -memcached_result_key_length() returns the key length associated with the -current result object. +\fBmemcached_result_key_length()\fP returns the key length associated with +the current result object. .sp -memcached_result_value() returns the result value associated with the +\fBmemcached_result_value()\fP returns the result value associated with the current result object. .sp -memcached_result_length() returns the result length associated with the -current result object. +\fBmemcached_result_length()\fP returns the result length associated with +the current result object. .sp -memcached_result_flags() returns the flags associated with the +\fI\%memcached_result_flags()\fP returns the flags associated with the current result object. .sp -memcached_result_cas() returns the cas associated with the +\fBmemcached_result_cas()\fP returns the cas associated with the current result object. This value will only be available if the server tests it. .sp -memcached_result_set_value() takes a byte array and a size and sets +\fI\%memcached_result_set_value()\fP takes a byte array and a size and sets the result to this value. This function is used for trigger responses. .sp -void memcached_result_set_flags() takes a result structure and stores +\fBvoid memcached_result_set_flags()\fP takes a result structure and stores a new value for the flags field. .sp -void memcached_result_set_expiration(A) takes a result structure and stores -a new value for the expiration field (this is only used by read through -triggers). +\fBvoid memcached_result_set_expiration(A)()\fP takes a result structure and stores a new value for the expiration field (this is only used by read +through triggers). .sp You may wish to avoid using memcached_result_create(3) with a stack based allocation. The most common issues related to ABI safety involve @@ -137,8 +136,8 @@ heap allocated structures. .SH RETURN .sp Varies, see particular functions. All structures must have -memcached_result_free() called on them for cleanup purposes. Failure to -do this will result in leaked memory. +\fBmemcached_result_free()\fP called on them for cleanup purposes. Failure +to do this will result in leaked memory. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_sasl.3 b/docs/man/memcached_sasl.3 index 78c3d677..27a66c0d 100644 --- a/docs/man/memcached_sasl.3 +++ b/docs/man/memcached_sasl.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SASL" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SASL" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_sasl \- libmemcached Documentation . @@ -59,21 +59,20 @@ libsasl to perform SASL authentication. Please note that SASL requires the memcached binary protocol, and you have to specify the callbacks before you connect to the server. .sp -memcached_set_sasl_auth_data() is a helper function defining +\fI\%memcached_set_sasl_auth_data()\fP is a helper function defining the basic functionality for you, but it will store the username and password in memory. If you choose to use this method you have to call -memcached_destroy_sasl_auth_data before calling memcached_free to avoid -a memory leak. You should NOT call memcached_destroy_sasl_auth_data if you -specify your own callback function with memcached_set_sasl_callbacks(). +\fI\%memcached_destroy_sasl_auth_data\fP before calling +\fBmemcached_free\fP to avoid a memory leak. You should NOT call +\fI\%memcached_destroy_sasl_auth_data\fP if you specify your own callback +function with \fI\%memcached_set_sasl_callbacks()\fP. .sp -You as a client user have to initialize libsasl by using sasl_client_init -before enabling it in libmemcached, and you have to shut down libsasl by -calling sasl_done() when you are done using SASL from libmemcached. +You as a client user have to initialize libsasl by using \fBsasl_client_init\fP before enabling it in libmemcached, and you have to shut down libsasl by +calling \fBsasl_done()\fP when you are done using SASL from libmemcached. .SH RETURN .sp -memcached_get_sasl_callbacks() returns the callbacks currently used -by this memcached handle. -memcached_get_sasl_set_auth_data() returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_get_sasl_callbacks()\fP returns the callbacks currently used +by this memcached handle. \fBmemcached_get_sasl_set_auth_data()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_sasl_set_auth_data.3 b/docs/man/memcached_sasl_set_auth_data.3 index 79cff931..a64e20d6 100644 --- a/docs/man/memcached_sasl_set_auth_data.3 +++ b/docs/man/memcached_sasl_set_auth_data.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SASL_SET_AUTH_DATA" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SASL_SET_AUTH_DATA" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_sasl_set_auth_data \- libmemcached Documentation . @@ -59,21 +59,20 @@ libsasl to perform SASL authentication. Please note that SASL requires the memcached binary protocol, and you have to specify the callbacks before you connect to the server. .sp -memcached_set_sasl_auth_data() is a helper function defining +\fI\%memcached_set_sasl_auth_data()\fP is a helper function defining the basic functionality for you, but it will store the username and password in memory. If you choose to use this method you have to call -memcached_destroy_sasl_auth_data before calling memcached_free to avoid -a memory leak. You should NOT call memcached_destroy_sasl_auth_data if you -specify your own callback function with memcached_set_sasl_callbacks(). +\fI\%memcached_destroy_sasl_auth_data\fP before calling +\fBmemcached_free\fP to avoid a memory leak. You should NOT call +\fI\%memcached_destroy_sasl_auth_data\fP if you specify your own callback +function with \fI\%memcached_set_sasl_callbacks()\fP. .sp -You as a client user have to initialize libsasl by using sasl_client_init -before enabling it in libmemcached, and you have to shut down libsasl by -calling sasl_done() when you are done using SASL from libmemcached. +You as a client user have to initialize libsasl by using \fBsasl_client_init\fP before enabling it in libmemcached, and you have to shut down libsasl by +calling \fBsasl_done()\fP when you are done using SASL from libmemcached. .SH RETURN .sp -memcached_get_sasl_callbacks() returns the callbacks currently used -by this memcached handle. -memcached_get_sasl_set_auth_data() returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_get_sasl_callbacks()\fP returns the callbacks currently used +by this memcached handle. \fBmemcached_get_sasl_set_auth_data()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_server_add.3 b/docs/man/memcached_server_add.3 index f70b1139..6d50adf0 100644 --- a/docs/man/memcached_server_add.3 +++ b/docs/man/memcached_server_add.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVER_ADD" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SERVER_ADD" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_server_add \- libmemcached Documentation . @@ -76,52 +76,46 @@ compile and link with \-lmemcached \fBlibmemcached\fP performs operations on a list of hosts. The order of these hosts determine routing to keys. Functions are provided to add keys to memcached_st structures. To manipulate lists of servers see -\fBmemcached_server_st()\fP. +memcached_server_st(3). .sp -\fI\%memcached_server_count()\fP provides you a count of the current -number of servers being used by a \fBmemcached_st\fP structure. +\fI\%memcached_server_count()\fP provides you a count of the current number of +servers being used by a \fBmemcached_st\fP structure. +.INDENT 0.0 +.TP +.B \fI\%memcached_server_add()\fP pushes a single TCP server into the \fBmemcached_st\fP structure. This server will be placed at the end. Duplicate servers .sp -\fI\%memcached_server_add()\fP pushes a single TCP server into the -\fBmemcached_st\fP structure. This server will be placed at the end. -Duplicate servers are allowed, so duplication is not checked. Executing this -function with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set will -result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +are allowed, so duplication is not checked. Executing this function with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +.UNINDENT .sp -\fI\%memcached_server_add_udp()\fP pushes a single UDP server into the -\fBmemcached_st\fP structure. This server will be placed at the end. -Duplicate servers are allowed, so duplication is not checked. Executing this -function with out setting the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior -will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +\fI\%memcached_server_add_udp()\fP pushes a single UDP server into the \fBmemcached_st\fP structure. This server will be placed at the end. Duplicate +servers are allowed, so duplication is not checked. Executing this function with out setting the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior will result in a +\fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. .sp -\fI\%memcached_server_add_unix_socket()\fP pushes a single UNIX socket -into the \fBmemcached_st\fP structure. This UNIX socket will be placed -at the end. Duplicate servers are allowed, so duplication is not checked. -The length of the filename must be one character less then -\fBMEMCACHED_MAX_HOST_LENGTH\fP. +\fI\%memcached_server_add_unix_socket()\fP pushes a single UNIX socket into the \fBmemcached_st\fP structure. This UNIX socket will be placed at the end. +Duplicate servers are allowed, so duplication is not checked. The length +of the filename must be one character less than \fBMEMCACHED_MAX_HOST_LENGTH\fP. .sp -\fI\%memcached_server_push()\fP pushes an array of -\fBmemcached_server_st\fP into the \fBmemcached_st\fP structure. -These servers will be placed at the end. Duplicate servers are allowed, so -duplication is not checked. A copy is made of structure so the list provided -(and any operations on the list) are not saved. +\fI\%memcached_server_push()\fP pushes an array of \fBmemcached_server_st\fP into the \fBmemcached_st\fP structure. These servers will be placed at +the end. Duplicate servers are allowed, so duplication is not checked. A +copy is made of structure so the list provided (and any operations on +the list) are not saved. .sp -\fI\%memcached_server_by_key()\fP allows you to provide a key and retrieve -the server which would be used for assignment. This structure is cloned from -its original structure and must be freed. If NULL is returned you should -consult *error. The returning structure should be freed with +\fI\%memcached_server_by_key()\fP allows you to provide a key and retrieve the +server which would be used for assignment. This structure is cloned +from its original structure and must be freed. If NULL is returned you +should consult *error. The returning structure should be freed with \fBmemcached_server_free()\fP. .sp -\fI\%memcached_server_get_last_disconnect()\fP returns a pointer to the -last server for which there was a connection problem. It does not mean this +\fI\%memcached_server_get_last_disconnect()\fP returns a pointer to the last +server for which there was a connection problem. It does not mean this particular server is currently dead but if the library is reporting a server is, the returned server is a very good candidate. .sp -\fI\%memcached_server_cursor()\fP takes a memcached_st and loops through -the list of hosts currently in the cursor calling the list of callback -functions provided. You can optionally pass in a value via context which -will be provided to each callback function. An error return from any -callback will terminate the loop. \fI\%memcached_server_cursor()\fP is -passed the original caller memcached_st in its current state. +\fI\%memcached_server_cursor()\fP takes a memcached_st and loops through the +list of hosts currently in the cursor calling the list of callback +functions provided. You can optionally pass in a value via +context which will be provided to each callback function. An error +return from any callback will terminate the loop. \fI\%memcached_server_cursor()\fP is passed the original caller \fBmemcached_st\fP in its current state. .SH RETURN .sp Varies, see particular functions. diff --git a/docs/man/memcached_server_add_unix_socket.3 b/docs/man/memcached_server_add_unix_socket.3 index 4d737b62..fc903b18 100644 --- a/docs/man/memcached_server_add_unix_socket.3 +++ b/docs/man/memcached_server_add_unix_socket.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVER_ADD_UNIX_SOCKET" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SERVER_ADD_UNIX_SOCKET" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_server_add_unix_socket \- libmemcached Documentation . @@ -76,52 +76,46 @@ compile and link with \-lmemcached \fBlibmemcached\fP performs operations on a list of hosts. The order of these hosts determine routing to keys. Functions are provided to add keys to memcached_st structures. To manipulate lists of servers see -\fBmemcached_server_st()\fP. +memcached_server_st(3). .sp -\fI\%memcached_server_count()\fP provides you a count of the current -number of servers being used by a \fBmemcached_st\fP structure. +\fI\%memcached_server_count()\fP provides you a count of the current number of +servers being used by a \fBmemcached_st\fP structure. +.INDENT 0.0 +.TP +.B \fI\%memcached_server_add()\fP pushes a single TCP server into the \fBmemcached_st\fP structure. This server will be placed at the end. Duplicate servers .sp -\fI\%memcached_server_add()\fP pushes a single TCP server into the -\fBmemcached_st\fP structure. This server will be placed at the end. -Duplicate servers are allowed, so duplication is not checked. Executing this -function with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set will -result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +are allowed, so duplication is not checked. Executing this function with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +.UNINDENT .sp -\fI\%memcached_server_add_udp()\fP pushes a single UDP server into the -\fBmemcached_st\fP structure. This server will be placed at the end. -Duplicate servers are allowed, so duplication is not checked. Executing this -function with out setting the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior -will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +\fI\%memcached_server_add_udp()\fP pushes a single UDP server into the \fBmemcached_st\fP structure. This server will be placed at the end. Duplicate +servers are allowed, so duplication is not checked. Executing this function with out setting the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior will result in a +\fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. .sp -\fI\%memcached_server_add_unix_socket()\fP pushes a single UNIX socket -into the \fBmemcached_st\fP structure. This UNIX socket will be placed -at the end. Duplicate servers are allowed, so duplication is not checked. -The length of the filename must be one character less then -\fBMEMCACHED_MAX_HOST_LENGTH\fP. +\fI\%memcached_server_add_unix_socket()\fP pushes a single UNIX socket into the \fBmemcached_st\fP structure. This UNIX socket will be placed at the end. +Duplicate servers are allowed, so duplication is not checked. The length +of the filename must be one character less than \fBMEMCACHED_MAX_HOST_LENGTH\fP. .sp -\fI\%memcached_server_push()\fP pushes an array of -\fBmemcached_server_st\fP into the \fBmemcached_st\fP structure. -These servers will be placed at the end. Duplicate servers are allowed, so -duplication is not checked. A copy is made of structure so the list provided -(and any operations on the list) are not saved. +\fI\%memcached_server_push()\fP pushes an array of \fBmemcached_server_st\fP into the \fBmemcached_st\fP structure. These servers will be placed at +the end. Duplicate servers are allowed, so duplication is not checked. A +copy is made of structure so the list provided (and any operations on +the list) are not saved. .sp -\fI\%memcached_server_by_key()\fP allows you to provide a key and retrieve -the server which would be used for assignment. This structure is cloned from -its original structure and must be freed. If NULL is returned you should -consult *error. The returning structure should be freed with +\fI\%memcached_server_by_key()\fP allows you to provide a key and retrieve the +server which would be used for assignment. This structure is cloned +from its original structure and must be freed. If NULL is returned you +should consult *error. The returning structure should be freed with \fBmemcached_server_free()\fP. .sp -\fI\%memcached_server_get_last_disconnect()\fP returns a pointer to the -last server for which there was a connection problem. It does not mean this +\fI\%memcached_server_get_last_disconnect()\fP returns a pointer to the last +server for which there was a connection problem. It does not mean this particular server is currently dead but if the library is reporting a server is, the returned server is a very good candidate. .sp -\fI\%memcached_server_cursor()\fP takes a memcached_st and loops through -the list of hosts currently in the cursor calling the list of callback -functions provided. You can optionally pass in a value via context which -will be provided to each callback function. An error return from any -callback will terminate the loop. \fI\%memcached_server_cursor()\fP is -passed the original caller memcached_st in its current state. +\fI\%memcached_server_cursor()\fP takes a memcached_st and loops through the +list of hosts currently in the cursor calling the list of callback +functions provided. You can optionally pass in a value via +context which will be provided to each callback function. An error +return from any callback will terminate the loop. \fI\%memcached_server_cursor()\fP is passed the original caller \fBmemcached_st\fP in its current state. .SH RETURN .sp Varies, see particular functions. diff --git a/docs/man/memcached_server_count.3 b/docs/man/memcached_server_count.3 index 8c58e573..f3c35c72 100644 --- a/docs/man/memcached_server_count.3 +++ b/docs/man/memcached_server_count.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVER_COUNT" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SERVER_COUNT" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_server_count \- libmemcached Documentation . @@ -76,52 +76,46 @@ compile and link with \-lmemcached \fBlibmemcached\fP performs operations on a list of hosts. The order of these hosts determine routing to keys. Functions are provided to add keys to memcached_st structures. To manipulate lists of servers see -\fBmemcached_server_st()\fP. +memcached_server_st(3). .sp -\fI\%memcached_server_count()\fP provides you a count of the current -number of servers being used by a \fBmemcached_st\fP structure. +\fI\%memcached_server_count()\fP provides you a count of the current number of +servers being used by a \fBmemcached_st\fP structure. +.INDENT 0.0 +.TP +.B \fI\%memcached_server_add()\fP pushes a single TCP server into the \fBmemcached_st\fP structure. This server will be placed at the end. Duplicate servers .sp -\fI\%memcached_server_add()\fP pushes a single TCP server into the -\fBmemcached_st\fP structure. This server will be placed at the end. -Duplicate servers are allowed, so duplication is not checked. Executing this -function with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set will -result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +are allowed, so duplication is not checked. Executing this function with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +.UNINDENT .sp -\fI\%memcached_server_add_udp()\fP pushes a single UDP server into the -\fBmemcached_st\fP structure. This server will be placed at the end. -Duplicate servers are allowed, so duplication is not checked. Executing this -function with out setting the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior -will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +\fI\%memcached_server_add_udp()\fP pushes a single UDP server into the \fBmemcached_st\fP structure. This server will be placed at the end. Duplicate +servers are allowed, so duplication is not checked. Executing this function with out setting the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior will result in a +\fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. .sp -\fI\%memcached_server_add_unix_socket()\fP pushes a single UNIX socket -into the \fBmemcached_st\fP structure. This UNIX socket will be placed -at the end. Duplicate servers are allowed, so duplication is not checked. -The length of the filename must be one character less then -\fBMEMCACHED_MAX_HOST_LENGTH\fP. +\fI\%memcached_server_add_unix_socket()\fP pushes a single UNIX socket into the \fBmemcached_st\fP structure. This UNIX socket will be placed at the end. +Duplicate servers are allowed, so duplication is not checked. The length +of the filename must be one character less than \fBMEMCACHED_MAX_HOST_LENGTH\fP. .sp -\fI\%memcached_server_push()\fP pushes an array of -\fBmemcached_server_st\fP into the \fBmemcached_st\fP structure. -These servers will be placed at the end. Duplicate servers are allowed, so -duplication is not checked. A copy is made of structure so the list provided -(and any operations on the list) are not saved. +\fI\%memcached_server_push()\fP pushes an array of \fBmemcached_server_st\fP into the \fBmemcached_st\fP structure. These servers will be placed at +the end. Duplicate servers are allowed, so duplication is not checked. A +copy is made of structure so the list provided (and any operations on +the list) are not saved. .sp -\fI\%memcached_server_by_key()\fP allows you to provide a key and retrieve -the server which would be used for assignment. This structure is cloned from -its original structure and must be freed. If NULL is returned you should -consult *error. The returning structure should be freed with +\fI\%memcached_server_by_key()\fP allows you to provide a key and retrieve the +server which would be used for assignment. This structure is cloned +from its original structure and must be freed. If NULL is returned you +should consult *error. The returning structure should be freed with \fBmemcached_server_free()\fP. .sp -\fI\%memcached_server_get_last_disconnect()\fP returns a pointer to the -last server for which there was a connection problem. It does not mean this +\fI\%memcached_server_get_last_disconnect()\fP returns a pointer to the last +server for which there was a connection problem. It does not mean this particular server is currently dead but if the library is reporting a server is, the returned server is a very good candidate. .sp -\fI\%memcached_server_cursor()\fP takes a memcached_st and loops through -the list of hosts currently in the cursor calling the list of callback -functions provided. You can optionally pass in a value via context which -will be provided to each callback function. An error return from any -callback will terminate the loop. \fI\%memcached_server_cursor()\fP is -passed the original caller memcached_st in its current state. +\fI\%memcached_server_cursor()\fP takes a memcached_st and loops through the +list of hosts currently in the cursor calling the list of callback +functions provided. You can optionally pass in a value via +context which will be provided to each callback function. An error +return from any callback will terminate the loop. \fI\%memcached_server_cursor()\fP is passed the original caller \fBmemcached_st\fP in its current state. .SH RETURN .sp Varies, see particular functions. diff --git a/docs/man/memcached_server_cursor.3 b/docs/man/memcached_server_cursor.3 index 2a94f149..db2d118e 100644 --- a/docs/man/memcached_server_cursor.3 +++ b/docs/man/memcached_server_cursor.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVER_CURSOR" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SERVER_CURSOR" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_server_cursor \- libmemcached Documentation . @@ -76,52 +76,46 @@ compile and link with \-lmemcached \fBlibmemcached\fP performs operations on a list of hosts. The order of these hosts determine routing to keys. Functions are provided to add keys to memcached_st structures. To manipulate lists of servers see -\fBmemcached_server_st()\fP. +memcached_server_st(3). .sp -\fI\%memcached_server_count()\fP provides you a count of the current -number of servers being used by a \fBmemcached_st\fP structure. +\fI\%memcached_server_count()\fP provides you a count of the current number of +servers being used by a \fBmemcached_st\fP structure. +.INDENT 0.0 +.TP +.B \fI\%memcached_server_add()\fP pushes a single TCP server into the \fBmemcached_st\fP structure. This server will be placed at the end. Duplicate servers .sp -\fI\%memcached_server_add()\fP pushes a single TCP server into the -\fBmemcached_st\fP structure. This server will be placed at the end. -Duplicate servers are allowed, so duplication is not checked. Executing this -function with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set will -result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +are allowed, so duplication is not checked. Executing this function with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +.UNINDENT .sp -\fI\%memcached_server_add_udp()\fP pushes a single UDP server into the -\fBmemcached_st\fP structure. This server will be placed at the end. -Duplicate servers are allowed, so duplication is not checked. Executing this -function with out setting the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior -will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +\fI\%memcached_server_add_udp()\fP pushes a single UDP server into the \fBmemcached_st\fP structure. This server will be placed at the end. Duplicate +servers are allowed, so duplication is not checked. Executing this function with out setting the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior will result in a +\fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. .sp -\fI\%memcached_server_add_unix_socket()\fP pushes a single UNIX socket -into the \fBmemcached_st\fP structure. This UNIX socket will be placed -at the end. Duplicate servers are allowed, so duplication is not checked. -The length of the filename must be one character less then -\fBMEMCACHED_MAX_HOST_LENGTH\fP. +\fI\%memcached_server_add_unix_socket()\fP pushes a single UNIX socket into the \fBmemcached_st\fP structure. This UNIX socket will be placed at the end. +Duplicate servers are allowed, so duplication is not checked. The length +of the filename must be one character less than \fBMEMCACHED_MAX_HOST_LENGTH\fP. .sp -\fI\%memcached_server_push()\fP pushes an array of -\fBmemcached_server_st\fP into the \fBmemcached_st\fP structure. -These servers will be placed at the end. Duplicate servers are allowed, so -duplication is not checked. A copy is made of structure so the list provided -(and any operations on the list) are not saved. +\fI\%memcached_server_push()\fP pushes an array of \fBmemcached_server_st\fP into the \fBmemcached_st\fP structure. These servers will be placed at +the end. Duplicate servers are allowed, so duplication is not checked. A +copy is made of structure so the list provided (and any operations on +the list) are not saved. .sp -\fI\%memcached_server_by_key()\fP allows you to provide a key and retrieve -the server which would be used for assignment. This structure is cloned from -its original structure and must be freed. If NULL is returned you should -consult *error. The returning structure should be freed with +\fI\%memcached_server_by_key()\fP allows you to provide a key and retrieve the +server which would be used for assignment. This structure is cloned +from its original structure and must be freed. If NULL is returned you +should consult *error. The returning structure should be freed with \fBmemcached_server_free()\fP. .sp -\fI\%memcached_server_get_last_disconnect()\fP returns a pointer to the -last server for which there was a connection problem. It does not mean this +\fI\%memcached_server_get_last_disconnect()\fP returns a pointer to the last +server for which there was a connection problem. It does not mean this particular server is currently dead but if the library is reporting a server is, the returned server is a very good candidate. .sp -\fI\%memcached_server_cursor()\fP takes a memcached_st and loops through -the list of hosts currently in the cursor calling the list of callback -functions provided. You can optionally pass in a value via context which -will be provided to each callback function. An error return from any -callback will terminate the loop. \fI\%memcached_server_cursor()\fP is -passed the original caller memcached_st in its current state. +\fI\%memcached_server_cursor()\fP takes a memcached_st and loops through the +list of hosts currently in the cursor calling the list of callback +functions provided. You can optionally pass in a value via +context which will be provided to each callback function. An error +return from any callback will terminate the loop. \fI\%memcached_server_cursor()\fP is passed the original caller \fBmemcached_st\fP in its current state. .SH RETURN .sp Varies, see particular functions. diff --git a/docs/man/memcached_server_list.3 b/docs/man/memcached_server_list.3 index ae292003..dc52b8f7 100644 --- a/docs/man/memcached_server_list.3 +++ b/docs/man/memcached_server_list.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVER_LIST" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SERVER_LIST" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_server_list \- libmemcached Documentation . @@ -76,52 +76,46 @@ compile and link with \-lmemcached \fBlibmemcached\fP performs operations on a list of hosts. The order of these hosts determine routing to keys. Functions are provided to add keys to memcached_st structures. To manipulate lists of servers see -\fBmemcached_server_st()\fP. +memcached_server_st(3). .sp -\fI\%memcached_server_count()\fP provides you a count of the current -number of servers being used by a \fBmemcached_st\fP structure. +\fI\%memcached_server_count()\fP provides you a count of the current number of +servers being used by a \fBmemcached_st\fP structure. +.INDENT 0.0 +.TP +.B \fI\%memcached_server_add()\fP pushes a single TCP server into the \fBmemcached_st\fP structure. This server will be placed at the end. Duplicate servers .sp -\fI\%memcached_server_add()\fP pushes a single TCP server into the -\fBmemcached_st\fP structure. This server will be placed at the end. -Duplicate servers are allowed, so duplication is not checked. Executing this -function with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set will -result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +are allowed, so duplication is not checked. Executing this function with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +.UNINDENT .sp -\fI\%memcached_server_add_udp()\fP pushes a single UDP server into the -\fBmemcached_st\fP structure. This server will be placed at the end. -Duplicate servers are allowed, so duplication is not checked. Executing this -function with out setting the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior -will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +\fI\%memcached_server_add_udp()\fP pushes a single UDP server into the \fBmemcached_st\fP structure. This server will be placed at the end. Duplicate +servers are allowed, so duplication is not checked. Executing this function with out setting the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior will result in a +\fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. .sp -\fI\%memcached_server_add_unix_socket()\fP pushes a single UNIX socket -into the \fBmemcached_st\fP structure. This UNIX socket will be placed -at the end. Duplicate servers are allowed, so duplication is not checked. -The length of the filename must be one character less then -\fBMEMCACHED_MAX_HOST_LENGTH\fP. +\fI\%memcached_server_add_unix_socket()\fP pushes a single UNIX socket into the \fBmemcached_st\fP structure. This UNIX socket will be placed at the end. +Duplicate servers are allowed, so duplication is not checked. The length +of the filename must be one character less than \fBMEMCACHED_MAX_HOST_LENGTH\fP. .sp -\fI\%memcached_server_push()\fP pushes an array of -\fBmemcached_server_st\fP into the \fBmemcached_st\fP structure. -These servers will be placed at the end. Duplicate servers are allowed, so -duplication is not checked. A copy is made of structure so the list provided -(and any operations on the list) are not saved. +\fI\%memcached_server_push()\fP pushes an array of \fBmemcached_server_st\fP into the \fBmemcached_st\fP structure. These servers will be placed at +the end. Duplicate servers are allowed, so duplication is not checked. A +copy is made of structure so the list provided (and any operations on +the list) are not saved. .sp -\fI\%memcached_server_by_key()\fP allows you to provide a key and retrieve -the server which would be used for assignment. This structure is cloned from -its original structure and must be freed. If NULL is returned you should -consult *error. The returning structure should be freed with +\fI\%memcached_server_by_key()\fP allows you to provide a key and retrieve the +server which would be used for assignment. This structure is cloned +from its original structure and must be freed. If NULL is returned you +should consult *error. The returning structure should be freed with \fBmemcached_server_free()\fP. .sp -\fI\%memcached_server_get_last_disconnect()\fP returns a pointer to the -last server for which there was a connection problem. It does not mean this +\fI\%memcached_server_get_last_disconnect()\fP returns a pointer to the last +server for which there was a connection problem. It does not mean this particular server is currently dead but if the library is reporting a server is, the returned server is a very good candidate. .sp -\fI\%memcached_server_cursor()\fP takes a memcached_st and loops through -the list of hosts currently in the cursor calling the list of callback -functions provided. You can optionally pass in a value via context which -will be provided to each callback function. An error return from any -callback will terminate the loop. \fI\%memcached_server_cursor()\fP is -passed the original caller memcached_st in its current state. +\fI\%memcached_server_cursor()\fP takes a memcached_st and loops through the +list of hosts currently in the cursor calling the list of callback +functions provided. You can optionally pass in a value via +context which will be provided to each callback function. An error +return from any callback will terminate the loop. \fI\%memcached_server_cursor()\fP is passed the original caller \fBmemcached_st\fP in its current state. .SH RETURN .sp Varies, see particular functions. diff --git a/docs/man/memcached_server_list_append.3 b/docs/man/memcached_server_list_append.3 index 516c1077..87b80287 100644 --- a/docs/man/memcached_server_list_append.3 +++ b/docs/man/memcached_server_list_append.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVER_LIST_APPEND" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SERVER_LIST_APPEND" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_server_list_append \- libmemcached Documentation . @@ -68,30 +68,25 @@ Compile and link with \-lmemcached .SH DESCRIPTION .sp libmemcached(3) operates on a list of hosts which are stored in -memcached_server_st structures. You should not modify these structures +\fBmemcached_server_st\fP structures. You should not modify these structures directly. Functions are provided to modify these structures (and more can be added, just ask!). .sp -\fI\%memcached_server_list()\fP is used to provide an array of all defined hosts. -This was incorrectly documented as "requiring free()" up till version 0.39. +\fI\%memcached_server_list()\fP is used to provide an array of all defined hosts. This was incorrectly documented as "requiring free()" up till version 0.39. .sp -\fI\%memcached_server_list_free()\fP deallocates all memory associated with the array -of memcached_server_st that you passed to it. +\fI\%memcached_server_list_free()\fP deallocates all memory associated with the array of \fBmemcached_server_st\fP that you passed to it. .sp \fI\%memcached_server_list_append()\fP adds a server to the end of a -memcached_server_st array. On error null will be returned and the -memcached_return_t pointer you passed into the function will be set with the -appropriate error. If the value of port is zero, it is set to the default +\fBmemcached_server_st\fP array. On error null will be returned and the +\fBmemcached_return_t\fP pointer you passed into the function will be set with the appropriate error. If the value of port is zero, it is set to the default port of a memcached server. .sp DEPRECATED \fBmemcached_servers_parse()\fP, please see \fBmemcached()\fP .sp -\fI\%memcached_server_error()\fP can be used to look at the text of the last error -message sent by the server to to the client. +\fI\%memcached_server_error()\fP can be used to look at the text of the last error message sent by the server to to the client. .sp -Before version 0.39 these functions used a memcache_server_st *. In 0.39 -memcached_server_st * was aliased to \fBmemcached_server_list_st\fP. This was -done for a style reason/to help clean up some concepts in the code. +Before version 0.39 theses functions used a memcache_server_st *. In 0.39 +memcached_server_st * was aliased to \fBmemcached_server_list_st\fP. This was done for a style reason to help clean up some concepts in the code. .SH RETURN .sp Varies, see particular functions. diff --git a/docs/man/memcached_server_list_count.3 b/docs/man/memcached_server_list_count.3 index df695b11..bf0514ac 100644 --- a/docs/man/memcached_server_list_count.3 +++ b/docs/man/memcached_server_list_count.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVER_LIST_COUNT" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SERVER_LIST_COUNT" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_server_list_count \- libmemcached Documentation . @@ -68,30 +68,25 @@ Compile and link with \-lmemcached .SH DESCRIPTION .sp libmemcached(3) operates on a list of hosts which are stored in -memcached_server_st structures. You should not modify these structures +\fBmemcached_server_st\fP structures. You should not modify these structures directly. Functions are provided to modify these structures (and more can be added, just ask!). .sp -\fI\%memcached_server_list()\fP is used to provide an array of all defined hosts. -This was incorrectly documented as "requiring free()" up till version 0.39. +\fI\%memcached_server_list()\fP is used to provide an array of all defined hosts. This was incorrectly documented as "requiring free()" up till version 0.39. .sp -\fI\%memcached_server_list_free()\fP deallocates all memory associated with the array -of memcached_server_st that you passed to it. +\fI\%memcached_server_list_free()\fP deallocates all memory associated with the array of \fBmemcached_server_st\fP that you passed to it. .sp \fI\%memcached_server_list_append()\fP adds a server to the end of a -memcached_server_st array. On error null will be returned and the -memcached_return_t pointer you passed into the function will be set with the -appropriate error. If the value of port is zero, it is set to the default +\fBmemcached_server_st\fP array. On error null will be returned and the +\fBmemcached_return_t\fP pointer you passed into the function will be set with the appropriate error. If the value of port is zero, it is set to the default port of a memcached server. .sp DEPRECATED \fBmemcached_servers_parse()\fP, please see \fBmemcached()\fP .sp -\fI\%memcached_server_error()\fP can be used to look at the text of the last error -message sent by the server to to the client. +\fI\%memcached_server_error()\fP can be used to look at the text of the last error message sent by the server to to the client. .sp -Before version 0.39 these functions used a memcache_server_st *. In 0.39 -memcached_server_st * was aliased to \fBmemcached_server_list_st\fP. This was -done for a style reason/to help clean up some concepts in the code. +Before version 0.39 theses functions used a memcache_server_st *. In 0.39 +memcached_server_st * was aliased to \fBmemcached_server_list_st\fP. This was done for a style reason to help clean up some concepts in the code. .SH RETURN .sp Varies, see particular functions. diff --git a/docs/man/memcached_server_list_free.3 b/docs/man/memcached_server_list_free.3 index 00e026cb..5f950d3a 100644 --- a/docs/man/memcached_server_list_free.3 +++ b/docs/man/memcached_server_list_free.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVER_LIST_FREE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SERVER_LIST_FREE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_server_list_free \- libmemcached Documentation . @@ -68,30 +68,25 @@ Compile and link with \-lmemcached .SH DESCRIPTION .sp libmemcached(3) operates on a list of hosts which are stored in -memcached_server_st structures. You should not modify these structures +\fBmemcached_server_st\fP structures. You should not modify these structures directly. Functions are provided to modify these structures (and more can be added, just ask!). .sp -\fI\%memcached_server_list()\fP is used to provide an array of all defined hosts. -This was incorrectly documented as "requiring free()" up till version 0.39. +\fI\%memcached_server_list()\fP is used to provide an array of all defined hosts. This was incorrectly documented as "requiring free()" up till version 0.39. .sp -\fI\%memcached_server_list_free()\fP deallocates all memory associated with the array -of memcached_server_st that you passed to it. +\fI\%memcached_server_list_free()\fP deallocates all memory associated with the array of \fBmemcached_server_st\fP that you passed to it. .sp \fI\%memcached_server_list_append()\fP adds a server to the end of a -memcached_server_st array. On error null will be returned and the -memcached_return_t pointer you passed into the function will be set with the -appropriate error. If the value of port is zero, it is set to the default +\fBmemcached_server_st\fP array. On error null will be returned and the +\fBmemcached_return_t\fP pointer you passed into the function will be set with the appropriate error. If the value of port is zero, it is set to the default port of a memcached server. .sp DEPRECATED \fBmemcached_servers_parse()\fP, please see \fBmemcached()\fP .sp -\fI\%memcached_server_error()\fP can be used to look at the text of the last error -message sent by the server to to the client. +\fI\%memcached_server_error()\fP can be used to look at the text of the last error message sent by the server to to the client. .sp -Before version 0.39 these functions used a memcache_server_st *. In 0.39 -memcached_server_st * was aliased to \fBmemcached_server_list_st\fP. This was -done for a style reason/to help clean up some concepts in the code. +Before version 0.39 theses functions used a memcache_server_st *. In 0.39 +memcached_server_st * was aliased to \fBmemcached_server_list_st\fP. This was done for a style reason to help clean up some concepts in the code. .SH RETURN .sp Varies, see particular functions. diff --git a/docs/man/memcached_server_push.3 b/docs/man/memcached_server_push.3 index 8c581355..731eed6f 100644 --- a/docs/man/memcached_server_push.3 +++ b/docs/man/memcached_server_push.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVER_PUSH" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SERVER_PUSH" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_server_push \- libmemcached Documentation . @@ -76,52 +76,46 @@ compile and link with \-lmemcached \fBlibmemcached\fP performs operations on a list of hosts. The order of these hosts determine routing to keys. Functions are provided to add keys to memcached_st structures. To manipulate lists of servers see -\fBmemcached_server_st()\fP. +memcached_server_st(3). .sp -\fI\%memcached_server_count()\fP provides you a count of the current -number of servers being used by a \fBmemcached_st\fP structure. +\fI\%memcached_server_count()\fP provides you a count of the current number of +servers being used by a \fBmemcached_st\fP structure. +.INDENT 0.0 +.TP +.B \fI\%memcached_server_add()\fP pushes a single TCP server into the \fBmemcached_st\fP structure. This server will be placed at the end. Duplicate servers .sp -\fI\%memcached_server_add()\fP pushes a single TCP server into the -\fBmemcached_st\fP structure. This server will be placed at the end. -Duplicate servers are allowed, so duplication is not checked. Executing this -function with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set will -result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +are allowed, so duplication is not checked. Executing this function with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +.UNINDENT .sp -\fI\%memcached_server_add_udp()\fP pushes a single UDP server into the -\fBmemcached_st\fP structure. This server will be placed at the end. -Duplicate servers are allowed, so duplication is not checked. Executing this -function with out setting the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior -will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +\fI\%memcached_server_add_udp()\fP pushes a single UDP server into the \fBmemcached_st\fP structure. This server will be placed at the end. Duplicate +servers are allowed, so duplication is not checked. Executing this function with out setting the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior will result in a +\fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. .sp -\fI\%memcached_server_add_unix_socket()\fP pushes a single UNIX socket -into the \fBmemcached_st\fP structure. This UNIX socket will be placed -at the end. Duplicate servers are allowed, so duplication is not checked. -The length of the filename must be one character less then -\fBMEMCACHED_MAX_HOST_LENGTH\fP. +\fI\%memcached_server_add_unix_socket()\fP pushes a single UNIX socket into the \fBmemcached_st\fP structure. This UNIX socket will be placed at the end. +Duplicate servers are allowed, so duplication is not checked. The length +of the filename must be one character less than \fBMEMCACHED_MAX_HOST_LENGTH\fP. .sp -\fI\%memcached_server_push()\fP pushes an array of -\fBmemcached_server_st\fP into the \fBmemcached_st\fP structure. -These servers will be placed at the end. Duplicate servers are allowed, so -duplication is not checked. A copy is made of structure so the list provided -(and any operations on the list) are not saved. +\fI\%memcached_server_push()\fP pushes an array of \fBmemcached_server_st\fP into the \fBmemcached_st\fP structure. These servers will be placed at +the end. Duplicate servers are allowed, so duplication is not checked. A +copy is made of structure so the list provided (and any operations on +the list) are not saved. .sp -\fI\%memcached_server_by_key()\fP allows you to provide a key and retrieve -the server which would be used for assignment. This structure is cloned from -its original structure and must be freed. If NULL is returned you should -consult *error. The returning structure should be freed with +\fI\%memcached_server_by_key()\fP allows you to provide a key and retrieve the +server which would be used for assignment. This structure is cloned +from its original structure and must be freed. If NULL is returned you +should consult *error. The returning structure should be freed with \fBmemcached_server_free()\fP. .sp -\fI\%memcached_server_get_last_disconnect()\fP returns a pointer to the -last server for which there was a connection problem. It does not mean this +\fI\%memcached_server_get_last_disconnect()\fP returns a pointer to the last +server for which there was a connection problem. It does not mean this particular server is currently dead but if the library is reporting a server is, the returned server is a very good candidate. .sp -\fI\%memcached_server_cursor()\fP takes a memcached_st and loops through -the list of hosts currently in the cursor calling the list of callback -functions provided. You can optionally pass in a value via context which -will be provided to each callback function. An error return from any -callback will terminate the loop. \fI\%memcached_server_cursor()\fP is -passed the original caller memcached_st in its current state. +\fI\%memcached_server_cursor()\fP takes a memcached_st and loops through the +list of hosts currently in the cursor calling the list of callback +functions provided. You can optionally pass in a value via +context which will be provided to each callback function. An error +return from any callback will terminate the loop. \fI\%memcached_server_cursor()\fP is passed the original caller \fBmemcached_st\fP in its current state. .SH RETURN .sp Varies, see particular functions. diff --git a/docs/man/memcached_server_st.3 b/docs/man/memcached_server_st.3 index e3520282..9a4e6edc 100644 --- a/docs/man/memcached_server_st.3 +++ b/docs/man/memcached_server_st.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVER_ST" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SERVER_ST" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_server_st \- libmemcached Documentation . @@ -76,52 +76,46 @@ compile and link with \-lmemcached \fBlibmemcached\fP performs operations on a list of hosts. The order of these hosts determine routing to keys. Functions are provided to add keys to memcached_st structures. To manipulate lists of servers see -\fBmemcached_server_st()\fP. +memcached_server_st(3). .sp -\fI\%memcached_server_count()\fP provides you a count of the current -number of servers being used by a \fBmemcached_st\fP structure. +\fI\%memcached_server_count()\fP provides you a count of the current number of +servers being used by a \fBmemcached_st\fP structure. +.INDENT 0.0 +.TP +.B \fI\%memcached_server_add()\fP pushes a single TCP server into the \fBmemcached_st\fP structure. This server will be placed at the end. Duplicate servers .sp -\fI\%memcached_server_add()\fP pushes a single TCP server into the -\fBmemcached_st\fP structure. This server will be placed at the end. -Duplicate servers are allowed, so duplication is not checked. Executing this -function with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set will -result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +are allowed, so duplication is not checked. Executing this function with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +.UNINDENT .sp -\fI\%memcached_server_add_udp()\fP pushes a single UDP server into the -\fBmemcached_st\fP structure. This server will be placed at the end. -Duplicate servers are allowed, so duplication is not checked. Executing this -function with out setting the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior -will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +\fI\%memcached_server_add_udp()\fP pushes a single UDP server into the \fBmemcached_st\fP structure. This server will be placed at the end. Duplicate +servers are allowed, so duplication is not checked. Executing this function with out setting the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior will result in a +\fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. .sp -\fI\%memcached_server_add_unix_socket()\fP pushes a single UNIX socket -into the \fBmemcached_st\fP structure. This UNIX socket will be placed -at the end. Duplicate servers are allowed, so duplication is not checked. -The length of the filename must be one character less then -\fBMEMCACHED_MAX_HOST_LENGTH\fP. +\fI\%memcached_server_add_unix_socket()\fP pushes a single UNIX socket into the \fBmemcached_st\fP structure. This UNIX socket will be placed at the end. +Duplicate servers are allowed, so duplication is not checked. The length +of the filename must be one character less than \fBMEMCACHED_MAX_HOST_LENGTH\fP. .sp -\fI\%memcached_server_push()\fP pushes an array of -\fBmemcached_server_st\fP into the \fBmemcached_st\fP structure. -These servers will be placed at the end. Duplicate servers are allowed, so -duplication is not checked. A copy is made of structure so the list provided -(and any operations on the list) are not saved. +\fI\%memcached_server_push()\fP pushes an array of \fBmemcached_server_st\fP into the \fBmemcached_st\fP structure. These servers will be placed at +the end. Duplicate servers are allowed, so duplication is not checked. A +copy is made of structure so the list provided (and any operations on +the list) are not saved. .sp -\fI\%memcached_server_by_key()\fP allows you to provide a key and retrieve -the server which would be used for assignment. This structure is cloned from -its original structure and must be freed. If NULL is returned you should -consult *error. The returning structure should be freed with +\fI\%memcached_server_by_key()\fP allows you to provide a key and retrieve the +server which would be used for assignment. This structure is cloned +from its original structure and must be freed. If NULL is returned you +should consult *error. The returning structure should be freed with \fBmemcached_server_free()\fP. .sp -\fI\%memcached_server_get_last_disconnect()\fP returns a pointer to the -last server for which there was a connection problem. It does not mean this +\fI\%memcached_server_get_last_disconnect()\fP returns a pointer to the last +server for which there was a connection problem. It does not mean this particular server is currently dead but if the library is reporting a server is, the returned server is a very good candidate. .sp -\fI\%memcached_server_cursor()\fP takes a memcached_st and loops through -the list of hosts currently in the cursor calling the list of callback -functions provided. You can optionally pass in a value via context which -will be provided to each callback function. An error return from any -callback will terminate the loop. \fI\%memcached_server_cursor()\fP is -passed the original caller memcached_st in its current state. +\fI\%memcached_server_cursor()\fP takes a memcached_st and loops through the +list of hosts currently in the cursor calling the list of callback +functions provided. You can optionally pass in a value via +context which will be provided to each callback function. An error +return from any callback will terminate the loop. \fI\%memcached_server_cursor()\fP is passed the original caller \fBmemcached_st\fP in its current state. .SH RETURN .sp Varies, see particular functions. diff --git a/docs/man/memcached_servers.3 b/docs/man/memcached_servers.3 index e7f4b100..1c05d20d 100644 --- a/docs/man/memcached_servers.3 +++ b/docs/man/memcached_servers.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVERS" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SERVERS" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_servers \- libmemcached Documentation . @@ -76,52 +76,46 @@ compile and link with \-lmemcached \fBlibmemcached\fP performs operations on a list of hosts. The order of these hosts determine routing to keys. Functions are provided to add keys to memcached_st structures. To manipulate lists of servers see -\fBmemcached_server_st()\fP. +memcached_server_st(3). .sp -\fI\%memcached_server_count()\fP provides you a count of the current -number of servers being used by a \fBmemcached_st\fP structure. +\fI\%memcached_server_count()\fP provides you a count of the current number of +servers being used by a \fBmemcached_st\fP structure. +.INDENT 0.0 +.TP +.B \fI\%memcached_server_add()\fP pushes a single TCP server into the \fBmemcached_st\fP structure. This server will be placed at the end. Duplicate servers .sp -\fI\%memcached_server_add()\fP pushes a single TCP server into the -\fBmemcached_st\fP structure. This server will be placed at the end. -Duplicate servers are allowed, so duplication is not checked. Executing this -function with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set will -result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +are allowed, so duplication is not checked. Executing this function with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +.UNINDENT .sp -\fI\%memcached_server_add_udp()\fP pushes a single UDP server into the -\fBmemcached_st\fP structure. This server will be placed at the end. -Duplicate servers are allowed, so duplication is not checked. Executing this -function with out setting the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior -will result in a \fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. +\fI\%memcached_server_add_udp()\fP pushes a single UDP server into the \fBmemcached_st\fP structure. This server will be placed at the end. Duplicate +servers are allowed, so duplication is not checked. Executing this function with out setting the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior will result in a +\fBMEMCACHED_INVALID_HOST_PROTOCOL\fP. .sp -\fI\%memcached_server_add_unix_socket()\fP pushes a single UNIX socket -into the \fBmemcached_st\fP structure. This UNIX socket will be placed -at the end. Duplicate servers are allowed, so duplication is not checked. -The length of the filename must be one character less then -\fBMEMCACHED_MAX_HOST_LENGTH\fP. +\fI\%memcached_server_add_unix_socket()\fP pushes a single UNIX socket into the \fBmemcached_st\fP structure. This UNIX socket will be placed at the end. +Duplicate servers are allowed, so duplication is not checked. The length +of the filename must be one character less than \fBMEMCACHED_MAX_HOST_LENGTH\fP. .sp -\fI\%memcached_server_push()\fP pushes an array of -\fBmemcached_server_st\fP into the \fBmemcached_st\fP structure. -These servers will be placed at the end. Duplicate servers are allowed, so -duplication is not checked. A copy is made of structure so the list provided -(and any operations on the list) are not saved. +\fI\%memcached_server_push()\fP pushes an array of \fBmemcached_server_st\fP into the \fBmemcached_st\fP structure. These servers will be placed at +the end. Duplicate servers are allowed, so duplication is not checked. A +copy is made of structure so the list provided (and any operations on +the list) are not saved. .sp -\fI\%memcached_server_by_key()\fP allows you to provide a key and retrieve -the server which would be used for assignment. This structure is cloned from -its original structure and must be freed. If NULL is returned you should -consult *error. The returning structure should be freed with +\fI\%memcached_server_by_key()\fP allows you to provide a key and retrieve the +server which would be used for assignment. This structure is cloned +from its original structure and must be freed. If NULL is returned you +should consult *error. The returning structure should be freed with \fBmemcached_server_free()\fP. .sp -\fI\%memcached_server_get_last_disconnect()\fP returns a pointer to the -last server for which there was a connection problem. It does not mean this +\fI\%memcached_server_get_last_disconnect()\fP returns a pointer to the last +server for which there was a connection problem. It does not mean this particular server is currently dead but if the library is reporting a server is, the returned server is a very good candidate. .sp -\fI\%memcached_server_cursor()\fP takes a memcached_st and loops through -the list of hosts currently in the cursor calling the list of callback -functions provided. You can optionally pass in a value via context which -will be provided to each callback function. An error return from any -callback will terminate the loop. \fI\%memcached_server_cursor()\fP is -passed the original caller memcached_st in its current state. +\fI\%memcached_server_cursor()\fP takes a memcached_st and loops through the +list of hosts currently in the cursor calling the list of callback +functions provided. You can optionally pass in a value via +context which will be provided to each callback function. An error +return from any callback will terminate the loop. \fI\%memcached_server_cursor()\fP is passed the original caller \fBmemcached_st\fP in its current state. .SH RETURN .sp Varies, see particular functions. diff --git a/docs/man/memcached_servers_parse.3 b/docs/man/memcached_servers_parse.3 index 5bb41b0a..9338408d 100644 --- a/docs/man/memcached_servers_parse.3 +++ b/docs/man/memcached_servers_parse.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVERS_PARSE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SERVERS_PARSE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_servers_parse \- libmemcached Documentation . @@ -68,30 +68,25 @@ Compile and link with \-lmemcached .SH DESCRIPTION .sp libmemcached(3) operates on a list of hosts which are stored in -memcached_server_st structures. You should not modify these structures +\fBmemcached_server_st\fP structures. You should not modify these structures directly. Functions are provided to modify these structures (and more can be added, just ask!). .sp -\fI\%memcached_server_list()\fP is used to provide an array of all defined hosts. -This was incorrectly documented as "requiring free()" up till version 0.39. +\fI\%memcached_server_list()\fP is used to provide an array of all defined hosts. This was incorrectly documented as "requiring free()" up till version 0.39. .sp -\fI\%memcached_server_list_free()\fP deallocates all memory associated with the array -of memcached_server_st that you passed to it. +\fI\%memcached_server_list_free()\fP deallocates all memory associated with the array of \fBmemcached_server_st\fP that you passed to it. .sp \fI\%memcached_server_list_append()\fP adds a server to the end of a -memcached_server_st array. On error null will be returned and the -memcached_return_t pointer you passed into the function will be set with the -appropriate error. If the value of port is zero, it is set to the default +\fBmemcached_server_st\fP array. On error null will be returned and the +\fBmemcached_return_t\fP pointer you passed into the function will be set with the appropriate error. If the value of port is zero, it is set to the default port of a memcached server. .sp DEPRECATED \fBmemcached_servers_parse()\fP, please see \fBmemcached()\fP .sp -\fI\%memcached_server_error()\fP can be used to look at the text of the last error -message sent by the server to to the client. +\fI\%memcached_server_error()\fP can be used to look at the text of the last error message sent by the server to to the client. .sp -Before version 0.39 these functions used a memcache_server_st *. In 0.39 -memcached_server_st * was aliased to \fBmemcached_server_list_st\fP. This was -done for a style reason/to help clean up some concepts in the code. +Before version 0.39 theses functions used a memcache_server_st *. In 0.39 +memcached_server_st * was aliased to \fBmemcached_server_list_st\fP. This was done for a style reason to help clean up some concepts in the code. .SH RETURN .sp Varies, see particular functions. diff --git a/docs/man/memcached_servers_reset.3 b/docs/man/memcached_servers_reset.3 index f194b243..91b9f58f 100644 --- a/docs/man/memcached_servers_reset.3 +++ b/docs/man/memcached_servers_reset.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVERS_RESET" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SERVERS_RESET" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_servers_reset \- libmemcached Documentation . @@ -35,54 +35,63 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_st *memcached_create (memcached_st *ptr); +.B memcachd_st .UNINDENT .INDENT 0.0 .TP -.B void memcached_free (memcached_st *ptr); +.B memcached_st* memcached_create(memcached_st\fI\ *ptr\fP) .UNINDENT .INDENT 0.0 .TP -.B memcached_st *memcached_clone (memcached_st *destination, memcached_st *source); +.B void memcached_free(memcached_st\fI\ *ptr\fP) .UNINDENT .INDENT 0.0 .TP -.B void memcached_servers_reset(memcached_st); +.B memcached_st* memcached_clone(memcached_st\fI\ *destination\fP, memcached_st\fI\ *source\fP) +.UNINDENT +.INDENT 0.0 +.TP +.B void memcached_servers_reset(memcached_st) .UNINDENT .sp Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_create() is used to create a \fBmemcached_st\fP structure that will then -be used by other libmemcached(3) functions to communicate with the server. You -should either pass a statically declared \fBmemcached_st\fP to memcached_create() or +\fI\%memcached_create()\fP is used to create a \fBmemcached_st\fP +structure that will then be used by other libmemcached(3) functions to +communicate with the server. You should either pass a statically declared +\fBmemcached_st\fP to \fI\%memcached_create()\fP or a NULL. If a NULL passed in then a structure is allocated for you. .sp -Please note, when you write new application use memcached_create_with_options() over memcached_create(). +Please note, when you write new application use +\fBmemcached_create_with_options()\fP over +\fI\%memcached_create()\fP. .sp -memcached_clone() is similar to memcached_create(3) but it copies the -defaults and list of servers from the source \fBmemcached_st\fP. If you pass a null as -the argument for the source to clone, it is the same as a call to memcached_create(). -If the destination argument is NULL a \fBmemcached_st\fP will be allocated for you. +\fI\%memcached_clone()\fP is similar to \fI\%memcached_create()\fP but +it copies the defaults and list of servers from the source +\fBmemcached_st\fP. If you pass a null as the argument for the source +to clone, it is the same as a call to \fI\%memcached_create()\fP. +If the destination argument is NULL a \fBmemcached_st\fP will be allocated +for you. .sp -memcached_servers_reset() allows you to zero out the list of servers that -the memcached_st has. +\fI\%memcached_servers_reset()\fP allows you to zero out the list of +servers that the \fBmemcached_st\fP has. .sp -To clean up memory associated with a \fBmemcached_st\fP structure you should pass -it to memcached_free() when you are finished using it. memcached_free() is -the only way to make sure all memory is deallocated when you finish using -the structure. +To clean up memory associated with a \fBmemcached_st\fP structure you +should pass it to \fI\%memcached_free()\fP when you are finished using it. +\fI\%memcached_free()\fP is the only way to make sure all memory is +deallocated when you finish using the structure. .sp You may wish to avoid using memcached_create(3) or memcached_clone(3) with a stack based allocation. The most common issues related to ABI safety involve heap allocated structures. .SH RETURN .sp -memcached_create() returns a pointer to the memcached_st that was created -(or initialized). On an allocation failure, it returns NULL. +\fI\%memcached_create()\fP returns a pointer to the \fBmemcached_st\fP +that was created (or initialized). On an allocation failure, it returns NULL. .sp -memcached_clone() returns a pointer to the memcached_st that was created -(or initialized). On an allocation failure, it returns NULL. +\fI\%memcached_clone()\fP returns a pointer to the \fBmemcached_st\fP +that was created (or initialized). On an allocation failure, it returns NULL. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_set.3 b/docs/man/memcached_set.3 index b96dee34..7f200ec3 100644 --- a/docs/man/memcached_set.3 +++ b/docs/man/memcached_set.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SET" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SET" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_set \- Storing and Replacing Data . @@ -61,68 +61,57 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_set(), memcached_add(), and memcached_replace() are all used to -store information on the server. All methods take a key, and its length to -store the object. Keys are currently limited to 250 characters when using either a version of memcached(1) which is 1.4 or below, or when using the text protocol. -You must supply both a value and a length. Optionally you -may test an expiration time for the object and a 16 byte value (it is -meant to be used as a bitmap). "flags" is a 4byte space that is stored alongside of the main value. Many sub libraries make use of this field, so in most cases users should avoid making use of it. +\fBmemcached_set()\fP, \fBmemcached_add()\fP, and \fBmemcached_replace()\fP are all used to store information on the server. All methods take a key, and its length to store the object. Keys are currently limited to 250 characters when using either a version of memcached(1) which is 1.4 or below, or when using the text protocol. You must supply both a value and a length. Optionally you +store the object. Keys are currently limited to 250 characters by the +memcached(1) server. You must supply both a value and a length. Optionally you +may test an expiration time for the object and a 16 byte value (it is meant to be used as a bitmap). "flags" is a 4byte space that is stored alongside of the main value. Many sub libraries make use of this field, so in most cases users should avoid making use of it. .sp -memcached_set() will write an object to the server. If an object already -exists it will overwrite what is in the server. If the object does not exist -it will be written. If you are using the non\-blocking mode this function +\fBmemcached_set()\fP will write an object to the server. If an object +already exists it will overwrite what is in the server. If the object does not +exist it will be written. If you are using the non\-blocking mode this function will always return true unless a network error occurs. .sp -memcached_replace() replaces an object on the server. If the object is not -found on the server an error occurs. +\fBmemcached_replace()\fP replaces an object on the server. If the object is not found on the server an error occurs. .sp -memcached_add() adds an object to the server. If the object is found on the -server an error occurs, otherwise the value is stored. +\fBmemcached_add()\fP adds an object to the server. If the object is found on the server an error occurs, otherwise the value is stored. .sp -memcached_cas() overwrites data in the server as long as the "cas" value is -still the same in the server. You can get the cas value of a result by -calling memcached_result_cas() on a memcached_result_st(3) structure. At the point +\fBmemcached_cas()\fP overwrites data in the server as long as the "cas" +value is still the same in the server. You can get the cas value of a result by +calling \fBmemcached_result_cas()\fP on a memcached_result_st(3) structure. At the point that this note was written cas is still buggy in memached. Turning on tests for it in libmemcached(3) is optional. Please see memcached_set() for information on how to do this. .sp -memcached_set_by_key(), memcached_add_by_key(), and memcached_replace_by_key() -methods all behave in a similar method as the non key -methods. The difference is that they use their group_key parameter to map +\fBmemcached_set_by_key()\fP, \fBmemcached_add_by_key()\fP, and \fBmemcached_replace_by_key()\fP methods all behave in a similar method as the non +key methods. The difference is that they use their group_key parameter to map objects to particular servers. .sp -If you are looking for performance, memcached_set() with non\-blocking IO is -the fastest way to store data on the server. +If you are looking for performance, \fBmemcached_set()\fP with non\-blocking IO is the fastest way to store data on the server. .sp -All of the above functions are testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPbehavior enabled. However, when using these operations with this behavior on, there -are limits to the size of the payload being sent to the server. The reason for -these limits is that the Memcached Server does not allow multi\-datagram requests -and the current server implementation sets a datagram size to 1400 bytes. Due -to protocol overhead, the actual limit of the user supplied data is less than -1400 bytes and depends on the protocol in use as, well as the operation being -executed. When running with the binary protocol, \(ga\(ga MEMCACHED_BEHAVIOR_BINARY_PROTOCOL\(ga\(ga, -the size of the key,value, flags and expiry combined may not exceed 1368 bytes. -When running with the ASCII protocol, the exact limit fluctuates depending on -which function is being executed and whether the function is a cas operation -or not. For non\-cas ASCII set operations, there are at least 1335 bytes available -to split among the key, key_prefix, and value; for cas ASCII operations there are -at least 1318 bytes available to split among the key, key_prefix and value. If the -total size of the command, including overhead, exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fPwill be returned. +All of the above functions are testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior enabled. However, when using these operations with this behavior +on, there are limits to the size of the payload being sent to the server. +The reason for these limits is that the Memcached Server does not allow +multi\-datagram requests and the current server implementation sets a datagram +size to 1400 bytes. Due to protocol overhead, the actual limit of the user supplied data is less than 1400 bytes and depends on the protocol in use as, well as the operation being +executed. When running with the binary protocol, \fBMEMCACHED_BEHAVIOR_BINARY_PROTOCOL\fP, the size of the key,value, flags and expiry combined may not +exceed 1368 bytes. When running with the ASCII protocol, the exact limit fluctuates depending on which function is being executed and whether the function is a cas operation or not. For non\-cas ASCII set operations, there are at least +1335 bytes available to split among the key, key_prefix, and value; for cas +ASCII operations there are at least 1318 bytes available to split among the key, key_prefix and value. If the total size of the command, including overhead, +exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fP will be returned. .SH RETURN .sp All methods return a value of type \fBmemcached_return_t\fP. On success the value will be \fBMEMCACHED_SUCCESS\fP. -Use memcached_strerror() to translate this value to a printable string. +Use \fBmemcached_strerror()\fP to translate this value to a printable string. .sp -For memcached_replace() and memcached_add(), \fBMEMCACHED_NOTSTORED\fP is a -legitmate error in the case of a collision. +For \fBmemcached_replace()\fP and \fBmemcached_add()\fP, \fBMEMCACHED_NOTSTORED\fP is a legitmate error in the case of a collision. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemached(3) memcached_strerror(3) memcached_prepend(3) memcached_cas(3) memcached_append(3) +\fImemcached(1)\fP \fIlibmemached(3)\fP \fImemcached_strerror(3)\fP \fImemcached_prepend(3)\fP \fImemcached_cas(3)\fP \fImemcached_append(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_set_by_key.3 b/docs/man/memcached_set_by_key.3 index 7b56ecdb..422cba53 100644 --- a/docs/man/memcached_set_by_key.3 +++ b/docs/man/memcached_set_by_key.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SET_BY_KEY" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SET_BY_KEY" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_set_by_key \- Storing and Replacing Data . @@ -61,68 +61,57 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_set(), memcached_add(), and memcached_replace() are all used to -store information on the server. All methods take a key, and its length to -store the object. Keys are currently limited to 250 characters when using either a version of memcached(1) which is 1.4 or below, or when using the text protocol. -You must supply both a value and a length. Optionally you -may test an expiration time for the object and a 16 byte value (it is -meant to be used as a bitmap). "flags" is a 4byte space that is stored alongside of the main value. Many sub libraries make use of this field, so in most cases users should avoid making use of it. +\fBmemcached_set()\fP, \fBmemcached_add()\fP, and \fBmemcached_replace()\fP are all used to store information on the server. All methods take a key, and its length to store the object. Keys are currently limited to 250 characters when using either a version of memcached(1) which is 1.4 or below, or when using the text protocol. You must supply both a value and a length. Optionally you +store the object. Keys are currently limited to 250 characters by the +memcached(1) server. You must supply both a value and a length. Optionally you +may test an expiration time for the object and a 16 byte value (it is meant to be used as a bitmap). "flags" is a 4byte space that is stored alongside of the main value. Many sub libraries make use of this field, so in most cases users should avoid making use of it. .sp -memcached_set() will write an object to the server. If an object already -exists it will overwrite what is in the server. If the object does not exist -it will be written. If you are using the non\-blocking mode this function +\fBmemcached_set()\fP will write an object to the server. If an object +already exists it will overwrite what is in the server. If the object does not +exist it will be written. If you are using the non\-blocking mode this function will always return true unless a network error occurs. .sp -memcached_replace() replaces an object on the server. If the object is not -found on the server an error occurs. +\fBmemcached_replace()\fP replaces an object on the server. If the object is not found on the server an error occurs. .sp -memcached_add() adds an object to the server. If the object is found on the -server an error occurs, otherwise the value is stored. +\fBmemcached_add()\fP adds an object to the server. If the object is found on the server an error occurs, otherwise the value is stored. .sp -memcached_cas() overwrites data in the server as long as the "cas" value is -still the same in the server. You can get the cas value of a result by -calling memcached_result_cas() on a memcached_result_st(3) structure. At the point +\fBmemcached_cas()\fP overwrites data in the server as long as the "cas" +value is still the same in the server. You can get the cas value of a result by +calling \fBmemcached_result_cas()\fP on a memcached_result_st(3) structure. At the point that this note was written cas is still buggy in memached. Turning on tests for it in libmemcached(3) is optional. Please see memcached_set() for information on how to do this. .sp -memcached_set_by_key(), memcached_add_by_key(), and memcached_replace_by_key() -methods all behave in a similar method as the non key -methods. The difference is that they use their group_key parameter to map +\fBmemcached_set_by_key()\fP, \fBmemcached_add_by_key()\fP, and \fBmemcached_replace_by_key()\fP methods all behave in a similar method as the non +key methods. The difference is that they use their group_key parameter to map objects to particular servers. .sp -If you are looking for performance, memcached_set() with non\-blocking IO is -the fastest way to store data on the server. +If you are looking for performance, \fBmemcached_set()\fP with non\-blocking IO is the fastest way to store data on the server. .sp -All of the above functions are testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fPbehavior enabled. However, when using these operations with this behavior on, there -are limits to the size of the payload being sent to the server. The reason for -these limits is that the Memcached Server does not allow multi\-datagram requests -and the current server implementation sets a datagram size to 1400 bytes. Due -to protocol overhead, the actual limit of the user supplied data is less than -1400 bytes and depends on the protocol in use as, well as the operation being -executed. When running with the binary protocol, \(ga\(ga MEMCACHED_BEHAVIOR_BINARY_PROTOCOL\(ga\(ga, -the size of the key,value, flags and expiry combined may not exceed 1368 bytes. -When running with the ASCII protocol, the exact limit fluctuates depending on -which function is being executed and whether the function is a cas operation -or not. For non\-cas ASCII set operations, there are at least 1335 bytes available -to split among the key, key_prefix, and value; for cas ASCII operations there are -at least 1318 bytes available to split among the key, key_prefix and value. If the -total size of the command, including overhead, exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fPwill be returned. +All of the above functions are testsed with the \fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior enabled. However, when using these operations with this behavior +on, there are limits to the size of the payload being sent to the server. +The reason for these limits is that the Memcached Server does not allow +multi\-datagram requests and the current server implementation sets a datagram +size to 1400 bytes. Due to protocol overhead, the actual limit of the user supplied data is less than 1400 bytes and depends on the protocol in use as, well as the operation being +executed. When running with the binary protocol, \fBMEMCACHED_BEHAVIOR_BINARY_PROTOCOL\fP, the size of the key,value, flags and expiry combined may not +exceed 1368 bytes. When running with the ASCII protocol, the exact limit fluctuates depending on which function is being executed and whether the function is a cas operation or not. For non\-cas ASCII set operations, there are at least +1335 bytes available to split among the key, key_prefix, and value; for cas +ASCII operations there are at least 1318 bytes available to split among the key, key_prefix and value. If the total size of the command, including overhead, +exceeds 1400 bytes, a \fBMEMCACHED_WRITE_FAILURE\fP will be returned. .SH RETURN .sp All methods return a value of type \fBmemcached_return_t\fP. On success the value will be \fBMEMCACHED_SUCCESS\fP. -Use memcached_strerror() to translate this value to a printable string. +Use \fBmemcached_strerror()\fP to translate this value to a printable string. .sp -For memcached_replace() and memcached_add(), \fBMEMCACHED_NOTSTORED\fP is a -legitmate error in the case of a collision. +For \fBmemcached_replace()\fP and \fBmemcached_add()\fP, \fBMEMCACHED_NOTSTORED\fP is a legitmate error in the case of a collision. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemached(3) memcached_strerror(3) memcached_prepend(3) memcached_cas(3) memcached_append(3) +\fImemcached(1)\fP \fIlibmemached(3)\fP \fImemcached_strerror(3)\fP \fImemcached_prepend(3)\fP \fImemcached_cas(3)\fP \fImemcached_append(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_set_memory_allocators.3 b/docs/man/memcached_set_memory_allocators.3 index 216281ff..3b28de5e 100644 --- a/docs/man/memcached_set_memory_allocators.3 +++ b/docs/man/memcached_set_memory_allocators.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SET_MEMORY_ALLOCATORS" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SET_MEMORY_ALLOCATORS" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_set_memory_allocators \- libmemcached Documentation . @@ -70,18 +70,18 @@ Compile and link with \-lmemcached libmemcached(3) allows you to specify your own memory allocators, optimized for your application. This enables libmemcached to be used inside of applications that have their own malloc implementation. .sp -memcached_set_memory_allocators() is used to set the memory allocators used -by the memcached instance specified by ptr. Please note that you cannot -override only one of the memory allocators, you have to specify a complete -new set if you want to override one of them. All of the memory allocation -functions should behave as specified in the C99 standard. Specify NULL as -all functions to reset them to the default values. +\fBmemcached_set_memory_allocators()\fP is used to set the memory +allocators used by the memcached instance specified by ptr. Please note that +you cannot override only one of the memory allocators, you have to specify a +complete new set if you want to override one of them. All of the memory +allocation functions should behave as specified in the C99 standard. Specify +NULL as all functions to reset them to the default values. .sp -memcached_get_memory_allocators() is used to get the currently used memory -allocators by a mamcached handle. +\fBmemcached_get_memory_allocators()\fP is used to get the currently used +memory allocators by a mamcached handle. .sp -memcached_get_memory_allocators_context() returns the void * that was -passed in during the call to memcached_set_memory_allocators(). +\fBmemcached_get_memory_allocators_context()\fP returns the void * that +was passed in during the call to \fBmemcached_set_memory_allocators()\fP. .sp The first argument to the memory allocator functions is a pointer to a memcached structure, the is passed as const and you will need to clone @@ -93,8 +93,9 @@ passed to them. This was so that customer allocators could have their own space for memory. .SH RETURN .sp -memcached_set_memory_allocators() return MEMCACHED_SUCCESS upon success, -and MEMCACHED_FAILURE if you don\(aqt pass a complete set of function pointers. +\fBmemcached_set_memory_allocators()\fP return \fBMEMCACHED_SUCCESS\fP +upon success, and \fBMEMCACHED_FAILURE\fP if you don\(aqt pass a complete set +of function pointers. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_set_memory_allocators_context.3 b/docs/man/memcached_set_memory_allocators_context.3 index 65ddca2c..d45daa2d 100644 --- a/docs/man/memcached_set_memory_allocators_context.3 +++ b/docs/man/memcached_set_memory_allocators_context.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SET_MEMORY_ALLOCATORS_CONTEXT" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SET_MEMORY_ALLOCATORS_CONTEXT" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_set_memory_allocators_context \- libmemcached Documentation . @@ -70,18 +70,18 @@ Compile and link with \-lmemcached libmemcached(3) allows you to specify your own memory allocators, optimized for your application. This enables libmemcached to be used inside of applications that have their own malloc implementation. .sp -memcached_set_memory_allocators() is used to set the memory allocators used -by the memcached instance specified by ptr. Please note that you cannot -override only one of the memory allocators, you have to specify a complete -new set if you want to override one of them. All of the memory allocation -functions should behave as specified in the C99 standard. Specify NULL as -all functions to reset them to the default values. +\fBmemcached_set_memory_allocators()\fP is used to set the memory +allocators used by the memcached instance specified by ptr. Please note that +you cannot override only one of the memory allocators, you have to specify a +complete new set if you want to override one of them. All of the memory +allocation functions should behave as specified in the C99 standard. Specify +NULL as all functions to reset them to the default values. .sp -memcached_get_memory_allocators() is used to get the currently used memory -allocators by a mamcached handle. +\fBmemcached_get_memory_allocators()\fP is used to get the currently used +memory allocators by a mamcached handle. .sp -memcached_get_memory_allocators_context() returns the void * that was -passed in during the call to memcached_set_memory_allocators(). +\fBmemcached_get_memory_allocators_context()\fP returns the void * that +was passed in during the call to \fBmemcached_set_memory_allocators()\fP. .sp The first argument to the memory allocator functions is a pointer to a memcached structure, the is passed as const and you will need to clone @@ -93,8 +93,9 @@ passed to them. This was so that customer allocators could have their own space for memory. .SH RETURN .sp -memcached_set_memory_allocators() return MEMCACHED_SUCCESS upon success, -and MEMCACHED_FAILURE if you don\(aqt pass a complete set of function pointers. +\fBmemcached_set_memory_allocators()\fP return \fBMEMCACHED_SUCCESS\fP +upon success, and \fBMEMCACHED_FAILURE\fP if you don\(aqt pass a complete set +of function pointers. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_set_sasl_callbacks.3 b/docs/man/memcached_set_sasl_callbacks.3 index 4e71622b..3430e853 100644 --- a/docs/man/memcached_set_sasl_callbacks.3 +++ b/docs/man/memcached_set_sasl_callbacks.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SET_SASL_CALLBACKS" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SET_SASL_CALLBACKS" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_set_sasl_callbacks \- libmemcached Documentation . @@ -59,21 +59,20 @@ libsasl to perform SASL authentication. Please note that SASL requires the memcached binary protocol, and you have to specify the callbacks before you connect to the server. .sp -memcached_set_sasl_auth_data() is a helper function defining +\fI\%memcached_set_sasl_auth_data()\fP is a helper function defining the basic functionality for you, but it will store the username and password in memory. If you choose to use this method you have to call -memcached_destroy_sasl_auth_data before calling memcached_free to avoid -a memory leak. You should NOT call memcached_destroy_sasl_auth_data if you -specify your own callback function with memcached_set_sasl_callbacks(). +\fI\%memcached_destroy_sasl_auth_data\fP before calling +\fBmemcached_free\fP to avoid a memory leak. You should NOT call +\fI\%memcached_destroy_sasl_auth_data\fP if you specify your own callback +function with \fI\%memcached_set_sasl_callbacks()\fP. .sp -You as a client user have to initialize libsasl by using sasl_client_init -before enabling it in libmemcached, and you have to shut down libsasl by -calling sasl_done() when you are done using SASL from libmemcached. +You as a client user have to initialize libsasl by using \fBsasl_client_init\fP before enabling it in libmemcached, and you have to shut down libsasl by +calling \fBsasl_done()\fP when you are done using SASL from libmemcached. .SH RETURN .sp -memcached_get_sasl_callbacks() returns the callbacks currently used -by this memcached handle. -memcached_get_sasl_set_auth_data() returns MEMCACHED_SUCCESS upon success. +\fI\%memcached_get_sasl_callbacks()\fP returns the callbacks currently used +by this memcached handle. \fBmemcached_get_sasl_set_auth_data()\fP returns \fBMEMCACHED_SUCCESS\fP upon success. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcached_set_user_data.3 b/docs/man/memcached_set_user_data.3 index e771bb70..69b03fb0 100644 --- a/docs/man/memcached_set_user_data.3 +++ b/docs/man/memcached_set_user_data.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SET_USER_DATA" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_SET_USER_DATA" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_set_user_data \- libmemcached Documentation . @@ -51,25 +51,22 @@ void *memcached_set_user_data (memcached_st *ptr, void *data); libmemcached(3) allows you to store a pointer to a user specific data inside the memcached_st structure. .sp -memcached_set_user_data() is used to set the user specific data in the -memcached_st structure. +\fBmemcached_set_user_data()\fP is used to set the user specific data in the +\fBmemcached_st\fP structure. .sp -memcached_get_user_data() is used to retrieve the user specific data in -the memcached_st structure. +\fBmemcached_get_user_data()\fP is used to retrieve the user specific data in the \fBmemcached_st\fP structure. .SH RETURN .sp -memcached_set_user_data() returns the previous value of the user specific -data. +\fBmemcached_set_user_data()\fP returns the previous value of the user specific data. .sp -memcached_get_user_data() returns the current value uf the user specific -data. +\fBmemcached_get_user_data()\fP returns the current value uf the user specific data. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemcached(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_stat.3 b/docs/man/memcached_stat.3 index e32c3daa..9bbbdb06 100644 --- a/docs/man/memcached_stat.3 +++ b/docs/man/memcached_stat.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_STAT" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_STAT" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_stat \- libmemcached Documentation . @@ -61,33 +61,20 @@ Compile and link with \-lmemcached .sp libmemcached(3) has the ability to query a memcached server (or collection of servers) for their current state. Queries to find state return a -\fBmemcached_stat_st\fP structure. You are responsible for freeing this structure. -While it is possible to access the structure directly it is not advisable. - .SH SEE ALSO .sp -memcached(1) libmemcached(3) memcached_strerror(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_stat_execute.3 b/docs/man/memcached_stat_execute.3 index 49e80ee0..80a567eb 100644 --- a/docs/man/memcached_stat_execute.3 +++ b/docs/man/memcached_stat_execute.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_STAT_EXECUTE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_STAT_EXECUTE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_stat_execute \- libmemcached Documentation . @@ -61,33 +61,20 @@ Compile and link with \-lmemcached .sp libmemcached(3) has the ability to query a memcached server (or collection of servers) for their current state. Queries to find state return a -\fBmemcached_stat_st\fP structure. You are responsible for freeing this structure. -While it is possible to access the structure directly it is not advisable. - .SH SEE ALSO .sp -memcached(1) libmemcached(3) memcached_strerror(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_stat_get_keys.3 b/docs/man/memcached_stat_get_keys.3 index 9c63ffde..cb1a7f44 100644 --- a/docs/man/memcached_stat_get_keys.3 +++ b/docs/man/memcached_stat_get_keys.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_STAT_GET_KEYS" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_STAT_GET_KEYS" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_stat_get_keys \- libmemcached Documentation . @@ -61,33 +61,20 @@ Compile and link with \-lmemcached .sp libmemcached(3) has the ability to query a memcached server (or collection of servers) for their current state. Queries to find state return a -\fBmemcached_stat_st\fP structure. You are responsible for freeing this structure. -While it is possible to access the structure directly it is not advisable. - .SH SEE ALSO .sp -memcached(1) libmemcached(3) memcached_strerror(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_stat_get_value.3 b/docs/man/memcached_stat_get_value.3 index 1a6ed284..1be95b69 100644 --- a/docs/man/memcached_stat_get_value.3 +++ b/docs/man/memcached_stat_get_value.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_STAT_GET_VALUE" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_STAT_GET_VALUE" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_stat_get_value \- libmemcached Documentation . @@ -61,33 +61,20 @@ Compile and link with \-lmemcached .sp libmemcached(3) has the ability to query a memcached server (or collection of servers) for their current state. Queries to find state return a -\fBmemcached_stat_st\fP structure. You are responsible for freeing this structure. -While it is possible to access the structure directly it is not advisable. - .SH SEE ALSO .sp -memcached(1) libmemcached(3) memcached_strerror(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_stat_servername.3 b/docs/man/memcached_stat_servername.3 index 65167a04..2c743fc2 100644 --- a/docs/man/memcached_stat_servername.3 +++ b/docs/man/memcached_stat_servername.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_STAT_SERVERNAME" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_STAT_SERVERNAME" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_stat_servername \- libmemcached Documentation . @@ -61,33 +61,20 @@ Compile and link with \-lmemcached .sp libmemcached(3) has the ability to query a memcached server (or collection of servers) for their current state. Queries to find state return a -\fBmemcached_stat_st\fP structure. You are responsible for freeing this structure. -While it is possible to access the structure directly it is not advisable. - .SH SEE ALSO .sp -memcached(1) libmemcached(3) memcached_strerror(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_stats.3 b/docs/man/memcached_stats.3 index bb5d71ec..85d683f6 100644 --- a/docs/man/memcached_stats.3 +++ b/docs/man/memcached_stats.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_STATS" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_STATS" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_stats \- libmemcached Documentation . @@ -61,33 +61,20 @@ Compile and link with \-lmemcached .sp libmemcached(3) has the ability to query a memcached server (or collection of servers) for their current state. Queries to find state return a -\fBmemcached_stat_st\fP structure. You are responsible for freeing this structure. -While it is possible to access the structure directly it is not advisable. - .SH SEE ALSO .sp -memcached(1) libmemcached(3) memcached_strerror(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_strerror.3 b/docs/man/memcached_strerror.3 index 7107536a..c51cdea6 100644 --- a/docs/man/memcached_strerror.3 +++ b/docs/man/memcached_strerror.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_STRERROR" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_STRERROR" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_strerror \- libmemcached Documentation . @@ -41,25 +41,23 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_strerror() takes a \fBmemcached_return_t\fP value and returns a string -describing the error. +\fBmemcached_strerror()\fP takes a \fBmemcached_return_t\fP value and returns a string describing the error. .sp This string must not be modified by the application. .sp \fBmemcached_return_t\fP values are returned from nearly all libmemcached(3) functions. .sp -\fBmemcached_return_t\fP values are of an enum type so that you can set up responses -with switch/case and know that you are capturing all possible return values. +\fBmemcached_return_t\fP values are of an enum type so that you can set up responses with switch/case and know that you are capturing all possible return values. .SH RETURN .sp -memcached_strerror() returns a string describing a \fBmemcached_return_t\fP value. +\fBmemcached_strerror()\fP returns a string describing a \fBmemcached_return_t\fP value. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemcached(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_user_data.3 b/docs/man/memcached_user_data.3 index 311862c5..d3119871 100644 --- a/docs/man/memcached_user_data.3 +++ b/docs/man/memcached_user_data.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_USER_DATA" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_USER_DATA" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_user_data \- libmemcached Documentation . @@ -51,25 +51,22 @@ void *memcached_set_user_data (memcached_st *ptr, void *data); libmemcached(3) allows you to store a pointer to a user specific data inside the memcached_st structure. .sp -memcached_set_user_data() is used to set the user specific data in the -memcached_st structure. +\fBmemcached_set_user_data()\fP is used to set the user specific data in the +\fBmemcached_st\fP structure. .sp -memcached_get_user_data() is used to retrieve the user specific data in -the memcached_st structure. +\fBmemcached_get_user_data()\fP is used to retrieve the user specific data in the \fBmemcached_st\fP structure. .SH RETURN .sp -memcached_set_user_data() returns the previous value of the user specific -data. +\fBmemcached_set_user_data()\fP returns the previous value of the user specific data. .sp -memcached_get_user_data() returns the current value uf the user specific -data. +\fBmemcached_get_user_data()\fP returns the current value uf the user specific data. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemcached(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_verbosity.3 b/docs/man/memcached_verbosity.3 index f8637856..9119178f 100644 --- a/docs/man/memcached_verbosity.3 +++ b/docs/man/memcached_verbosity.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_VERBOSITY" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_VERBOSITY" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_verbosity \- libmemcached Documentation . @@ -43,20 +43,22 @@ Modifiy verbosity of servers Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_verbosity() modifies the "verbosity" of the -memcached(1) servers referenced in the \fBmemcached_st\fP parameter. +\fBmemcached_verbosity()\fP modifies the "verbosity" of the +memcached(1) servers referenced in the \fBmemcached_st\fP parameter. .SH RETURN .sp -A value of type \fBmemcached_return_t\fP is returned +A value of type \fBmemcached_return_t\fP is returned. +.sp On success that value will be \fBMEMCACHED_SUCCESS\fP. -Use memcached_strerror() to translate this value to a printable string. +.sp +Use \fBmemcached_strerror()\fP to translate this value to a printable string. .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemcached(3) memcached_strerror(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcached_version.3 b/docs/man/memcached_version.3 index f077dba5..060c21fc 100644 --- a/docs/man/memcached_version.3 +++ b/docs/man/memcached_version.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_VERSION" "3" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCACHED_VERSION" "3" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcached_version \- libmemcached Documentation . @@ -45,20 +45,20 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcached .SH DESCRIPTION .sp -memcached_lib_version() is used to return a simple version string representing -the libmemcached version (client library version, not server version) +\fI\%memcached_lib_version()\fP is used to return a simple version string representing the libmemcached version (client library version, not server version) .sp -memcached_version() is used to set the major, minor, and micro versions of each -memcached server being used by the memcached_st connection structure. It returns the -memcached server return code. +\fI\%memcached_version()\fP is used to set the major, minor, and micro versions of each memcached server being used by the memcached_st connection structure. It returns the memcached server return code. .SH RETURN .sp -A string with the version of libmemcached driver is returned from -memcached_lib_version() +\fI\%memcached_lib_version()\fP returns a string with the version of the libmemcached driver. .sp -A value of type \fBmemcached_return_t\fP is returned from memcached_version() -On success that value will be \fBMEMCACHED_SUCCESS\fP. If called with the -\fBMEMCACHED_BEHAVIOR_USE_UDP\fP behavior set, the value \fBMEMCACHED_NOT_SUPPORTED\fPwill be returned. Use memcached_strerror() to translate this value to +A value of \fBmemcached_return_t\fP is returned from :c:func:\(aqmemcached_version()\(aq +.sp +On success that value will be \fBMEMCACHED_SUCCESS\fP. +.sp +If called with the \fBMEMCACHED_BEHAVIOR_USE_UDP()\fP behavior set, the value \fBMEMCACHED_NOT_SUPPORTED\fP will be returned. +.sp +Use \fBmemcached_strerror()\fP to translate this value to a printable string. .SH HOME .sp @@ -66,7 +66,7 @@ To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemcached(3) memcached_strerror(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcapable.1 b/docs/man/memcapable.1 index 21a67ca8..0e93e5b3 100644 --- a/docs/man/memcapable.1 +++ b/docs/man/memcapable.1 @@ -1,4 +1,4 @@ -.TH "MEMCAPABLE" "1" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCAPABLE" "1" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcapable \- libmemcached Documentation . @@ -30,11 +30,18 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .. .\" Man page generated from reStructeredText. . -.sp -Check the server for compatibility and capabilities .SH SYNOPSIS .sp -\fBmemcapable\fP +memcapable [options] +.SH DESCRIPTION +.sp +\fBmemcapable\fP connects to the specified memcached server and tries to +determine its capabilities by running the various commands and verifying +the response. +.SH LIMITATIONS +.sp +The current version of memcapable will only verify the binary protocol. +.SH OPTIONS .INDENT 0.0 .TP .B \-h hostname @@ -65,14 +72,6 @@ Print out the comparison when it detects an error from the server. .UNINDENT .sp Set the timeout from an IO operation to/from the server to \fIn\fP seconds. -.SH DESCRIPTION -.sp -\fBmemcapable\fP connects to the specified memcached server and tries to -determine its capabilities by running the various commands and verifying -the response. -.SH LIMITATIONS -.sp -The current version of memcapable will only verify the binary protocol. .SH HOME .sp To find out more information please check: diff --git a/docs/man/memcat.1 b/docs/man/memcat.1 index 63ce9af2..33bc41e7 100644 --- a/docs/man/memcat.1 +++ b/docs/man/memcat.1 @@ -1,4 +1,4 @@ -.TH "MEMCAT" "1" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCAT" "1" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcat \- libmemcached Documentation . @@ -30,26 +30,36 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .. .\" Man page generated from reStructeredText. . -.sp -Copy a set of keys to stdout .SH SYNOPSIS .sp -\fBmemcat\fP -.INDENT 0.0 -.TP -.B \-\-help -.UNINDENT +memcat [options] key +.sp +Copy a set of keys to stdout .SH DESCRIPTION .sp \fBmemcat\fP outputs to stdout the value a single or multiple set of keys stored in a memcached(1) server. If any key is not found an error is returned. .sp It is similar to the standard UNIX cat(1) utility. +.SH OPTIONS .sp -You can specify servers via the \fB\-\-servers\fP option or via the -environment variable \fBMEMCACHED_SERVERS\fP. +You can specify servers via the option: +.INDENT 0.0 +.TP +.B \-\-servers +.UNINDENT +.sp +or via the environment variable: +.INDENT 0.0 +.TP +.B \(gaMEMCACHED_SERVERS\(ga +.UNINDENT .sp -For a full list of operations run the tool with the \fB\-\-help\fP option. +For a full list of operations run the tool with the option: +.INDENT 0.0 +.TP +.B \-\-help +.UNINDENT .SH HOME .sp To find out more information please check: @@ -61,7 +71,7 @@ Brian Aker, <\fI\%brian@tangent.org\fP> Mark Atwood <\fI\%mark@fallenpegasus.com\fP> .SH SEE ALSO .sp -memcached(1) libmemcached(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memcp.1 b/docs/man/memcp.1 index 1f1f6ed2..6ab48a1c 100644 --- a/docs/man/memcp.1 +++ b/docs/man/memcp.1 @@ -1,4 +1,4 @@ -.TH "MEMCP" "1" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMCP" "1" "July 21, 2011" "0.51" "libmemcached" .SH NAME memcp \- libmemcached Documentation . @@ -33,16 +33,8 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .sp Copies files to a collection of memcached servers .SH SYNOPSIS -.INDENT 0.0 -.TP -.B program -. -\fImemcp\fP -.UNINDENT -.INDENT 0.0 -.TP -.B \-\-help -.UNINDENT +.sp +memcp [options] [file] [server] .SH DESCRIPTION .sp \fBmemcp\fP copies one or more files into memcached(1) servers. @@ -50,12 +42,27 @@ It is similar to the standard UNIX cp(1) command. .sp The key names will be the names of the files, without any directory path. +.SH OPTIONS .sp -You can specify servers via the \fB\-\-servers\fP option or via the -environment variable \fBMEMCACHED_SERVERS\fP. If you do not specify either these, the final value in the command line list is the name of a -server(s). +You can specify servers via the option: +.INDENT 0.0 +.TP +.B \-\-servers +.UNINDENT +.sp +or via the environment variable: +.INDENT 0.0 +.TP +.B \(gaMEMCACHED_SERVERS\(ga +.UNINDENT .sp -For a full list of operations run the tool with the \fB\-\-help\fP option. +If you do not specify either these, the final value in the command line list is the name of a server(s). +.sp +For a full list of operations run the tool with the option: +.INDENT 0.0 +.TP +.B \-\-help +.UNINDENT .SH HOME .sp To find out more information please check: @@ -67,7 +74,7 @@ Brian Aker, <\fI\%brian@tangent.org\fP> Mark Atwood, <\fI\%mark@fallenpegasus.com\fP> .SH SEE ALSO .sp -memcached(1) libmemcached(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memdump.1 b/docs/man/memdump.1 index 1484c139..1c2f8f49 100644 --- a/docs/man/memdump.1 +++ b/docs/man/memdump.1 @@ -1,4 +1,4 @@ -.TH "MEMDUMP" "1" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMDUMP" "1" "July 21, 2011" "0.51" "libmemcached" .SH NAME memdump \- libmemcached Documentation . @@ -33,27 +33,27 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .sp Dump a list of keys from a server. .SH SYNOPSIS -.INDENT 0.0 -.TP -.B program -. -\fImemdump\fP -.UNINDENT -.INDENT 0.0 -.TP -.B \-\-help -.UNINDENT +.sp +memdump [options] .SH DESCRIPTION .sp -\fBmemdump\fP dumps a list of "keys" from all servers that +\fBmemdump\fP dumps a list of "keys" from all servers that it is told to fetch from. Because memcached does not guarentee to provide all keys it is not possible to get a complete "dump". +.SH OPTIONS .sp -For a full list of operations run the tool with the \fB\-\-help\fP option. +For a full list of operations run the tool with option: +.INDENT 0.0 +.TP +.B \-\-help +.UNINDENT .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP +.SH AUTHOR +.sp +Brian Aker, <\fI\%brian@tangent.org\fP> .SH SEE ALSO .sp \fImemcached(1)\fP \fIlibmemcached(3)\fP diff --git a/docs/man/memerror.1 b/docs/man/memerror.1 index fe53b01e..401ba93d 100644 --- a/docs/man/memerror.1 +++ b/docs/man/memerror.1 @@ -1,4 +1,4 @@ -.TH "MEMERROR" "1" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMERROR" "1" "July 21, 2011" "0.51" "libmemcached" .SH NAME memerror \- libmemcached Documentation . @@ -33,29 +33,29 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .sp Translates a memcached error code into a string .SH SYNOPSIS -.INDENT 0.0 -.TP -.B program -. -\fImemerror\fP -.UNINDENT -.INDENT 0.0 -.TP -.B \-\-help -.UNINDENT +.sp +memerror [options] [error code] .SH DESCRIPTION .sp -\fBmemerror\fP translate an error code from libmemcached(3) into a human +\fBmemerror\fP translates an error code from libmemcached(3) into a human readable string. +.SH OPTIONS .sp -For a full list of operations run the tool with the \fB\-\-help\fP option. +For a full list of operations run the tool with option: +.INDENT 0.0 +.TP +.B \-\-help +.UNINDENT .SH HOME .sp To find out more infoerroration please check: \fI\%http://libmemcached.org/\fP +.SH AUTHOR +.sp +Brian Aker, <\fI\%brian@tangent.org\fP> .SH SEE ALSO .sp -memcached(1) libmemcached(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memflush.1 b/docs/man/memflush.1 index b72d9250..7091285a 100644 --- a/docs/man/memflush.1 +++ b/docs/man/memflush.1 @@ -1,4 +1,4 @@ -.TH "MEMFLUSH" "1" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMFLUSH" "1" "July 21, 2011" "0.51" "libmemcached" .SH NAME memflush \- libmemcached Documentation . @@ -33,25 +33,31 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .sp Reset a server or list of servers .SH SYNOPSIS +.sp +memflush [options] +.SH DESCRIPTION +.sp +\fBmemflush\fP resets the contents of memcached(1) servers. +This means that all data in the specified servers will be deleted. +.SH OPTIONS +.sp +You can specify servers via the option: .INDENT 0.0 .TP -.B program -. -\fImemflush\fP +.B \-\-servers .UNINDENT +.sp +or via the environment variable: .INDENT 0.0 .TP -.B \-\-help +.B \(gaMEMCACHED_SERVERS\(ga .UNINDENT -.SH DESCRIPTION -.sp -\fBmemflush\fP resets the contents of memcached(1) servers. -This means that all data in the specified servers will be deleted. -.sp -You can specify servers via the \fB\-\-servers\fP option or via the -environment variable \fBMEMCACHED_SERVERS\fP. .sp -For a full list of operations run the tool with the \fB\-\-help\fP option. +For a full list of operations run the tool with option: +.INDENT 0.0 +.TP +.B \-\-help +.UNINDENT .SH HOME .sp To find out more information please check: @@ -63,7 +69,7 @@ Brian Aker, <\fI\%brian@tangent.org\fP> Mark Atwood <\fI\%mark@fallenpegasus.com\fP> .SH SEE ALSO .sp -memcached(1) libmemcached(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memrm.1 b/docs/man/memrm.1 index 0bab9b72..8d2e6c6f 100644 --- a/docs/man/memrm.1 +++ b/docs/man/memrm.1 @@ -1,4 +1,4 @@ -.TH "MEMRM" "1" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMRM" "1" "July 21, 2011" "0.51" "libmemcached" .SH NAME memrm \- libmemcached Documentation . @@ -33,24 +33,30 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .sp memrm \- Remove a key(s) from a collection of memcached servers .SH SYNOPSIS +.sp +memrm [options] [key] +.SH DESCRIPTION +.sp +\fBmemrm\fP removes items, specified by key, from memcached(1) servers. +.SH OPTIONS +.sp +You can specify servers via the option: .INDENT 0.0 .TP -.B program -. -\fImemrm\fP +.B \-\-servers .UNINDENT +.sp +or via the environment variable: .INDENT 0.0 .TP -.B \-\-help +.B \(gaMEMCACHED_SERVERS\(ga .UNINDENT -.SH DESCRIPTION -.sp -\fBmemrm\fP removes items, specified by key, from memcached(1) servers. .sp -You can specify servers via the \fB\-\-servers\fP option or via the -environment variable \fBMEMCACHED_SERVERS\fP. -.sp -For a full list of operations run the tool with the \fB\-\-help\fP option. +For a full list of operations run the tool with the +.INDENT 0.0 +.TP +.B \-\-help +.UNINDENT .SH HOME .sp To find out more information please check: @@ -62,7 +68,7 @@ Brian Aker, <\fI\%brian@tangent.org\fP> Mark Atwood, <\fI\%mark@fallenpegasus.com\fP> .SH SEE ALSO .sp -memcached(1) libmemcached(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT diff --git a/docs/man/memslap.1 b/docs/man/memslap.1 index b5b84308..f66e4fd1 100644 --- a/docs/man/memslap.1 +++ b/docs/man/memslap.1 @@ -1,4 +1,4 @@ -.TH "MEMSLAP" "1" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMSLAP" "1" "July 21, 2011" "0.51" "libmemcached" .SH NAME memslap \- libmemcached Documentation . @@ -31,22 +31,38 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" Man page generated from reStructeredText. . .SH SYNOPSIS +.sp +memslap [options] +.SH DESCRIPTION +.sp +\fBmemslap\fP is a load generation and benchmark tool for memcached(1) +servers. It generates configurable workload such as threads, concurrencies, connections, run time, overwrite, miss rate, key size, value size, get/set proportion, expected throughput, and so on. +.SH OPTIONS +.sp +You can specify servers via the option: .INDENT 0.0 .TP -.B program -. -\fImemslap\fP +.B \-\-servers +.UNINDENT +.sp +or via the environment variable: +.INDENT 0.0 +.TP +.B \(gaMEMCACHED_SERVERS\(ga .UNINDENT +.sp +For a full list of operations run the tool with: .INDENT 0.0 .TP .B \-\-help .UNINDENT -.SH DESCRIPTION +.SH HOME .sp -\fBmemslap\fP is a load generation and benchmark tool for memcached(1) -servers. It generates configurable workload such as threads, concurrencies, connections, run time, overwrite, miss rate, key size, value size, get/set proportion, expected throughput, and so on. +To find out more information please check: +\(aq\fI\%http://libmemcached.org/\fP <\fI\%http://libmemcached.org/\fP>\(aq_ +.SH AUTHOR .sp -You can specify servers via the \fB\-\-servers\fP option or via the environment variable \fBMEMCACHED_SERVERS\fP. +Brian Aker, <\fI\%brian@tangent.org\fP> .SH SEE ALSO .sp \fImemcached(1)\fP \fIlibmemcached(3)\fP diff --git a/docs/man/memstat.1 b/docs/man/memstat.1 index 21edde5a..7c197483 100644 --- a/docs/man/memstat.1 +++ b/docs/man/memstat.1 @@ -1,4 +1,4 @@ -.TH "MEMSTAT" "1" "June 17, 2011" "0.49" "libmemcached" +.TH "MEMSTAT" "1" "July 21, 2011" "0.51" "libmemcached" .SH NAME memstat \- libmemcached Documentation . @@ -33,34 +33,40 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .sp memstat \- Display the operating status of a single or group of memcached servers .SH SYNOPSIS +.sp +memstat [options] +.SH DESCRIPTION +.sp +\fBmemstat\fP dumps the state of memcached(1) servers. +It displays all data to stdout. +.SH OPTIONS +.sp +You can specify servers via the option: .INDENT 0.0 .TP -.B program -. -\fImemstat\fP +.B \-\-servers .UNINDENT +.sp +or via the environment variable: .INDENT 0.0 .TP -.B \-\-help +.B \(aqMEMCACHED_SERVERS, \-\-args\(aq .UNINDENT -.SH DESCRIPTION -.sp -\fBmemstat\fP dumps the state of memcached(1) servers. -It displays all data to stdout. .sp -You can specify servers via the \fB\-\-servers\fP option or via the -environment variable \fBMEMCACHED_SERVERS\fP. \fB\-\-args\fP can be used -to specify the "argument" sent to the stats command (ie slab, size, items, -etc..). +which can be used to specify the "argument" sent to the stats command (ie slab, size, items, etc..). .sp -For a full list of operations run the tool with the \fB\-\-help\fP option. +For a full list of operations run the tool with: +.INDENT 0.0 +.TP +.B \-\-help +.UNINDENT .SH HOME .sp To find out more information please check: \fI\%http://libmemcached.org/\fP .SH SEE ALSO .sp -memcached(1) libmemcached(3) +\fImemcached(1)\fP \fIlibmemcached(3)\fP .SH AUTHOR Brian Aker .SH COPYRIGHT -- 2.30.2