OS Manuals

org.freedesktop.oom1(5)

ORG.FREEDESKTOP.OOM1(5) org.freedesktop.oom1 ORG.FREEDESKTOP.OOM1(5)


.SH "NAME" org.freedesktop.oom1 - The D-Bus interface of systemd-oomd


.SH "INTRODUCTION"


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


.SH "THE MANAGER OBJECT"


.PP 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 { ... }; };


.SS "Methods"


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


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


.sp
Table 1. Killing reasons

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


.SH "VERSIONING"


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


.SH "HISTORY"


.SS "The Manager Object"


.PP Killed() was added in version 252.


.SH "SEE ALSO"


.PP systemd(1), systemd-oomd.service(8), oomctl(1)

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

systemd 262.2-r1 · os · ingested 2026-11-06