cfb47790ad
Systemd provides the status of a given user and system session as a human readable string. Retrieve this information via RequestSystemState and guard the retrieve of failed units depending on this request. The functionality is extended but does not change, which means that failed units in any granularity are displayed as before. Update documentation in the meantime. Signed-off-by: Steffen Kothe <steffen.kothe@skothe.net>
88 lines
1.8 KiB
Markdown
88 lines
1.8 KiB
Markdown
waybar-systemd-failed-units(5)
|
|
|
|
# NAME
|
|
|
|
waybar - systemd failed units monitor module
|
|
|
|
# DESCRIPTION
|
|
|
|
The *systemd-failed-units* module displays the number of failed systemd units.
|
|
|
|
# CONFIGURATION
|
|
|
|
Addressed by *systemd-failed-units*
|
|
|
|
*format*: ++
|
|
typeof: string ++
|
|
default: *{nr_failed} failed* ++
|
|
The format, how information should be displayed. This format is used when other formats aren't specified.
|
|
|
|
*format-ok*: ++
|
|
typeof: string ++
|
|
This format is used when there is no failing units.
|
|
|
|
*user*: ++
|
|
typeof: bool ++
|
|
default: *true* ++
|
|
Option to count user systemd units.
|
|
|
|
*system*: ++
|
|
typeof: bool ++
|
|
default: *true* ++
|
|
Option to count systemwide (PID=1) systemd units.
|
|
|
|
*hide-on-ok*: ++
|
|
typeof: bool ++
|
|
default: *true* ++
|
|
Option to hide this module when there is no failing units.
|
|
|
|
*menu*: ++
|
|
typeof: string ++
|
|
Action that popups the menu.
|
|
|
|
*menu-file*: ++
|
|
typeof: string ++
|
|
Location of the menu descriptor file. There need to be an element of type
|
|
GtkMenu with id *menu*
|
|
|
|
*menu-actions*: ++
|
|
typeof: array ++
|
|
The actions corresponding to the buttons of the menu.
|
|
|
|
*expand*: ++
|
|
typeof: bool ++
|
|
default: false ++
|
|
Enables this module to consume all left over space dynamically.
|
|
|
|
# FORMAT REPLACEMENTS
|
|
|
|
*{nr_failed_system}*: Number of failed units from systemwide (PID=1) systemd.
|
|
|
|
*{nr_failed_user}*: Number of failed units from user systemd.
|
|
|
|
*{nr_failed}*: Number of total failed units.
|
|
|
|
*{systemd_state}:* State of the systemd system session
|
|
|
|
*{user_state}:* State of the systemd user session
|
|
|
|
*{overall_state}:* Overall state of the systemd and user session. ("Ok" or "Degraded")
|
|
|
|
# EXAMPLES
|
|
|
|
```
|
|
"systemd-failed-units": {
|
|
"hide-on-ok": false,
|
|
"format": "✗ {nr_failed}",
|
|
"format-ok": "✓",
|
|
"system": true,
|
|
"user": false,
|
|
}
|
|
```
|
|
|
|
# STYLE
|
|
|
|
- *#systemd-failed-units*
|
|
- *#systemd-failed-units.ok*
|
|
- *#systemd-failed-units.degraded*
|