MEMSTAT(1)

💅 MEMSTAT(1) — your girl's guide to memstat

okay bestie, welcome to memstat(1), straight out of libmemcached-awesome ✨ this is the little tool that strolls up to your memcached(1) servers and asks them how they're doing. no cap, it's giving "wellness check for your cache" 🫶

---

🌸 NAME 🌸

memstat — libmemcached Documentation 💖

(yeah, the official NAME section is literally just "libmemcached Documentation", we're not gonna pretend otherwise, periodt)

---

✨ SYNOPSIS ✨

memstat [options] [stat args]

Gather statistics from a server 👑

---

🦋 DESCRIPTION 🦋

So here's the vibe: memstat dumps the state of memcached(1) servers. All of it. It prints all data to stdout 💫

That's it, that's the whole personality. She shows up, she dumps state, she leaves. iconic.

---

🎀 OPTIONS 🎀

• -h, --help — Display help. your lil "what do I do" button 🥺
• -V, --version — Display version. proof of who she is ✨
• -q, --quiet — Operate quietly 🤫 (lowercase girlie)
• -v, --verbose — Operate more verbosely 🗣️ (uppercase girlie energy)
• -d, --debug — See -v, --verbose. basically the same thing, she's just wearing a different outfit 💅
• -s, --servers <list of servers> — Specify the list of servers as hostname[:port][,hostname[:port]...]. yes the bracket situation is real, that's the whole format, copy it carefully bestie 🧚
• -n, --non-blocking — Enable non-blocking operations. no waiting around fr fr
• -N, --tcp-nodelay — Disable Nagle's algorithm. less batching, more immediate, we love a fast girl 🔥
• -b, --binary — Enable binary protocol. binary mode activated bestie 💀
• -B, --buffer — Buffer requests. hold it, hold it, annnnnd go 📦
• -u, --username <username> — Use username for SASL authentication 🔐
• -p, --password <password> — Use password for SASL authentication 🤐
• -A, --args <stat> — Stat args.

⚠️ DEPRECATED: use positional arguments. seriously, use the positional args instead, this one's on the way out, don't get attached 😭

• -a, --analyze [<arg>] — Analyze and print differences of a server cluster. A memory and uptime comparison is performed by default 👑

Options:

• --analyze[=default] — Memory and uptime comparison.
• --analyze=latency — Network latency comparison. (speed-checking your cluster, we love to see it ⭐)

• -S, -server-version — Obtain and print server version(s) only. just the version, nothing else, she's being mysterious 🙈
• --iterations — Iteration count of GETs sent by the latency test (default: 1000). a thousand whole GETs, go off 💯

---

🌈 ENVIRONMENT 🌈

• MEMCACHED_SERVERS — Specify a list of servers. set it once, forget about it, live your life 🫶

---

💜 NOTES 💜

🌟 PROGRAM PREFIX 🌟

okay this part is a lil meta but it's important iykyk:

The prefix of this program is variable, i.e. it can be configured at build time 👷‍♀️

Usually the client programs of libmemcached-awesome are prefixed with mem, like memcat or memcp 🐱

It can be configured, though, to replace the prefix with something else like mc — in case of that, the client programs of libmemcached-awesome would be called mccat, mccp, etc. respectively 😮‍💨 so if you can't find memstat, maybe she's going by another name now, main character rebrand energy fr fr.

---

⭐ SEE ALSO ⭐

memcached(1) libmemcached(3) 💖

• C/C++ Client Library for memcached
• Working with statistical information from a server

---

💡 friendly reminder: everything gets printed to stdout. pipe it, redirect it, frame it, do whatever, she doesn't judge 🎀

---

k so that's the whole page bestie 🌸 this was libmemcached-awesome, version 1.1, dated Jul 18, 2024 — go forth, run memstat, gather those stats, and slay 💅👑✨