X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.xml;h=497dd2bfeeb635a78ab8f835fff303ce7922bab4;hb=3ae83f9896bff49679c8a60e6ff9520557df8b16;hp=a7dc4530ed6aaf20342850662c672bc17b593da0;hpb=bb29785e0df6a7cf07db0259a60bc1f3b4814cb4;p=elogind.git
diff --git a/man/systemd.xml b/man/systemd.xml
index a7dc4530e..497dd2bfe 100644
--- a/man/systemd.xml
+++ b/man/systemd.xml
@@ -8,16 +8,16 @@
Copyright 2010 Lennart Poettering
systemd is free software; you can redistribute it and/or modify it
- under the terms of the GNU General Public License as published by
- the Free Software Foundation; either version 2 of the License, or
+ under the terms of the GNU Lesser General Public License as published by
+ the Free Software Foundation; either version 2.1 of the License, or
(at your option) any later version.
systemd is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
+ Lesser General Public License for more details.
- You should have received a copy of the GNU General Public License
+ You should have received a copy of the GNU Lesser General Public License
along with systemd; If not, see .
-->
@@ -45,7 +45,7 @@
systemdinit
- systemd System and Service Manager
+ systemd system and service manager
@@ -78,7 +78,7 @@
the configuration file
system.conf, otherwise
user.conf. See
- systemd.conf5
+ systemd-system.conf5
for more information.
@@ -95,6 +95,12 @@
Prints a short help
text and exits.
+
+
+
+ Prints a systemd version
+ identifier and exits.
+
@@ -138,11 +144,13 @@
- 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.
+ For ,
+ tell systemd to run a
+ system instance, even if the process ID is
+ not 1, i.e. systemd is not run as init process.
+ does the opposite,
+ running a user instance even if the process
+ ID is 1.
Normally it should not be necessary to
pass these options, as systemd
automatically detects the mode it is
@@ -191,26 +199,16 @@
interpreted as
.
-
-
-
- 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
- .
- Set log
target. Argument must be one of
,
+ ,
,
,
+ ,
,
.
@@ -255,22 +253,29 @@
Sets the default
- output resp. error output for all
- services and sockets, i.e. controls
+ output or error output for all
+ services and sockets, respectively. That is, controls
the default for
- resp.
+ and
(see
systemd.exec5
for details). Takes one of
,
,
,
+ ,
+ ,
,
,
,
. If the
- argument is omitted it defaults to
+ argument is omitted
+
+ defaults to
+ and
+
+ to
.
@@ -483,6 +488,21 @@
by systemd are covered by the Interface
Stability Promise.
+
+ Units may be generated dynamically at boot and
+ system manager reload time, for example based on other
+ configuration files or parameters passed on the kernel
+ command line. For details see the Generators
+ Specification.
+
+ Systems which invoke systemd in a container
+ or initrd environment should implement the
+ Container
+ Interface or initrd
+ Interface specifications, respectively.
@@ -500,9 +520,9 @@
pkg-config systemd
--variable=systemdsystemunitdir. Other
directories checked are
- /usr/local/share/systemd/system
+ /usr/local/lib/systemd/system
and
- /usr/share/systemd/system. User
+ /usr/lib/systemd/system. User
configuration always takes
precedence. pkg-config
systemd
@@ -515,7 +535,9 @@
disable commands of
the
systemctl1
- tool.
+ tool. Full list of directories is provided in
+ systemd.unit5.
+
@@ -544,7 +566,9 @@
tool can handle both global (i.e. for
all users) and private (for one user)
enabling/disabling of
- units.
+ units. Full list of directories is provided in
+ systemd.unit5.
+
@@ -800,13 +824,64 @@
on the kernel command
line.
+
+
+ SIGRTMIN+22
+ SIGRTMIN+23
+
+ Sets the log level to
+ debug
+ (or info on
+ SIGRTMIN+23), as
+ controlled via
+ systemd.log_level=debug
+ (or systemd.log_level=info
+ on SIGRTMIN+23) on
+ the kernel command
+ line.
+
+
+
+ SIGRTMIN+24
+
+ Immediately exits the
+ manager (only available for --user
+ instances).
+
+
+
+ SIGRTMIN+26
+ SIGRTMIN+27
+ SIGRTMIN+28
+ SIGRTMIN+29
+
+ Sets the log level to
+ journal-or-kmsg
+ (or console on
+ SIGRTMIN+27,
+ kmsg on
+ SIGRTMIN+28,
+ or syslog-or-kmsg
+ on SIGRTMIN+29), as
+ controlled via
+ systemd.log_target=journal-or-kmsg
+ (or systemd.log_target=console
+ on SIGRTMIN+27,
+ systemd.log_target=kmsg
+ on SIGRTMIN+28,
+ or
+ systemd.log_target=syslog-or-kmsg
+ on SIGRTMIN+29) on
+ the kernel command
+ line.
+ Environment
-
+ $SYSTEMD_LOG_LEVELsystemd reads the
@@ -905,11 +980,21 @@
Kernel Command Line
- When run as system instance systemd parses a few kernel command line arguments:
+ When run as system instance systemd parses a
+ number of kernel command line
+ argumentsIf run inside a Linux
+ container these arguments may be passed as command
+ line arguments to systemd itself, next to any of the
+ command line options listed in the Options section
+ above. If run outside of Linux containers, these
+ arguments are parsed from
+ /proc/cmdline
+ instead.:
-
+ systemd.unit=
+ rd.systemd.unit=Overrides the unit to
activate on boot. Defaults to
@@ -919,8 +1004,12 @@
rescue.target or
emergency.service. See
systemd.special7
- for details about these
- units.
+ for details about these units. The
+ option prefixed with
+ rd. is honored
+ only in the initial RAM disk (initrd),
+ while the one that isn't prefixed only
+ in the main system.
@@ -975,16 +1064,6 @@
argument. If
shows terse service status updates on
the console during bootup. Defaults to
- .
-
-
-
- systemd.sysv_console=
-
- Takes a boolean
- argument. If
- output of SysV init scripts will be
- directed to the console. Defaults to
, unless
is passed as
kernel command line option in which
@@ -1008,15 +1087,131 @@
systemd.default_standard_output=systemd.default_standard_error=Controls default
- standard output/error output for
+ standard output and error output for
services, with the same effect as the
- resp.
+ and
command line arguments described
- above.
+ above, respectively.
+
+
+
+ systemd.setenv=
+
+ 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 it unsets
+ an environment variable which might be
+ passed in from the initial ram
+ disk.
+
+
+
+ quiet
+
+ Turn off
+ status output at boot, much like
+ systemd.show_status=false
+ would. Note that this option is also
+ read by the kernel itself and disables
+ kernel log output. Passing this option
+ hence turns off the usual output from
+ both the system manager and the kernel.
+
+
+
+
+ debug
+
+ Turn on debugging
+ output. This is equivalent to
+ systemd.log_level=debug.
+ Note that this option is also read by
+ the kernel itself and enables kernel
+ debug output. Passing this option
+ hence turns on the debug output from
+ both the system manager and the
+ kernel.
+
+ emergency
+
+ Boot into emergency
+ mode. This is equivalent to
+ systemd.unit=emergency.target
+ and provided for compatibility
+ reasons and to be easier to type.
+
+
+
+ single
+ s
+ S
+ 1
+
+ Boot into rescue
+ mode. This is equivalent to
+ systemd.unit=rescue.target
+ and provided for compatibility reasons
+ and to be easier to
+ type.
+
+
+
+ 2
+ 3
+ 4
+ 5
+
+ Boot into the
+ specified legacy SysV runlevel. These
+ are equivalent to
+ systemd.unit=runlevel2.target,
+ systemd.unit=runlevel3.target,
+ systemd.unit=runlevel4.target,
+ and systemd.unit=runlevel5.target, respectively,
+ and provided for compatibility reasons
+ and to be easier to
+ type.
+
+
+
+ locale.LANG=
+ locale.LANGUAGE=
+ locale.LC_CTYPE=
+ locale.LC_NUMERIC=
+ locale.LC_TIME=
+ locale.LC_COLLATE=
+ locale.LC_MONETARY=
+ locale.LC_MESSAGES=
+ locale.LC_PAPER=
+ locale.LC_NAME=
+ locale.LC_ADDRESS=
+ locale.LC_TELEPHONE=
+ locale.LC_MEASUREMENT=
+ locale.LC_IDENTIFICATION=
+
+ Set the system locale
+ to use. This overrides the settings in
+ /etc/locale.conf. For
+ more information see
+ locale.conf5
+ and
+ locale7.
+
+
+
+ For other kernel command line parameters
+ understood by components of the core OS, please refer
+ to
+ kernel-command-line7.
@@ -1035,19 +1230,6 @@
-
- /run/systemd/logger
-
- Used internally by the
- systemd-logger.service
- unit to connect STDOUT and/or STDERR
- of spawned processes to
- syslog3
- or the kernel log buffer. This is an
- AF_UNIX stream
- socket.
-
-
/run/systemd/shutdownd
@@ -1089,14 +1271,19 @@
See Also
+ systemd-system.conf5,
+ locale.conf5,
systemctl1,
- systemadm1,
+ journalctl1,
systemd-notify1,
daemon7,
- sd-daemon7,
+ sd-daemon3,
systemd.unit5,
systemd.special5,
- pkg-config1
+ pkg-config1,
+ kernel-command-line7,
+ bootup7,
+ systemd.directives7