X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd-run.xml;h=f57c13b50008c2051826e03c2335b7b922f652ea;hp=9ca17df55a7d6f1d5ad298ee33ad2c5d3f56d193;hb=e56cdb7ae2657d62c9a8b6d3427382b209dff8e7;hpb=dca348bcbb462305864526c587495a14a76bfcde diff --git a/man/systemd-run.xml b/man/systemd-run.xml index 9ca17df55..f57c13b50 100644 --- a/man/systemd-run.xml +++ b/man/systemd-run.xml @@ -1,4 +1,4 @@ - + @@ -45,7 +45,7 @@ along with systemd; If not, see . 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 @@ -123,7 +143,7 @@ along with systemd; If not, see . 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