X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd-run.xml;h=0881561d103d2569f0f800b70b0a93237278446c;hp=98ee4762dd1a5568055ece27494b586e4ebfa2b0;hb=d21ed1ead18d16d35c30299a69d3366847f8a039;hpb=3803cde44c3d949765bdf0e8bce06886224d40b4
diff --git a/man/systemd-run.xml b/man/systemd-run.xml
index 98ee4762d..0881561d1 100644
--- a/man/systemd-run.xml
+++ b/man/systemd-run.xml
@@ -112,6 +112,27 @@ along with systemd; If not, see .
+
+
+
+
+ Execute operation
+ remotely. Specify a hostname, or
+ username and hostname separated by @,
+ to connect to. This will use SSH to
+ talk to the remote machine manager
+ instance.
+
+
+
+
+
+
+ Execute operation on a
+ local container. Specify a container
+ name to connect to.
+
+
@@ -147,11 +168,36 @@ along with systemd; If not, see .
instead of the system.slice.
+
+
+
+
+ After the service's process has terminated, keep
+ the service around until it is explicitly stopped. This is
+ useful to collect runtime information about the service after
+ it finished running. Also see
+ RemainAfterExit= in
+ systemd.service5.
+
+
+
+
+
+
+
+ When terminating the scope unit, send a SIGHUP
+ immediately after SIGTERM. This is useful to indicate to
+ shells and shell-like processes that the connection has been
+ severed. Also see SendSIGHUP= in
+ systemd.kill5.
+
+
+ All command-line arguments after the first non-option
argument become part of the commandline of the launched
- process. If a command is run as service unit its first argument
+ process. If a command is run as service unit, its first argument
needs to be an absolute binary path.
@@ -162,6 +208,23 @@ along with systemd; If not, see .
code otherwise.
+
+ Example
+
+ The following command will log the environment variables
+ provided by systemd to services:
+
+ # systemd-run env
+Running as unit run-19945.service.
+# journalctl -u run-19945.service
+Sep 08 07:37:21 bupkis systemd[1]: Starting /usr/bin/env...
+Sep 08 07:37:21 bupkis systemd[1]: Started /usr/bin/env.
+Sep 08 07:37:21 bupkis env[19948]: PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin
+Sep 08 07:37:21 bupkis env[19948]: LANG=en_US.UTF-8
+Sep 08 07:37:21 bupkis env[19948]: BOOT_IMAGE=/vmlinuz-3.11.0-0.rc5.git6.2.fc20.x86_64
+
+
+
See Also
@@ -170,7 +233,8 @@ along with systemd; If not, see .
systemd.unit5,
systemd.service5,
systemd.scope5,
- systemd.slice5.
+ systemd.slice5,
+ machinectl1