aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorGravatar Antoine Damhet <antoine.damhet@lse.epita.fr>2019-09-10 00:24:05 +0200
committerGravatar Hummer12007 <hilobakho@gmail.com>2019-09-19 13:21:27 +0300
commit99c21787cbbbde7ca1eb57abc8e7e3b3101eeb6d (patch)
tree5cd1900315b581201d47a8dca6aaee19a88b4785 /README.md
parent4500f760d4f847bc29d4b85e77d6d7c2a228f9d4 (diff)
Support the new `SetBrightness` logind API
This API from `org.freedesktop.login1.Session` allows an unprivileged user with an active session to change its own backlight. Systemd >= v243 is needed. Signed-off-by: Antoine Damhet <antoine.damhet@lse.epita.fr>
Diffstat (limited to 'README.md')
-rw-r--r--README.md6
1 files changed, 5 insertions, 1 deletions
diff --git a/README.md b/README.md
index d349a4e..9601c9c 100644
--- a/README.md
+++ b/README.md
@@ -18,14 +18,18 @@ One can build and install the program using `make install`. Consult the Makefile
## Permissions
-Modifying brightness requires write permissions for device files. `brightnessctl` accomplishes this (without using `sudo`/`su`/etc.) by either of the following means:
+Modifying brightness requires write permissions for device files or systemd support. `brightnessctl` accomplishes this (without using `sudo`/`su`/etc.) by either of the following means:
1) installing relevant udev rules to add permissions to backlight class devices for users in `video` and leds for users in `input`. (done by default)
2) installing `brightnessctl` as a suid binary.
+3) using the `systemd-logind` API.
+
The behavior is controlled by the `INSTALL_UDEV_RULES` flag (setting it to `1` installs the udev rules, it is the default value).
+The systemd support (since v243) is controlled by the `ENABLE_SYSTEMD` flag (in that case it is recommended to set `INSTALL_UDEV_RULES` to 0).
+
## Usage
```
Usage: brightnessctl [options] [operation] [value]