ORG.FREEDESKTOP.OOM1(5)

🎀 NAME 🎀

okay bestie, this is org.freedesktop.oom1(5) — literally the D-Bus interface of systemd-oomd. That’s the whole name-and-what-it-is moment. 💅

---

🌸 INTRODUCTION 🌸

systemd-oomd.service(8) is a system service that implements a userspace out-of-memory (OOM) killer. No cap. This page describes the D-Bus interface. 🦋

---

👑 THE MANAGER OBJECT 👑

The service exposes the following interfaces on the Manager object on the bus:

node /org/freedesktop/oom1 {
  interface org.freedesktop.oom1.Manager {
    methods:
      DumpByFileDescriptor(out h fd);
    signals:
      Killed(s cgroup,
             s reason);
  };
  interface org.freedesktop.DBus.Peer { ... };
  interface org.freedesktop.DBus.Introspectable { ... };
  interface org.freedesktop.DBus.Properties { ... };
};

🫶 Methods 🫶

Killed() signal is sent when any cgroup is killed by oomd. periodt. 💀

Note that more reasons will be added in the future, and the table below will be expanded accordingly. 👑

🍓 Table 1. Killing reasons 🍓

• memory-used — Application took too much memory and swap.
• memory-pressure — Application took enough memory and swap to cause sufficient slowdown of other applications.

---

🌈 VERSIONING 🌈

These D-Bus interfaces follow the usual interface versioning guidelines[1]. slay. ✨

---

💜 HISTORY 💜

✨ The Manager Object ✨

Killed() was added in version 252. iconic behavior. 👑

---

🔥 SEE ALSO 🔥

• systemd(1)
• systemd-oomd.service(8)
• oomctl(1)

---

🧚 NOTES 🧚

1. the usual interface versioning guidelines — https://0pointer.de/blog/projects/versioning-dbus.html

💖 that’s the whole page, brought to you by systemd 261.3 — mwah 💋