X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd-run.xml;h=28a9878b8360718cb6f2d48711bd7548568a43ef;hb=9c0f842033c577d58b6b263073468ec5802478fc;hp=fc2131eb2f6a99cd96d13e624f64b2f7ce5e75b4;hpb=88ae7333ee052e64607ae6678fe0e84991fe3482;p=elogind.git
diff --git a/man/systemd-run.xml b/man/systemd-run.xml
index fc2131eb2..28a9878b8 100644
--- a/man/systemd-run.xml
+++ b/man/systemd-run.xml
@@ -1,4 +1,4 @@
-
+
@@ -89,27 +89,6 @@ along with systemd; If not, see .
The following options are understood:
-
-
-
-
- Execute the 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 the operation on a
- local container. Specify a container
- name to connect to.
-
-
@@ -127,12 +106,24 @@ along with systemd; If not, see .
generated one.
+
+
+
+
+ Sets a unit property for the scope or service
+ unit that is created. This takes an assignment in the same
+ format as
+ systemctl1's
+ set-property command.
+
+
+
- Provide description for the unit. If not
- specified, the command itself will be used as a description.
- See Description= in
+ Provide a description for the service or scope
+ unit. If not specified, the command itself will be used as a
+ description. See Description= in
systemd.unit5.
@@ -149,10 +140,10 @@ along with systemd; If not, see .
- 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
+ After the service or scope 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.
@@ -162,24 +153,69 @@ along with systemd; If not, see .
- 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
+ When terminating the scope or service 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.
+
+
+
+ Sets the service type. Also see
+ Type= in
+ systemd.service5. This
+ option has no effect in conjunction with
+ . Defaults to
+ simple.
+
+
+
+
+
+
+
+ Runs the service process under the UNIX user
+ and group. Also see User= and
+ Group= in
+ systemd.exec5.
+
+
+
+
+
+
+ Runs the service process with the specified
+ nice level. Also see Nice= in
+ systemd.exec5.
+
+
+
+
+
+
+ Runs the service process with the specified
+ environment variables set. Also see
+ Environment= in
+ systemd.exec5.
+
+
+
+
+
- All command-line arguments after the first non-option
- argument become part of the commandline of the launched
+ 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, its first argument
needs to be an absolute binary path.
@@ -192,7 +228,7 @@ along with systemd; If not, see .
- Example
+ ExamplesThe following command will log the environment variables
provided by systemd to services:
@@ -205,6 +241,15 @@ 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
+
+ The following command invokes the
+ updatedb8
+ tool, but lowers the block IO weight for it to 10. See
+ systemd.resource-control5
+ for more information on the BlockIOWeight=
+ property.
+
+ # systemd-run -p BlockIOWeight=10 updatedb
@@ -216,6 +261,8 @@ Sep 08 07:37:21 bupkis env[19948]: BOOT_IMAGE=/vmlinuz-3.11.0-0.rc5.git6.2.fc20.
systemd.service5,
systemd.scope5,
systemd.slice5,
+ systemd.exec5,
+ systemd.resource-control5,
machinectl1