1
0
Fork 0
mirror of https://github.com/warmcat/libwebsockets.git synced 2025-03-23 00:00:06 +01:00
libwebsockets/READMEs
Andy Green c591e1adfc asynchronous dns for ipv4 and ipv6
This adds the option to have lws do its own dns resolution on
the event loop, without blocking.  Existing implementations get
the name resolution done by the libc, which is blocking.  In
the case you are opening client connections but need to carefully
manage latency, another connection opening and doing the name
resolution becomes a big problem.

Currently it supports

 - ipv4 / A records
 - ipv6 / AAAA records
 - ipv4-over-ipv6 ::ffff:1.2.3.4 A record promotion for ipv6
 - only one server supported over UDP :53
 - nameserver discovery on linux, windows, freertos

It also has some nice advantages

 - lws-style paranoid response parsing
 - random unique tid generation to increase difficulty of poisoning
 - it's really integrated with the lws event loop, it does not spawn
   threads or use the libc resolver, and of course no blocking at all
 - platform-specific server address capturing (from /etc/resolv.conf
   on linux, windows apis on windows)
 - it has LRU caching
 - piggybacking (multiple requests before the first completes go on
   a list on the first request, not spawn multiple requests)
 - observes TTL in cache
 - TTL and timeout use lws_sul timers on the event loop
 - ipv6 pieces only built if cmake LWS_IPV6 enabled
2019-09-19 06:54:53 +01:00
..
mainpage.md libwebsockets.h: split out into a dir of sub-includes included by libwebsockets.h 2018-09-11 18:27:59 +08:00
README.async-dns.md asynchronous dns for ipv4 and ipv6 2019-09-19 06:54:53 +01:00
README.build.md cmake: miniz: add as option 2019-07-03 19:46:23 +01:00
README.ci.md README.ci.md 2018-10-13 08:16:27 +08:00
README.coding.md adopt: allow associated accepted vhost connections to specific role 2018-12-01 11:05:59 +08:00
README.content-security-policy.md minimal examples: update for CSP best practices 2018-11-21 17:03:29 +08:00
README.contributing.md README.contributing.md 2018-10-13 08:16:27 +08:00
README.crypto-apis.md lws-x509: validation functions 2018-12-31 20:35:54 +08:00
README.esp32.md esp32: map basic auth to nvs 2018-02-24 08:14:17 +08:00
README.generic-sessions.md clean up top level of project 2017-09-27 08:24:05 +08:00
README.generic-table.md clean up top level of project 2017-09-27 08:24:05 +08:00
README.http-fallback.md role: raw-proxy 2018-12-01 11:05:59 +08:00
README.lws_dll.md docs: lws_dll and lws_dll2 documentation 3 2019-03-26 14:54:50 +08:00
README.lws_sequencer.md lws_retry_bo_t: generic retry backoff 2019-08-05 14:47:51 +01:00
README.lws_struct.md lws_struct 2019-04-06 06:08:47 +08:00
README.lwsws.md unix skt: allow control over skt user:group 2019-03-26 14:54:49 +08:00
README.plugin-acme.md ACME client plugin 2017-12-01 11:37:35 +08:00
README.plugin-sshd-base.md genaes: generic AES layer independent of tls library 2018-12-27 06:45:31 +08:00
README.porting.md docs: add READMEs/README.porting.md 2019-03-28 06:47:02 +08:00
README.problems.md docs: cleanups 2018-11-21 17:03:29 +08:00
README.release-policy.md docs: release-policy README and pics 2018-11-14 08:57:29 +08:00
README.test-apps.md README.md: update in preparation for v3.1 2018-11-16 09:10:41 +08:00
README.unix-domain-reverse-proxy.md clean: general whitespace cleanup 2018-11-23 08:47:56 +08:00
README.vulnerability-reporting.md README.vulnerability-reporting.md 2018-10-13 08:16:27 +08:00
release-checklist v3.1.0 2018-11-23 11:30:56 +08:00

Vulnerability Reporting

If you become aware of an issue with lws that has a security dimension for users, please contact andy@warmcat.com by direct email.

Procedure for announcing vulnerability fixes

The problem and fixed versions will be announced on the libwebsockets mailing list and a note added to the master README.md.