X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.service.xml;h=e4fa6bcc7c6fc14177c774754c74854352c0082a;hp=d6c0e3fd9429e33db906469c6fb807c427b92f2e;hb=b24a167b6f0f9a44686736734e6d0cec07e1efa3;hpb=96d4ce01103ebebe9335fb321667043bb620c06b diff --git a/man/systemd.service.xml b/man/systemd.service.xml index d6c0e3fd9..e4fa6bcc7 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -271,11 +271,11 @@ - an exit code of the command normally considered a failure (i.e. non-zero exit status or - abormal exit due to signal) is ignored + abnormal exit due to signal) is ignored and considered success. If both - and @ are used for the - same command the former must preceed + same command the former must precede the latter. Unless Type=forking is set, the process started via this @@ -292,8 +292,11 @@ $FOO may appear as separate word on the command line in which case the variable is replaced by - its value split at - whitespaces. + its value split at whitespaces. Note + that the first argument (i.e. the + binary to execute) may not be a + variable, and must be a literal and + absolute path name. @@ -304,14 +307,14 @@ the command in ExecStart=. Multiple command lines may be concatenated in a - single directive, by seperating them + single directive, by separating them by semicolons (these semicolons must be passed as separate 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, + once with the same effect. However, the latter syntax is not recommended for compatibility with parsers suitable for XDG @@ -341,7 +344,7 @@ daemon, and may be used for command lines like the following: /bin/kill -HUP - $(MAINPID). + $MAINPID. @@ -365,7 +368,7 @@ requested. Specifier and environment variable substitution is supported (including - $(MAINPID), see + $MAINPID, see above). @@ -423,19 +426,28 @@ Restart= Configures whether the - main service process shall be restarted when - it exists. Takes one of - , - or - . If - set to (the - default) the service will not be - restarted when it exits. If set to - it - will be restarted only when it exited - cleanly, i.e. terminated with an exit - code of 0. If set to - the + main service process shall be + restarted when it exits. Takes one of + , + , + , + or + . If set to + (the default) the + service will not be restarted when it + exits. If set to + it will be + restarted only when it exited cleanly, + i.e. terminated with an exit code of + 0. If set to + it will be + restarted only when it exited with an + exit code not equalling 0, or when + terminated by a signal. If set to + it will be + restarted only if it exits due to + reception of an uncaught signal. If + set to the service will be restarted regardless whether it exited cleanly or not, or got terminated abnormally by a @@ -545,7 +557,7 @@ group and the control group continues to exist after stop unless it is empty. Defaults to - . + . Processes will first be terminated via SIGTERM. If then after @@ -585,7 +597,7 @@ or . If no daemon status - updates are accepted by the service + updates are accepted from the service processes, all status update messages are ignored. If only service updates sent from the @@ -599,6 +611,60 @@ Type=notify (see above). + + Sockets= + Specifies the name of + the socket units this service shall + inherit the sockets from when the + service (ignoring the different suffix + of course) is started. Normally it + should not be necessary to use this + setting as all sockets whose unit + shares the same name as the service + are passed to the spawned + process. + + Note that the same socket may be + passed to multiple processes at the + same time. Also note that a different + service may be activated on incoming + traffic than inherits the sockets. Or + in other words: The + Service= setting of + .socket units + doesn't have to match the inverse of the + Sockets= setting of + the .service it + refers to. + + + + FsckPassNo= + Set the fsck passno + priority to use to order this service + in relation to other file system + checking services. This option is only + necessary to fix ordering in relation + to fsck jobs automatically created for + all /etc/fstab + entries with a value in the fs_passno + column > 0. As such it should only be + used as option for fsck + services. Almost always it is a better + choice to add explicit ordering + directives via + After= or + Before=, + instead. For more details see + systemd.unit5. If + used, pass an integer value in the + same range as + /etc/fstab's + fs_passno column. See + fstab5 + for details. + +