waybar-systemd-failed-units - Man Page
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. This replacement is only available in tooltip-format and tooltip-format-ok; it is not supplied to format/format-ok and using it there breaks label rendering.
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