Merge pull request #768 from oliver-sanders/6438

document cylc-flow#6438
cylc · Nov 21, 2024 · 7f4b9c7 · 7f4b9c7
2 parents 7fb4cad + 13c9988
commit 7f4b9c7
Show file tree

Hide file tree

Showing 2 changed files with 23 additions and 1 deletion.
diff --git a/...ing-workflows/handling-job-preemption.rst → ...user-guide/running-workflows/advanced.rst b/...ing-workflows/handling-job-preemption.rst → ...user-guide/running-workflows/advanced.rst
@@ -1,3 +1,25 @@
+Advanced
+========
+
+
+Scheduler Signals
+-----------------
+
+The Cylc scheduler will shutdown gracefully on receipt of any of the following
+signals:
+
+* ``SIGINT``
+* ``SIGTERM``
+* ``SIGHUP``
+
+The signal will cause the scheduler to shutdown in ``--now`` mode.
+
+If the scheduler is already shutting down in ``--now`` mode, the signal will
+escalate shutdown to ``--now --now`` mode.
+
+See ``cylc stop --help`` for details on stop modes.
+
+
 .. _PreemptionHPC:
 
 Handling Job Preemption

diff --git a/src/user-guide/running-workflows/index.rst b/src/user-guide/running-workflows/index.rst
@@ -17,4 +17,4 @@ Running Workflows
    dynamic-behaviour
    authentication-files
    workflow-databases
-   handling-job-preemption
+   advanced