---
name: "Memcached::libmemcached::memcached_analyze"
section: "3pm"
platform: "linux"
package: "libmemcached-libmemcached-perl"
version: "1.001801+dfsg-5+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Memcached::libmemcached::memcached_analyze"
---

# Memcached::libmemcached::memcached\_analyze(3pm)

Analyze server information

## NAME

memcached\_analyze - Analyze server information

## LIBRARY

C Client Library for memcached (libmemcached, -lmemcached)

## SYNOPSIS

```
  #include <memcached.h>
  memcached_analysis_st *
    memcached_analyze (memcached_st *ptr,
                       memcached_stat_st *stat,
                       memcached_return_t *error);
```

## DESCRIPTION

[**libmemcached**(3)](/libmemcached/3.md) 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.

**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.

A command line tool, [**memstat**(1)](/memstat/1.md) with the option --analyze, is provided so that you do not have to write an application to use this method.

## 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.

Any method returning a `"memcached_analysis_st"` expects you to free the memory allocated for it.

## HOME

To find out more information please check: \<https://launchpad.net/libmemcached\>

## AUTHOR

Toru Maesaka, \<dev@torum.net\>

## SEE ALSO

[**memcached**(1)](/memcached/1.md) [**libmemcached**(3)](/libmemcached/3.md) [**memcached\_strerror**(3)](/memcached_strerror/3.md)