diff options
| -rw-r--r-- | man/systemd-run.xml | 37 | ||||
| -rw-r--r-- | src/run/run.c | 2 |
2 files changed, 28 insertions, 11 deletions
diff --git a/man/systemd-run.xml b/man/systemd-run.xml index 4ced9bfc00..98ee4762dd 100644 --- a/man/systemd-run.xml +++ b/man/systemd-run.xml @@ -44,7 +44,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <refnamediv> <refname>systemd-run</refname> - <refpurpose>Run programs as volatile systemd units</refpurpose> + <refpurpose>Run programs in transient scope or service units</refpurpose> </refnamediv> <refsynopsisdiv> @@ -60,11 +60,26 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <refsect1> <title>Description</title> - <para><command>systemd-run</command> may be used - create a transient <filename>.service</filename> unit - or a <filename>.scope</filename> unit and launch the - specified <replaceable>COMMAND</replaceable> as part - of this unit.</para> + <para><command>systemd-run</command> may be used create and start + a transient <filename>.service</filename> or a + <filename>.scope</filename> unit and run the specified + <replaceable>COMMAND</replaceable> in it.</para> + + <para>If a command is run as transient service unit, it will be + started and managed by the service manager like any other service, + and thus show up in the output of <command>systemctl + list-units</command> like any other unit. It will run in a clean + and detached execution environment. <command>systemd-run</command> + will start the service asynchronously in the background and + immediately return.</para> + + <para>If a command is run as transient scope unit, it will be + started directly by <command>systemd-run</command> and thus + inherit the execution environment of the caller. It is however + managed by the service manager similar to normal services, and + will also show up in the output of <command>systemctl + list-units</command>. Execution in this case is synchronous, and + execution will return only when the command finishes.</para> </refsect1> <refsect1> @@ -92,8 +107,8 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <term><option>--user</option></term> <listitem> - <para>Talk to the systemd manager of the calling - user.</para> + <para>Talk to the service manager of the calling user, + rather than the service manager of the system.</para> </listitem> </varlistentry> @@ -101,7 +116,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <term><option>--scope</option></term> <listitem> - <para>Create a <filename>.scope</filename> unit instead of + <para>Create a transient <filename>.scope</filename> unit instead of the default transient <filename>.service</filename> unit. </para> </listitem> @@ -136,7 +151,8 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <para>All command-line arguments after the first non-option argument become part of the commandline of the launched - process.</para> + process. If a command is run as service unit its first argument + needs to be an absolute binary path.</para> </refsect1> <refsect1> @@ -150,6 +166,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>. <title>See Also</title> <para> <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>, + <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>systemd.scope</refentrytitle><manvolnum>5</manvolnum></citerefentry>, diff --git a/src/run/run.c b/src/run/run.c index e5a62d9e35..e56a977de3 100644 --- a/src/run/run.c +++ b/src/run/run.c @@ -38,7 +38,7 @@ static const char *arg_slice = NULL; static int help(void) { printf("%s [OPTIONS...] [COMMAND LINE...]\n\n" - "Notify the init system about service status updates.\n\n" + "Run the specified command in a transient scope or service unit.\n\n" " -h --help Show this help\n" " --version Show package version\n" " --user Run as user unit\n" |