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=c3eebeabc1950395f31b1f03340dbe846c25fe9c;hb=5471472d441d9ac48640f11a3b07e6a1fd6d1b63;hpb=b1690fe70afa090545933560e9cbcbb8aa0387c4 diff --git a/man/systemd.service.xml b/man/systemd.service.xml index c3eebeabc..e4fa6bcc7 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -164,7 +164,7 @@ to , however it is expected that the process has to exit before systemd starts follow-up - units. ValidNoProcess= + units. RemainAfterExit= is particularly useful for this type of service. @@ -205,7 +205,7 @@ - ValidNoProcess= + RemainAfterExit= Takes a boolean value that specifies whether the service @@ -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 @@ -290,10 +290,13 @@ by the string value of the environment variable of the same name. Also $FOO may appear as - seperate word on the command line in + 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 seperate words). In that + 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. + +