systemctl
Subcommands
Name | Description |
---|---|
list-units | List units currently in memory |
list-sockets | List socket units currently in memory ordered by address |
list-timers | List timer units currently in memory ordered by next elapse |
is-active | Check whether units are active |
is-failed | Check whether units are failed |
status | Show runtime status of one or more units |
show | Show properties of one or more |
cat | Show files and drop-ins of specified units |
help | Show manual for one or more units |
list-dependencies | Recursively show units which are required or wanted by the units or by which those |
start | Start (activate) one or more units |
stop | Stop (deactivate) one or more units |
reload | Reload one or more units |
restart | Start or restart one or more units |
try-restart | Restart one or more units if active |
reload-or-restart | Reload one or more units if possible, otherwise start or restart |
try-reload-or-restart | If active, reload one or more units, if supported, otherwise restart |
isolate | Start one unit and stop all others |
kill | Send signal to processes of a unit |
clean | Clean runtime, cache, state, logs or configuration of unit |
freeze | Freeze execution of unit processes |
thaw | Resume execution of a frozen unit |
set-property | Sets one or more properties of a unit |
bind | Bind-mount a path from the host into a unit's namespace |
mount-image | Mount an image from the host into a unit's namespace |
service-log-level | Get/set logging threshold for service |
service-log-target | Get/set logging target for service |
reset-failed | Reset failed state for all, one, or more units |
list-unit-files | List installed unit files |
enable | Enable one or more unit files |
disable | Disable one or more unit files |
reenable | Reenable one or more unit files |
preset | Enable/disable one or more unit files based on preset configuration |
preset-all | Enable/disable all unit files based on preset configuration |
mask | Mask one or more unit files |
unmask | Unmask one or more unit files |
link | Link one or more units files into the search path |
revert | Revert one or more unit files to vendor version |
add-wants | Add 'Wants' dependency for the target on specified one or more units |
add-requires | Add 'Requires' dependency for the target on specified one or more units |
edit | Edit one or more unit files |
get-default | Get the name of the default target |
set-default | Set the default target |
list-jobs | List jobs |
cancel | Cancel all, one, or more jobs |
show-environment | Dump environment |
set-environment | Set one or more environment variables |
unset-environment | Unset one or more environment variables |
import-environment | Import all or some environment variables |
daemon-reload | Reload systemd manager configuration |
daemon-reexec | Reexecute systemd manager |
log-level | Get/set logging threshold for manager |
log-target | Get/set logging target for manager |
service-watchdogs | Get/set service watchdog state |
is-system-running | Check whether system is fully running |
default | Enter system default mode |
rescue | Enter system rescue mode |
emergency | Enter system emergency mode |
halt | Shut down and halt the system |
poweroff | Shut down and power-off the system |
reboot | Shut down and reboot the system |
kexec | Shut down and reboot the system with kexec |
exit | Request user instance or container exit |
switch-root | Change to a different root file system |
suspend | Suspend the system |
hibernate | Hibernate the system |
hybrid-sleep | Hibernate and suspend the system |
suspend-then-hibernate | Suspend the system, wake after a period of time, and hibernate |
Options
Name | Description |
---|---|
-h, --help | Show this help |
--version | Show package version |
--system | Connect to system manager |
--user | Connect to user service manager |
-H, --host <[USER@]HOST> | Operate on remote host |
-M, --machine <CONTAINER> | Operate on a local container |
-t, --type <TYPE> | List units of a particular type |
--state <STATE> | List units with particular LOAD or SUB or ACTIVE state |
--failed | Shortcut for --state=failed |
-p, --property <NAME> | Show only properties by this name |
-P | Equivalent to --value --property=NAME |
-a, --all | Show all properties/all units currently in memory, including dead/empty ones. To list all units installed on the system, use 'list-unit-files' instead |
-l, --full | Don't ellipsize unit names on output |
-r, --recursive | Show unit list of host and local containers |
--reverse | Show reverse dependencies with 'list-dependencies' |
--with-dependencies | Show unit dependencies with 'status', 'cat', 'list-units', and 'list-unit-files' |
--job-mode <MODE> | Specify how to deal with already queued jobs, when queueing a new job |
-T, --show-transaction | When enqueuing a unit job, show full transaction |
--show-types | When showing sockets, explicitly show their type |
--value | When showing properties, only print the value |
--check-inhibitors <MODE> | Specify if checking inhibitors before shutting down sleeping or hibernating |
-i | Shortcut for --check-inhibitors=no |
--kill-who <WHO> | Whom to send signal to |
-s, --signal <SIGNAL> | Which signal to send |
--what <RESOURCES> | Which types of resources to remove |
--now | Start or stop unit after enabling or disabling it |
--dry-run | Only print what would be done |
-q, --quiet | Supress output |
--wait | For (re)start, wait until service stopped again. For is-system-running, wait until startup is completed |
--no-block | Do not wait until operation finished |
--no-wall | Don't send wall message before halt/power-off/reboot |
--no-reload | Don't reload daemon after en-/dis-abling unit files |
--legend <BOOL> | Enable/disable the legend (column headers and hints) |
--no-pager | Do not pipe output into a pager |
--no-ask-password | Do not ask for system passwords |
--global | Edit/enable/disable/mask default user unit files globally |
--runtime | Edit/enable/disable/mask unit files temporarily until next reboot |
-f, --force | When enabling unit files, override existing symlinks. When shutting down, execute action immediately |
--preset-mode <MODE> | Apply only enable, only disable, or all presets |
--root <PATH> | Edit/enable/disable/mask unit files in the specified root directory |
-n, --lines <N> | Number of journal entries to show |
-o, --output <MODE> | Change journal output mode |
--firmware-setup | Tell the firmware to show the setup menu on next boot |
--boot-loader-menu <TIME> | Boot into boot loader menu on next boot |
--boot-loader-entry <NAME> | Boot into a specific boot loader entry on next boot |
--plain | Print unit dependencies as a list instead of a tree |
--timestamp <FORMAT> | Change format of printed timestamps |
--read-only | Create read-only bind mount |
--mkdir | Create directory before mounting, if missing |
--marked | Restart/reload previously marked units |