Control flow: Document restrictions on globalsystemfailure

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>

diff --git a/src/event.c b/src/event.c
index 95386f42c4fed8351a939290cd85dcfdf5bed53b..81766c5ac48f8d605da5dab8788589e4ec367b4d 100644 (file)
--- a/src/event.c
+++ b/src/event.c
@@ -624,6 +624,9 @@ xit:
 /* General helpful functions. */
 
 void adns_globalsystemfailure(adns_state ads) {
+  /* Must not be called by adns during actual processing of a
+   * particular query, since it reenters adns.  Only safe to call in
+   * situations where it would be safe to call adns_returning. */
   adns__consistency(ads,0,cc_entex);
 
   for (;;) {