History

liiir1985 7f62dcda9f initial		2024-06-22 20:45:49 +08:00
..
READMEs	initial	2024-06-22 20:45:49 +08:00
cmake	initial	2024-06-22 20:45:49 +08:00
contrib	initial	2024-06-22 20:45:49 +08:00
doc-assets	initial	2024-06-22 20:45:49 +08:00
include	initial	2024-06-22 20:45:49 +08:00
lib	initial	2024-06-22 20:45:49 +08:00
lwsws	initial	2024-06-22 20:45:49 +08:00
minimal-examples	initial	2024-06-22 20:45:49 +08:00
plugin-standalone	initial	2024-06-22 20:45:49 +08:00
plugins	initial	2024-06-22 20:45:49 +08:00
scripts	initial	2024-06-22 20:45:49 +08:00
test-apps	initial	2024-06-22 20:45:49 +08:00
win32port	initial	2024-06-22 20:45:49 +08:00
.mailmap	initial	2024-06-22 20:45:49 +08:00
.sai.json	initial	2024-06-22 20:45:49 +08:00
Android.bp	initial	2024-06-22 20:45:49 +08:00
Android.mk	initial	2024-06-22 20:45:49 +08:00
CMakeAndroidLists.txt.template	initial	2024-06-22 20:45:49 +08:00
CMakeLists-implied-options.txt	initial	2024-06-22 20:45:49 +08:00
CMakeLists.txt	initial	2024-06-22 20:45:49 +08:00
Kconfig	initial	2024-06-22 20:45:49 +08:00
LICENSE	initial	2024-06-22 20:45:49 +08:00
METADATA	initial	2024-06-22 20:45:49 +08:00
Makefile.projbuild	initial	2024-06-22 20:45:49 +08:00
OWNERS	initial	2024-06-22 20:45:49 +08:00
README.md	initial	2024-06-22 20:45:49 +08:00
bug_report.md	initial	2024-06-22 20:45:49 +08:00
changelog	initial	2024-06-22 20:45:49 +08:00
component.mk	initial	2024-06-22 20:45:49 +08:00
gen_lws_config_h.sh	initial	2024-06-22 20:45:49 +08:00
libwebsockets.dox	initial	2024-06-22 20:45:49 +08:00

README.md

Libwebsockets

Libwebsockets is a simple-to-use, MIT-license, pure C library providing client and server for http/1, http/2, websockets, MQTT and other protocols in a security-minded, lightweight, configurable, scalable and flexible way. It's easy to build and cross-build via cmake and is suitable for tasks from embedded RTOS through mass cloud serving.

It supports a lot of lightweight ancilliary implementations for things like JSON, CBOR, JOSE, COSE, and supports OpenSSL and MbedTLS v2 and v3 out of the box for everything. It's very gregarious when it comes to event loop sharing, supporting libuv, libevent, libev, sdevent, glib and uloop, as well as custom event libs.

100+ independent minimal examples for various scenarios, CC0-licensed (public domain) for cut-and-paste, allow you to get started quickly.

There are a lot of READMEs on a variety of topics.

We do a huge amount of CI testing per push, currently 582 builds on 30 platforms. You can see the lws CI rack and read about how lws-based Sai is used to coordinate all the testing.

News

v4.3 is released

See the changelog

Lws work retrospective

The initial commit for lws will have been 11 years ago come Oct 28 2021, it's been a lot of work. There are a total of 4.3K patches, touching 800KLOC cumulatively (this is not the size in the repo, but over the years, how many source lines were changed by patches).

Gratifyingly, it turns out over the years, ~15% of that was contributed by 404 contributors: that's not so bad. Thanks a lot to everyone who has provided patches.

Today at least tens of millions of devices and product features rely on lws to handle their communications including several from FAANG; Google now include lws as part of Android sources.

Support

This is the libwebsockets C library for lightweight websocket clients and servers. For support, visit

https://libwebsockets.org

and consider joining the project mailing list at

https://libwebsockets.org/mailman/listinfo/libwebsockets

You can get the latest version of the library from git:

https://libwebsockets.org/git

Doxygen API docs for development: https://libwebsockets.org/lws-api-doc-main/html/index.html