X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd-run.xml;h=febcdb0262895d540e58bc9f2e11b2f016ef2340;hp=8bb587cf7fad1815e139a4c7181b54260018942c;hb=484122c3458ae5ff5236dd4a6e6ddffcffa08336;hpb=4de33e7f3238a6fe616e61139ab87e221572e5e5
diff --git a/man/systemd-run.xml b/man/systemd-run.xml
index 8bb587cf7..febcdb026 100644
--- a/man/systemd-run.xml
+++ b/man/systemd-run.xml
@@ -1,24 +1,24 @@
-
+
.
systemd-run
- Run programs in transient scope or service units
+ Run programs in transient scope or service or timer units
@@ -56,15 +56,23 @@ along with systemd; If not, see .
ARGS
+
+ systemd-run
+ OPTIONS
+ TIMER OPTIONS
+ COMMAND
+ ARGS
+ Description
- systemd-run may be used to create and start
- a transient .service or a
- .scope unit and run the specified
- COMMAND in it.
+ systemd-run may be used to create and
+ start a transient .service or a transient
+ .timer 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,
@@ -74,6 +82,18 @@ along with systemd; If not, see .
will start the service asynchronously in the background and
immediately return.
+ If a command is run with timer options, transient timer unit
+ also be created with transient service unit. But the transient
+ timer unit is only started immediately. The transient service unit
+ will be started when the transient timer is elapsed. If
+ is specified with timer options, the
+ COMMAND can be omitted. In this case,
+ systemd-run assumes service unit is already
+ loaded and creates transient timer unit only. To successfully
+ create timer unit, already loaded service unit should be specified
+ with . This transient timer unit can
+ activate the existing service unit like any other timer.
+
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
@@ -121,9 +141,9 @@ along with systemd; If not, see .
- Provide description for the service or scope
+ Provide a description for the service or scope
unit. If not specified, the command itself will be used as a
- description. See Description= in
+ description. See Description= in
systemd.unit5.
@@ -205,6 +225,75 @@ along with systemd; If not, see .
+
+
+
+
+ When invoking a command as service connects
+ its standard input and output to the invoking tty via a
+ pseudo TTY device. This allows invoking binaries as services
+ that expect interactive user input, such as interactive
+ command shells.
+
+
+
+
+
+
+ Suppresses additional informational output
+ while running. This is particularly useful in combination with
+ when it will suppress the initial
+ message explaining how to terminate the TTY connection.
+
+
+
+
+
+
+
+
+
+ Defines monotonic timers relative to different
+ starting points. Also see OnActiveSec=,
+ OnBootSec=,
+ OnStartupSec=,
+ OnUnitActiveSec= and
+ OnUnitInactiveSec= in
+ systemd.timer5. This
+ options have no effect in conjunction with
+ .
+
+
+
+
+
+
+ Defines realtime (i.e. wallclock) timers with
+ calendar event expressions. Also see
+ OnCalendar= in
+ systemd.timer5. This
+ option has no effect in conjunction with
+ .
+
+
+
+
+
+
+ Sets a timer unit property for the timer unit
+ that is created. It is similar with
+ but only for created timer
+ unit. This option only has effect in conjunction with
+ , ,
+ ,
+ ,
+ ,
+ . This takes an assignment in
+ the same format as
+ systemctl1's
+ set-property command.
+
+
@@ -214,8 +303,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
+ 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.
@@ -243,13 +332,35 @@ 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
+ 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
+
+ The following command will touch a file after 30 seconds.
+
+ # date; systemd-run --on-active=30 --timer-property=AccuracySec=100ms /bin/touch /tmp/foo
+Mon Dec 8 20:44:24 KST 2014
+Running as unit run-71.timer.
+Will run as unit run-71.service.
+# journalctl -b -u run-73.timer
+-- Logs begin at Fri 2014-12-05 19:09:21 KST, end at Mon 2014-12-08 20:44:54 KST. --
+Dec 08 20:44:38 container systemd[1]: Starting /bin/touch /tmp/foo.
+Dec 08 20:44:38 container systemd[1]: Started /bin/touch /tmp/foo.
+# journalctl -b -u run-73.service
+-- Logs begin at Fri 2014-12-05 19:09:21 KST, end at Mon 2014-12-08 20:44:54 KST. --
+Dec 08 20:44:48 container systemd[1]: Starting /bin/touch /tmp/foo...
+Dec 08 20:44:48 container systemd[1]: Started /bin/touch /tmp/foo.
+
+ The following command invokes /bin/bash
+ as a service passing its standard input, output and error to
+ the calling TTY.
+
+ # systemd-run -t /bin/bash
+
@@ -263,6 +374,7 @@ Sep 08 07:37:21 bupkis env[19948]: BOOT_IMAGE=/vmlinuz-3.11.0-0.rc5.git6.2.fc20.
systemd.slice5,
systemd.exec5,
systemd.resource-control5,
+ systemd.timer5,
machinectl1