From: brian@tangent.org <> Date: Mon, 11 Apr 2011 05:22:20 +0000 (-0700) Subject: Merge in laptops efforts for extending pool/documenting more of it. X-Git-Tag: 0.51~15^2~5 X-Git-Url: https://git.m6w6.name/?a=commitdiff_plain;h=2e5705daa52faa457f104864a27cfbba98ed568e;p=awesomized%2Flibmemcached Merge in laptops efforts for extending pool/documenting more of it. --- diff --git a/docs/conf.py b/docs/conf.py index d4cd9f9c..47025e4b 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -270,6 +270,7 @@ man_pages = [ ('memcached_memory_allocators', 'memcached_set_memory_allocators', u'libmemcached Documentation', [u'Brian Aker'], 3), ('memcached_memory_allocators', 'memcached_set_memory_allocators_context', u'libmemcached Documentation', [u'Brian Aker'], 3), ('memcached_pool', 'memcached_pool', u'libmemcached Documentation', [u'Brian Aker'], 3), + ('memcached_pool', 'memcached_pool_st', u'libmemcached Documentation', [u'Brian Aker'], 3), ('memcached_pool', 'memcached_pool_behavior_get', u'libmemcached Documentation', [u'Brian Aker'], 3), ('memcached_pool', 'memcached_pool_behavior_set', u'libmemcached Documentation', [u'Brian Aker'], 3), ('memcached_pool', 'memcached_pool_create', u'libmemcached Documentation', [u'Brian Aker'], 3), diff --git a/docs/include.am b/docs/include.am index 28cea239..3d6871c8 100644 --- a/docs/include.am +++ b/docs/include.am @@ -130,6 +130,7 @@ man_MANS+= \ docs/man/memcached_pool_destroy.3 \ docs/man/memcached_pool_pop.3 \ docs/man/memcached_pool_push.3 \ + docs/man/memcached_pool_st.3 \ docs/man/memcached_prepend.3 \ docs/man/memcached_prepend_by_key.3 \ docs/man/memcached_quit.3 \ diff --git a/docs/index.rst b/docs/index.rst index 00a437d8..f41089c8 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -6,36 +6,68 @@ Welcome to the libmemcached documentation Libmemcached ------------ + +###### +Basics +###### + + .. toctree:: :maxdepth: 1 libmemcached + memcached_create libmemcached_examples libmemcached_configuration - memcached_analyze + + +################# +Working with data +################# + +.. toctree:: + :maxdepth: 1 + memcached_auto - memcached_behavior - memcached_callback - memcached_create memcached_delete - memcached_dump memcached_flush_buffers memcached_flush - memcached_generate_hash_value memcached_get + memcached_result_st + memcached_set + + +############### +Advanced Topics +############### + +.. toctree:: + :maxdepth: 1 + + memcached_behavior + memcached_callback + memcached_dump + memcached_generate_hash_value memcached_memory_allocators memcached_quit - memcached_result_st memcached_sasl - memcached_servers memcached_server_st - memcached_set - memcached_stats + memcached_servers memcached_strerror memcached_user_data memcached_verbosity memcached_version +################################# +Deriving statistics from a server +################################# + +.. toctree:: + :maxdepth: 1 + + memcached_analyze + memcached_stats + ---------------- Libmemcachedutil ---------------- @@ -76,6 +108,7 @@ Libhashkit hashkit_functions hashkit_value +================== Indices and tables ================== diff --git a/docs/libmemcached_examples.rst b/docs/libmemcached_examples.rst index 922ee143..5c3acf6a 100644 --- a/docs/libmemcached_examples.rst +++ b/docs/libmemcached_examples.rst @@ -13,9 +13,9 @@ For full examples, test cases are found in tests/\*.c in the main distribution. These are always up to date, and are used for each test run of the library. ------------------------------- -Creating and Freeing structure ------------------------------- +----------------------------------------------- +Creating and Freeing the memcached_st structure +----------------------------------------------- .. code-block:: c @@ -51,6 +51,43 @@ Connecting to servers In the above code you create a \ ``memcached_st``\ object with three server by making use of :manpage:`memcached_create_with_options(3)`. +-------------------------- +Creating a pool of servers +-------------------------- + + + +.. code-block:: 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)); + + memcached_return_t rc; + + memcached_st *memc= memcached_pool_pop(pool, false, &rc); + + .... do work + + /* + Release the memc_ptr that was pulled from the pool + */ + memcached_pool_push(pool, memc); + + /* + Destroy the pool. + */ + memcached_pool_destroy(pool); + + + +In the above code you create a \ ``memcached_pool_st``\ object with three +server by making use of :manpage:`memcached_pool(3)`. + +When memcached_pool_destroy() all memory will be released that is associated +with the pool. + + ---------------------------- Adding a value to the server ---------------------------- diff --git a/docs/man/hashkit_clone.3 b/docs/man/hashkit_clone.3 index cd2bf026..6673c775 100644 --- a/docs/man/hashkit_clone.3 +++ b/docs/man/hashkit_clone.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_CLONE" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "HASHKIT_CLONE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME hashkit_clone \- libhashkit Documentation . diff --git a/docs/man/hashkit_crc32.3 b/docs/man/hashkit_crc32.3 index cd6ee8c1..8b0feb5b 100644 --- a/docs/man/hashkit_crc32.3 +++ b/docs/man/hashkit_crc32.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_CRC32" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "HASHKIT_CRC32" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME hashkit_crc32 \- libhashkit Documentation . diff --git a/docs/man/hashkit_create.3 b/docs/man/hashkit_create.3 index b3f78c63..ec8da320 100644 --- a/docs/man/hashkit_create.3 +++ b/docs/man/hashkit_create.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_CREATE" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "HASHKIT_CREATE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME hashkit_create \- libhashkit Documentation . diff --git a/docs/man/hashkit_fnv1_32.3 b/docs/man/hashkit_fnv1_32.3 index 6ca49830..44480c6b 100644 --- a/docs/man/hashkit_fnv1_32.3 +++ b/docs/man/hashkit_fnv1_32.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_FNV1_32" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "HASHKIT_FNV1_32" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME hashkit_fnv1_32 \- libhashkit Documentation . diff --git a/docs/man/hashkit_fnv1_64.3 b/docs/man/hashkit_fnv1_64.3 index 3112bea0..8a57e5e5 100644 --- a/docs/man/hashkit_fnv1_64.3 +++ b/docs/man/hashkit_fnv1_64.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_FNV1_64" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "HASHKIT_FNV1_64" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME hashkit_fnv1_64 \- libhashkit Documentation . diff --git a/docs/man/hashkit_fnv1a_32.3 b/docs/man/hashkit_fnv1a_32.3 index 0e1fb593..d3366497 100644 --- a/docs/man/hashkit_fnv1a_32.3 +++ b/docs/man/hashkit_fnv1a_32.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_FNV1A_32" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "HASHKIT_FNV1A_32" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME hashkit_fnv1a_32 \- libhashkit Documentation . diff --git a/docs/man/hashkit_fnv1a_64.3 b/docs/man/hashkit_fnv1a_64.3 index 3cbc785c..c06e5264 100644 --- a/docs/man/hashkit_fnv1a_64.3 +++ b/docs/man/hashkit_fnv1a_64.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_FNV1A_64" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "HASHKIT_FNV1A_64" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME hashkit_fnv1a_64 \- libhashkit Documentation . diff --git a/docs/man/hashkit_free.3 b/docs/man/hashkit_free.3 index 0c072cf2..81fe571b 100644 --- a/docs/man/hashkit_free.3 +++ b/docs/man/hashkit_free.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_FREE" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "HASHKIT_FREE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME hashkit_free \- libhashkit Documentation . diff --git a/docs/man/hashkit_functions.3 b/docs/man/hashkit_functions.3 index c0386cbc..02223420 100644 --- a/docs/man/hashkit_functions.3 +++ b/docs/man/hashkit_functions.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_FUNCTIONS" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "HASHKIT_FUNCTIONS" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME hashkit_functions \- libhashkit Documentation . diff --git a/docs/man/hashkit_hsieh.3 b/docs/man/hashkit_hsieh.3 index 9815ff0e..30d62544 100644 --- a/docs/man/hashkit_hsieh.3 +++ b/docs/man/hashkit_hsieh.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_HSIEH" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "HASHKIT_HSIEH" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME hashkit_hsieh \- libhashkit Documentation . diff --git a/docs/man/hashkit_is_allocated.3 b/docs/man/hashkit_is_allocated.3 index 9b556f8d..3c40e2df 100644 --- a/docs/man/hashkit_is_allocated.3 +++ b/docs/man/hashkit_is_allocated.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_IS_ALLOCATED" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "HASHKIT_IS_ALLOCATED" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME hashkit_is_allocated \- libhashkit Documentation . diff --git a/docs/man/hashkit_jenkins.3 b/docs/man/hashkit_jenkins.3 index 7096ff65..04743a17 100644 --- a/docs/man/hashkit_jenkins.3 +++ b/docs/man/hashkit_jenkins.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_JENKINS" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "HASHKIT_JENKINS" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME hashkit_jenkins \- libhashkit Documentation . diff --git a/docs/man/hashkit_md5.3 b/docs/man/hashkit_md5.3 index 21b278ae..ac40f8b5 100644 --- a/docs/man/hashkit_md5.3 +++ b/docs/man/hashkit_md5.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_MD5" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "HASHKIT_MD5" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME hashkit_md5 \- libhashkit Documentation . diff --git a/docs/man/hashkit_murmur.3 b/docs/man/hashkit_murmur.3 index 966707b5..1ceba0e0 100644 --- a/docs/man/hashkit_murmur.3 +++ b/docs/man/hashkit_murmur.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_MURMUR" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "HASHKIT_MURMUR" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME hashkit_murmur \- libhashkit Documentation . diff --git a/docs/man/hashkit_value.3 b/docs/man/hashkit_value.3 index 8893b0bc..f4039f96 100644 --- a/docs/man/hashkit_value.3 +++ b/docs/man/hashkit_value.3 @@ -1,4 +1,4 @@ -.TH "HASHKIT_VALUE" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "HASHKIT_VALUE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME hashkit_value \- libhashkit Documentation . diff --git a/docs/man/libhashkit.3 b/docs/man/libhashkit.3 index cb735062..1c86053b 100644 --- a/docs/man/libhashkit.3 +++ b/docs/man/libhashkit.3 @@ -1,4 +1,4 @@ -.TH "LIBHASHKIT" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "LIBHASHKIT" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME libhashkit \- libhashkit Documentation . diff --git a/docs/man/libmemcached.3 b/docs/man/libmemcached.3 index d70d225c..7b11fcf7 100644 --- a/docs/man/libmemcached.3 +++ b/docs/man/libmemcached.3 @@ -1,4 +1,4 @@ -.TH "LIBMEMCACHED" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "LIBMEMCACHED" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME libmemcached \- Introducing the C Client Library for memcached . diff --git a/docs/man/libmemcached_check_configuration.3 b/docs/man/libmemcached_check_configuration.3 index c5a81dfb..7c222811 100644 --- a/docs/man/libmemcached_check_configuration.3 +++ b/docs/man/libmemcached_check_configuration.3 @@ -1,4 +1,4 @@ -.TH "LIBMEMCACHED_CHECK_CONFIGURATION" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "LIBMEMCACHED_CHECK_CONFIGURATION" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME libmemcached_check_configuration \- libmemcached Documentation . diff --git a/docs/man/libmemcached_configuration.3 b/docs/man/libmemcached_configuration.3 index dac97b93..3fa476ea 100644 --- a/docs/man/libmemcached_configuration.3 +++ b/docs/man/libmemcached_configuration.3 @@ -1,4 +1,4 @@ -.TH "LIBMEMCACHED_CONFIGURATION" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "LIBMEMCACHED_CONFIGURATION" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME libmemcached_configuration \- libmemcached Documentation . diff --git a/docs/man/libmemcached_examples.3 b/docs/man/libmemcached_examples.3 index d274724c..c650f58b 100644 --- a/docs/man/libmemcached_examples.3 +++ b/docs/man/libmemcached_examples.3 @@ -1,4 +1,4 @@ -.TH "LIBMEMCACHED_EXAMPLES" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "LIBMEMCACHED_EXAMPLES" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME libmemcached_examples \- libmemcached Documentation . @@ -37,7 +37,7 @@ Examples for libmemcached For full examples, test cases are found in tests/*.c in the main distribution. These are always up to date, and are used for each test run of the library. -.SH CREATING AND FREEING STRUCTURE +.SH CREATING AND FREEING THE MEMCACHED_ST STRUCTURE .sp .nf .ft C @@ -66,6 +66,37 @@ memcached_free(memc); .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. +.SH 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)); + +memcached_return_t rc; + +memcached_st *memc= memcached_pool_pop(pool, false, &rc); + +\&.... do work + +/* + Release the memc_ptr that was pulled from the pool +*/ +memcached_pool_push(pool, memc); + +/* + Destroy the pool. +*/ +memcached_pool_destroy(pool); +.ft P +.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. +.sp +When memcached_pool_destroy() all memory will be released that is associated +with the pool. .SH ADDING A VALUE TO THE SERVER .sp .nf diff --git a/docs/man/libmemcachedutil.3 b/docs/man/libmemcachedutil.3 index ca993e1b..4a12d0d5 100644 --- a/docs/man/libmemcachedutil.3 +++ b/docs/man/libmemcachedutil.3 @@ -1,4 +1,4 @@ -.TH "LIBMEMCACHEDUTIL" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "LIBMEMCACHEDUTIL" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME libmemcachedutil \- libmemcached Documentation . diff --git a/docs/man/memaslap.1 b/docs/man/memaslap.1 index ca4926a6..1709e40a 100644 --- a/docs/man/memaslap.1 +++ b/docs/man/memaslap.1 @@ -1,4 +1,4 @@ -.TH "MEMASLAP" "1" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMASLAP" "1" "April 10, 2011" "0.47" "libmemcached" .SH NAME memaslap \- libmemcached Documentation . @@ -31,6 +31,8 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" Man page generated from reStructeredText. . .SH SYNOPSIS +.sp +:program:: \fImemaslap\fP .INDENT 0.0 .TP .B \-\-help diff --git a/docs/man/memcached_add.3 b/docs/man/memcached_add.3 index 17ecbe0b..64df8e2a 100644 --- a/docs/man/memcached_add.3 +++ b/docs/man/memcached_add.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_ADD" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_ADD" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_add \- Storing and Replacing Data . diff --git a/docs/man/memcached_add_by_key.3 b/docs/man/memcached_add_by_key.3 index b1331717..4b3e1f03 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_ADD_BY_KEY" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_add_by_key \- Storing and Replacing Data . diff --git a/docs/man/memcached_analyze.3 b/docs/man/memcached_analyze.3 index 68cbec46..f3e66af5 100644 --- a/docs/man/memcached_analyze.3 +++ b/docs/man/memcached_analyze.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_ANALYZE" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_ANALYZE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_analyze \- libmemcached Documentation . diff --git a/docs/man/memcached_append.3 b/docs/man/memcached_append.3 index 4da04b80..f804fbcb 100644 --- a/docs/man/memcached_append.3 +++ b/docs/man/memcached_append.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_APPEND" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_APPEND" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_append \- Storing and Replacing Data . diff --git a/docs/man/memcached_append_by_key.3 b/docs/man/memcached_append_by_key.3 index b51fdce8..04f63177 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_APPEND_BY_KEY" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_append_by_key \- Storing and Replacing Data . diff --git a/docs/man/memcached_auto.3 b/docs/man/memcached_auto.3 index 39530a28..1fb40191 100644 --- a/docs/man/memcached_auto.3 +++ b/docs/man/memcached_auto.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_AUTO" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_AUTO" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_auto \- Incrementing and Decrementing Values . diff --git a/docs/man/memcached_behavior.3 b/docs/man/memcached_behavior.3 index 826497fe..41c14ced 100644 --- a/docs/man/memcached_behavior.3 +++ b/docs/man/memcached_behavior.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_BEHAVIOR" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_BEHAVIOR" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_behavior \- libmemcached Documentation . diff --git a/docs/man/memcached_behavior_get.3 b/docs/man/memcached_behavior_get.3 index 9b39d56d..4f04c4e3 100644 --- a/docs/man/memcached_behavior_get.3 +++ b/docs/man/memcached_behavior_get.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_BEHAVIOR_GET" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_BEHAVIOR_GET" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_behavior_get \- libmemcached Documentation . diff --git a/docs/man/memcached_behavior_set.3 b/docs/man/memcached_behavior_set.3 index 57574fa1..cfb7ae68 100644 --- a/docs/man/memcached_behavior_set.3 +++ b/docs/man/memcached_behavior_set.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_BEHAVIOR_SET" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_BEHAVIOR_SET" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_behavior_set \- libmemcached Documentation . diff --git a/docs/man/memcached_callback.3 b/docs/man/memcached_callback.3 index 6b3c13a5..003ea6b4 100644 --- a/docs/man/memcached_callback.3 +++ b/docs/man/memcached_callback.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_CALLBACK" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_CALLBACK" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_callback \- libmemcached Documentation . diff --git a/docs/man/memcached_callback_get.3 b/docs/man/memcached_callback_get.3 index df265fb9..a0de8f74 100644 --- a/docs/man/memcached_callback_get.3 +++ b/docs/man/memcached_callback_get.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_CALLBACK_GET" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_CALLBACK_GET" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_callback_get \- libmemcached Documentation . diff --git a/docs/man/memcached_callback_set.3 b/docs/man/memcached_callback_set.3 index fa5c0c9c..ca1eea70 100644 --- a/docs/man/memcached_callback_set.3 +++ b/docs/man/memcached_callback_set.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_CALLBACK_SET" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_CALLBACK_SET" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_callback_set \- libmemcached Documentation . diff --git a/docs/man/memcached_cas.3 b/docs/man/memcached_cas.3 index 48d9ca3b..82daae3e 100644 --- a/docs/man/memcached_cas.3 +++ b/docs/man/memcached_cas.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_CAS" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_CAS" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_cas \- Storing and Replacing Data . diff --git a/docs/man/memcached_cas_by_key.3 b/docs/man/memcached_cas_by_key.3 index c7288165..56a8e21c 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_CAS_BY_KEY" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_cas_by_key \- Storing and Replacing Data . diff --git a/docs/man/memcached_clone.3 b/docs/man/memcached_clone.3 index 798e6d8c..41445408 100644 --- a/docs/man/memcached_clone.3 +++ b/docs/man/memcached_clone.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_CLONE" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_CLONE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_clone \- libmemcached Documentation . diff --git a/docs/man/memcached_create.3 b/docs/man/memcached_create.3 index 601175a6..79b26859 100644 --- a/docs/man/memcached_create.3 +++ b/docs/man/memcached_create.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_CREATE" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_CREATE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_create \- libmemcached Documentation . diff --git a/docs/man/memcached_create_with_options.3 b/docs/man/memcached_create_with_options.3 index eac57824..b3c7ecbd 100644 --- a/docs/man/memcached_create_with_options.3 +++ b/docs/man/memcached_create_with_options.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_CREATE_WITH_OPTIONS" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_CREATE_WITH_OPTIONS" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_create_with_options \- libmemcached Documentation . diff --git a/docs/man/memcached_decrement.3 b/docs/man/memcached_decrement.3 index e6b8b69d..0384c801 100644 --- a/docs/man/memcached_decrement.3 +++ b/docs/man/memcached_decrement.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_DECREMENT" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_DECREMENT" "3" "April 10, 2011" "0.47" "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 4ce2deb8..744977b1 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_DECREMENT_WITH_INITIAL" "3" "April 10, 2011" "0.47" "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 2e715437..86dad7d9 100644 --- a/docs/man/memcached_delete.3 +++ b/docs/man/memcached_delete.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_DELETE" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_DELETE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_delete \- libmemcached Documentation . diff --git a/docs/man/memcached_delete_by_key.3 b/docs/man/memcached_delete_by_key.3 index ac8c46e8..5230363d 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_DELETE_BY_KEY" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_delete_by_key \- libmemcached Documentation . diff --git a/docs/man/memcached_destroy_sasl_auth_data.3 b/docs/man/memcached_destroy_sasl_auth_data.3 index f7a8c32c..cd9bdd75 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_DESTROY_SASL_AUTH_DATA" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_destroy_sasl_auth_data \- libmemcached Documentation . diff --git a/docs/man/memcached_dump.3 b/docs/man/memcached_dump.3 index 0b82f273..a93a5c43 100644 --- a/docs/man/memcached_dump.3 +++ b/docs/man/memcached_dump.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_DUMP" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_DUMP" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_dump \- libmemcached Documentation . diff --git a/docs/man/memcached_fetch.3 b/docs/man/memcached_fetch.3 index f0ce0087..fda2c578 100644 --- a/docs/man/memcached_fetch.3 +++ b/docs/man/memcached_fetch.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_FETCH" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_FETCH" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_fetch \- Retrieving data from the server . diff --git a/docs/man/memcached_fetch_execute.3 b/docs/man/memcached_fetch_execute.3 index 132cbb81..27e2e0a7 100644 --- a/docs/man/memcached_fetch_execute.3 +++ b/docs/man/memcached_fetch_execute.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_FETCH_EXECUTE" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_FETCH_EXECUTE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_fetch_execute \- Retrieving data from the server . diff --git a/docs/man/memcached_fetch_result.3 b/docs/man/memcached_fetch_result.3 index e7cdf56d..7e2279c3 100644 --- a/docs/man/memcached_fetch_result.3 +++ b/docs/man/memcached_fetch_result.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_FETCH_RESULT" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_FETCH_RESULT" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_fetch_result \- Retrieving data from the server . diff --git a/docs/man/memcached_flush.3 b/docs/man/memcached_flush.3 index 0535097a..a1904dd0 100644 --- a/docs/man/memcached_flush.3 +++ b/docs/man/memcached_flush.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_FLUSH" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_FLUSH" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_flush \- libmemcached Documentation . diff --git a/docs/man/memcached_flush_buffers.3 b/docs/man/memcached_flush_buffers.3 index 1b0446ef..29954839 100644 --- a/docs/man/memcached_flush_buffers.3 +++ b/docs/man/memcached_flush_buffers.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_FLUSH_BUFFERS" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_FLUSH_BUFFERS" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_flush_buffers \- libmemcached Documentation . diff --git a/docs/man/memcached_free.3 b/docs/man/memcached_free.3 index ddf508af..5fe91691 100644 --- a/docs/man/memcached_free.3 +++ b/docs/man/memcached_free.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_FREE" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_FREE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_free \- libmemcached Documentation . diff --git a/docs/man/memcached_generate_hash.3 b/docs/man/memcached_generate_hash.3 index 3c81b38c..4db0f232 100644 --- a/docs/man/memcached_generate_hash.3 +++ b/docs/man/memcached_generate_hash.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_GENERATE_HASH" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_GENERATE_HASH" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_generate_hash \- Generating hash values directly . diff --git a/docs/man/memcached_generate_hash_value.3 b/docs/man/memcached_generate_hash_value.3 index d047f5d0..e6460d6f 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_GENERATE_HASH_VALUE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_generate_hash_value \- Generating hash values directly . diff --git a/docs/man/memcached_get.3 b/docs/man/memcached_get.3 index 88aaa6f7..8dc91f4b 100644 --- a/docs/man/memcached_get.3 +++ b/docs/man/memcached_get.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_GET" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_GET" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_get \- Retrieving data from the server . diff --git a/docs/man/memcached_get_by_key.3 b/docs/man/memcached_get_by_key.3 index 147131bf..d9e18a7d 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_GET_BY_KEY" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_get_by_key \- Retrieving data from the server . diff --git a/docs/man/memcached_get_memory_allocators.3 b/docs/man/memcached_get_memory_allocators.3 index f68a5265..b76371bf 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_GET_MEMORY_ALLOCATORS" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_get_memory_allocators \- libmemcached Documentation . diff --git a/docs/man/memcached_get_sasl_callbacks.3 b/docs/man/memcached_get_sasl_callbacks.3 index fdbf6b77..8fa5fcc5 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_GET_SASL_CALLBACKS" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_get_sasl_callbacks \- libmemcached Documentation . diff --git a/docs/man/memcached_get_user_data.3 b/docs/man/memcached_get_user_data.3 index 487b5336..9a3f7218 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_GET_USER_DATA" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_get_user_data \- libmemcached Documentation . diff --git a/docs/man/memcached_increment.3 b/docs/man/memcached_increment.3 index e81aa2e3..b87a5344 100644 --- a/docs/man/memcached_increment.3 +++ b/docs/man/memcached_increment.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_INCREMENT" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_INCREMENT" "3" "April 10, 2011" "0.47" "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 c8a9ad48..c3a9781b 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_INCREMENT_WITH_INITIAL" "3" "April 10, 2011" "0.47" "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 ed8817d6..3c4897e0 100644 --- a/docs/man/memcached_lib_version.3 +++ b/docs/man/memcached_lib_version.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_LIB_VERSION" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_LIB_VERSION" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_lib_version \- libmemcached Documentation . diff --git a/docs/man/memcached_memory_allocators.3 b/docs/man/memcached_memory_allocators.3 index 4ee5ede4..cae0255b 100644 --- a/docs/man/memcached_memory_allocators.3 +++ b/docs/man/memcached_memory_allocators.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_MEMORY_ALLOCATORS" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_MEMORY_ALLOCATORS" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_memory_allocators \- libmemcached Documentation . diff --git a/docs/man/memcached_mget.3 b/docs/man/memcached_mget.3 index 8f4f7d31..4ff59a3b 100644 --- a/docs/man/memcached_mget.3 +++ b/docs/man/memcached_mget.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_MGET" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_MGET" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_mget \- Retrieving data from the server . diff --git a/docs/man/memcached_mget_by_key.3 b/docs/man/memcached_mget_by_key.3 index 2457318b..23238a7e 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_MGET_BY_KEY" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_mget_by_key \- Retrieving data from the server . diff --git a/docs/man/memcached_mget_execute.3 b/docs/man/memcached_mget_execute.3 index 62c92bfc..80e9acff 100644 --- a/docs/man/memcached_mget_execute.3 +++ b/docs/man/memcached_mget_execute.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_MGET_EXECUTE" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_MGET_EXECUTE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_mget_execute \- Retrieving data from the server . diff --git a/docs/man/memcached_mget_execute_by_key.3 b/docs/man/memcached_mget_execute_by_key.3 index 653e206c..fddf37e3 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_MGET_EXECUTE_BY_KEY" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_mget_execute_by_key \- Retrieving data from the server . diff --git a/docs/man/memcached_pool.3 b/docs/man/memcached_pool.3 index 350f43cd..24a698c0 100644 --- a/docs/man/memcached_pool.3 +++ b/docs/man/memcached_pool.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_POOL" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_POOL" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_pool \- libmemcached Documentation . @@ -35,7 +35,11 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); +.B memcached_pool_st *memcached_pool(const char *option_string, size_t option_string_length); +.UNINDENT +.INDENT 0.0 +.TP +.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); DEPRECATED .UNINDENT .INDENT 0.0 .TP @@ -65,22 +69,28 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -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\fP objects. The mmc argument should be an -initialised \fBmemcached_st\fP structure, 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. +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 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. +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.. .sp memcached_pool_pop() is used to grab a connection structure from the connection pool. The block argument specifies if the function should diff --git a/docs/man/memcached_pool_behavior_get.3 b/docs/man/memcached_pool_behavior_get.3 index 15f16cfb..6b1aeca8 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_POOL_BEHAVIOR_GET" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_pool_behavior_get \- libmemcached Documentation . @@ -35,7 +35,11 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); +.B memcached_pool_st *memcached_pool(const char *option_string, size_t option_string_length); +.UNINDENT +.INDENT 0.0 +.TP +.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); DEPRECATED .UNINDENT .INDENT 0.0 .TP @@ -65,22 +69,28 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -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\fP objects. The mmc argument should be an -initialised \fBmemcached_st\fP structure, 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. +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 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. +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.. .sp memcached_pool_pop() is used to grab a connection structure from the connection pool. The block argument specifies if the function should diff --git a/docs/man/memcached_pool_behavior_set.3 b/docs/man/memcached_pool_behavior_set.3 index b4667c6c..e4928ea9 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_POOL_BEHAVIOR_SET" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_pool_behavior_set \- libmemcached Documentation . @@ -35,7 +35,11 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); +.B memcached_pool_st *memcached_pool(const char *option_string, size_t option_string_length); +.UNINDENT +.INDENT 0.0 +.TP +.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); DEPRECATED .UNINDENT .INDENT 0.0 .TP @@ -65,22 +69,28 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -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\fP objects. The mmc argument should be an -initialised \fBmemcached_st\fP structure, 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. +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 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. +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.. .sp memcached_pool_pop() is used to grab a connection structure from the connection pool. The block argument specifies if the function should diff --git a/docs/man/memcached_pool_create.3 b/docs/man/memcached_pool_create.3 index 7e3538e3..a869f738 100644 --- a/docs/man/memcached_pool_create.3 +++ b/docs/man/memcached_pool_create.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_POOL_CREATE" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_POOL_CREATE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_pool_create \- libmemcached Documentation . @@ -35,7 +35,11 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); +.B memcached_pool_st *memcached_pool(const char *option_string, size_t option_string_length); +.UNINDENT +.INDENT 0.0 +.TP +.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); DEPRECATED .UNINDENT .INDENT 0.0 .TP @@ -65,22 +69,28 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -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\fP objects. The mmc argument should be an -initialised \fBmemcached_st\fP structure, 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. +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 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. +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.. .sp memcached_pool_pop() is used to grab a connection structure from the connection pool. The block argument specifies if the function should diff --git a/docs/man/memcached_pool_destroy.3 b/docs/man/memcached_pool_destroy.3 index c874b6f9..6fd65125 100644 --- a/docs/man/memcached_pool_destroy.3 +++ b/docs/man/memcached_pool_destroy.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_POOL_DESTROY" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_POOL_DESTROY" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_pool_destroy \- libmemcached Documentation . @@ -35,7 +35,11 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); +.B memcached_pool_st *memcached_pool(const char *option_string, size_t option_string_length); +.UNINDENT +.INDENT 0.0 +.TP +.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); DEPRECATED .UNINDENT .INDENT 0.0 .TP @@ -65,22 +69,28 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -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\fP objects. The mmc argument should be an -initialised \fBmemcached_st\fP structure, 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. +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 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. +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.. .sp memcached_pool_pop() is used to grab a connection structure from the connection pool. The block argument specifies if the function should diff --git a/docs/man/memcached_pool_pop.3 b/docs/man/memcached_pool_pop.3 index cb294d0f..621e54ad 100644 --- a/docs/man/memcached_pool_pop.3 +++ b/docs/man/memcached_pool_pop.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_POOL_POP" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_POOL_POP" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_pool_pop \- libmemcached Documentation . @@ -35,7 +35,11 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); +.B memcached_pool_st *memcached_pool(const char *option_string, size_t option_string_length); +.UNINDENT +.INDENT 0.0 +.TP +.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); DEPRECATED .UNINDENT .INDENT 0.0 .TP @@ -65,22 +69,28 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -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\fP objects. The mmc argument should be an -initialised \fBmemcached_st\fP structure, 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. +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 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. +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.. .sp memcached_pool_pop() is used to grab a connection structure from the connection pool. The block argument specifies if the function should diff --git a/docs/man/memcached_pool_push.3 b/docs/man/memcached_pool_push.3 index 64d70c6e..8131a1dc 100644 --- a/docs/man/memcached_pool_push.3 +++ b/docs/man/memcached_pool_push.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_POOL_PUSH" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_POOL_PUSH" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_pool_push \- libmemcached Documentation . @@ -35,7 +35,11 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] #include .INDENT 0.0 .TP -.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); +.B memcached_pool_st *memcached_pool(const char *option_string, size_t option_string_length); +.UNINDENT +.INDENT 0.0 +.TP +.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); DEPRECATED .UNINDENT .INDENT 0.0 .TP @@ -65,22 +69,28 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] Compile and link with \-lmemcachedutil \-lmemcached .SH DESCRIPTION .sp -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\fP objects. The mmc argument should be an -initialised \fBmemcached_st\fP structure, 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. +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 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. +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.. .sp memcached_pool_pop() is used to grab a connection structure from the connection pool. The block argument specifies if the function should diff --git a/docs/man/memcached_pool_st.3 b/docs/man/memcached_pool_st.3 new file mode 100644 index 00000000..edd5a9f0 --- /dev/null +++ b/docs/man/memcached_pool_st.3 @@ -0,0 +1,139 @@ +.TH "MEMCACHED_POOL_ST" "3" "April 10, 2011" "0.47" "libmemcached" +.SH NAME +memcached_pool_st \- libmemcached Documentation +. +.nr rst2man-indent-level 0 +. +.de1 rstReportMargin +\\$1 \\n[an-margin] +level \\n[rst2man-indent-level] +level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] +- +\\n[rst2man-indent0] +\\n[rst2man-indent1] +\\n[rst2man-indent2] +.. +.de1 INDENT +.\" .rstReportMargin pre: +. RS \\$1 +. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] +. nr rst2man-indent-level +1 +.\" .rstReportMargin post: +.. +.de UNINDENT +. RE +.\" indent \\n[an-margin] +.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] +.nr rst2man-indent-level -1 +.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] +.in \\n[rst2man-indent\\n[rst2man-indent-level]]u +.. +.\" Man page generated from reStructeredText. +. +.SH SYNOPSIS +.sp +#include +.INDENT 0.0 +.TP +.B memcached_pool_st *memcached_pool(const char *option_string, size_t option_string_length); +.UNINDENT +.INDENT 0.0 +.TP +.B memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); DEPRECATED +.UNINDENT +.INDENT 0.0 +.TP +.B memcached_st * memcached_pool_destroy(memcached_pool_st* pool); +.UNINDENT +.INDENT 0.0 +.TP +.B memcached_st * memcached_pool_pop (memcached_pool_st* pool, bool block, memcached_return_t *rc); +.UNINDENT +.INDENT 0.0 +.TP +.B memcached_return_t memcached_pool_push(memcached_pool_st* pool, memcached_st *mmc); +.UNINDENT +.INDENT 0.0 +.TP +.B memcached_st *memcached_create (memcached_st *ptr); +.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) +.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) +.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 +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.. +.sp +memcached_pool_pop() 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. +.sp +memcached_pool_behavior_set() and memcached_pool_behagior_get() 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. +.sp +memcached_pool_pop() returns a pointer to a memcached_st structure +from the pool (or NULL if an allocation cannot be satisfied). +.sp +memcached_pool_push() returns MEMCACHED_SUCCESS upon success. +.sp +memcached_pool_behavior_get() and memcached_pool_behavior_get() +returns MEMCACHED_SUCCESS upon success. +.SH HOME +.sp +To find out more information please check: +\fI\%https://launchpad.net/libmemcached\fP +.SH AUTHOR +.sp +Brian Aker, <\fI\%brian@tangent.org\fP> +.sp +Trond Norbye, <\fI\%trond.norbye@gmail.com\fP> +.SH SEE ALSO +.sp +\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP +.SH AUTHOR +Brian Aker +.SH COPYRIGHT +2011, Brian Aker DataDifferential, http://datadifferential.com/ +.\" Generated by docutils manpage writer. +.\" +. diff --git a/docs/man/memcached_prepend.3 b/docs/man/memcached_prepend.3 index 4aa5f87d..5bc859e5 100644 --- a/docs/man/memcached_prepend.3 +++ b/docs/man/memcached_prepend.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_PREPEND" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_PREPEND" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_prepend \- Storing and Replacing Data . diff --git a/docs/man/memcached_prepend_by_key.3 b/docs/man/memcached_prepend_by_key.3 index d310a8d9..c55eddba 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_PREPEND_BY_KEY" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_prepend_by_key \- Storing and Replacing Data . diff --git a/docs/man/memcached_quit.3 b/docs/man/memcached_quit.3 index c0a4f8c1..0f78e613 100644 --- a/docs/man/memcached_quit.3 +++ b/docs/man/memcached_quit.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_QUIT" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_QUIT" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_quit \- libmemcached Documentation . diff --git a/docs/man/memcached_replace.3 b/docs/man/memcached_replace.3 index 3b359afb..b4aa226e 100644 --- a/docs/man/memcached_replace.3 +++ b/docs/man/memcached_replace.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_REPLACE" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_REPLACE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_replace \- Storing and Replacing Data . diff --git a/docs/man/memcached_replace_by_key.3 b/docs/man/memcached_replace_by_key.3 index fc3f37ae..8a50dbd6 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_REPLACE_BY_KEY" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_replace_by_key \- Storing and Replacing Data . diff --git a/docs/man/memcached_result_cas.3 b/docs/man/memcached_result_cas.3 index 5c79c7b9..445ab8d6 100644 --- a/docs/man/memcached_result_cas.3 +++ b/docs/man/memcached_result_cas.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_RESULT_CAS" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_RESULT_CAS" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_result_cas \- Working with result sets . diff --git a/docs/man/memcached_result_create.3 b/docs/man/memcached_result_create.3 index 6d426325..47848bbe 100644 --- a/docs/man/memcached_result_create.3 +++ b/docs/man/memcached_result_create.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_RESULT_CREATE" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_RESULT_CREATE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_result_create \- Working with result sets . diff --git a/docs/man/memcached_result_flags.3 b/docs/man/memcached_result_flags.3 index 501b9ec9..dc9c5248 100644 --- a/docs/man/memcached_result_flags.3 +++ b/docs/man/memcached_result_flags.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_RESULT_FLAGS" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_RESULT_FLAGS" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_result_flags \- Working with result sets . diff --git a/docs/man/memcached_result_free.3 b/docs/man/memcached_result_free.3 index dddf7307..b5276e1b 100644 --- a/docs/man/memcached_result_free.3 +++ b/docs/man/memcached_result_free.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_RESULT_FREE" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_RESULT_FREE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_result_free \- Working with result sets . diff --git a/docs/man/memcached_result_key_length.3 b/docs/man/memcached_result_key_length.3 index 8a648a56..f95a4d30 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_RESULT_KEY_LENGTH" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_result_key_length \- Working with result sets . diff --git a/docs/man/memcached_result_key_value.3 b/docs/man/memcached_result_key_value.3 index 88d0fa2a..81fceab5 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_RESULT_KEY_VALUE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_result_key_value \- Working with result sets . diff --git a/docs/man/memcached_result_length.3 b/docs/man/memcached_result_length.3 index 0d28a293..b56053e6 100644 --- a/docs/man/memcached_result_length.3 +++ b/docs/man/memcached_result_length.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_RESULT_LENGTH" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_RESULT_LENGTH" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_result_length \- Working with result sets . diff --git a/docs/man/memcached_result_st.3 b/docs/man/memcached_result_st.3 index c1b418de..99dbb104 100644 --- a/docs/man/memcached_result_st.3 +++ b/docs/man/memcached_result_st.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_RESULT_ST" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_RESULT_ST" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_result_st \- Working with result sets . diff --git a/docs/man/memcached_result_value.3 b/docs/man/memcached_result_value.3 index b04a2ad0..33dedb93 100644 --- a/docs/man/memcached_result_value.3 +++ b/docs/man/memcached_result_value.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_RESULT_VALUE" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_RESULT_VALUE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_result_value \- Working with result sets . diff --git a/docs/man/memcached_sasl.3 b/docs/man/memcached_sasl.3 index 791b979f..d46b0b49 100644 --- a/docs/man/memcached_sasl.3 +++ b/docs/man/memcached_sasl.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SASL" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SASL" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_sasl \- libmemcached Documentation . diff --git a/docs/man/memcached_sasl_set_auth_data.3 b/docs/man/memcached_sasl_set_auth_data.3 index 4d599937..46dc450d 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SASL_SET_AUTH_DATA" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_sasl_set_auth_data \- libmemcached Documentation . diff --git a/docs/man/memcached_server_add.3 b/docs/man/memcached_server_add.3 index a63ab51b..007e7823 100644 --- a/docs/man/memcached_server_add.3 +++ b/docs/man/memcached_server_add.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVER_ADD" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SERVER_ADD" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_server_add \- libmemcached Documentation . diff --git a/docs/man/memcached_server_add_unix_socket.3 b/docs/man/memcached_server_add_unix_socket.3 index ec5a8bd0..229a32d4 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SERVER_ADD_UNIX_SOCKET" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_server_add_unix_socket \- libmemcached Documentation . diff --git a/docs/man/memcached_server_count.3 b/docs/man/memcached_server_count.3 index 41e30cbe..dbac54d1 100644 --- a/docs/man/memcached_server_count.3 +++ b/docs/man/memcached_server_count.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVER_COUNT" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SERVER_COUNT" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_server_count \- libmemcached Documentation . diff --git a/docs/man/memcached_server_cursor.3 b/docs/man/memcached_server_cursor.3 index a355c130..9d986faa 100644 --- a/docs/man/memcached_server_cursor.3 +++ b/docs/man/memcached_server_cursor.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVER_CURSOR" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SERVER_CURSOR" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_server_cursor \- libmemcached Documentation . diff --git a/docs/man/memcached_server_list.3 b/docs/man/memcached_server_list.3 index 95ffc8fe..b1768821 100644 --- a/docs/man/memcached_server_list.3 +++ b/docs/man/memcached_server_list.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVER_LIST" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SERVER_LIST" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_server_list \- libmemcached Documentation . diff --git a/docs/man/memcached_server_list_append.3 b/docs/man/memcached_server_list_append.3 index fd3feb33..054ef6f8 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SERVER_LIST_APPEND" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_server_list_append \- libmemcached Documentation . diff --git a/docs/man/memcached_server_list_count.3 b/docs/man/memcached_server_list_count.3 index 37748324..39dfd3bf 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SERVER_LIST_COUNT" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_server_list_count \- libmemcached Documentation . diff --git a/docs/man/memcached_server_list_free.3 b/docs/man/memcached_server_list_free.3 index d4b9f929..a1bd6e9a 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SERVER_LIST_FREE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_server_list_free \- libmemcached Documentation . diff --git a/docs/man/memcached_server_push.3 b/docs/man/memcached_server_push.3 index bd291b3d..a2edbca0 100644 --- a/docs/man/memcached_server_push.3 +++ b/docs/man/memcached_server_push.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVER_PUSH" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SERVER_PUSH" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_server_push \- libmemcached Documentation . diff --git a/docs/man/memcached_server_st.3 b/docs/man/memcached_server_st.3 index ac7c9a46..e4a863a6 100644 --- a/docs/man/memcached_server_st.3 +++ b/docs/man/memcached_server_st.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVER_ST" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SERVER_ST" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_server_st \- libmemcached Documentation . diff --git a/docs/man/memcached_servers.3 b/docs/man/memcached_servers.3 index a58c4878..9658d1e0 100644 --- a/docs/man/memcached_servers.3 +++ b/docs/man/memcached_servers.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVERS" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SERVERS" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_servers \- libmemcached Documentation . diff --git a/docs/man/memcached_servers_parse.3 b/docs/man/memcached_servers_parse.3 index 8bc67ecc..149c98e7 100644 --- a/docs/man/memcached_servers_parse.3 +++ b/docs/man/memcached_servers_parse.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVERS_PARSE" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SERVERS_PARSE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_servers_parse \- libmemcached Documentation . diff --git a/docs/man/memcached_servers_reset.3 b/docs/man/memcached_servers_reset.3 index 42dde1fe..be51b9f3 100644 --- a/docs/man/memcached_servers_reset.3 +++ b/docs/man/memcached_servers_reset.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SERVERS_RESET" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SERVERS_RESET" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_servers_reset \- libmemcached Documentation . diff --git a/docs/man/memcached_set.3 b/docs/man/memcached_set.3 index 048dc42b..b30a53d4 100644 --- a/docs/man/memcached_set.3 +++ b/docs/man/memcached_set.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_SET" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SET" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_set \- Storing and Replacing Data . diff --git a/docs/man/memcached_set_by_key.3 b/docs/man/memcached_set_by_key.3 index 8c870cbe..60ceb9f5 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SET_BY_KEY" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_set_by_key \- Storing and Replacing Data . diff --git a/docs/man/memcached_set_memory_allocators.3 b/docs/man/memcached_set_memory_allocators.3 index e4547ff2..6f6b4293 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SET_MEMORY_ALLOCATORS" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_set_memory_allocators \- libmemcached Documentation . diff --git a/docs/man/memcached_set_memory_allocators_context.3 b/docs/man/memcached_set_memory_allocators_context.3 index f74529c0..31f905b0 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SET_MEMORY_ALLOCATORS_CONTEXT" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_set_memory_allocators_context \- libmemcached Documentation . diff --git a/docs/man/memcached_set_sasl_callbacks.3 b/docs/man/memcached_set_sasl_callbacks.3 index 241d7ef5..12919f49 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SET_SASL_CALLBACKS" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_set_sasl_callbacks \- libmemcached Documentation . diff --git a/docs/man/memcached_set_user_data.3 b/docs/man/memcached_set_user_data.3 index f7bcb554..a24319fc 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_SET_USER_DATA" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_set_user_data \- libmemcached Documentation . diff --git a/docs/man/memcached_stat.3 b/docs/man/memcached_stat.3 index 03dd9213..d0877c3c 100644 --- a/docs/man/memcached_stat.3 +++ b/docs/man/memcached_stat.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_STAT" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_STAT" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_stat \- libmemcached Documentation . diff --git a/docs/man/memcached_stat_execute.3 b/docs/man/memcached_stat_execute.3 index 233c4f35..43c6f846 100644 --- a/docs/man/memcached_stat_execute.3 +++ b/docs/man/memcached_stat_execute.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_STAT_EXECUTE" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_STAT_EXECUTE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_stat_execute \- libmemcached Documentation . diff --git a/docs/man/memcached_stat_get_keys.3 b/docs/man/memcached_stat_get_keys.3 index 82201db4..d9d3309e 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_STAT_GET_KEYS" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_stat_get_keys \- libmemcached Documentation . diff --git a/docs/man/memcached_stat_get_value.3 b/docs/man/memcached_stat_get_value.3 index d629cb6f..1fe3a264 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" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_STAT_GET_VALUE" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_stat_get_value \- libmemcached Documentation . diff --git a/docs/man/memcached_stat_servername.3 b/docs/man/memcached_stat_servername.3 index dd879d4e..162caf55 100644 --- a/docs/man/memcached_stat_servername.3 +++ b/docs/man/memcached_stat_servername.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_STAT_SERVERNAME" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_STAT_SERVERNAME" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_stat_servername \- libmemcached Documentation . diff --git a/docs/man/memcached_stats.3 b/docs/man/memcached_stats.3 index f61f5550..fbcb8487 100644 --- a/docs/man/memcached_stats.3 +++ b/docs/man/memcached_stats.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_STATS" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_STATS" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_stats \- libmemcached Documentation . diff --git a/docs/man/memcached_strerror.3 b/docs/man/memcached_strerror.3 index 5f0c7758..d9d5ef1c 100644 --- a/docs/man/memcached_strerror.3 +++ b/docs/man/memcached_strerror.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_STRERROR" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_STRERROR" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_strerror \- libmemcached Documentation . diff --git a/docs/man/memcached_user_data.3 b/docs/man/memcached_user_data.3 index 56e9abc4..ec1815bf 100644 --- a/docs/man/memcached_user_data.3 +++ b/docs/man/memcached_user_data.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_USER_DATA" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_USER_DATA" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_user_data \- libmemcached Documentation . diff --git a/docs/man/memcached_verbosity.3 b/docs/man/memcached_verbosity.3 index adc61beb..bc90bec0 100644 --- a/docs/man/memcached_verbosity.3 +++ b/docs/man/memcached_verbosity.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_VERBOSITY" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_VERBOSITY" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_verbosity \- libmemcached Documentation . diff --git a/docs/man/memcached_version.3 b/docs/man/memcached_version.3 index 2462b757..9790bfdc 100644 --- a/docs/man/memcached_version.3 +++ b/docs/man/memcached_version.3 @@ -1,4 +1,4 @@ -.TH "MEMCACHED_VERSION" "3" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCACHED_VERSION" "3" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcached_version \- libmemcached Documentation . diff --git a/docs/man/memcapable.1 b/docs/man/memcapable.1 index 6659f88f..7310eee7 100644 --- a/docs/man/memcapable.1 +++ b/docs/man/memcapable.1 @@ -1,4 +1,4 @@ -.TH "MEMCAPABLE" "1" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCAPABLE" "1" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcapable \- libmemcached Documentation . @@ -33,6 +33,8 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .sp Check the server for compatibility and capabilities .SH SYNOPSIS +.sp +\fBmemcapable\fP .INDENT 0.0 .TP .B \-h hostname diff --git a/docs/man/memcat.1 b/docs/man/memcat.1 index 5b4c395d..79071a14 100644 --- a/docs/man/memcat.1 +++ b/docs/man/memcat.1 @@ -1,4 +1,4 @@ -.TH "MEMCAT" "1" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCAT" "1" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcat \- libmemcached Documentation . @@ -33,6 +33,8 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .sp Copy a set of keys to stdout .SH SYNOPSIS +.sp +\fBmemcat\fP .INDENT 0.0 .TP .B \-\-help diff --git a/docs/man/memcp.1 b/docs/man/memcp.1 index 0a9a46f1..0f5bfc5e 100644 --- a/docs/man/memcp.1 +++ b/docs/man/memcp.1 @@ -1,4 +1,4 @@ -.TH "MEMCP" "1" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMCP" "1" "April 10, 2011" "0.47" "libmemcached" .SH NAME memcp \- libmemcached Documentation . @@ -35,6 +35,12 @@ 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 .SH DESCRIPTION diff --git a/docs/man/memdump.1 b/docs/man/memdump.1 index 5df5ab66..7a5c35a6 100644 --- a/docs/man/memdump.1 +++ b/docs/man/memdump.1 @@ -1,4 +1,4 @@ -.TH "MEMDUMP" "1" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMDUMP" "1" "April 10, 2011" "0.47" "libmemcached" .SH NAME memdump \- libmemcached Documentation . @@ -35,6 +35,12 @@ 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 .SH DESCRIPTION diff --git a/docs/man/memerror.1 b/docs/man/memerror.1 index 8af03844..b7c6af0e 100644 --- a/docs/man/memerror.1 +++ b/docs/man/memerror.1 @@ -1,4 +1,4 @@ -.TH "MEMERROR" "1" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMERROR" "1" "April 10, 2011" "0.47" "libmemcached" .SH NAME memerror \- libmemcached Documentation . @@ -35,6 +35,12 @@ Translate a memcached error code to a string .SH SYNOPSIS .INDENT 0.0 .TP +.B program +. +\fImemerror\fP +.UNINDENT +.INDENT 0.0 +.TP .B \-\-help .UNINDENT .SH DESCRIPTION diff --git a/docs/man/memflush.1 b/docs/man/memflush.1 index 192b3e07..d3c446c6 100644 --- a/docs/man/memflush.1 +++ b/docs/man/memflush.1 @@ -1,4 +1,4 @@ -.TH "MEMFLUSH" "1" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMFLUSH" "1" "April 10, 2011" "0.47" "libmemcached" .SH NAME memflush \- libmemcached Documentation . @@ -35,6 +35,12 @@ Reset a server or list of servers .SH SYNOPSIS .INDENT 0.0 .TP +.B program +. +\fImemflush\fP +.UNINDENT +.INDENT 0.0 +.TP .B \-\-help .UNINDENT .SH DESCRIPTION diff --git a/docs/man/memrm.1 b/docs/man/memrm.1 index 67351604..19b3d9c1 100644 --- a/docs/man/memrm.1 +++ b/docs/man/memrm.1 @@ -1,4 +1,4 @@ -.TH "MEMRM" "1" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMRM" "1" "April 10, 2011" "0.47" "libmemcached" .SH NAME memrm \- libmemcached Documentation . @@ -35,6 +35,12 @@ memrm \- Remove a key(s) from a collection of memcached servers .SH SYNOPSIS .INDENT 0.0 .TP +.B program +. +\fImemrm\fP +.UNINDENT +.INDENT 0.0 +.TP .B \-\-help .UNINDENT .SH DESCRIPTION diff --git a/docs/man/memslap.1 b/docs/man/memslap.1 index 304ccbc5..5fae1bd6 100644 --- a/docs/man/memslap.1 +++ b/docs/man/memslap.1 @@ -1,4 +1,4 @@ -.TH "MEMSLAP" "1" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMSLAP" "1" "April 10, 2011" "0.47" "libmemcached" .SH NAME memslap \- libmemcached Documentation . @@ -31,6 +31,16 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" Man page generated from reStructeredText. . .SH SYNOPSIS +.INDENT 0.0 +.TP +.B program +. +\fImemslap\fP +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-help +.UNINDENT .SH DESCRIPTION .sp \fBmemslap\fP is a load generation and benchmark tool for memcached(1) diff --git a/docs/man/memstat.1 b/docs/man/memstat.1 index bc0fdd13..d4811d74 100644 --- a/docs/man/memstat.1 +++ b/docs/man/memstat.1 @@ -1,4 +1,4 @@ -.TH "MEMSTAT" "1" "April 09, 2011" "0.47" "libmemcached" +.TH "MEMSTAT" "1" "April 10, 2011" "0.47" "libmemcached" .SH NAME memstat \- libmemcached Documentation . @@ -35,6 +35,12 @@ memstat \- Display the operating status of a single or group of memcached server .SH SYNOPSIS .INDENT 0.0 .TP +.B program +. +\fImemstat\fP +.UNINDENT +.INDENT 0.0 +.TP .B \-\-help .UNINDENT .SH DESCRIPTION diff --git a/docs/memaslap.rst b/docs/memaslap.rst index 841b7a64..5229a970 100644 --- a/docs/memaslap.rst +++ b/docs/memaslap.rst @@ -7,6 +7,8 @@ memaslap - Load testing and benchmarking a server SYNOPSIS -------- +:program:: `memaslap` + .. program:: memaslap .. option:: --help diff --git a/docs/memcached_pool.rst b/docs/memcached_pool.rst index b7a0f040..603419f5 100644 --- a/docs/memcached_pool.rst +++ b/docs/memcached_pool.rst @@ -8,7 +8,9 @@ SYNOPSIS #include -.. c:function:: memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); +.. c:function:: memcached_pool_st *memcached_pool(const char *option_string, size_t option_string_length); + +.. c:function:: memcached_pool_st * memcached_pool_create(memcached_st* mmc, int initial, int max); DEPRECATED .. c:function:: memcached_st * memcached_pool_destroy(memcached_pool_st* pool); @@ -30,23 +32,28 @@ DESCRIPTION ----------- -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 \ ``memcached_st``\ objects. The mmc argument should be an -initialised \ ``memcached_st``\ structure, and a successfull invocation of -memcached_pool_create takes full ownership of the variable (until it -is released by memcached_pool_destroy). The \ ``initial``\ argument -specifies the initial size of the connection pool, and the \ ``max``\ -argument 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. +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 +\ ``memcached_st``\ objects. Please see :manpage:`libmemcached_configuration` for details on the format of the configuration string. + +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 \ ``memcached_st``\ objects. The mmc argument should be an +initialised \ ``memcached_st``\ structure, and a successfull invocation of +memcached_pool_create takes full ownership of the variable (until it is +released by memcached_pool_destroy). The \ ``initial``\ argument specifies +the initial size of the connection pool, and the \ ``max``\ argument +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. memcached_pool_destroy() is used to destroy the connection pool created with memcached_pool_create() and release all allocated resources. It will return the pointer to the \ ``memcached_st``\ structure -passed as an argument to memcached_pool_create(), and returns the -ownership of the pointer to the caller. +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.. memcached_pool_pop() is used to grab a connection structure from the connection pool. The block argument specifies if the function should diff --git a/docs/memcapable.rst b/docs/memcapable.rst index 97dbc066..a22ba2c8 100644 --- a/docs/memcapable.rst +++ b/docs/memcapable.rst @@ -10,7 +10,9 @@ Check the server for compatibility and capabilities SYNOPSIS -------- -.. program:: memcat +:program:`memcapable` + +.. program:: memcapable .. option:: -h hostname diff --git a/docs/memcat.rst b/docs/memcat.rst index 911e478b..0558ed2a 100644 --- a/docs/memcat.rst +++ b/docs/memcat.rst @@ -11,6 +11,7 @@ SYNOPSIS -------- +:program:`memcat` .. program:: memcat diff --git a/docs/memcp.rst b/docs/memcp.rst index 1933078b..0d4bae57 100644 --- a/docs/memcp.rst +++ b/docs/memcp.rst @@ -10,6 +10,8 @@ Copies files to a collection of memcached servers SYNOPSIS -------- +:program: `memcp` + .. program:: memcp .. option:: --help diff --git a/docs/memdump.rst b/docs/memdump.rst index 05fea79a..e667278e 100644 --- a/docs/memdump.rst +++ b/docs/memdump.rst @@ -10,6 +10,8 @@ Dump a list of keys from a server. SYNOPSIS -------- +:program: `memdump` + .. program:: memdump .. option:: --help diff --git a/docs/memerror.rst b/docs/memerror.rst index 880de8ca..37638c26 100644 --- a/docs/memerror.rst +++ b/docs/memerror.rst @@ -10,6 +10,8 @@ Translate a memcached error code to a string SYNOPSIS -------- +:program: `memerror` + .. program:: memerror .. option:: --help diff --git a/docs/memflush.rst b/docs/memflush.rst index 88982259..62ab6792 100644 --- a/docs/memflush.rst +++ b/docs/memflush.rst @@ -10,6 +10,8 @@ Reset a server or list of servers SYNOPSIS -------- +:program: `memflush` + .. program:: memflush .. option:: --help diff --git a/docs/memrm.rst b/docs/memrm.rst index eab53ba0..d35cbd51 100644 --- a/docs/memrm.rst +++ b/docs/memrm.rst @@ -10,7 +10,7 @@ memrm - Remove a key(s) from a collection of memcached servers SYNOPSIS -------- - +:program: `memrm` .. program:: memrm diff --git a/docs/memslap.rst b/docs/memslap.rst index 134cdf2d..cde4ace7 100644 --- a/docs/memslap.rst +++ b/docs/memslap.rst @@ -8,8 +8,11 @@ SYNOPSIS -------- -.. program:: memslap [options] +:program: `memslap` +.. program:: memslap + +.. option:: --help ----------- DESCRIPTION diff --git a/docs/memstat.rst b/docs/memstat.rst index bed68398..da15a8d4 100644 --- a/docs/memstat.rst +++ b/docs/memstat.rst @@ -10,6 +10,8 @@ memstat - Display the operating status of a single or group of memcached servers SYNOPSIS -------- +:program: `memstat` + .. program:: memstat .. option:: --help diff --git a/libmemcached/connect.c b/libmemcached/connect.c index 9f17f0c3..a7b17f0c 100644 --- a/libmemcached/connect.c +++ b/libmemcached/connect.c @@ -165,7 +165,9 @@ static inline memcached_return_t set_socket_nonblocking(memcached_server_st *ptr int flags; do + { flags= fcntl(ptr->fd, F_GETFL, 0); + } while (flags == -1 && (errno == EINTR || errno == EAGAIN)); unlikely (flags == -1) @@ -178,7 +180,9 @@ static inline memcached_return_t set_socket_nonblocking(memcached_server_st *ptr int rval; do + { rval= fcntl(ptr->fd, F_SETFL, flags | O_NONBLOCK); + } while (rval == -1 && (errno == EINTR || errno == EAGAIN)); unlikely (rval == -1) diff --git a/libmemcached/memcached.c b/libmemcached/memcached.c index 120c2087..3c327d7b 100644 --- a/libmemcached/memcached.c +++ b/libmemcached/memcached.c @@ -121,6 +121,8 @@ static inline bool _memcached_init(memcached_st *self) self->error_messages= NULL; self->prefix_key= NULL; + self->configure.initial_pool_size= 1; + self->configure.max_pool_size= 1; self->configure.filename= NULL; return true; diff --git a/libmemcached/memcached.h b/libmemcached/memcached.h index fa291f93..1654ee1d 100644 --- a/libmemcached/memcached.h +++ b/libmemcached/memcached.h @@ -159,6 +159,8 @@ struct memcached_st { struct memcached_error_t *error_messages; struct memcached_array_st *prefix_key; struct { + uint32_t initial_pool_size; + uint32_t max_pool_size; struct memcached_array_st *filename; } configure; struct { diff --git a/libmemcached/util/pool.c b/libmemcached/util/pool.c index 7879cc23..e8be3c73 100644 --- a/libmemcached/util/pool.c +++ b/libmemcached/util/pool.c @@ -25,6 +25,7 @@ struct memcached_pool_st int firstfree; uint32_t size; uint32_t current_size; + bool _owns_master; char *version; }; @@ -71,17 +72,17 @@ static int grow_pool(memcached_pool_st* pool) return EXIT_SUCCESS; } -memcached_pool_st *memcached_pool_create(memcached_st* mmc, - uint32_t initial, uint32_t max) +static inline memcached_pool_st *_pool_create(memcached_st* mmc, uint32_t initial, uint32_t max) { - memcached_pool_st* ret = NULL; - memcached_pool_st object = { .mutex = PTHREAD_MUTEX_INITIALIZER, + memcached_pool_st* ret= NULL; + memcached_pool_st object= { .mutex = PTHREAD_MUTEX_INITIALIZER, .cond = PTHREAD_COND_INITIALIZER, .master = mmc, .mmc = calloc(max, sizeof(memcached_st*)), - .firstfree = -1, + .firstfree= -1, .size = max, - .current_size = 0 }; + .current_size= 0, + ._owns_master= false}; if (object.mmc != NULL) { @@ -108,9 +109,38 @@ memcached_pool_st *memcached_pool_create(memcached_st* mmc, return ret; } +memcached_pool_st *memcached_pool_create(memcached_st* mmc, uint32_t initial, uint32_t max) +{ + return _pool_create(mmc, initial, max); +} + +memcached_pool_st * memcached_pool(const char *option_string, size_t option_string_length) +{ + memcached_pool_st *self; + memcached_st *memc= memcached_create_with_options(option_string, option_string_length); + + if (! memc) + return NULL; + + self= memcached_pool_create(memc, memc->configure.initial_pool_size, memc->configure.max_pool_size); + if (self) + { + self->_owns_master= true; + } + else + { + memcached_free(memc); + } + + return self; +} + memcached_st* memcached_pool_destroy(memcached_pool_st* pool) { - memcached_st *ret = pool->master; + if (! pool) + return NULL; + + memcached_st *ret= pool->master; for (int xx= 0; xx <= pool->firstfree; ++xx) { @@ -122,6 +152,11 @@ memcached_st* memcached_pool_destroy(memcached_pool_st* pool) pthread_mutex_destroy(&pool->mutex); pthread_cond_destroy(&pool->cond); free(pool->mmc); + if (pool->_owns_master) + { + memcached_free(pool->master); + ret= NULL; + } free(pool); return ret; @@ -138,7 +173,9 @@ memcached_st* memcached_pool_pop(memcached_pool_st* pool, do { if (pool->firstfree > -1) + { ret= pool->mmc[pool->firstfree--]; + } else if (pool->current_size == pool->size) { if (!block) @@ -149,9 +186,9 @@ memcached_st* memcached_pool_pop(memcached_pool_st* pool, if (pthread_cond_wait(&pool->cond, &pool->mutex) == -1) { - int err = errno; + int err= errno; mutex_exit(&pool->mutex); - errno = err; + errno= err; *rc= MEMCACHED_ERRNO; return NULL; } @@ -229,11 +266,14 @@ memcached_return_t memcached_pool_behavior_set(memcached_pool_st *pool, { rc= memcached_behavior_set(pool->mmc[xx], flag, data); if (rc == MEMCACHED_SUCCESS) + { memcached_set_user_data(pool->mmc[xx], pool->version); + } else { memcached_free(pool->mmc[xx]); memset(pool->mmc[xx], 0, sizeof(*pool->mmc[xx])); + if (memcached_clone(pool->mmc[xx], pool->master) == NULL) { /* I'm not sure what to do in this case.. this would happen diff --git a/libmemcached/util/pool.h b/libmemcached/util/pool.h index f2e71a2a..f00966aa 100644 --- a/libmemcached/util/pool.h +++ b/libmemcached/util/pool.h @@ -23,10 +23,14 @@ struct memcached_pool_st; typedef struct memcached_pool_st memcached_pool_st; LIBMEMCACHED_API -memcached_pool_st *memcached_pool_create(memcached_st* mmc, uint32_t initial, - uint32_t max); +memcached_pool_st *memcached_pool_create(memcached_st* mmc, uint32_t initial, uint32_t max); + +LIBMEMCACHED_API +memcached_pool_st *memcached_pool(const char *option_string, size_t option_string_length); + LIBMEMCACHED_API memcached_st* memcached_pool_destroy(memcached_pool_st* pool); + LIBMEMCACHED_API memcached_st* memcached_pool_pop(memcached_pool_st* pool, bool block, diff --git a/tests/include.am b/tests/include.am index 990c772d..420435d5 100644 --- a/tests/include.am +++ b/tests/include.am @@ -35,6 +35,7 @@ noinst_HEADERS+= \ tests/ketama_test_cases_spy.h \ tests/libmemcached_world.h \ tests/parser.h \ + tests/pool.h \ tests/print.h \ tests/replication.h \ tests/string.h \ @@ -56,6 +57,7 @@ tests_testapp_SOURCES= \ tests/error_conditions.cc \ tests/mem_functions.c \ tests/parser.cc \ + tests/pool.cc \ tests/print.cc \ tests/replication.cc \ tests/string.cc \ diff --git a/tests/mem_functions.c b/tests/mem_functions.c index 014c9bba..72b3b193 100644 --- a/tests/mem_functions.c +++ b/tests/mem_functions.c @@ -35,6 +35,7 @@ #include #include "tests/parser.h" +#include "tests/pool.h" #include "tests/string.h" #include "tests/replication.h" #include "tests/basic.h" @@ -5980,10 +5981,9 @@ test_st tests[] ={ {"delete_through", 1, (test_callback_fn)delete_through }, {"noreply", 1, (test_callback_fn)noreply_test}, {"analyzer", 1, (test_callback_fn)analyzer_test}, -#ifdef HAVE_LIBMEMCACHEDUTIL {"connectionpool", 1, (test_callback_fn)connection_pool_test }, + {"memcached_pool_test", 1, (test_callback_fn)memcached_pool_test }, {"ping", 1, (test_callback_fn)ping_test }, -#endif {"test_get_last_disconnect", 1, (test_callback_fn)test_get_last_disconnect}, {"verbosity", 1, (test_callback_fn)test_verbosity}, {"test_server_failure", 1, (test_callback_fn)test_server_failure}, diff --git a/tests/parser.cc b/tests/parser.cc index 900e89a7..f3dca792 100644 --- a/tests/parser.cc +++ b/tests/parser.cc @@ -44,6 +44,7 @@ #define BUILDING_LIBMEMCACHED #include +#include #include "tests/parser.h" #include "tests/print.h" @@ -483,9 +484,11 @@ test_return_t random_statement_build_test(memcached_st*) break; case ENOMEM: std::cerr << "Failed to allocate memory for memcached_create_with_options()" << std::endl; + memcached_free(memc_ptr); return TEST_FAILURE; default: std::cerr << "Unknown error from memcached_create_with_options?!!" << std::endl; + memcached_free(memc_ptr); return TEST_FAILURE; } } diff --git a/tests/parser.h b/tests/parser.h index c50b3789..c53f0e41 100644 --- a/tests/parser.h +++ b/tests/parser.h @@ -1,6 +1,6 @@ /* vim:expandtab:shiftwidth=2:tabstop=2:smarttab: * - * Gearmand client and server library. + * Libmemcached * * Copyright (C) 2011 Data Differential, http://datadifferential.com/ * All rights reserved. diff --git a/tests/pool.cc b/tests/pool.cc new file mode 100644 index 00000000..e7929232 --- /dev/null +++ b/tests/pool.cc @@ -0,0 +1,71 @@ +/* vim:expandtab:shiftwidth=2:tabstop=2:smarttab: + * + * Libmemcached Client and Server + * + * Copyright (C) 2011 Data Differential, http://datadifferential.com/ + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above + * copyright notice, this list of conditions and the following disclaimer + * in the documentation and/or other materials provided with the + * distribution. + * + * * The names of its contributors may not be used to endorse or + * promote products derived from this software without specific prior + * written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT + * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE + * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + */ + +#include + +#include +#include +#include +#include + +#include +#include +#include + +test_return_t memcached_pool_test(memcached_st *) +{ + 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)); + + memcached_return_t rc; + memcached_st *memc= memcached_pool_pop(pool, false, &rc); + + test_true(rc == MEMCACHED_SUCCESS); + test_true(memc); + + /* + Release the memc_ptr that was pulled from the pool + */ + memcached_pool_push(pool, memc); + + /* + Destroy the pool. + */ + memcached_pool_destroy(pool); + + return TEST_SUCCESS; +} diff --git a/tests/pool.h b/tests/pool.h new file mode 100644 index 00000000..45bb14da --- /dev/null +++ b/tests/pool.h @@ -0,0 +1,51 @@ +/* vim:expandtab:shiftwidth=2:tabstop=2:smarttab: + * + * Libmemcached client and server library. + * + * Copyright (C) 2011 Data Differential, http://datadifferential.com/ + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are + * met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * * Redistributions in binary form must reproduce the above + * copyright notice, this list of conditions and the following disclaimer + * in the documentation and/or other materials provided with the + * distribution. + * + * * The names of its contributors may not be used to endorse or + * promote products derived from this software without specific prior + * written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT + * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE + * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + */ + +#pragma once + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +LIBTEST_INTERNAL_API +test_return_t memcached_pool_test(memcached_st *); + +#ifdef __cplusplus +} +#endif