Scroll to navigation

REBOOTMGRCTL(1) rebootmgrctl REBOOTMGRCTL(1)

NAME

rebootmgrctl - Tool to control and configure the reboot manager daemon.

SYNOPSIS

rebootmgrctl [--help | --version]

rebootmgrctl is-active [--quiet]

rebootmgrctl reboot [now]

rebootmgrctl soft-reboot [now]

rebootmgrctl cancel

rebootmgrctl status [--full] [--quiet]

rebootmgrctl set-strategy best-effort | maint-window | instantly | off | on

rebootmgrctl get-strategy

rebootmgrctl set-window time duration

rebootmgrctl get-window

DESCRIPTION

rebootmgrctl is used to query and configure the rebootmgrd(8) process.

OPTIONS

--help

display help text and exit

--version

output version information and exit

cancel

Cancels an already running reboot.

is-active [--quiet]

Prints if the rebootmgrd is running and active or not. With the [--quiet] option, rebootmgrctl does not print any output, but returns 0 if rebootmgrd is running or 1 if not.

reboot [now]

Tells rebootmgrd to schedule a reboot. With the [now] option, a forced reboot is done and a maintenance window is ignored. If there is already a reboot or soft-reboot scheduled, this request is ignored.

soft-reboot [now]

Tells rebootmgrd to schedule a soft-reboot (see systemd-soft-reboot.service(8)). With the [now] option, a forced soft-reboot is done and a maintenance window is ignored. If there is already a reboot or soft-reboot scheduled, this request is ignored.

status [--full|--quiet]

Prints the current status of rebootmgrd. With the [--full] option, not only the current status, but also the configuration values currently in use are printed. With the [--quiet] option, rebootmgrctl does not print any output, but returns the current reboot status as return value. Valid values are:

0

No reboot requested

1

Reboot requested

2

Reboot requested, waiting for maintenance window

set-strategy best-effort|maint-window|instantly|off|on

A new strategy to reboot the machine is written in /etc/rebootmgr/rebootmgr.conf.d/50-strategy.conf.

best-effort

This is the default setting. If a maintenance window is specified, maint-window is used. If no maintenance window is specified, the reboot takes place immediately (instantly).

maint-window

Reboot only during a specific maintenance window. If no maintenance window is specified, the system reboots immediately.

instantly

The reboot is carried out without waiting for a maintenance window.

off

rebootmgrd continues to run, but ignores all reboot timers that expire in the meantime. The configuration file is not updated, so this option is no longer active after a reboot. When rebootmgr is reactivated, it will continue to use the old specified maintenance window and any reboot timers that are still running will no longer be ignored.

on

Reboots will be enabled again.

get-strategy

The currently used reboot strategy of rebootmgrd will be printed.

set-window time duration

Set's the maintenance window. The format of time is a calendar event described in systemd.time(7). The format of duration is [XXh][YYm].

A new maintenance window is written in /etc/rebootmgr/rebootmgr.conf.d/50-maintenance-window.conf.

get-window

The currently set maintenance window will be printed.

SEE ALSO

systemd.time(7), systemd-soft-reboot.service(8)

AUTHOR

Thorsten Kukuk <kukuk@suse.de>

07/22/2025 rebootmgr