SMEMSTAT(8)

💖 SMEMSTAT — the manual page, but make it cute ✨

okay bestie, welcome to smemstat(8), a System Manager's Manual situation. this is the girl who reports memory usage with shared memory divided proportionally, and honestly? she ate. let's get into it 🫶

---

✨ NAME ✨

smemstat — report memory usage with shared memory divided proportionally 💅

---

🌸 SYNOPSIS 🌸

smemstat [options] [delay [count]]

---

🦋 DESCRIPTION 🦋

so smemstat reports the physical memory usage, taking shared memory into consideration. like, it does the math so you don't have to. iconic behaviour fr fr.

Swap reports memory that is swapped out to disk. Unshared memory is reported as USS (Unique Set Size). Unshared memory including the proportion of shared memory is reported as the PSS (Proportional Set Size). And the non-swapped physical memory is reported as the RSS (Resident Set Size). three acronyms, all besties, all telling you a different little piece of the story. 😌

Running with root privilege will report all user space processes. Running without it? you just get the current user's processes. no cap, that's just how it is 🔐

If a delay and count are not specified, you get a snapshot of the current memory used by the user's processes. one and done, a little polaroid of your RAM 📸

If a delay in seconds is specified, smemstat will periodically show any per-process changes in memory — the interval being the specified delay. and the way that it runs indefinitely until a SIGINT is caught... main character energy honestly. Specifying count will repeat the periodic output count number of times, so it actually knows when to stop. 💖

---

💅 OPTIONS 💅

smemstat options are as follow, bestie:

• -a — show memory size change with up arrow ↑ (increase) and down arrow ↓ (decrease)
• -c — get command information from processes comm field
• -d — strip directory basename off command information
• -g — report memory in gigabytes
• -h — show help
• -k — report memory in kilobytes
• -l — show long (full) command information
• -m — report memory in megabytes
• -o file — output data into a JSON formatted file
• -p proclist — specify a comma separated list of processes to monitor. The process list may contain one or more PIDs or process names.
• -q — run quietly, only really makes sense with -o option
• -s — show short command information
• -t — top mode, show top changes of memory
• -T — top mode, show top consumers of memory

🎀 When running in 'top mode', pressing q will quit, a toggles the memory change arrow, and t toggles the top consumers of memory view. keyboard shortcuts, we love to see it. ✨

---

🌈 SEE ALSO 🌈

cpustat(8), eventstat(8), forkstat(8), top(1), vmstat(8)

the whole friend group, go say hi 🫶

---

👑 AUTHOR 👑

smemstat was written by Colin Ian King <colin.i.king@gmail.com>

This manual page was written by Colin Ian King <colin.i.king@gmail.com>, for the Ubuntu project (but may be used by others).

---

⭐ COPYRIGHT ⭐

Copyright © 2014-2021 Canonical Ltd, Copyright © 2021-2024 Colin Ian King.

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

😭 okay so that last bit is the serious one — no warranty, not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. read it, know it, respect it. it's giving legal realness.

---

and that's the whole page, bestie 💖 this was the January 11, 2024 edition of SMEMSTAT(8), from the System Manager's Manual — go forth and measure your memory, you absolute icon 🎀🦋✨