---
name: "memcached-tool"
section: "1"
platform: "linux"
package: "memcached"
version: "1.6.45-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/memcached-tool"
---

# memcached-tool(1)

stats and management tool for memcached

## NAME

memcached-tool - stats and management tool for memcached

## SYNOPSIS

**memcached-tool** \<*host*\[:*port*\] \| */path/to/socket*\> \[*mode*\]

## DESCRIPTION

**memcached-tool** is a Perl script used to print statistics from a running memcached instance. The first parameter specifies the address of the daemon either by a hostname, optionally followed by the port number (the default is 11211), or a path to UNIX domain socket. The second parameter specifies the mode in which the tool should run.

## MODES

- **display**

  Print slab class statistics. This is the default mode if no mode is specified. The printed columns are:

  - **#**

    Number of the slab class.

  - **Item\_Size**

    The amount of space each chunk uses. One item uses one chunk of the appropriate size.

  - **Max\_age**

    Age of the oldest item in the LRU.

  - **Pages**

    Total number of pages allocated to the slab class.

  - **Count**

    Number of items presently stored in this class. Expired items are not automatically excluded.

  - **Full?**

    Yes if there are no free chunks at the end of the last allocated page.

  - **Evicted**

    Number of times an item had to be evicted from the LRU before it expired.

  - **Evict\_Time**

    Seconds since the last access for the most recent item evicted from this class.

  - **OOM**

    Number of times the underlying slab class was unable to store a new item.

- **stats**

  Print general-purpose statistics of the daemon. Each line contains the name of the statistic and its value.

- **dump \[limit\]**

  Make a partial dump of the cache written in the add statements of the memcached protocol. If **limit** is given and is a strictly positive integer, then the dump is limited to that number of items.

## SEE ALSO

[**memcached**(1)](/memcached/1.md),\
 **https://www.memcached.org**

## AUTHOR

The memcached-tool script was written by Brad Fitzpatrick **\<brad@danga.com\>**