Project homepage Mailing List  API Docs  Github Mirror 
{"schema":"libjg2-1", "vpath":"/git/", "avatar":"/git/avatar/", "alang":"en-US,en;q\u003d0.5", "gen_ut":1594307478, "reponame":"libwebsockets", "desc":"libwebsockets lightweight C networking library", "owner": { "name": "Andy Green", "email": "", "md5": "c50933ca2aa61e0fe2c43d46bb6b59cb" },"url":"", "f":3, "items": [ {"schema":"libjg2-1", "cid":"6fb1d7e2600e3116ff18d65583cd0324", "oid":{ "oid": "1be6b4d075e63cbe9d4c4f9696a0a7647c475068", "alias": [ "refs/heads/master"]},"blobname": "changelog", "blob": "Changelog\n---------\n\nv4.0.0\n\u003d\u003d\u003d\u003d\u003d\u003d\n\n - NEW: Lws is now under the MIT license, see ./LICENSE for details\n \n - NEW: GLIB native event loop support, lws + gtk example\n\n - NEW: native lws MQTT client... supports client stream binding like h2 when\n multiple logical connections are going to the same endpoint over MQTT, they\n transparently and independently share the one connection + tls tunnel\n \n - NEW: \u0022Secure Streams\u0022... if you are making a device with client connections\n to the internet or cloud, this allows separation of the communications\n policy (endpoints, tls cert validation, protocols, etc) from the code, with\n the goal you can combine streams, change protocols and cloud provision, and\n reflect that in the device's JSON policy document without having to change\n any code.\n\n - NEW: lws_system: New lightweight and efficient Asynchronous DNS resolver\n implementation for both A and AAAA records, supports recursive (without\n recursion in code) lookups, caching, and getaddrinfo() compatible results\n scheme (from cache directly without per-consumer allocation). Able to\n perform DNS lookups without introducing latency in the event loop.\n\n - NEW: lws_system: ntpclient implementation with interface for setting system\n time via lws_system ops\n \n - NEW: lws_system: dhcpclient implementation\n \n - NEW: Connection validity tracking, autoproduce PING/PONG for protocols that\n support it if not informed that the connection has passed data in both\n directions recently enough\n\n - NEW: lws_retry: standardized exponential backoff and retry timing based\n around backoff table and lws_sul\n\n - NEW: there are official public helpers for unaligned de/serialization of all\n common types, see eh, lws_ser_wu16be() in include/libwebsockets/lws-misc.h\n\n - NEW: lws_tls_client_vhost_extra_cert_mem() api allows attaching extra certs\n to a client vhost from DER in memory\n \n - NEW: lws_system: generic blobs support passing auth tokens, per-connection\n client certs etc from platform into lws\n\n - NEW: public helpers to consume and produce ipv4/6 addresses in a clean way,\n along with lws_sockaddr46 type now public. See eg, lws_sockaddr46-based\n lws_sa46_parse_numeric_address(), lws_write_numeric_address()\n in include/libwebsockets/lws-network-helper.h\n\n - Improved client redirect handling, h2 compatibility\n \n - NEW: lwsac: additional features for constant folding support (strings that\n already are in the lwsac can be pointed to without copying again), backfill\n (look for gaps in previous chunks that could take a new use size), and\n lwsac_extend() so last use() can attempt to use more unallocated chunk space\n\n - NEW: lws_humanize: apis for reporting scalar quanties like 1234 as \u00221.234KB\u0022\n with the scaled symbol strings passed in by caller\n\n - NEW: freertos: support lws_cancel_service() by using UDP pair bound to lo,\n since it doesn't have logical pipes\n\n - NEW: \u0022esp32\u0022 plat, which implemented freertos plat compatibility on esp32, is\n renamed to \u0022freertos\u0022 plat, targeting esp32 and other freertos platforms\n\n - NEW: base64 has an additional api supporting stateful decode, where the input\n is not all in the same place at the same time and can be processed\n incrementally\n\n - NEW: lws ws proxy: support RFC8441\n \n - NEW: lws_spawn_piped apis: generic support for vforking a process with child\n wsis attached to its stdin, stdout and stderr via pipes. When processes are\n reaped, a specified callback is triggered. Currently Linux + OSX.\n \n - NEW: lws_fsmount apis: Linux-only overlayfs mount and unmount management for\n aggregating read-only layers with disposable, changeable upper layer fs\n\n - Improvements for RTOS / small build case bring the footprint of lws v4 below\n that of v3.1 on ARM \n \n - lws_tokenize: flag specifying # should mark rest of line as comment\n\n - NEW: minimal example for integrating libasound / alsa via raw file\n\n - lws_struct: sqlite and json / lejp translation now usable\n\n\nv3.2.0\n\u003d\u003d\u003d\u003d\u003d\u003d\n\n - This is the last planned release under LGPLv2+SLE. It's not planned to be\n maintained like previous releases, please switch to master for the latest\n stuff or continue to use v3.1-stable until the next release under the\n new MIT license.\n\n - NEW: completely refactored scheduler with a unified, sorted us-resolution\n linked-list implementation. All polled checks like timeout are migrated\n to use the new timers, which also work on the event lib implementations.\n Faster operation, us-resolution timeouts and generic scheduled callbacks\n from the event loop.\n\n - NEW: lws_dsh specialized buffer memory allocator that can borrow space\n from other cooperating buffers on the same list.\n\n - NEW: lws_sequencer allows managing multi-connection processes and\n retries\n\n - NEW: memory buffer cert support\n\n - NEW: LWS_WITH_NETWORK in CMake... can be configured without any network-\n related code at all\n\n - NEW: builds on QNX 6.5 and SmartOS\n\n - NEW: JOSE / JWK / JWS / JWE support, for all common ciphers and algs,\n works on OpenSSL and mbedtls backends\n\n - NEW: gencrypto now has genaes and genec in addition to genrsa, works\n on OpenSSL and mbedtls backends\n\n - NEW: raw_proxy role\n\n - NEW: Basic Auth works on ws connections\n\n - CHANGE: REMOVED: LWS_WITH_GENRSA, LWS_WITH_GENHASH, LWS_WITH_GENEC,\n LWS_WITH_GENAES have all been removed and combined into LWS_WITH_GENCRYPTO\n\n - CHANGE: REMOVED: LWS_WITH_JWS, LWS_WITH_JWE have been removed and combined\n into LWS_WITH_JOSE\n\nv3.1.0\n\u003d\u003d\u003d\u003d\u003d\u003d\n\n - CHANGE: REMOVED: lws_client_connect() and lws_client_connect_extended()\n compatibility apis for lws_client_connect_via_info() have been marked as\n deprecated for several versions and are now removed. Use\n lws_client_connect_via_info() directly instead.\n\n - CHANGE: CMAKE:\n - LWS_WITH_HTTP2: now defaults ON\n\n - CHANGE: Minimal examples updated to use Content Security Policy best\n practices, using\n `LWS_SERVER_OPTION_HTTP_HEADERS_SECURITY_BEST_PRACTICES_ENFORCE` vhost\n option flag and disabling of inline style and scripts. A side-effect of\n this is that buffers used to marshal headers have to be prepared to take\n more content than previously... LWS_RECOMMENDED_MIN_HEADER_SPACE (2048\n currently) is available for user (and internal) use to logically tie the\n buffer size to this usecase (and follow future increases).\n\n - NEW: CMAKE\n - LWS_FOR_GITOHASHI: sets various cmake options suitable for gitohashi\n - LWS_WITH_ASAN: for Linux, enable build with ASAN\n\n Don't forget LWS_WITH_DISTRO_RECOMMENDED, which enables a wide range of lws\n options suitable for a distro build of the library.\n \n - NEW: lws threadpool - lightweight pool of pthreads integrated to lws wsi, with\n all synchronization to event loop handled internally, queue for excess tasks\n [threadpool docs](\n [threadpool minimal example](\n Cmake config: `-DLWS_WITH_THREADPOOL\u003d1`\n\n - NEW: libdbus support integrated on lws event loop\n [lws dbus docs](\n [lws dbus client minimal examples](\n [lws dbus server minimal examples](\n Cmake config: `-DLWS_ROLE_DBUS\u003d1`\n\n - NEW: lws allocated chunks (lwsac) - helpers for optimized mass allocation of small\n objects inside a few larger malloc chunks... if you need to allocate a lot of\n inter-related structs for a limited time, this removes per-struct allocation\n library overhead completely and removes the need for any destruction handling\n [lwsac docs](\n [lwsac minimal example](\n Cmake Config: `-DLWS_WITH_LWSAC\u003d1`\n\n - NEW: lws tokenizer - helper api for robustly tokenizing your own strings without\n allocating or adding complexity. Configurable by flags for common delimiter\n sets and comma-separated-lists in the tokenizer. Detects and reports syntax\n errors.\n [lws_tokenize docs](\n [lws_tokenize minimal example / api test](\n\n - NEW: lws full-text search - optimized trie generation, serialization,\n autocomplete suggestion generation and instant global search support extensible\n to huge corpuses of UTF-8 text while remaining super lightweight on resources.\n [full-text search docs](\n [full-text search minimal example / api test](\n [demo](\n [demo sources](\n Cmake config: `-DLWS_WITH_FTS\u003d1 -DLWS_WITH_LWSAC\u003d1`\n\n - NEW: gzip + brotli http server-side compression - h1 and h2 automatic advertising\n of server compression and application to files with mimetypes \u0022text/*\u0022,\n \u0022application/javascript\u0022 and \u0022image/svg.xml\u0022.\n Cmake config: `-DLWS_WITH_HTTP_STREAM_COMPRESSION\u003d1`, `-DLWS_WITH_HTTP_BROTLI\u003d1`\n\n - NEW: managed disk cache - API for managing a directory containing cached files\n with hashed names, and automatic deletion of LRU files once the cache is\n above a given limit.\n [lws diskcache docs](\n Cmake config: `-DLWS_WITH_DISKCACHE\u003d1`\n\n - NEW: http reverse proxy - lws mounts support proxying h1 or h2 requests to\n a local or remote IP, or unix domain socket over h1. This allows microservice\n type architectures where parts of the common URL space are actually handled\n by external processes which may be remote or on the same machine.\n [lws gitohashi serving]( is handled this way.\n CMake config: `-DLWS_WITH_HTTP_PROXY\u003d1`\n \n - NEW: lws_buflist - internally several types of ad-hoc malloc'd buffer have\n been replaced by a new, exported api `struct lws_buflist`. This allows\n multiple buffers to be chained and drawn down in strict FIFO order.\n\n - NEW: In the case of h1 upgrade, the connection header is checked to contain\n \u0022upgrade\u0022. The vhost flag LWS_SERVER_OPTION_VHOST_UPG_STRICT_HOST_CHECK\n also causes the Host: header to be confirmed to match the vhost name and\n listen port.\n \n - NEW: If no 404 redirect for `lws_return_http_status()` is specified for the vhost,\n the status page produced will try to bring in a stylesheet `/error.css`. This allows\n you to produce styled 404 or other error pages with logos, graphics etc. See\n for an example of what you can do with it.\n\nv3.0.0\n\u003d\u003d\u003d\u003d\u003d\u003d\n\n - CHANGE: Clients used to call LWS_CALLBACK_CLOSED same as servers...\n LWS_CALLBACK_CLIENT_CLOSED has been introduced and is called for clients\n now.\n \n - CHANGE: LWS_CALLBACK_CLIENT_CONNECTION_ERROR used to only be directed at\n protocols[0]. However in many cases, the protocol to bind to was provided\n at client connection info time and the wsi bound accordingly. In those\n cases, CONNECTION_ERROR is directed at the bound protocol, not protcols[0]\n any more.\n\n - CHANGE: CMAKE: the following cmake defaults have changed with this version:\n \n - LWS_WITH_ZIP_FOPS: now defaults OFF\n - LWS_WITH_RANGES: now defaults OFF\n - LWS_WITH_ZLIB: now defaults OFF\n - LWS_WITHOUT_EXTENSIONS: now defaults ON\n \n - CHANGE: REMOVED: lws_alloc_vfs_file() (read a file to malloc buffer)\n \n - CHANGE: REMOVED: lws_read() (no longer useful outside of lws internals)\n \n - CHANGE: REMOVED: ESP8266... ESP32 is now within the same price range and much\n more performant\n \n - CHANGE: soname bump... don't forget to `ldconfig`\n \n - NEW: all event libraries support \u0022foreign\u0022 loop integration where lws itself\n if just a temporary user of the loop unrelated to the actual loop lifecycle.\n \n See `minimal-http-server-eventlib-foreign` for example code demonstrating\n this for all the event libraries.\n \n Internal loop in lws is also supported and demonstrated by\n `minimal-http-server-eventlib`.\n \n - NEW: ws-over-h2 support. This is a new RFC-on-the-way supported by Chrome\n and shortly firefox that allows ws connections to be multiplexed back to the\n server on the same tcp + tls wrapper h2 connection that the html and scripts\n came in on. This is hugely faster that discrete connections.\n \n - NEW: UDP socket adoption and related event callbacks\n \n - NEW: Multi-client connection binding, queuing and pipelining support.\n \n Lws detects multiple client connections to the same server and port, and\n optimizes how it handles them according to the server type and provided\n flags. For http/1.0, all occur with individual parallel connections. For\n http/1.1, you can enable keepalive pipelining, so the connections occur\n sequentially on a single network connection. For http/2, they all occur\n as parallel streams within a single h2 network connection.\n \n See minimal-http-client-multi for example code. \n \n - NEW: High resolution timer API for wsi, get a callback on your wsi with\n LWS_CALLBACK_TIMER, set and reset the timer with lws_set_timer_usecs(wsi, us)\n Actual resolution depends on event backend. Works with all backends, poll,\n libuv, libevent, and libev.\n \n - NEW: Protocols can arrange vhost-protocol instance specific callbacks with\n second resolution using `lws_timed_callback_vh_protocol()`\n\n - NEW: ACME client plugin for self-service TLS certificates\n \n - NEW: RFC7517 JSON Web Keys RFC7638 JWK thumbprint, and RFC7515 JSON Web\n signatures support\n \n - NEW: lws_cancel_service() now provides a generic way to synchronize events\n from other threads, which appear as a LWS_CALLBACK_EVENT_WAIT_CANCELLED\n callback on all protocols. This is compatible with all the event libraries.\n\n - NEW: support BSD poll() where changes to the poll wait while waiting are\n undone.\n\n - NEW: Introduce generic hash, hmac and RSA apis that operate the same\n regardless of OpenSSL or mbedTLS tls backend\n \n - NEW: Introduce X509 element query api that works the same regardless of\n OpenSSL or mbedTLS tls backend\n \n - NEW: Introduce over 30 \u0022minimal examples\u0022 in ./minimal-examples... these\n replace most of the old test servers\n \n - test-echo -\u003e minimal-ws-server-echo and minimal-ws-client-echo\n\n - test-server-libuv / -libevent / -libev -\u003e\n minimal-https-server-eventlib / -eventlib-foreign / -eventlib-demos\n\n - test-server-v2.0 -\u003e folded into all the minimal servers\n\n - test-server direct http serving -\u003e minimal-http-server-dynamic\n \n The minimal examples allow individual standalone build using their own\n small CMakeLists.txt.\n \n - NEW: lws now detects any back-to-back writes that did not go through the\n event loop inbetween and reports them. This will flag any possibility of\n failure rather than wait until the problem happens.\n \n - NEW: CMake has LWS_WITH_DISTRO_RECOMMENDED to select features that are\n appropriate for distros\n \n - NEW: Optional vhost URL `error_document_404` if given causes a redirect there\n instead of serve the default 404 page.\n \n - NEW: lws_strncpy() wrapper guarantees NUL in copied string even if it was\n truncated to fit.\n \n - NEW: for client connections, local protocol binding name can be separated\n from the ws subprotocol name if needed, using .local_protocol_name\n\n - NEW: Automatic detection of time discontiguities\n \n - NEW: Applies TCP_USER_TIMEOUT for Linux tcp keepalive where available\n \n - QA: 1600 tests run on each commit in Travis CI, including almost all\n Autobahn in client and server mode, various h2load tests, h2spec,\n the minimal example selftests and others.\n\n - QA: fix small warnings introduced on gcc8.x (eg, Fedora 28)\n \n - QA: Add most of -Wextra on gcc (-Wsign-compare, -Wignored-qualifiers,\n -Wtype-limits, -Wuninitialized)\n \n - QA: clean out warnings on windows\n \n - QA: pass all 146 h2spec tests now on strict\n \n - QA: introduce 35 selftests that operate different minimal examples against\n each other and confirm the results.\n \n - QA: LWS_WITH_MINIMAL_EXAMPLES allows mass build of all relevant minimal-\n examples with the LWS build, for CI and to make all the example binaries\n available from the lws build dir ./bin\n \n - REFACTOR: the lws source directory layout in ./lib has been radically\n improved, and there are now files in selected subdirs with extra\n documentation of interest to people working on lws itself.\n\n - REFACTOR: pipelined transactions return to the event loop before starting the\n next part. \n \n - REFACTOR: TLS: replace all TLS library constants with generic LWS ones and\n adapt all the TLS library code to translate to these common ones.\n \n Isolated all the tls-related private stuff in `./lib/tls/private.h`, and all\n the mbedTLS stuff in `./lib/tls/mbedtls` + openSSL stuff in\n `./lib/tls/openssl`\n \n - REFACTOR: the various kinds of wsi possible with lws have been extracted\n from the main code and isolated into \u0022roles\u0022 in `./lib/roles` which\n communicate with the core code via an ops struct. Everything related to\n ah is migrated to the http role.\n \n wsi modes are eliminated and replaced by the ops pointer for the role the\n wsi is performing. Generic states for wsi are available to control the\n lifecycle using core code.\n \n Adding new \u0022roles\u0022 is now much easier with the changes and ops struct to\n plug into.\n\n - REFACTOR: reduce four different kinds of buffer management in lws into a\n generic scatter-gather struct lws_buflist. \n\n - REFACTOR: close notifications go through event loop\n\n\nv2.4.0\n\u003d\u003d\u003d\u003d\u003d\u003d\n\n - HTTP/2 server support is now mature and usable! LWS_WITH_HTTP2\u003d1 enables it.\n Uses ALPN to serve HTTP/2, HTTP/1 and ws[s] connections all from the same\n listen port seamlessly. (Requires ALPN-capable OpenSSL 1.1 or mbedTLS).\n\n - LWS_WITH_MBEDTLS\u003d1 at CMake now builds and works against mbedTLS instead of\n OpenSSL. Most things work identically, although on common targets where\n OpenSSL has acceleration, mbedTLS is many times slower in operation. However\n it is a lot smaller codewise.\n \n - Generic hash apis introduced that work the same on mbedTLS or OpenSSL backend\n \n - LWS_WITH_PEER_LIMITS tracks IPs across all vhosts and allows restrictions on\n both the number of simultaneous connections and wsi in use for any single IP\n\n - lws_ring apis provide a generic single- or multi-tail ringbuffer... mirror\n protocol now uses this. Features include ring elements may be sized to fit\n structs in the ringbuffer, callback when no tail any longer needs an element\n and it can be deleted, and zerocopy options to write new members directly\n into the ringbuffer, and use the ringbuffer element by address too.\n \n - abstract ssh 2 server plugin included, with both plugin and standalone\n demos provided. You can bind the plugin to a vhost and also serve full-\n strength ssh from the vhost. IO from the ssh server is controlled by an\n \u0022ops\u0022 struct of callbacks for tx, rx, auth etc.\n \n - Many fixes, cleanups, source refactors and other improvements.\n\n\nv2.3.0\n\u003d\u003d\u003d\u003d\u003d\u003d\n\n - ESP32 OpenSSL support for client and server\n\n - ESP32 4 x WLAN credential slots may be configured\n\n - Libevent event loop support\n\n - SOCKS5 proxy support\n\n - lws_meta protocol for websocket connection multiplexing\n\n - lws_vhost_destroy() added... allows dynamic removal of listening\n vhosts. Vhosts with shared listen sockets adopt the listen socket\n automatically if the owner is destroyed.\n\n - IPv6 on Windows\n\n - Improved CGI handling suitable for general CGI scripting, eg, PHP\n\n - Convert even the \u0022old style\u0022 test servers to use statically included\n plugin sources\n\n - LWS_WITH_STATS cmake option dumps resource usage and timing information\n every few seconds to debug log, including latency information about\n delay from asking for writeable callback to getting it\n\n - Large (\u003e 2GB) files may be served\n\n - LWS_WITH_HTTP_PROXY Cmake option adds proxying mounts\n\n - Workaround for libev build by disabling -Werror on the test app\n\n - HTTP2 support disabled since no way to serve websockets on it\n\n\nv2.2.0\n\u003d\u003d\u003d\u003d\u003d\u003d\n\nMajor new features\n\n - A mount can be protected by Basic Auth... in lwsws it looks like this\n\n ```\n{\n \u0022mountpoint\u0022: \u0022/basic-auth\u0022,\n \u0022origin\u0022: \u0022file://_lws_ddir_/libwebsockets-test-server/private\u0022,\n \u0022basic-auth\u0022: \u0022/var/www/balogins-private\u0022\n}\n```\n\nThe text file named in `basic-auth` contains user:password information\none per line.\n\nSee for more information.\n\n - RFC7233 RANGES support in lws server... both single and multipart.\n This allows seeking for multimedia file serving and download resume.\n It's enabled by default but can be disabled by CMake option.\n\n - On Linux, lwsws can reload configuration without dropping ongoing\n connections, when sent a SIGHUP. The old configuration drops its\n listen sockets so the new configuration can listen on them.\n New connections connect to the server instance with the new\n configuration. When all old connections eventually close, the old\n instance automatically exits. This is equivalent to\n `systemctl reload apache`\n\n - New `adopt` api allow adoption including SSL negotiation and\n for raw sockets and file descriptors.\n\n - Chunked transfer encoding supported for client and server\n\n - Adaptations to allow operations inside OPTEE Secure World\n\n - ESP32 initial port - able to do all test server functions. See\n\n\n - Serving gzipped files from inside a ZIP file is supported... this\n includes directly serving the gzipped content if the client\n indicated it could accept it (ie, almost all browsers) saving\n bandwidth and time. For clients that can't accept it, lws\n automatically decompresses and serves the content in memory-\n efficient chunks. Only a few hundred bytes of heap are needed\n to serve any size file from inside the zip. See\n\n - RAW file descriptors may now be adopted into the lws event loop,\n independent of event backend (including poll service).\n See\n\n - RAW server socket descriptors may now be enabled on the vhost if\n the first thing sent on the connection is not a valid http method.\n The user code can associate these with a specific protocol per\n vhost, and RAW-specific callbacks appear there for creation, rx,\n writable and close. See libwebsockets-test-server-v2.0 for an example.\n See\n\n - RAW client connections are now possible using the method \u0022RAW\u0022.\n After connection, the socket is associated to the protocol\n named in the client connection info and RAW-specific callbacks\n appear there for creation, rx, writable and close.\n See libwebsockets-test-client (with raw://) for an example.\n See\n\n\n(for earlier changelogs, see the tagged releases)\n","s":{"c":1594307478,"u": 906}} ],"g": 5650,"chitpc": 0,"ehitpc": 0,"indexed":0 , "ab": 1, "si": 0, "db":0, "di":0, "sat":0, "lfc": "0000"}