summaryrefslogtreecommitdiff
path: root/man/systemd-run.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2022-08-25 11:40:57 +0200
committerGitHub <noreply@github.com>2022-08-25 11:40:57 +0200
commit13be736d1f7e3bd41cca3abe289eb23b68b13437 (patch)
tree7d1cd6c3b1321698afd91479be9c5fd0f0e3400d /man/systemd-run.xml
parent5b9ae04c6578f559186d981f0cf88cf36fa652ea (diff)
parent24536bebe0fe4b674fda3ddf960287754e3e3cfe (diff)
downloadsystemd-13be736d1f7e3bd41cca3abe289eb23b68b13437.tar.gz
Merge pull request #24408 from keszybz/execstart-escape
Properly escape ExecStart= commandlines in transient units
Diffstat (limited to 'man/systemd-run.xml')
-rw-r--r--man/systemd-run.xml25
1 files changed, 12 insertions, 13 deletions
diff --git a/man/systemd-run.xml b/man/systemd-run.xml
index 00f1586a5b..0e67911fb0 100644
--- a/man/systemd-run.xml
+++ b/man/systemd-run.xml
@@ -72,7 +72,7 @@
processes of the command are managed by the service manager similarly to normal services, and will show
up in the output of <command>systemctl list-units</command>. Execution in this case is synchronous, and
will return only when the command finishes. This mode is enabled via the <option>--scope</option> switch
- (see below). </para>
+ (see below).</para>
<para>If a command is run with path, socket, or timer options such as <option>--on-calendar=</option> (see below),
a transient path, socket, or timer unit is created alongside the service unit for the specified command. Only the
@@ -82,15 +82,16 @@
<filename>.path</filename>, <filename>.socket</filename>, or <filename>.timer</filename> unit that triggers the
specified unit.</para>
- <para>By default, services created with <command>systemd-run</command> default to the <option>simple</option> type,
- see the description of <varname>Type=</varname> in
+ <para>By default, services created with <command>systemd-run</command> default to the
+ <option>simple</option> type, see the description of <varname>Type=</varname> in
<citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry> for
- details. Note that when this type is used the service manager (and thus the <command>systemd-run</command> command)
- considers service start-up successful as soon as the <function>fork()</function> for the main service process
- succeeded, i.e. before the <function>execve()</function> is invoked, and thus even if the specified command cannot
- be started. Consider using the <option>exec</option> service type (i.e. <option>--property=Type=exec</option>) to
- ensure that <command>systemd-run</command> returns successfully only if the specified command line has been
- successfully started.</para>
+ details. Note that when this type is used, the service manager (and thus the
+ <command>systemd-run</command> command) considers service start-up successful as soon as the
+ <function>fork()</function> for the main service process succeeded, i.e. before the
+ <function>execve()</function> is invoked, and thus even if the specified command cannot be started.
+ Consider using the <option>exec</option> service type (i.e. <option>--property=Type=exec</option>) to
+ ensure that <command>systemd-run</command> returns successfully only if the specified command line has
+ been successfully started.</para>
</refsect1>
<refsect1>
@@ -411,10 +412,8 @@
<xi:include href="standard-options.xml" xpointer="version" />
</variablelist>
- <para>All command line arguments after the first non-option
- argument become part of the command line of the launched
- process. If a command is run as service unit, the first argument
- needs to be an absolute program path.</para>
+ <para>All command line arguments after the first non-option argument become part of the command line of
+ the launched process.</para>
</refsect1>
<refsect1>