Run one or more qrunners, once or repeatedly.
![](/@@/translation-newline)
Each named runner class is run in round-robin fashion. In other words, the
![](/@@/translation-newline)
first named runner is run to consume all the files currently in its
![](/@@/translation-newline)
directory. When that qrunner is done, the next one is run to consume all the
![](/@@/translation-newline)
files in /its/ directory, and so on. The number of total iterations can be
![](/@@/translation-newline)
given on the command line.
![](/@@/translation-newline)
Usage: %(PROGRAM)s [options]
![](/@@/translation-newline)
Options:
-r runner[:slice:range]
--runner=runner[:slice:range]
Run the named qrunner, which must be one of the strings returned by
the -l option. Optional slice:range if given, is used to assign
multiple qrunner processes to a queue. range is the total number of
qrunners for this queue while slice is the number of this qrunner from
[0..range).
If using the slice:range form, you better make sure that each qrunner
for the queue is given the same range value. If slice:runner is not
given, then 1:1 is used.
Multiple -r options may be given, in which case each qrunner will run
once in round-robin fashion. The special runner `All' is shorthand
for a qrunner for each listed by the -l option.
--once
-o
Run each named qrunner exactly once through its main loop. Otherwise,
each qrunner runs indefinitely, until the process receives a SIGTERM
or SIGINT.
-l/--list
Shows the available qrunner names and exit.
-v/--verbose
Spit out more debugging information to the logs/qrunner log file.
-s/--subproc
This should only be used when running qrunner as a subprocess of the
mailmanctl startup script. It changes some of the exit-on-error
behavior to work better with that framework.
-h/--help
Print this message and exit.
![](/@@/translation-newline)
runner is required unless -l or -h is given, and it must be one of the names
![](/@@/translation-newline)
displayed by the -l switch.