Skip to content

Instantly share code, notes, and snippets.

Embed
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"
.SH NAME
systemd \- manual page for systemd 241 (241)
.SH DESCRIPTION
systemctl [OPTIONS...] {COMMAND} ...
.PP
Query or send control commands to the systemd manager.
.TP
\fB\-h\fR \fB\-\-help\fR
Show this help
.TP
\fB\-\-version\fR
Show package version
.TP
\fB\-\-system\fR
Connect to system manager
.TP
\fB\-\-user\fR
Connect to user service manager
.TP
\fB\-H\fR \fB\-\-host\fR=\fI\,[USER\/\fR@]HOST
Operate on remote host
.TP
\fB\-M\fR \fB\-\-machine\fR=\fI\,CONTAINER\/\fR
Operate on local container
.TP
\fB\-t\fR \fB\-\-type\fR=\fI\,TYPE\/\fR
List units of a particular type
.TP
\fB\-\-state\fR=\fI\,STATE\/\fR
List units with particular LOAD or SUB or ACTIVE state
.TP
\fB\-p\fR \fB\-\-property\fR=\fI\,NAME\/\fR
Show only properties by this name
.TP
\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.
.TP
\fB\-\-failed\fR
Same as \fB\-\-state\fR=\fI\,failed\/\fR
.TP
\fB\-l\fR \fB\-\-full\fR
Don't ellipsize unit names on output
.TP
\fB\-r\fR \fB\-\-recursive\fR
Show unit list of host and local containers
.TP
\fB\-\-reverse\fR
Show reverse dependencies with 'list\-dependencies'
.TP
\fB\-\-job\-mode\fR=\fI\,MODE\/\fR
Specify how to deal with already queued jobs, when
queueing a new job
.TP
\fB\-\-show\-types\fR
When showing sockets, explicitly show their type
.TP
\fB\-\-value\fR
When showing properties, only print the value
.TP
\fB\-i\fR \fB\-\-ignore\-inhibitors\fR
When shutting down or sleeping, ignore inhibitors
.TP
\fB\-\-kill\-who\fR=\fI\,WHO\/\fR
Who to send signal to
.TP
\fB\-s\fR \fB\-\-signal\fR=\fI\,SIGNAL\/\fR
Which signal to send
.TP
\fB\-\-now\fR
Start or stop unit in addition to enabling or disabling it
.TP
\fB\-\-dry\-run\fR
Only print what would be done
.TP
\fB\-q\fR \fB\-\-quiet\fR
Suppress output
.TP
\fB\-\-wait\fR
For (re)start, wait until service stopped again
For is\-system\-running, wait until startup is completed
.TP
\fB\-\-no\-block\fR
Do not wait until operation finished
.TP
\fB\-\-no\-wall\fR
Don't send wall message before halt/power\-off/reboot
.TP
\fB\-\-no\-reload\fR
Don't reload daemon after en\-/dis\-abling unit files
.TP
\fB\-\-no\-legend\fR
Do not print a legend (column headers and hints)
.TP
\fB\-\-no\-pager\fR
Do not pipe output into a pager
.TP
\fB\-\-no\-ask\-password\fR
Do not ask for system passwords
.TP
\fB\-\-global\fR
Enable/disable/mask unit files globally
.TP
\fB\-\-runtime\fR
Enable/disable/mask unit files temporarily until next
reboot
.TP
\fB\-f\fR \fB\-\-force\fR
When enabling unit files, override existing symlinks
When shutting down, execute action immediately
.TP
\fB\-\-preset\-mode=\fR
Apply only enable, only disable, or all presets
.TP
\fB\-\-root\fR=\fI\,PATH\/\fR
Enable/disable/mask unit files in the specified root
directory
.TP
\fB\-n\fR \fB\-\-lines\fR=\fI\,INTEGER\/\fR
Number of journal entries to show
.TP
\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)
.HP
\fB\-\-firmware\-setup\fR Tell the firmware to show the setup menu on next boot
.TP
\fB\-\-plain\fR
Print unit dependencies as a list instead of a tree
.SS "Unit Commands:"
.TP
list\-units [PATTERN...]
List units currently in memory
.TP
list\-sockets [PATTERN...]
List socket units currently in memory,
ordered by address
.TP
list\-timers [PATTERN...]
List timer units currently in memory,
ordered by next elapse
.TP
start UNIT...
Start (activate) one or more units
.TP
stop UNIT...
Stop (deactivate) one or more units
.TP
reload UNIT...
Reload one or more units
.TP
restart UNIT...
Start or restart one or more units
.TP
try\-restart UNIT...
Restart one or more units if active
.TP
reload\-or\-restart UNIT...
Reload one or more units if possible,
otherwise start or restart
.TP
try\-reload\-or\-restart UNIT...
If active, reload one or more units,
if supported, otherwise restart
.TP
isolate UNIT
Start one unit and stop all others
.TP
kill UNIT...
Send signal to processes of a unit
.TP
is\-active PATTERN...
Check whether units are active
.TP
is\-failed PATTERN...
Check whether units are failed
.TP
status [PATTERN...|PID...]
Show runtime status of one or more units
.TP
show [PATTERN...|JOB...]
Show properties of one or more
units/jobs or the manager
.TP
cat PATTERN...
Show files and drop\-ins of specified units
.IP
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
.IP
units
.TP
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:"
.TP
list\-unit\-files [PATTERN...]
List installed unit files
.TP
enable [UNIT...|PATH...]
Enable one or more unit files
.TP
disable UNIT...
Disable one or more unit files
.TP
reenable UNIT...
Reenable one or more unit files
.TP
preset UNIT...
Enable/disable one or more unit files
based on preset configuration
.TP
preset\-all
Enable/disable all unit files based on
preset configuration
.TP
is\-enabled UNIT...
Check whether unit files are enabled
.TP
mask UNIT...
Mask one or more units
.TP
unmask UNIT...
Unmask one or more units
.TP
link PATH...
Link one or more units files into
the search path
.TP
revert UNIT...
Revert one or more unit files to vendor
version
.TP
add\-wants TARGET UNIT...
Add 'Wants' dependency for the target
on specified one or more units
.TP
add\-requires TARGET UNIT...
Add 'Requires' dependency for the target
on specified one or more units
.TP
edit UNIT...
Edit one or more unit files
.TP
get\-default
Get the name of the default target
.TP
set\-default TARGET
Set the default target
.SS "Machine Commands:"
.TP
list\-machines [PATTERN...]
List local containers and host
.SS "Job Commands:"
.TP
list\-jobs [PATTERN...]
List jobs
.TP
cancel [JOB...]
Cancel all, one, or more jobs
.SS "Environment Commands:"
.TP
show\-environment
Dump environment
.TP
set\-environment VARIABLE=VALUE...
Set one or more environment variables
.TP
unset\-environment VARIABLE...
Unset one or more environment variables
.TP
import\-environment [VARIABLE...]
Import all or some environment variables
.SS "Manager Lifecycle Commands:"
.TP
daemon\-reload
Reload systemd manager configuration
.TP
daemon\-reexec
Reexecute systemd manager
.SS "System Commands:"
.TP
is\-system\-running
Check whether system is fully running
.TP
default
Enter system default mode
.TP
rescue
Enter system rescue mode
.TP
emergency
Enter system emergency mode
.TP
halt
Shut down and halt the system
.TP
poweroff
Shut down and power\-off the system
.TP
reboot [ARG]
Shut down and reboot the system
.TP
kexec
Shut down and reboot the system with kexec
.TP
exit [EXIT_CODE]
Request user instance or container exit
.TP
switch\-root ROOT [INIT]
Change to a different root file system
.TP
suspend
Suspend the system
.TP
hibernate
Hibernate the system
.TP
hybrid\-sleep
Hibernate and suspend the system
.TP
suspend\-then\-hibernate
Suspend the system, wake after a period of
time and put it into hibernate
.PP
See the systemctl(1) man page for details.
.PP
+PAM +AUDIT +SELINUX +IMA +APPARMOR +SMACK +SYSVINIT +UTMP +LIBCRYPTSETUP +GCRYPT +GNUTLS +ACL +XZ +LZ4 +SECCOMP +BLKID +ELFUTILS +KMOD \fB\-IDN2\fR +IDN \fB\-PCRE2\fR default\-hierarchy=hybrid
.SH "SEE ALSO"
The full documentation for
.B systemd
is maintained as a Texinfo manual. If the
.B info
and
.B systemd
programs are properly installed at your site, the command
.IP
.B info systemd
.PP
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.