man/systemd.1

   1 '\" t
   2 .\"     Title: systemd
   3 .\"    Author: Lennart Poettering <lennart@poettering.net>
   4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
   5 .\"      Date: 02/15/2012
   6 .\"    Manual: systemd
   7 .\"    Source: systemd
   8 .\"  Language: English
   9 .\"
  10 .TH "SYSTEMD" "1" "02/15/2012" "systemd" "systemd"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 systemd, init \- systemd System and Service Manager
  32 .SH "SYNOPSIS"
  33 .HP \w'\fBsystemd\ \fR\fB[OPTIONS...]\fR\ 'u
  34 \fBsystemd \fR\fB[OPTIONS...]\fR
  35 .HP \w'\fBinit\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB{COMMAND}\fR\ 'u
  36 \fBinit \fR\fB[OPTIONS...]\fR\fB \fR\fB{COMMAND}\fR
  37 .SH "DESCRIPTION"
  38 .PP
  39 systemd is a system and service manager for Linux operating systems\&. When run as first process on boot (as PID 1), it acts as init system that brings up and maintains userspace services\&.
  40 .PP
  41 For compatibility with SysV, if systemd is called as
  42 \fBinit\fR
  43 and a PID that is not 1, it will execute
  44 \fBtelinit\fR
  45 and pass all command line arguments unmodified\&. That means
  46 \fBinit\fR
  47 and
  48 \fBtelinit\fR
  49 are mostly equivalent when invoked from normal login sessions\&. See
  50 \fBtelinit\fR(8)
  51 for more information\&.
  52 .PP
  53 When run as system instance, systemd interprets the configuration file
  54 system\&.conf, otherwise
  55 user\&.conf\&. See
  56 \fBsystemd.conf\fR(5)
  57 for more information\&.
  58 .SH "OPTIONS"
  59 .PP
  60 The following options are understood:
  61 .PP
  62 \fB\-h\fR, \fB\-\-help\fR
  63 .RS 4
  64 Prints a short help text and exits\&.
  65 .RE
  66 .PP
  67 \fB\-\-test\fR
  68 .RS 4
  69 Determine startup sequence, dump it and exit\&. This is an option useful for debugging only\&.
  70 .RE
  71 .PP
  72 \fB\-\-dump\-configuration\-items\fR
  73 .RS 4
  74 Dump understood unit configuration items\&. This outputs a terse but complete list of configuration items understood in unit definition files\&.
  75 .RE
  76 .PP
  77 \fB\-\-introspect=\fR
  78 .RS 4
  79 Extract D\-Bus interface introspection data\&. This is mostly useful at install time to generate data suitable for the D\-Bus interfaces repository\&. Optionally the interface name for the introspection data may be specified\&. If omitted, the introspection data for all interfaces is dumped\&.
  80 .RE
  81 .PP
  82 \fB\-\-unit=\fR
  83 .RS 4
  84 Set default unit to activate on startup\&. If not specified defaults to
  85 default\&.target\&.
  86 .RE
  87 .PP
  88 \fB\-\-system\fR, \fB\-\-user\fR
  89 .RS 4
  90 Tell systemd to run a system instance (resp\&. user instance), even if the process ID is not 1 (resp\&. is 1), i\&.e\&. systemd is not (resp\&. is) run as init process\&. Normally it should not be necessary to pass these options, as systemd automatically detects the mode it is started in\&. These options are hence of little use except for debugging\&. Note that it is not supported booting and maintaining a full system with systemd running in
  91 \fB\-\-system\fR
  92 mode, but PID not 1\&. In practice, passing
  93 \fB\-\-system\fR
  94 explicitly is only useful in conjunction with
  95 \fB\-\-test\fR\&.
  96 .RE
  97 .PP
  98 \fB\-\-dump\-core\fR
  99 .RS 4
 100 Dump core on crash\&. This switch has no effect when run as user instance\&.
 101 .RE
 102 .PP
 103 \fB\-\-crash\-shell\fR
 104 .RS 4
 105 Run shell on crash\&. This switch has no effect when run as user instance\&.
 106 .RE
 107 .PP
 108 \fB\-\-confirm\-spawn\fR
 109 .RS 4
 110 Ask for confirmation when spawning processes\&. This switch has no effect when run as user instance\&.
 111 .RE
 112 .PP
 113 \fB\-\-show\-status=\fR
 114 .RS 4
 115 Show terse service status information while booting\&. This switch has no effect when run as user instance\&. Takes a boolean argument which may be omitted which is interpreted as
 116 \fBtrue\fR\&.
 117 .RE
 118 .PP
 119 \fB\-\-sysv\-console=\fR
 120 .RS 4
 121 Controls whether output of SysV init scripts will be directed to the console\&. This switch has no effect when run as user instance\&. Takes a boolean argument which may be omitted which is interpreted as
 122 \fBtrue\fR\&.
 123 .RE
 124 .PP
 125 \fB\-\-log\-target=\fR
 126 .RS 4
 127 Set log target\&. Argument must be one of
 128 \fBconsole\fR,
 129 \fBjournal\fR,
 130 \fBsyslog\fR,
 131 \fBkmsg\fR,
 132 \fBjournal\-or\-kmsg\fR,
 133 \fBsyslog\-or\-kmsg\fR,
 134 \fBnull\fR\&.
 135 .RE
 136 .PP
 137 \fB\-\-log\-level=\fR
 138 .RS 4
 139 Set log level\&. As argument this accepts a numerical log level or the well\-known
 140 \fBsyslog\fR(3)
 141 symbolic names (lowercase):
 142 \fBemerg\fR,
 143 \fBalert\fR,
 144 \fBcrit\fR,
 145 \fBerr\fR,
 146 \fBwarning\fR,
 147 \fBnotice\fR,
 148 \fBinfo\fR,
 149 \fBdebug\fR\&.
 150 .RE
 151 .PP
 152 \fB\-\-log\-color=\fR
 153 .RS 4
 154 Highlight important log messages\&. Argument is a boolean value\&. If the argument is omitted it defaults to
 155 \fBtrue\fR\&.
 156 .RE
 157 .PP
 158 \fB\-\-log\-location=\fR
 159 .RS 4
 160 Include code location in log messages\&. This is mostly relevant for debugging purposes\&. Argument is a boolean value\&. If the argument is omitted it defaults to
 161 \fBtrue\fR\&.
 162 .RE
 163 .PP
 164 \fB\-\-default\-standard\-output=\fR, \fB\-\-default\-standard\-error=\fR
 165 .RS 4
 166 Sets the default output resp\&. error output for all services and sockets, i\&.e\&. controls the default for
 167 \fBStandardOutput=\fR
 168 resp\&.
 169 \fBStandardError=\fR
 170 (see
 171 \fBsystemd.exec\fR(5)
 172 for details)\&. Takes one of
 173 \fBinherit\fR,
 174 \fBnull\fR,
 175 \fBtty\fR,
 176 \fBjournal\fR,
 177 \fBjournal+console\fR,
 178 \fBsyslog\fR,
 179 \fBsyslog+console\fR,
 180 \fBkmsg\fR,
 181 \fBkmsg+console\fR\&. If the argument is omitted
 182 \fB\-\-default\-standard\-output=\fR
 183 defaults to
 184 \fBjournal\fR
 185 and
 186 \fB\-\-default\-standard\-error=\fR
 187 to
 188 \fBinherit\fR\&.
 189 .RE
 190 .SH "CONCEPTS"
 191 .PP
 192 systemd provides a dependency system between various entities called "units"\&. Units encapsulate various objects that are relevant for system boot\-up and maintenance\&. The majority of units are configured in unit configuration files, whose syntax and basic set of options is described in
 193 \fBsystemd.unit\fR(5), however some are created automatically from other configuration or dynamically from system state\&. Units may be \*(Aqactive\*(Aq (meaning started, bound, plugged in, \&.\&.\&. depending on the unit type, see below), or \*(Aqinactive\*(Aq (meaning stopped, unbound, unplugged, \&.\&.\&.), as well as in the process of being activated or deactivated, i\&.e\&. between the two states (these states are called \*(Aqactivating\*(Aq, \*(Aqdeactivating\*(Aq)\&. A special \*(Aqfailed\*(Aq state is available as well which is very similar to \*(Aqinactive\*(Aq and is entered when the service failed in some way (process returned error code on exit, or crashed, or an operation timed out)\&. If this state is entered the cause will be logged, for later reference\&. Note that the various unit types may have a number of additional substates, which are mapped to the five generalized unit states described here\&.
 194 .PP
 195 The following unit types are available:
 196 .sp
 197 .RS 4
 198 .ie n \{\
 199 \h'-04' 1.\h'+01'\c
 200 .\}
 201 .el \{\
 202 .sp -1
 203 .IP "  1." 4.2
 204 .\}
 205 Service units, which control daemons and the processes they consist of\&. For details see
 206 \fBsystemd.service\fR(5)\&.
 207 .RE
 208 .sp
 209 .RS 4
 210 .ie n \{\
 211 \h'-04' 2.\h'+01'\c
 212 .\}
 213 .el \{\
 214 .sp -1
 215 .IP "  2." 4.2
 216 .\}
 217 Socket units, which encapsulate local IPC or network sockets in the system, useful for socket\-based activation\&. For details about socket units see
 218 \fBsystemd.socket\fR(5), for details on socket\-based activation and other forms of activation, see
 219 \fBdaemon\fR(7)\&.
 220 .RE
 221 .sp
 222 .RS 4
 223 .ie n \{\
 224 \h'-04' 3.\h'+01'\c
 225 .\}
 226 .el \{\
 227 .sp -1
 228 .IP "  3." 4.2
 229 .\}
 230 Target units are useful to group units, or provide well\-known synchronization points during boot\-up, see
 231 \fBsystemd.target\fR(5)\&.
 232 .RE
 233 .sp
 234 .RS 4
 235 .ie n \{\
 236 \h'-04' 4.\h'+01'\c
 237 .\}
 238 .el \{\
 239 .sp -1
 240 .IP "  4." 4.2
 241 .\}
 242 Device units expose kernel devices in systemd and may be used to implement device\-based activation\&. For details see
 243 \fBsystemd.device\fR(5)\&.
 244 .RE
 245 .sp
 246 .RS 4
 247 .ie n \{\
 248 \h'-04' 5.\h'+01'\c
 249 .\}
 250 .el \{\
 251 .sp -1
 252 .IP "  5." 4.2
 253 .\}
 254 Mount units control mount points in the file system, for details see
 255 \fBsystemd.mount\fR(5)\&.
 256 .RE
 257 .sp
 258 .RS 4
 259 .ie n \{\
 260 \h'-04' 6.\h'+01'\c
 261 .\}
 262 .el \{\
 263 .sp -1
 264 .IP "  6." 4.2
 265 .\}
 266 Automount units provide automount capabilities, for on\-demand mounting of file systems as well as parallelized boot\-up\&. See
 267 \fBsystemd.automount\fR(5)\&.
 268 .RE
 269 .sp
 270 .RS 4
 271 .ie n \{\
 272 \h'-04' 7.\h'+01'\c
 273 .\}
 274 .el \{\
 275 .sp -1
 276 .IP "  7." 4.2
 277 .\}
 278 Snapshot units can be used to temporarily save the state of the set of systemd units, which later may be restored by activating the saved snapshot unit\&. For more information see
 279 \fBsystemd.snapshot\fR(5)\&.
 280 .RE
 281 .sp
 282 .RS 4
 283 .ie n \{\
 284 \h'-04' 8.\h'+01'\c
 285 .\}
 286 .el \{\
 287 .sp -1
 288 .IP "  8." 4.2
 289 .\}
 290 Timer units are useful for triggering activation of other units based on timers\&. You may find details in
 291 \fBsystemd.timer\fR(5)\&.
 292 .RE
 293 .sp
 294 .RS 4
 295 .ie n \{\
 296 \h'-04' 9.\h'+01'\c
 297 .\}
 298 .el \{\
 299 .sp -1
 300 .IP "  9." 4.2
 301 .\}
 302 Swap units are very similar to mount units and encapsulate memory swap partitions or files of the operating system\&. They are described in
 303 \fBsystemd.swap\fR(5)\&.
 304 .RE
 305 .sp
 306 .RS 4
 307 .ie n \{\
 308 \h'-04'10.\h'+01'\c
 309 .\}
 310 .el \{\
 311 .sp -1
 312 .IP "10." 4.2
 313 .\}
 314 Path units may be used to activate other services when file system objects change or are modified\&. See
 315 \fBsystemd.path\fR(5)\&.
 316 .RE
 317 .PP
 318 Units are named as their configuration files\&. Some units have special semantics\&. A detailed list is available in
 319 \fBsystemd.special\fR(7)\&.
 320 .PP
 321 systemd knows various kinds of dependencies, including positive and negative requirement dependencies (i\&.e\&.
 322 \fIRequires=\fR
 323 and
 324 \fIConflicts=\fR) as well as ordering dependencies (\fIAfter=\fR
 325 and
 326 \fIBefore=\fR)\&. NB: ordering and requirement dependencies are orthogonal\&. If only a requirement dependency exists between two units (e\&.g\&.
 327 foo\&.service
 328 requires
 329 bar\&.service), but no ordering dependency (e\&.g\&.
 330 foo\&.service
 331 after
 332 bar\&.service) and both are requested to start, they will be started in parallel\&. It is a common pattern that both requirement and ordering dependencies are placed between two units\&. Also note that the majority of dependencies are implicitly created and maintained by systemd\&. In most cases it should be unnecessary to declare additional dependencies manually, however it is possible to do this\&.
 333 .PP
 334 Application programs and units (via dependencies) may request state changes of units\&. In systemd, these requests are encapsulated as \*(Aqjobs\*(Aq and maintained in a job queue\&. Jobs may succeed or can fail, their execution is ordered based on the ordering dependencies of the units they have been scheduled for\&.
 335 .PP
 336 On boot systemd activates the target unit
 337 default\&.target
 338 whose job is to activate on\-boot services and other on\-boot units by pulling them in via dependencies\&. Usually the unit name is just an alias (symlink) for either
 339 graphical\&.target
 340 (for fully\-featured boots into the UI) or
 341 multi\-user\&.target
 342 (for limited console\-only boots for use in embedded or server environments, or similar; a subset of graphical\&.target)\&. However it is at the discretion of the administrator to configure it as an alias to any other target unit\&. See
 343 \fBsystemd.special\fR(7)
 344 for details about these target units\&.
 345 .PP
 346 Processes systemd spawns are placed in individual Linux control groups named after the unit which they belong to in the private systemd hierarchy\&. (see
 347 \m[blue]\fBcgroups\&.txt\fR\m[]\&\s-2\u[1]\d\s+2
 348 for more information about control groups, or short "cgroups")\&. systemd uses this to effectively keep track of processes\&. Control group information is maintained in the kernel, and is accessible via the file system hierarchy (beneath
 349 /sys/fs/cgroup/systemd/), or in tools such as
 350 \fBps\fR(1)
 351 (\fBps xawf \-eo pid,user,cgroup,args\fR
 352 is particularly useful to list all processes and the systemd units they belong to\&.)\&.
 353 .PP
 354 systemd is compatible with the SysV init system to a large degree: SysV init scripts are supported and simply read as an alternative (though limited) configuration file format\&. The SysV
 355 /dev/initctl
 356 interface is provided, and compatibility implementations of the various SysV client tools are available\&. In addition to that, various established Unix functionality such as
 357 /etc/fstab
 358 or the
 359 utmp
 360 database are supported\&.
 361 .PP
 362 systemd has a minimal transaction system: if a unit is requested to start up or shut down it will add it and all its dependencies to a temporary transaction\&. Then, it will verify if the transaction is consistent (i\&.e\&. whether the ordering of all units is cycle\-free)\&. If it is not, systemd will try to fix it up, and removes non\-essential jobs from the transaction that might remove the loop\&. Also, systemd tries to suppress non\-essential jobs in the transaction that would stop a running service\&. Finally it is checked whether the jobs of the transaction contradict jobs that have already been queued, and optionally the transaction is aborted then\&. If all worked out and the transaction is consistent and minimized in its impact it is merged with all already outstanding jobs and added to the run queue\&. Effectively this means that before executing a requested operation, systemd will verify that it makes sense, fixing it if possible, and only failing if it really cannot work\&.
 363 .PP
 364 Systemd contains native implementations of various tasks that need to be executed as part of the boot process\&. For example, it sets the host name or configures the loopback network device\&. It also sets up and mounts various API file systems, such as
 365 /sys
 366 or
 367 /proc\&.
 368 .PP
 369 For more information about the concepts and ideas behind systemd please refer to the
 370 \m[blue]\fBOriginal Design Document\fR\m[]\&\s-2\u[2]\d\s+2\&.
 371 .PP
 372 Note that some but not all interfaces provided by systemd are covered by the
 373 \m[blue]\fBInterface Stability Promise\fR\m[]\&\s-2\u[3]\d\s+2\&.
 374 .SH "DIRECTORIES"
 375 .PP
 376 System unit directories
 377 .RS 4
 378 The systemd system manager reads unit configuration from various directories\&. Packages that want to install unit files shall place them in the directory returned by
 379 \fBpkg\-config systemd \-\-variable=systemdsystemunitdir\fR\&. Other directories checked are
 380 /usr/local/lib/systemd/system
 381 and
 382 /usr/lib/systemd/system\&. User configuration always takes precedence\&.
 383 \fBpkg\-config systemd \-\-variable=systemdsystemconfdir\fR
 384 returns the path of the system configuration directory\&. Packages should alter the content of these directories only with the
 385 \fBenable\fR
 386 and
 387 \fBdisable\fR
 388 commands of the
 389 \fBsystemctl\fR(1)
 390 tool\&.
 391 .RE
 392 .PP
 393 User unit directories
 394 .RS 4
 395 Similar rules apply for the user unit directories\&. However, here the
 396 \m[blue]\fBXDG Base Directory specification\fR\m[]\&\s-2\u[4]\d\s+2
 397 is followed to find units\&. Applications should place their unit files in the directory returned by
 398 \fBpkg\-config systemd \-\-variable=systemduserunitdir\fR\&. Global configuration is done in the directory reported by
 399 \fBpkg\-config systemd \-\-variable=systemduserconfdir\fR\&. The
 400 \fBenable\fR
 401 and
 402 \fBdisable\fR
 403 commands of the
 404 \fBsystemctl\fR(1)
 405 tool can handle both global (i\&.e\&. for all users) and private (for one user) enabling/disabling of units\&.
 406 .RE
 407 .PP
 408 SysV init scripts directory
 409 .RS 4
 410 The location of the SysV init script directory varies between distributions\&. If systemd cannot find a native unit file for a requested service, it will look for a SysV init script of the same name (with the
 411 \&.service
 412 suffix removed)\&.
 413 .RE
 414 .PP
 415 SysV runlevel link farm directory
 416 .RS 4
 417 The location of the SysV runlevel link farm directory varies between distributions\&. systemd will take the link farm into account when figuring out whether a service shall be enabled\&. Note that a service unit with a native unit configuration file cannot be started by activating it in the SysV runlevel link farm\&.
 418 .RE
 419 .SH "SIGNALS"
 420 .PP
 421 SIGTERM
 422 .RS 4
 423 Upon receiving this signal the systemd system manager serializes its state, reexecutes itself and deserializes the saved state again\&. This is mostly equivalent to
 424 \fBsystemctl daemon\-reexec\fR\&.
 425 .sp
 426 systemd user managers will start the
 427 exit\&.target
 428 unit when this signal is received\&. This is mostly equivalent to
 429 \fBsystemctl \-\-user start exit\&.target\fR\&.
 430 .RE
 431 .PP
 432 SIGINT
 433 .RS 4
 434 Upon receiving this signal the systemd system manager will start the
 435 ctrl\-alt\-del\&.target
 436 unit\&. This is mostly equivalent to
 437 \fBsystemctl start ctl\-alt\-del\&.target\fR\&.
 438 .sp
 439 systemd user managers treat this signal the same way as SIGTERM\&.
 440 .RE
 441 .PP
 442 SIGWINCH
 443 .RS 4
 444 When this signal is received the systemd system manager will start the
 445 kbrequest\&.target
 446 unit\&. This is mostly equivalent to
 447 \fBsystemctl start kbrequest\&.target\fR\&.
 448 .sp
 449 This signal is ignored by systemd user managers\&.
 450 .RE
 451 .PP
 452 SIGPWR
 453 .RS 4
 454 When this signal is received the systemd manager will start the
 455 sigpwr\&.target
 456 unit\&. This is mostly equivalent to
 457 \fBsystemctl start sigpwr\&.target\fR\&.
 458 .RE
 459 .PP
 460 SIGUSR1
 461 .RS 4
 462 When this signal is received the systemd manager will try to reconnect to the D\-Bus bus\&.
 463 .RE
 464 .PP
 465 SIGUSR2
 466 .RS 4
 467 When this signal is received the systemd manager will log its complete state in human readable form\&. The data logged is the same as printed by
 468 \fBsystemctl dump\fR\&.
 469 .RE
 470 .PP
 471 SIGHUP
 472 .RS 4
 473 Reloads the complete daemon configuration\&. This is mostly equivalent to
 474 \fBsystemctl daemon\-reload\fR\&.
 475 .RE
 476 .PP
 477 SIGRTMIN+0
 478 .RS 4
 479 Enters default mode, starts the
 480 default\&.target
 481 unit\&. This is mostly equivalent to
 482 \fBsystemctl start default\&.target\fR\&.
 483 .RE
 484 .PP
 485 SIGRTMIN+1
 486 .RS 4
 487 Enters rescue mode, starts the
 488 rescue\&.target
 489 unit\&. This is mostly equivalent to
 490 \fBsystemctl isolate rescue\&.target\fR\&.
 491 .RE
 492 .PP
 493 SIGRTMIN+2
 494 .RS 4
 495 Enters emergency mode, starts the
 496 emergency\&.service
 497 unit\&. This is mostly equivalent to
 498 \fBsystemctl isolate emergency\&.service\fR\&.
 499 .RE
 500 .PP
 501 SIGRTMIN+3
 502 .RS 4
 503 Halts the machine, starts the
 504 halt\&.target
 505 unit\&. This is mostly equivalent to
 506 \fBsystemctl start halt\&.target\fR\&.
 507 .RE
 508 .PP
 509 SIGRTMIN+4
 510 .RS 4
 511 Powers off the machine, starts the
 512 poweroff\&.target
 513 unit\&. This is mostly equivalent to
 514 \fBsystemctl start poweroff\&.target\fR\&.
 515 .RE
 516 .PP
 517 SIGRTMIN+5
 518 .RS 4
 519 Reboots the machine, starts the
 520 reboot\&.target
 521 unit\&. This is mostly equivalent to
 522 \fBsystemctl start reboot\&.target\fR\&.
 523 .RE
 524 .PP
 525 SIGRTMIN+6
 526 .RS 4
 527 Reboots the machine via kexec, starts the
 528 kexec\&.target
 529 unit\&. This is mostly equivalent to
 530 \fBsystemctl start kexec\&.target\fR\&.
 531 .RE
 532 .PP
 533 SIGRTMIN+13
 534 .RS 4
 535 Immediately halts the machine\&.
 536 .RE
 537 .PP
 538 SIGRTMIN+14
 539 .RS 4
 540 Immediately powers off the machine\&.
 541 .RE
 542 .PP
 543 SIGRTMIN+15
 544 .RS 4
 545 Immediately reboots the machine\&.
 546 .RE
 547 .PP
 548 SIGRTMIN+16
 549 .RS 4
 550 Immediately reboots the machine with kexec\&.
 551 .RE
 552 .PP
 553 SIGRTMIN+20
 554 .RS 4
 555 Enables display of status messages on the console, as controlled via
 556 \fIsystemd\&.show_status=1\fR
 557 on the kernel command line\&.
 558 .RE
 559 .PP
 560 SIGRTMIN+21
 561 .RS 4
 562 Disables display of status messages on the console, as controlled via
 563 \fIsystemd\&.show_status=0\fR
 564 on the kernel command line\&.
 565 .RE
 566 .PP
 567 SIGRTMIN+22, SIGRTMIN+23
 568 .RS 4
 569 Sets the log level to
 570 debug
 571 (resp\&.
 572 info
 573 on
 574 SIGRTMIN+23), as controlled via
 575 \fIsystemd\&.log_level=debug\fR
 576 (resp\&.
 577 \fIsystemd\&.log_level=info\fR
 578 on
 579 SIGRTMIN+23) on the kernel command line\&.
 580 .RE
 581 .PP
 582 SIGRTMIN+26, SIGRTMIN+27, SIGRTMIN+28, SIGRTMIN+29
 583 .RS 4
 584 Sets the log level to
 585 journal\-or\-kmsg
 586 (resp\&.
 587 console
 588 on
 589 SIGRTMIN+27; resp\&.
 590 kmsg
 591 on
 592 SIGRTMIN+28; resp\&.
 593 syslog\-or\-kmsg
 594 on
 595 SIGRTMIN+29), as controlled via
 596 \fIsystemd\&.log_target=journal\-or\-kmsg\fR
 597 (resp\&.
 598 \fIsystemd\&.log_target=console\fR
 599 on
 600 SIGRTMIN+27; resp\&.
 601 \fIsystemd\&.log_target=kmsg\fR
 602 on
 603 SIGRTMIN+28; resp
 604 \fIsystemd\&.log_target=syslog\-or\-kmsg\fR
 605 on
 606 SIGRTMIN+29) on the kernel command line\&.
 607 .RE
 608 .SH "ENVIRONMENT"
 609 .PP
 610 \fI$SYSTEMD_LOG_LEVEL\fR
 611 .RS 4
 612 systemd reads the log level from this environment variable\&. This can be overridden with
 613 \fB\-\-log\-level=\fR\&.
 614 .RE
 615 .PP
 616 \fI$SYSTEMD_LOG_TARGET\fR
 617 .RS 4
 618 systemd reads the log target from this environment variable\&. This can be overridden with
 619 \fB\-\-log\-target=\fR\&.
 620 .RE
 621 .PP
 622 \fI$SYSTEMD_LOG_COLOR\fR
 623 .RS 4
 624 Controls whether systemd highlights important log messages\&. This can be overridden with
 625 \fB\-\-log\-color=\fR\&.
 626 .RE
 627 .PP
 628 \fI$SYSTEMD_LOG_LOCATION\fR
 629 .RS 4
 630 Controls whether systemd prints the code location along with log messages\&. This can be overridden with
 631 \fB\-\-log\-location=\fR\&.
 632 .RE
 633 .PP
 634 \fI$XDG_CONFIG_HOME\fR, \fI$XDG_CONFIG_DIRS\fR, \fI$XDG_DATA_HOME\fR, \fI$XDG_DATA_DIRS\fR
 635 .RS 4
 636 The systemd user manager uses these variables in accordance to the
 637 \m[blue]\fBXDG Base Directory specification\fR\m[]\&\s-2\u[4]\d\s+2
 638 to find its configuration\&.
 639 .RE
 640 .PP
 641 \fI$SYSTEMD_UNIT_PATH\fR
 642 .RS 4
 643 Controls where systemd looks for unit files\&.
 644 .RE
 645 .PP
 646 \fI$SYSTEMD_SYSVINIT_PATH\fR
 647 .RS 4
 648 Controls where systemd looks for SysV init scripts\&.
 649 .RE
 650 .PP
 651 \fI$SYSTEMD_SYSVRCND_PATH\fR
 652 .RS 4
 653 Controls where systemd looks for SysV init script runlevel link farms\&.
 654 .RE
 655 .PP
 656 \fI$LISTEN_PID\fR, \fI$LISTEN_FDS\fR
 657 .RS 4
 658 Set by systemd for supervised processes during socket\-based activation\&. See
 659 \fBsd_listen_fds\fR(3)
 660 for more information\&.
 661 .RE
 662 .PP
 663 \fI$NOTIFY_SOCKET\fR
 664 .RS 4
 665 Set by systemd for supervised processes for status and start\-up completion notification\&. See
 666 \fBsd_notify\fR(3)
 667 for more information\&.
 668 .RE
 669 .SH "KERNEL COMMAND LINE"
 670 .PP
 671 When run as system instance systemd parses a few kernel command line arguments:
 672 .PP
 673 \fIsystemd\&.unit=\fR
 674 .RS 4
 675 Overrides the unit to activate on boot\&. Defaults to
 676 default\&.target\&. This may be used to temporarily boot into a different boot unit, for example
 677 rescue\&.target
 678 or
 679 emergency\&.service\&. See
 680 \fBsystemd.special\fR(7)
 681 for details about these units\&.
 682 .RE
 683 .PP
 684 \fIsystemd\&.dump_core=\fR
 685 .RS 4
 686 Takes a boolean argument\&. If
 687 \fBtrue\fR
 688 systemd dumps core when it crashes\&. Otherwise no core dump is created\&. Defaults to
 689 \fBtrue\fR\&.
 690 .RE
 691 .PP
 692 \fIsystemd\&.crash_shell=\fR
 693 .RS 4
 694 Takes a boolean argument\&. If
 695 \fBtrue\fR
 696 systemd spawns a shell when it crashes\&. Otherwise no shell is spawned\&. Defaults to
 697 \fBfalse\fR, for security reasons, as the shell is not protected by any password authentication\&.
 698 .RE
 699 .PP
 700 \fIsystemd\&.crash_chvt=\fR
 701 .RS 4
 702 Takes an integer argument\&. If positive systemd activates the specified virtual terminal when it crashes\&. Defaults to
 703 \-1\&.
 704 .RE
 705 .PP
 706 \fIsystemd\&.confirm_spawn=\fR
 707 .RS 4
 708 Takes a boolean argument\&. If
 709 \fBtrue\fR
 710 asks for confirmation when spawning processes\&. Defaults to
 711 \fBfalse\fR\&.
 712 .RE
 713 .PP
 714 \fIsystemd\&.show_status=\fR
 715 .RS 4
 716 Takes a boolean argument\&. If
 717 \fBtrue\fR
 718 shows terse service status updates on the console during bootup\&. Defaults to
 719 \fBtrue\fR\&.
 720 .RE
 721 .PP
 722 \fIsystemd\&.sysv_console=\fR
 723 .RS 4
 724 Takes a boolean argument\&. If
 725 \fBtrue\fR
 726 output of SysV init scripts will be directed to the console\&. Defaults to
 727 \fBtrue\fR, unless
 728 \fBquiet\fR
 729 is passed as kernel command line option in which case it defaults to
 730 \fBfalse\fR\&.
 731 .RE
 732 .PP
 733 \fIsystemd\&.log_target=\fR, \fIsystemd\&.log_level=\fR, \fIsystemd\&.log_color=\fR, \fIsystemd\&.log_location=\fR
 734 .RS 4
 735 Controls log output, with the same effect as the
 736 \fI$SYSTEMD_LOG_TARGET\fR,
 737 \fI$SYSTEMD_LOG_LEVEL\fR,
 738 \fI$SYSTEMD_LOG_COLOR\fR,
 739 \fI$SYSTEMD_LOG_LOCATION\fR
 740 environment variables described above\&.
 741 .RE
 742 .PP
 743 \fIsystemd\&.default_standard_output=\fR, \fIsystemd\&.default_standard_error=\fR
 744 .RS 4
 745 Controls default standard output/error output for services, with the same effect as the
 746 \fB\-\-default\-standard\-output=\fR
 747 resp\&.
 748 \fB\-\-default\-standard\-error=\fR
 749 command line arguments described above\&.
 750 .RE
 751 .PP
 752 \fIsystemd\&.setenv=\fR
 753 .RS 4
 754 Takes a string argument in the form VARIABLE=VALUE\&. May be used to set environment variables for the init process and all its children at boot time\&. May be used more than once to set multiple variables\&. If the equal sign and variable are missing unsets an environment variable which might be passed in from the initial ram disk\&.
 755 .RE
 756 .SH "SOCKETS AND FIFOS"
 757 .PP
 758 /run/systemd/notify
 759 .RS 4
 760 Daemon status notification socket\&. This is an AF_UNIX datagram socket and is used to implement the daemon notification logic as implemented by
 761 \fBsd_notify\fR(3)\&.
 762 .RE
 763 .PP
 764 /run/systemd/shutdownd
 765 .RS 4
 766 Used internally by the
 767 \fBshutdown\fR(8)
 768 tool to implement delayed shutdowns\&. This is an AF_UNIX datagram socket\&.
 769 .RE
 770 .PP
 771 /run/systemd/private
 772 .RS 4
 773 Used internally as communication channel between
 774 \fBsystemctl\fR(1)
 775 and the systemd process\&. This is an AF_UNIX stream socket\&. This interface is private to systemd and should not be used in external projects\&.
 776 .RE
 777 .PP
 778 /dev/initctl
 779 .RS 4
 780 Limited compatibility support for the SysV client interface, as implemented by the
 781 systemd\-initctl\&.service
 782 unit\&. This is a named pipe in the file system\&. This interface is obsolete and should not be used in new applications\&.
 783 .RE
 784 .SH "SEE ALSO"
 785 .PP
 786
 787 \fBsystemctl\fR(1),
 788 \fBsystemadm\fR(1),
 789 \fBsystemd-notify\fR(1),
 790 \fBdaemon\fR(7),
 791 \fBsd-daemon\fR(7),
 792 \fBsystemd.unit\fR(5),
 793 \fBsystemd.special\fR(5),
 794 \fBpkg-config\fR(1)
 795 .SH "AUTHOR"
 796 .PP
 797 \fBLennart Poettering\fR <\&lennart@poettering\&.net\&>
 798 .RS 4
 799 Developer
 800 .RE
 801 .SH "NOTES"
 802 .IP " 1." 4
 803 cgroups.txt
 804 .RS 4
 805 \%http://www.kernel.org/doc/Documentation/cgroups/cgroups.txt
 806 .RE
 807 .IP " 2." 4
 808 Original Design Document
 809 .RS 4
 810 \%http://0pointer.de/blog/projects/systemd.html
 811 .RE
 812 .IP " 3." 4
 813 Interface Stability Promise
 814 .RS 4
 815 \%http://www.freedesktop.org/wiki/Software/systemd/InterfaceStabilityPromise
 816 .RE
 817 .IP " 4." 4
 818 XDG Base Directory specification
 819 .RS 4
 820 \%http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html
 821 .RE