OOMCTL(1)

πŸ’… OOMCTL(1) β€” the oomctl era

ok so bestie, welcome to oomctl, a page from manual section 1 (that's the "commands you just type" section, iykyk). Buckle up, this one's short and honestly kind of a vibe.


✨ NAME ✨

oomctl β€” analyze the state stored in systemd-oomd. that's it. that's the whole job. she's a state-inspector and she's slaying at it πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

oomctl [OPTIONS...] {COMMAND}

options first, then a command β€” like outfit first, then the fit check. simple.


🌸 DESCRIPTION 🌸

so oomctl is your little window into the various contexts that get read in by the systemd(1) userspace out-of-memory (OOM) killer, aka systemd-oomd(8). (yes, the thing that unalives your memory-hungry processes before your whole session goes down. dramatic, but necessary 🫢)

think of it as the group chat where oomd spills everything she's currently holding onto. you're just here to read the messages, lowkey.


πŸ‘‘ COMMANDS πŸ‘‘

these are the commands she understands, fr fr:

  • dump β€” show the current state of the cgroups and system contexts stored by systemd-oomd. that's the whole tea β˜• the cgroup contexts, the system contexts, all of it, dumped out for your reading pleasure ✨
Added in version 247. (so if you're on something older, she simply wasn't born yet 😭)

πŸ’– OPTIONS πŸ’–

these are the options she gets. all three of them. she's not complicated and that's iconic:

  • -h, --help β€” print a short help text and exit. the "who are you and what do you do" option πŸŽ€
  • --version β€” print a short version string and exit. the "how old are you" option πŸ’€
  • --no-pager β€” do not pipe output into a pager. for when you simply cannot with the scrolling situation and want everything dumped straight to your terminal, no less moment, no waiting πŸ™ˆ

⭐ EXIT STATUS ⭐

  • on success, 0 is returned. slay. πŸŽ‰
  • otherwise you get a non-zero failure code. not slay. something went sideways and she's telling you about it 😭

🌈 SEE ALSO 🌈

go read these too, bestie, they're all in the family:

  • systemd(1)
  • systemd-oomd.service(8)
  • oomd.conf(5)

ok that's the whole page, no cap. she's small, she's focused, she does one thing and she does it well πŸ§šβ€β™€οΈ

this has been oomctl, brought to you by systemd 261.3 β€” now go dump some contexts and have the day you deserve πŸ’œπŸŒΈβœ¨
πŸ“¦ where this page comes from