Add missing signal action descriptions to running.rst

docs/running.rst

@@ -318,9 +318,21 @@ restart all
    Restart all processes
    Note: restart does not reread config files. For that, see reread and update.
 
-signal
+signal <signal name> <name>
 
-   No help on signal
+   Signal a process
+
+signal <signal name> <gname>:\*
+
+   Signal all processes in a group
+
+signal <signal name> <name> <name>
+
+   Signal multiple processes or groups
+
+signal <signal name> all
+
+   Signal all processes
 
 start <name>
 

supervisor/datatypes.py

@@ -404,6 +404,8 @@ def url(value):
 
 # all valid signal numbers
 SIGNUMS = [ getattr(signal, k) for k in dir(signal) if k.startswith('SIG') ]
+if hasattr(signal, 'SIGRTMIN') and hasattr(signal, 'SIGRTMAX'):
+    SIGNUMS.extend(range(signal.SIGRTMIN, signal.SIGRTMAX + 1))
 
 def signal_number(value):
     try:

supervisor/tests/test_datatypes.py

@@ -750,6 +750,18 @@ def test_raises_for_bad_name(self):
             expected = "value 'BADSIG' is not a valid signal name"
             self.assertEqual(e.args[0], expected)
 
+    @unittest.skipUnless(
+        hasattr(signal, 'SIGRTMIN'), 'real-time signals not available'
+    )
+    def test_accepts_realtime_signal_number(self):
+        self.assertEqual(self._callFUT(signal.SIGRTMIN), signal.SIGRTMIN)
+
+    @unittest.skipUnless(
+        hasattr(signal, 'SIGRTMAX'), 'real-time signals not available'
+    )
+    def test_accepts_realtime_signal_max(self):
+        self.assertEqual(self._callFUT(signal.SIGRTMAX), signal.SIGRTMAX)
+
 class AutoRestartTests(unittest.TestCase):
     def _callFUT(self, arg):
         return datatypes.auto_restart(arg)