X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.service.xml;h=94a21d3fe3d99c2160611e590c15d70de69a2344;hb=ccbe77e993317eef933bd4f4d383c3f2b2db74bc;hp=bceb5aa110232043c157574540ed2c858c933cea;hpb=f3e219a238c716ffa06fab7b0618197c090dfd5a;p=elogind.git
diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index bceb5aa11..94a21d3fe 100644
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -256,12 +256,32 @@
token will be passed as
argv[0] to the
executed process, followed by the
- further arguments specified. Unless
- Type=forking is set,
- the process started via this command
- line will be considered the main
- process of the
- daemon.
+ further arguments specified. If the
+ first token is prefixed with
+ - an error code of
+ the command normally considered a
+ failure is ignored and considered
+ success. If both -
+ and @ are used for
+ the same command the latter must
+ preceed the latter. Unless
+ Type=forking is
+ set, the process started via this
+ command line will be considered the
+ main process of the daemon. The
+ command line accepts % specifiers as
+ described in
+ systemd.unit5. On
+ top of that basic environment variable
+ substitution is supported, where
+ ${FOO} is replaced
+ by the string value of the environment
+ variable of the same name. Also
+ $FOO may appear as
+ seperate word on the command line in
+ which case the variable is replaced by
+ its value split at
+ whitespaces.
@@ -270,31 +290,58 @@
Additional commands
that are executed before (resp. after)
the command in
- ExecStart=. If
- specified more than once, all commands
- are executed one after the other,
- serially. Use of these settings is
- optional.
+ ExecStart=. Multiple
+ command lines may be concatenated in a
+ single directive, by seperating them
+ by semicolons (these semicolons must
+ be passed as seperate words). In that
+ case, the commands are executed one
+ after the other,
+ serially. Alternatively, these
+ directives may be specified more than
+ once whith the same effect. However,
+ the latter syntax is not recommended
+ for compatibility with parsers
+ suitable for XDG
+ .desktop files.
+ Use of these settings is
+ optional. Specifier and environment
+ variable substitution is
+ supported.
ExecReload=
Commands to execute to
trigger a configuration reload in the
- service. If used more than once, all
- commands are executed one after the
- other, serially. Use of this setting is optional.
-
+ service. This argument takes multiple
+ command lines, following the same
+ scheme as pointed out for
+ ExecStartPre=
+ above. Use of this setting is
+ optional. Specifier and environment
+ variable substitution is supported
+ here following the same scheme as for
+ ExecStart=. One
+ special environment variable is set:
+ if known $MAINPID is
+ set to the main process of the
+ daemon, and may be used for command
+ lines like the following:
+ /bin/kill -HUP
+ $(MAINPID).
ExecStop=
Commands to execute to
stop the service started via
- ExecStart=. If used
- more than once, all commands are
- executed one after the other,
- serially. Use of this setting is
+ ExecStart=. This
+ argument takes multiple command lines,
+ following the same scheme as pointed
+ out for
+ ExecStartPre=
+ above. Use of this setting is
optional. All processes remaining for
a service after the commands
configured in this option are run are
@@ -303,7 +350,11 @@
(see below). If this option is not
specified the process is terminated
right-away when service stop is
- requested.
+ requested. Specifier and environment
+ variable substitution is supported
+ (including
+ $(MAINPID), see
+ above).
@@ -312,11 +363,15 @@
that are executed after the service
was stopped using the commands
configured in
- ExecStop=. If
- specified more than once, all commands
- are executed one after the other,
- serially. Use of these settings is
- optional.
+ ExecStop=. This
+ argument takes multiple command lines,
+ following the same scheme as pointed
+ out for
+ ExecStartPre. Use
+ of these settings is
+ optional. Specifier and environment
+ variable substitution is
+ supported.