.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.3 manpage writer.
.
.
.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
..
.TH "MEMCACHED_ANALYZE" "3" "Mar 07, 2026" "1.1" "libmemcached-awesome"
.SH NAME
memcached_analyze \- libmemcached Documentation
.SH SYNOPSIS
.INDENT 0.0
.TP
.B #include <libmemcached/memcached.h>
Compile and link with \-lmemcached
.UNINDENT
.INDENT 0.0
.TP
.B typedef struct memcached_analysis_st memcached_analysis_st 
.UNINDENT
.INDENT 0.0
.TP
.B memcached_analysis_st *memcached_analyze(memcached_st \%<#\:_CPPv412memcached_st> *ptr, memcached_stat_st \%<#\:_CPPv417memcached_stat_st> *stat, memcached_return_t \%<#\:_CPPv418memcached_return_t> *error) 
.INDENT 7.0
.TP
.B Parameters
.INDENT 7.0
.IP \(bu 2
\fBptr\fP \-\- pointer to initialized \fBmemcached_st\fP \%<#\:_CPPv412memcached_st> struct
.IP \(bu 2
\fBstat\fP \-\- pointer to a \fBmemcached_stat_st\fP \%<#\:_CPPv417memcached_stat_st> struct to fill
.IP \(bu 2
\fBerror\fP \-\- pointer to \fBmemcached_return_t\fP \%<#\:_CPPv418memcached_return_t> indicating success
.UNINDENT
.TP
.B Returns
pointer to an allocated and filled out \fBmemcached_analysis_t\fP struct
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
\fBlibmemcached\fP has the ability to query a memcached server (or collection of
servers) for their current state. Queries to find state return a
\fBmemcached_analysis_st\fP structure. You are responsible for freeing this
structure.
.sp
\fBmemcached_analyze()\fP analyzes useful information based on the provided servers
and sets the result to the \fBmemcached_analysis_st\fP structure. The return value
must be freed by the calling application.
.sp
\fBSee also:\fP
.INDENT 0.0
.INDENT 3.5
\fBmemstat \-a|\-\-analyze [<arg>]\fP
A command line tool to analyze a memcached server.
.UNINDENT
.UNINDENT
.SH RETURN VALUE
.sp
A pointer to the allocated \fBmemcached_analysis_st\fP structure on success and a
NULL pointer on failure. You may inspect the error detail by checking the
\fBmemcached_return_t\fP \%<#\:_CPPv418memcached_return_t> value.
.sp
Any method returning a \fBmemcached_analysis_st\fP expects you to free the memory
allocated for it.
.SH SEE ALSO
.sp
\fBmemcached(1) \%<https://\:linux\:.die\:.net/\:man/\:1/\:memcached>\fP
\fBlibmemcached(3) \%<https://\:linux\:.die\:.net/\:man/\:3/\:libmemcached>\fP
\fBmemcached_strerror(3) \%<https://\:linux\:.die\:.net/\:man/\:3/\:memcached_strerror>\fP
.\" End of generated man page.