From 3213c565161478bc761c1c788f6381c9f57c6fc2 Mon Sep 17 00:00:00 2001 From: Andy Green Date: Fri, 7 Oct 2016 20:04:19 +0800 Subject: [PATCH] document extpoll forced service problem on v2.0 --- README.coding.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/README.coding.md b/README.coding.md index 9d5e87a3..2801b55e 100644 --- a/README.coding.md +++ b/README.coding.md @@ -167,6 +167,14 @@ whereas info is ignored by default. External Polling Loop support ----------------------------- +NOTE: You should use v2.1 or later (or master) for external polling loop +support. After v2.0 was released a problem was found meaning some internal +APIs needed to be exposed to deal with connections that need service even +without any new network activity. For normal poll() and libuv/ev loops, +lws takes care of this internally but external polling loop needs it doing +externally. Since we can't change the API on a released version that +means you need to use v2.1 or later for this feature to work properly. + **libwebsockets** maintains an internal `poll()` array for all of its sockets, but you can instead integrate the sockets into an external polling array. That's needed if **libwebsockets** will