X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Fmemcached_analyze.rst;h=88f3ad9d6b74076d8666606bc5db1c7cce375ce0;hb=dbc62573e1a6dc8cbcc97d0898e8615b0916d6ab;hp=53cd85374767d4c8ac78f1c008383e1f693ca49f;hpb=86be0943416087ba738c28ddbde8cdcbd62ad777;p=awesomized%2Flibmemcached diff --git a/docs/memcached_analyze.rst b/docs/memcached_analyze.rst index 53cd8537..88f3ad9d 100644 --- a/docs/memcached_analyze.rst +++ b/docs/memcached_analyze.rst @@ -6,46 +6,36 @@ Anaylzing servers Analyze server information -------- -LIBRARY -------- - - -C Client Library for memcached (libmemcached, -lmemcached) - - -------- SYNOPSIS -------- +.. index:: object: memcached_analysis_st -.. code-block:: perl +#include - #include +.. c:type:: memcached_analysis_st - memcached_analysis_st * - memcached_analyze (memcached_st *ptr, - memcached_stat_st *stat, - memcached_return_t *error); - +.. c:function:: memcached_analysis_st * memcached_analyze (memcached_st *ptr, memcached_stat_st *stat, memcached_return_t *error) +Compile and link with -lmemcached ----------- DESCRIPTION ----------- -libmemcached(3) has the ability to query a memcached server (or collection -of servers) for their current state. Queries to find state return a -\ ``memcached_analysis_st``\ structure. You are responsible for freeing this structure. +:program:`libmemcached` has the ability to query a memcached server (or +collection of servers) for their current state. Queries to find state return a +:c:type:`memcached_analysis_st` structure. You are responsible for freeing this structure. -memcached_analyze() analyzes useful information based on the provided servers -and sets the result to the \ ``memcached_analysis_st``\ structure. The return value -must be freed by the calling application. +:c:func:`memcached_analyze` analyzes useful information based on the +provided servers and sets the result to the :c:type:`memcached_analysis_st` +structure. The return value must be freed by the calling application. -A command line tool, memstat(1) with the option --analyze, is provided so that -you do not have to write an application to use this method. +A command line tool, :program:`memstat` with the option :option:`memstat --analyze`, +is provided so that you do not have to write an application to use this method. ------ @@ -53,11 +43,11 @@ RETURN ------ -A pointer to the allocated \ ``memcached_analysis_st``\ structure on success and -a NULL pointer on failure. You may inspect the error detail by checking the -\ ``memcached_return_t``\ value. +A pointer to the allocated :c:type:`memcached_analysis_st` structure on +success and a NULL pointer on failure. You may inspect the error detail by +checking the :c:type:`memcached_return_t` value. -Any method returning a \ ``memcached_analysis_st``\ expects you to free the +Any method returning a :c:type:`memcached_analysis_st` expects you to free the memory allocated for it.