Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Timeout & signal predicates

Signal patterns

Some signal predicates attempt to match the signal number against a pattern supplied in the argument. The syntax for patterns is as follows.

  • Individual codes: 1
  • Inclusive ranges: 1..5
  • Combinations of patterns: 1,2,3,10..15
  • Whitespace is allowed: 1, 2, 3
  • Note that valid status codes are in the range [0, 255]

Retry predicates

--retry-if-timeout

Stop retrying if the command was killed specifically due to a timeout. This requires that the --timeout option is also specified.

--retry-if-killed

Retry if the command was killed by any signal. Note this implies --retry-if-timeout, because timeouts use signals to terminate processes.

--retry-if-signal <PATTERN>

Retrying if the command was killed by any signal matching the given pattern.

This is only available on Unix systems.

Stop predicates

--stop-if-timeout

Stop retrying if the command was killed specifically due to a timeout. This requires that the --timeout option is also specified.

--stop-if-killed

Stop retrying if the command was killed by any signal. Note this implies --stop-if-timeout, because timeouts use signals to terminate processes.

--stop-if-signal <PATTERN>

Stop retrying if the command was killed by any signal matching the given pattern.

This is only available on Unix systems.