about summary refs log tree commit homepage
diff options
context:
space:
mode:
authorEric Wong <e@80x24.org>2017-10-24 18:55:45 +0000
committerEric Wong <e@80x24.org>2017-10-24 18:55:45 +0000
commit8c8916c5b7a2afdb5dcb5cc88b4e1d28fe8a5acc (patch)
tree697882fcaa0c87f9a0e6ba0be5dd5a2f57533830
parent93c11990d215c678d254a56a7b3bc63e3a53e0de (diff)
downloadcmogstored-8c8916c5b7a2afdb5dcb5cc88b4e1d28fe8a5acc.tar.gz
This had become such second nature to me that I forgot to
document it :x
-rw-r--r--doc/queues.txt5
1 files changed, 3 insertions, 2 deletions
diff --git a/doc/queues.txt b/doc/queues.txt
index d1de9da..fe8c3bb 100644
--- a/doc/queues.txt
+++ b/doc/queues.txt
@@ -50,8 +50,9 @@ This is either an epoll(2) or kqueue(2) descriptor.  Unlike traditional
 poll(2)/select(2), epoll/kqueue easily allows clients to migrate between
 threads as client sockets become ready.
 
-To implement queue-like behavior, we rely exclusively on one-shot
-notifications (EPOLLONESHOT or EV_ONESHOT).
+To implement this behavior, we rely exclusively on one-shot notifications
+(EPOLLONESHOT or EV_ONESHOT) and only retrieve one event at-a-time with
+epoll_wait or kqueue to avoid head-of-line blocking.
 
 active queue
 ============