summaryrefslogtreecommitdiff
path: root/src/mailman/interfaces/runner.py
diff options
context:
space:
mode:
authorBarry Warsaw2013-06-17 09:36:43 -0400
committerBarry Warsaw2013-06-17 09:36:43 -0400
commit41059ed20ec668baf41cceaf539f8017171e9651 (patch)
tree391b33289ecb1d02905a897ed581ac9538531f10 /src/mailman/interfaces/runner.py
parentbffd71903475efad53ce6aa59c96a704a905a984 (diff)
downloadmailman-41059ed20ec668baf41cceaf539f8017171e9651.tar.gz
mailman-41059ed20ec668baf41cceaf539f8017171e9651.tar.zst
mailman-41059ed20ec668baf41cceaf539f8017171e9651.zip
Diffstat (limited to 'src/mailman/interfaces/runner.py')
-rw-r--r--src/mailman/interfaces/runner.py17
1 files changed, 9 insertions, 8 deletions
diff --git a/src/mailman/interfaces/runner.py b/src/mailman/interfaces/runner.py
index c54415c7a..a8b76652c 100644
--- a/src/mailman/interfaces/runner.py
+++ b/src/mailman/interfaces/runner.py
@@ -63,15 +63,16 @@ class IRunner(Interface):
through the main loop.
""")
- # BAW 2013-05-30: but see LP: #1184376 for why this perhaps should be
- # removed entirely.
- intercept_signals = Attribute("""\
- Should the runner mechanism intercept signals?
+ def set_signals():
+ """Set up the signal handlers necessary to control the runner.
- In general, the runner catches SIGINT, SIGTERM, SIGUSR1, and SIGHUP to
- manage the process. Some runners need to manage their own signals,
- and set this attribute to False.
- """)
+ The runner should catch the following signals:
+ - SIGTERM and SIGINT: treated exactly the same, they cause the runner
+ to exit with no restart from the master.
+ - SIGUSR1: Also causes the runner to exit, but the master watcher will
+ retart it.
+ - SIGHUP: Re-open the log files.
+ """
def _one_iteration():
"""The work done in one iteration of the main loop.