diff options
| author | Lennart Poettering <lennart@poettering.net> | 2017-11-13 17:17:53 +0100 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2017-11-16 14:38:36 +0100 |
| commit | fe9d0be90ba142bf06d43a831d8be53283415caa (patch) | |
| tree | 0bb24b88f0c0b347d3d9c9d05863fbb9339c8400 /man/systemd-run.xml | |
| parent | 5afe510c89f26b0e721b276a0e78af914b47f0b0 (diff) | |
| download | systemd-fe9d0be90ba142bf06d43a831d8be53283415caa.tar.gz | |
run: add "-G" as shortcut for "--property=CollectMode=inactive-or-failed"
This option is likely to be very useful for systemd-run invocations,
hence let's add a shortcut for it.
With this new concepts it's now very easy to put together systemd-run
invocations that leave zero artifacts in the system, including when they
fail.
Diffstat (limited to 'man/systemd-run.xml')
| -rw-r--r-- | man/systemd-run.xml | 15 |
1 files changed, 15 insertions, 0 deletions
diff --git a/man/systemd-run.xml b/man/systemd-run.xml index 2c74c1f39c..010c9c7197 100644 --- a/man/systemd-run.xml +++ b/man/systemd-run.xml @@ -324,6 +324,21 @@ <option>--no-block</option>, <option>--scope</option> or the various timer options.</para></listitem> </varlistentry> + <varlistentry> + <term><option>-G</option></term> + <term><option>--collect</option></term> + + <listitem><para>Unload the transient unit after it completed, even if it failed. Normally, without this option, + all units that ran and failed are kept in memory until the user explicitly resets their failure state with + <command>systemctl reset-failed</command> or an equivalent command. On the other hand, units that ran + successfully are unloaded immediately. If this option is turned on the "garbage collection" of units is more + aggressive, and unloads units regardless if they exited successfully or failed. This option is a shortcut for + <command>--property=CollectMode=inactive-or-failed</command>, see the explanation for + <varname>CollectMode=</varname> in + <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry> for further + information.</para></listitem> + </varlistentry> + <xi:include href="user-system-options.xml" xpointer="user" /> <xi:include href="user-system-options.xml" xpointer="system" /> <xi:include href="user-system-options.xml" xpointer="host" /> |