org.freedesktop.oom1 - Man Page

The D-Bus interface of systemd-oomd

Introduction

systemd-oomd.service(8) is a system service which implements a userspace out-of-memory (OOM) killer. 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.

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

Table 1. Killing reasons

ReasonDescription
memory-usedApplication took too much memory and swap.
memory-pressureApplication took enough memory and swap to cause sufficient slowdown of other applications.

Versioning

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

Notes

1.

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

Referenced By

systemd.directives(7), systemd.index(7).

systemd 254