gmemusage(1)

💖 gmemusage — bestie edition 💖

okay so real talk, this is gmemusage(1) from the General Commands Manual section of your fave Unix system, and she's here to show you exactly which of your little processes is eating all the RAM. 🍓

---

✨ NAME ✨

gmemusage — graphically display memory used by running processes. that's it, that's the whole vibe. 💅

---

🌸 SYNOPSIS 🌸

gmemusage [ options ]

yes bestie, that's the entire thing. just yeet some options at her and she'll do the rest. 🦋

---

👑 DESCRIPTION 👑

Gmemusage is lowkey a glow-up of the program with the same name on Silicon Graphics' workstations. she graphically displays the contents of memory on a running system, all broken up by individual process. it's giving stacked bar graph energy: the height of each area = the RSS size of that process. and on top of that she also shows you the process name, the number of processes with that name, and the size in kilobytes. icon, honestly. ✨

here's the tea though: any process taking up less memory than a user-specifiable threshhold gets merged into one single area on the graph. and multiple processes with the same name? also merged into a single area. no duplicates allowed, we're consolidating. 💅

while she's running, gmemusage accepts these keys:

• Q or q — exit the program. bye bestie 🫶
• Up Arrow — increase the minimum threshhold by 10 kb. 📈
• Down Arrow — decrease the minimum threshhold by 10 kb. 📉

and every other key? (not-so-silently!) ignored. 😭 she will let you know. she is not subtle about it.

---

🎀 OPTIONS 🎀

Gmemusage accepts the following command-line options (defaults are chillin' in the brackets):

• -name resourcename — the class name to use for resources (Gmemusage)
• -display display — which X server to contact ($DISPLAY environment variable)
• -geometry geometry — initial window geometry (320x400)
• -font font — use font font for drawing text (fixed)
• -background color — color for the window background (grey4)
• -update seconds — update interval (5 seconds)
• -threshhold kb — threshhold below which small processes are merged (400 kb)
• -ncolors #colors — how many different colors to use (3)
• -color1 color — name of first color (red/maroon)
• -color2 color — name of second color (green/OliveDrab)
• -color3 color — name of third color (blue/SlateBlue)
• -color[4-9] color — names of the remaining colors (undefined)
• -help — print a short help message. we love a helpful queen 💖

ngl, -threshhold really is spelled with three h's in the actual option name. do not "correct" her, she's been like this since 1998 and she's thriving.

---

🌈 RESOURCES 🌈

Gmemusage understands the following X resources. wanna know what each one does? go peek at the OPTIONS section, it's all there bestie.

name (class Name)
display (class Display)
geometry (class Geometry)
font (class Font)
background (class Background)
update (class Interval)
threshhold (class Threshhold)
ncolors (class NColors)
color1 (class Color)
color2 (class Color)
color3 (class Color)
color[4-9] (class Color)

---

💀 BUGS 💀

See the TODO file which comes with the distribution. (she's aware, she's working on it, she's in her growth era 🧚)

---

🔥 SEE ALSO 🔥

top(1), ps(1), xosview(1).

---

⭐ VERSION ⭐

Gmemusage version 0.2, 1998/01/14

---

💜 AUTHOR 💜

Raju Mathur (raju@sgi.com) aka OldMonk.

---

🦋 SITE 🦋

the canonical site for gmemusage is right here, no cap:

http://reality.sgi.com/raju/software

---

🎀 COPYRIGHT 🎀

Gmemusage is copyright (C) 1997, 1998 by Raju Mathur. See the file COPYING in the source directory for copyright information.

---

and that's the whole page, bestie. brought to you by Silicon Graphics, dated 14 January 1998, version energy forever. stay hydrated, check your RSS, and remember: if a process is taking up too much memory, that's not a you problem, that's a top(1) problem. 💅✨🫶