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 [fast | now]

rebootmgrctl soft-reboot [fast | now]

rebootmgrctl cancel

rebootmgrctl status [--quiet]

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

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 [fast|now]

Tells rebootmgrd to schedule a reboot. With the [now] option, a forced reboot is done and a maintenance window is ignored. With the [fast] option a defined maintenance window is ignored.

soft-reboot [fast|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. With the [fast] option a defined maintenance window is ignored.

status [--quiet]

Prints the current status of rebootmgrd. 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

A new strategy to reboot the machine is set and written into /etc/rebootmgr.conf.

best-effort

This is the default strategy. If a maintenance window is specified, the strategy will be maint-window. If no maintenance window is specified, the machine is immediately rebooted (instantly).

maint-window

Reboot does happen only during a specified maintenance window. If no window is specified, the instantly strategy is followed.

instantly

Other services will be informed that a reboot will happen. Reboot will be done without waiting for a maintenance window.

off

Reboot requests are temporary ignored. /etc/rebootmgr.conf is not modified.

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].

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>

11/11/2024 rebootmgr