comparison doc/commands.txt @ 752:673ec182679d

Allow ''timeout'' parameter to be set on sh:exec, python:exec and python:distutils commands, which kills the commands after the given number of seconds. This makes it much easier to deal with runaway processes. Small fix to killing processes-- ''kill'' isn't an attribute of subprocess. It's an attribute of subprocess.Popen. This is a good solution for #380-- set limits on the processes running the steps, and you'll eventually get through the build. Other tickets for ignoring a build fill in the rest. Closes #380. Will update http://bitten.edgewall.org/wiki/Documentation/commands.html when this goes in.
author wbell
date Sat, 24 Apr 2010 13:21:29 +0000
parents 59e67e5df620
children 3e22750b4168
comparison
equal deleted inserted replaced
749:94a4be5a1f0f 752:673ec182679d
103 +----------------+-----------------------------------------------------------+ 103 +----------------+-----------------------------------------------------------+
104 | ``output`` | Path to the output file | 104 | ``output`` | Path to the output file |
105 +----------------+-----------------------------------------------------------+ 105 +----------------+-----------------------------------------------------------+
106 | ``args`` | Any arguments to pass to the executable or script | 106 | ``args`` | Any arguments to pass to the executable or script |
107 +----------------+-----------------------------------------------------------+ 107 +----------------+-----------------------------------------------------------+
108 | `timeout` | Limits the runtime of this command to the specified |
109 | | number of seconds, after which it will be terminated. |
110 +----------------+-----------------------------------------------------------+
111
108 112
109 Either ``executable`` or ``file`` must be specified. 113 Either ``executable`` or ``file`` must be specified.
110 114
111 Examples 115 Examples
112 -------- 116 --------
649 | ``args`` | Any arguments that should be passed to the script. | 653 | ``args`` | Any arguments that should be passed to the script. |
650 +----------------+-----------------------------------------------------------+ 654 +----------------+-----------------------------------------------------------+
651 | ``output`` | Path to a file where any output by the script should be | 655 | ``output`` | Path to a file where any output by the script should be |
652 | | recorded. | 656 | | recorded. |
653 +----------------+-----------------------------------------------------------+ 657 +----------------+-----------------------------------------------------------+
658 | ``timeout`` | Limits the runtime of this command to the specified |
659 | | number of seconds, after which it will be terminated. |
660 +----------------+-----------------------------------------------------------+
661
654 662
655 Either `file` or `module` must be specified. 663 Either `file` or `module` must be specified.
656 664
657 Examples 665 Examples
658 -------- 666 --------
690 | `command` | The name of the `distutils` command that should be run | 698 | `command` | The name of the `distutils` command that should be run |
691 +----------------+-----------------------------------------------------------+ 699 +----------------+-----------------------------------------------------------+
692 | `options` | Additional options to pass to the command, separated by | 700 | `options` | Additional options to pass to the command, separated by |
693 | | spaces | 701 | | spaces |
694 +----------------+-----------------------------------------------------------+ 702 +----------------+-----------------------------------------------------------+
703 | `timeout` | Limits the runtime of this command to the specified |
704 | | number of seconds, after which it will be terminated. |
705 +----------------+-----------------------------------------------------------+
706
695 707
696 Examples 708 Examples
697 -------- 709 --------
698 710
699 .. code-block:: xml 711 .. code-block:: xml
Copyright (C) 2012-2017 Edgewall Software