mirror of
https://github.com/warmcat/libwebsockets.git
synced 2025-03-30 00:00:16 +01:00
c6c7ab2b44
Event lib support as it has been isn't scaling well, at the low level libevent and libev headers have a namespace conflict so they can't both be built into the same image, and at the distro level, binding all the event libs to libwebsockets.so makes a bloaty situation for packaging, lws will drag in all the event libs every time. This patch implements the plan discussed here https://github.com/warmcat/libwebsockets/issues/1980 and refactors the event lib support so they are built into isolated plugins and bound at runtime according to what the application says it wants to use. The event lib plugins can be packaged individually so that only the needed sets of support are installed (perhaps none of them if the user code is OK with the default poll() loop). And dependent user code can mark the specific event loop plugin package as required so pieces are added as needed. The eventlib-foreign example is also refactored to build the selected lib support isolated. A readme is added detailing the changes and how to use them. https://libwebsockets.org/git/libwebsockets/tree/READMEs/README.event-libs.md |
||
|---|---|---|
| .. | ||
| abstract | ||
| core | ||
| core-net | ||
| drivers | ||
| event-libs | ||
| jose | ||
| misc | ||
| plat | ||
| roles | ||
| secure-streams | ||
| system | ||
| tls | ||
| CMakeLists.txt | ||
| README.md | ||
Library sources layout
Code that goes in the libwebsockets library itself lives down ./lib
| Path | Sources |
|---|---|
| lib/core | Core lws code related to generic fd and wsi servicing and management |
| lib/core-net | Core lws code that applies only if networking enabled |
| lib/event-libs | Code containing optional event-lib specific adaptations |
| lib/jose | JOSE / JWS / JWK / JWE implementations |
| lib/misc | Code for various mostly optional miscellaneous features |
| lib/plat | Platform-specific adaptation code |
| lib/roles | Code for specific optional wsi roles, eg, http/1, h2, ws, raw, etc |
| lib/system | Code for system-level features, eg, dhcpclient |
| lib/tls | Code supporting the various TLS libraries |