]> git.ipfire.org Git - thirdparty/haproxy.git/commitdiff
DOC: sched: add missing scheduler API documentation for tasklet_wakeup_after()
authorWilly Tarreau <w@1wt.eu>
Tue, 19 Nov 2024 15:04:09 +0000 (16:04 +0100)
committerWilly Tarreau <w@1wt.eu>
Tue, 19 Nov 2024 19:13:41 +0000 (20:13 +0100)
This was added to 2.6 but the doc was forgotten. Let's add it. It's not
needed to backport this since it's only used for new developments.

doc/internals/api/scheduler.txt

index dd1ad5f07c948353bc8f30c1af31660794e43ec0..70230d16304c16f3d53d5560adf444c980f93b5d 100644 (file)
@@ -103,6 +103,17 @@ void tasklet_wakeup(tl)
         least once. The tasklet will run on its assigned thread, or on any
         thread if its TID is negative.
 
+struct list *tasklet_wakeup_after(head, tl)
+        Schedule tasklet <tl> to run immediately the current one if <head> is
+        NULL, or after the last queued one if <head> is non-null. The new head
+        is returned, to be passed to the next call. The purpose here is to
+        permit instant wakeups of resumed tasklets that still preserve
+        ordering between them. A typical use case is for a mux' I/O handler to
+        instantly wake up a series of urgent streams before continuing with
+        already queued tasklets. This may induce extra latencies for pending
+        jobs and must only be used extremely carefully when it's certain that
+        the processing will benefit from using fresh data from the L1 cache.
+
 void tasklet_wakeup_on(tl, thr)
         Make sure that tasklet <tl> will wake up on thread <thr>, that is, will
         execute at least once. The designated thread may only differ from the