libraries/kcgroups/README.md

0001 # KCGroups
0002
0003 This library allows easy access to currently running applications and their control groups resources, using the [systemd dbus API](https://www.freedesktop.org/wiki/Software/systemd/dbus/).
0004
0005 More info here: https://www.freedesktop.org/software/systemd/man/systemd.resource-control.html
0006
0007 # Introduction
0008
0009 To control an application's cgroup resources, use KApplicationScope.
0010
0011 To find a list of currently running applications, use KApplicationScopeLister.
0012
0013 For use in QML, KApplicationScopeListModel is provided to interact with an updated list of KApplicationScope's.
0014
0015 [List of Classes](annotated.html)
0016
0017 ## Requirements
0018
0019 - systemd >= 238 (for neon I used this PPA: https://launchpad.net/~ddstreet/+archive/ubuntu/systemd-upstream)
0020 - `systemd.unified_cgroup_hierarchy=1` on the kernel command line (in /etc/default/grub)
0021 - `Delegate=cpu` in `/etc/systemd/system/user@.service.d/override.conf` to be able to control CPU resources from user systemd
0022 - install `dbus-user-session` to get the user systemd instance to connect to the session bus
0023 - run applications in systemd scopes by starting them with `systemd-run --user --scope --unit org.kde.krun-<app_name>-<uuid>.desktop -- <app>`. There is a currently a patch to let `KRun` launch apps this way