Run one or more qrunners, once or repeatedly.
Each named runner class is run in round-robin fashion. In other words, the
first named runner is run to consume all the files currently in its
directory. When that qrunner is done, the next one is run to consume all the
files in /its/ directory, and so on. The number of total iterations can be
given on the command line.
Usage: %(PROGRAM)s [options]
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.
runner is required unless -l or -h is given, and it must be one of the names
displayed by the -l switch.
Note also that this script should be started up from mailmanctl as a normal
operation. It is only useful for debugging if it is run separately.
