X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd-run.xml;h=98ee4762dd1a5568055ece27494b586e4ebfa2b0;hp=4ced9bfc00b5d1233d560291e97a5793cb751bdd;hb=3803cde44c3d949765bdf0e8bce06886224d40b4;hpb=dc7adf202b82fc0054c457ce6ca3bcedb88dde57
diff --git a/man/systemd-run.xml b/man/systemd-run.xml
index 4ced9bfc0..98ee4762d 100644
--- a/man/systemd-run.xml
+++ b/man/systemd-run.xml
@@ -44,7 +44,7 @@ along with systemd; If not, see .
systemd-run
- Run programs as volatile systemd units
+ Run programs in transient scope or service units
@@ -60,11 +60,26 @@ along with systemd; If not, see .
Description
- systemd-run may be used
- create a transient .service unit
- or a .scope unit and launch the
- specified COMMAND as part
- of this unit.
+ systemd-run may be used create and start
+ a transient .service or a
+ .scope unit and run the specified
+ COMMAND in it.
+
+ 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 systemctl
+ list-units like any other unit. It will run in a clean
+ and detached execution environment. systemd-run
+ will start the service asynchronously in the background and
+ immediately return.
+
+ If a command is run as transient scope unit, it will be
+ started directly by systemd-run 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 systemctl
+ list-units. Execution in this case is synchronous, and
+ execution will return only when the command finishes.
@@ -92,8 +107,8 @@ along with systemd; If not, see .
- Talk to the systemd manager of the calling
- user.
+ Talk to the service manager of the calling user,
+ rather than the service manager of the system.
@@ -101,7 +116,7 @@ along with systemd; If not, see .
- Create a .scope unit instead of
+ Create a transient .scope unit instead of
the default transient .service unit.
@@ -136,7 +151,8 @@ along with systemd; If not, see .
All command-line arguments after the first non-option
argument become part of the commandline of the launched
- process.
+ process. If a command is run as service unit its first argument
+ needs to be an absolute binary path.
@@ -150,6 +166,7 @@ along with systemd; If not, see .
See Alsosystemd1,
+ systemctl1,
systemd.unit5,
systemd.service5,
systemd.scope5,