X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.service.xml;h=709a448f452426ce6b91b415e14a5497fe5104ab;hb=90d473a1c05c692d0beaac3ff939b01f930fcada;hp=bceb5aa110232043c157574540ed2c858c933cea;hpb=f3e219a238c716ffa06fab7b0618197c090dfd5a;p=elogind.git diff --git a/man/systemd.service.xml b/man/systemd.service.xml index bceb5aa11..709a448f4 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -257,11 +257,19 @@ 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. + 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 value of the environment + variable of the same + name. @@ -270,31 +278,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 +338,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 +351,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.