Skip to content

Instantly share code, notes, and snippets.

What would you like to do?
man page for systemctl
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.8.
.TH SYSTEMD "1" "January 2020" "systemd 241 (241)" "User Commands"
systemd \- manual page for systemd 241 (241)
systemctl [OPTIONS...] {COMMAND} ...
Query or send control commands to the systemd manager.
\fB\-h\fR \fB\-\-help\fR
Show this help
Show package version
Connect to system manager
Connect to user service manager
\fB\-H\fR \fB\-\-host\fR=\fI\,[USER\/\fR@]HOST
Operate on remote host
\fB\-M\fR \fB\-\-machine\fR=\fI\,CONTAINER\/\fR
Operate on local container
\fB\-t\fR \fB\-\-type\fR=\fI\,TYPE\/\fR
List units of a particular type
List units with particular LOAD or SUB or ACTIVE state
\fB\-p\fR \fB\-\-property\fR=\fI\,NAME\/\fR
Show only properties by this name
\fB\-a\fR \fB\-\-all\fR
Show all properties/all units currently in memory,
including dead/empty ones. To list all units installed on
the system, use the 'list\-unit\-files' command instead.
Same as \fB\-\-state\fR=\fI\,failed\/\fR
\fB\-l\fR \fB\-\-full\fR
Don't ellipsize unit names on output
\fB\-r\fR \fB\-\-recursive\fR
Show unit list of host and local containers
Show reverse dependencies with 'list\-dependencies'
Specify how to deal with already queued jobs, when
queueing a new job
When showing sockets, explicitly show their type
When showing properties, only print the value
\fB\-i\fR \fB\-\-ignore\-inhibitors\fR
When shutting down or sleeping, ignore inhibitors
Who to send signal to
\fB\-s\fR \fB\-\-signal\fR=\fI\,SIGNAL\/\fR
Which signal to send
Start or stop unit in addition to enabling or disabling it
Only print what would be done
\fB\-q\fR \fB\-\-quiet\fR
Suppress output
For (re)start, wait until service stopped again
For is\-system\-running, wait until startup is completed
Do not wait until operation finished
Don't send wall message before halt/power\-off/reboot
Don't reload daemon after en\-/dis\-abling unit files
Do not print a legend (column headers and hints)
Do not pipe output into a pager
Do not ask for system passwords
Enable/disable/mask unit files globally
Enable/disable/mask unit files temporarily until next
\fB\-f\fR \fB\-\-force\fR
When enabling unit files, override existing symlinks
When shutting down, execute action immediately
Apply only enable, only disable, or all presets
Enable/disable/mask unit files in the specified root
\fB\-n\fR \fB\-\-lines\fR=\fI\,INTEGER\/\fR
Number of journal entries to show
\fB\-o\fR \fB\-\-output\fR=\fI\,STRING\/\fR
Change journal output mode (short, short\-precise,
short\-iso, short\-iso\-precise, short\-full,
short\-monotonic, short\-unix,
verbose, export, json, json\-pretty, json\-sse, cat)
\fB\-\-firmware\-setup\fR Tell the firmware to show the setup menu on next boot
Print unit dependencies as a list instead of a tree
.SS "Unit Commands:"
list\-units [PATTERN...]
List units currently in memory
list\-sockets [PATTERN...]
List socket units currently in memory,
ordered by address
list\-timers [PATTERN...]
List timer units currently in memory,
ordered by next elapse
start UNIT...
Start (activate) one or more units
stop UNIT...
Stop (deactivate) one or more units
reload UNIT...
Reload one or more units
restart UNIT...
Start or restart one or more units
try\-restart UNIT...
Restart one or more units if active
reload\-or\-restart UNIT...
Reload one or more units if possible,
otherwise start or restart
try\-reload\-or\-restart UNIT...
If active, reload one or more units,
if supported, otherwise restart
isolate UNIT
Start one unit and stop all others
kill UNIT...
Send signal to processes of a unit
is\-active PATTERN...
Check whether units are active
is\-failed PATTERN...
Check whether units are failed
status [PATTERN...|PID...]
Show runtime status of one or more units
show [PATTERN...|JOB...]
Show properties of one or more
units/jobs or the manager
cat PATTERN...
Show files and drop\-ins of specified units
set\-property UNIT PROPERTY=VALUE... Sets one or more properties of a unit
help PATTERN...|PID... Show manual for one or more units
reset\-failed [PATTERN...] Reset failed state for all, one, or more
list\-dependencies [UNIT]
Recursively show units which are required
or wanted by this unit or by which this
unit is required or wanted
.SS "Unit File Commands:"
list\-unit\-files [PATTERN...]
List installed unit files
enable [UNIT...|PATH...]
Enable one or more unit files
disable UNIT...
Disable one or more unit files
reenable UNIT...
Reenable one or more unit files
preset UNIT...
Enable/disable one or more unit files
based on preset configuration
Enable/disable all unit files based on
preset configuration
is\-enabled UNIT...
Check whether unit files are enabled
mask UNIT...
Mask one or more units
unmask UNIT...
Unmask one or more units
link PATH...
Link one or more units files into
the search path
revert UNIT...
Revert one or more unit files to vendor
add\-wants TARGET UNIT...
Add 'Wants' dependency for the target
on specified one or more units
add\-requires TARGET UNIT...
Add 'Requires' dependency for the target
on specified one or more units
edit UNIT...
Edit one or more unit files
Get the name of the default target
set\-default TARGET
Set the default target
.SS "Machine Commands:"
list\-machines [PATTERN...]
List local containers and host
.SS "Job Commands:"
list\-jobs [PATTERN...]
List jobs
cancel [JOB...]
Cancel all, one, or more jobs
.SS "Environment Commands:"
Dump environment
set\-environment VARIABLE=VALUE...
Set one or more environment variables
unset\-environment VARIABLE...
Unset one or more environment variables
import\-environment [VARIABLE...]
Import all or some environment variables
.SS "Manager Lifecycle Commands:"
Reload systemd manager configuration
Reexecute systemd manager
.SS "System Commands:"
Check whether system is fully running
Enter system default mode
Enter system rescue mode
Enter system emergency mode
Shut down and halt the system
Shut down and power\-off the system
reboot [ARG]
Shut down and reboot the system
Shut down and reboot the system with kexec
exit [EXIT_CODE]
Request user instance or container exit
switch\-root ROOT [INIT]
Change to a different root file system
Suspend the system
Hibernate the system
Hibernate and suspend the system
Suspend the system, wake after a period of
time and put it into hibernate
See the systemctl(1) man page for details.
The full documentation for
.B systemd
is maintained as a Texinfo manual. If the
.B info
.B systemd
programs are properly installed at your site, the command
.B info systemd
should give you access to the complete manual.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.