6
Analyze server information
13
.. index:: object: memcached_analysis_st
16
#include <libmemcached/memcached.h>
18
.. c:type:: memcached_analysis_st
20
.. c:function:: memcached_analysis_st * memcached_analyze (memcached_st *ptr, memcached_stat_st *stat, memcached_return_t *error)
22
Compile and link with -lmemcached
29
:program:`libmemcached` has the ability to query a memcached server (or
30
collection of servers) for their current state. Queries to find state return a
31
:c:type:`memcached_analysis_st` structure. You are responsible for freeing this structure.
33
:c:func:`memcached_analyze` analyzes useful information based on the
34
provided servers and sets the result to the :c:type:`memcached_analysis_st`
35
structure. The return value must be freed by the calling application.
37
A command line tool, :program:`memstat` with the option :option:`memstat --analyze`,
38
is provided so that you do not have to write an application to use this method.
46
A pointer to the allocated :c:type:`memcached_analysis_st` structure on
47
success and a NULL pointer on failure. You may inspect the error detail by
48
checking the :c:type:`memcached_return_t` value.
50
Any method returning a :c:type:`memcached_analysis_st` expects you to free the
51
memory allocated for it.
59
To find out more information please check:
60
`http://libmemcached.org/ <http://libmemcached.org/>`_
68
:manpage:`memcached(1)` :manpage:`libmemcached(3)` :manpage:`memcached_strerror(3)`