diff options
| author | Lennart Poettering <lennart@poettering.net> | 2014-08-21 18:50:42 +0200 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2014-08-21 18:50:42 +0200 |
| commit | 96fb8242cc1ef6b0e28f6c86a4f57950095dd7f1 (patch) | |
| tree | ab027af32c2452d075292817111425657d466f6e /man | |
| parent | 1954ea346dc28226c0fffde848d49a297165b0a9 (diff) | |
service: allow services of Type=oneshot that specify no ExecStart= commands
This is useful for services that simply want to run something on
shutdown, but not at bootup. They should only set ExecStop= but leave
ExecStart= unset.
Diffstat (limited to 'man')
| -rw-r--r-- | man/systemd.service.xml | 44 |
1 files changed, 27 insertions, 17 deletions
diff --git a/man/systemd.service.xml b/man/systemd.service.xml index 5c4bd6569f..e584a1f006 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -139,9 +139,10 @@ <para>If set to <option>simple</option> (the default - value if neither + if neither <varname>Type=</varname> nor - <varname>BusName=</varname> are + <varname>BusName=</varname>, but + <varname>ExecStart=</varname> are specified), it is expected that the process configured with <varname>ExecStart=</varname> is the @@ -177,13 +178,17 @@ exits.</para> <para>Behavior of - <option>oneshot</option> is similar - to <option>simple</option>; however, - it is expected that the process has to + <option>oneshot</option> is similar to + <option>simple</option>; however, it + is expected that the process has to exit before systemd starts follow-up units. <varname>RemainAfterExit=</varname> is particularly useful for this type - of service.</para> + of service. This is the implied + default if neither + <varname>Type=</varname> or + <varname>ExecStart=</varname> are + specified.</para> <para>Behavior of <option>dbus</option> is similar to @@ -313,22 +318,27 @@ <para>When <varname>Type</varname> is not <option>oneshot</option>, only one - command may be given. When + command may and must be given. When <varname>Type=oneshot</varname> is - used, more than one command may be - specified. Multiple command lines may - be concatenated in a single directive - by separating them with semicolons - (these semicolons must be passed as - separate words). Alternatively, this - directive may be specified more than - once with the same effect. - Lone semicolons may be escaped as + used, none or more than one command + may be specified. Multiple command + lines may be concatenated in a single + directive by separating them with + semicolons (these semicolons must be + passed as separate + words). Alternatively, this directive + may be specified more than once with + the same effect. Lone semicolons may + be escaped as <literal>\;</literal>. If the empty string is assigned to this option, the list of commands to start is reset, prior assignments of this option will - have no effect.</para> + have no effect. If no + <varname>ExecStart=</varname> is + specified, then the service must have + <varname>RemainAfterExit=yes</varname> + set.</para> <para>Each command line is split on whitespace, with the first item being |