package Memcached::libmemcached::memcached_analyze;
=head1 NAME
memcached_analyze - Analyze server information
=head1 LIBRARY
C Client Library for memcached (libmemcached, -lmemcached)
=head1 SYNOPSIS
#include <memcached.h>
memcached_analysis_st *
memcached_analyze (memcached_st *ptr,
memcached_stat_st *stat,
memcached_return_t *error);
=head1 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
C<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 C<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.
=head1 RETURN
A pointer to the allocated C<memcached_analysis_st> structure on success and
a NULL pointer on failure. You may inspect the error detail by checking the
C<memcached_return_t> value.
Any method returning a C<memcached_analysis_st> expects you to free the
memory allocated for it.
=head1 HOME
To find out more information please check:
L<https://launchpad.net/libmemcached>
=head1 AUTHOR
Toru Maesaka, E<lt>dev@torum.netE<gt>
=head1 SEE ALSO
memcached(1) libmemcached(3) memcached_strerror(3)
=cut
1;