117 lines
2.9 KiB
Markdown
117 lines
2.9 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 are 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 are no failed units.
|
|
|
|
*tooltip-format*: ++
|
|
typeof: string ++
|
|
default: *System: {system_state}\nUser: {user_state}\nFailed units ({nr_failed}):\n{failed_units_list}* ++
|
|
Tooltip format shown when there are failed units.
|
|
|
|
*tooltip-format-ok*: ++
|
|
typeof: string ++
|
|
default: *System: {system_state}\nUser: {user_state}* ++
|
|
Tooltip format used when there are no failed units.
|
|
|
|
*tooltip-unit-format*: ++
|
|
typeof: string ++
|
|
default: *{name}: {description}* ++
|
|
Format used to render each failed unit inside the tooltip. Each item is prefixed with a bullet.
|
|
|
|
*menu*: ++
|
|
typeof: string ++
|
|
Action that pops up the menu.
|
|
|
|
*menu-file*: ++
|
|
typeof: string ++
|
|
Location of the menu descriptor file. There needs 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 leftover 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.
|
|
|
|
*{system_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")
|
|
|
|
*{failed_units_list}:* Bulleted list of failed units using *tooltip-unit-format*. Empty when
|
|
there are no failed units.
|
|
|
|
The *tooltip-unit-format* string supports the following replacements:
|
|
|
|
*{name}*: Unit name ++
|
|
*{description}*: Unit description ++
|
|
*{load_state}*: Unit load state ++
|
|
*{active_state}*: Unit active state ++
|
|
*{sub_state}*: Unit sub state ++
|
|
*{scope}*: Either *system* or *user* depending on where the unit originated
|
|
|
|
# EXAMPLES
|
|
|
|
```
|
|
"systemd-failed-units": {
|
|
"hide-on-ok": false,
|
|
"format": "✗ {nr_failed}",
|
|
"format-ok": "✓",
|
|
"system": true,
|
|
"user": false,
|
|
"tooltip-format": "{nr_failed} failed units:\n{failed_units_list}",
|
|
"tooltip-unit-format": "{scope}: {name} ({active_state})",
|
|
}
|
|
```
|
|
|
|
# STYLE
|
|
|
|
- *#systemd-failed-units*
|
|
- *#systemd-failed-units.ok*
|
|
- *#systemd-failed-units.degraded*
|