1
0
Fork 0
mirror of https://github.com/warmcat/libwebsockets.git synced 2025-03-16 00:00:07 +01:00
libwebsockets/minimal-examples/raw/minimal-raw-file
Andy Green f7149e90c2 cc0: align dedication to CC0 FAQ recommended format
https://libwebsockets.org/pipermail/libwebsockets/2019-April/007937.html

thanks to Bruce Perens for noting it.

This doesn't change the intention or status of the CC0 files, they were
pure CC0 before (ie, public domain) and they are pure CC0 now.  It just
gets rid of the (C) part at the top of the dedication which may be read
to be a bit contradictory since the purpose is to make it public domain.
2019-05-02 09:29:01 +01:00
..
CMakeLists.txt minimal: minimal-raw-file 2018-04-06 10:38:03 +08:00
minimal-raw-file.c cc0: align dedication to CC0 FAQ recommended format 2019-05-02 09:29:01 +01:00
README.md minimal: minimal raw vhost 2018-04-06 10:38:03 +08:00

lws minimal ws server

This demonstrates adopting a file descriptor into the lws event loop. The filepath to open and adopt is given as an argument to the example app, eg

 $ ./lws-minimal-raw-file <file>

On a Linux system, some example files for testing might be

  • /proc/self/fd/0 (stdin)
  • /dev/ttyUSB0 (a USB <-> serial converter)
  • /dev/input/event (needs root... input device events)

The example application opens the file in the protocol init handler, and hexdumps data from the file to the lws log as it becomes available.

This isn't very useful standalone as shown here for clarity, but you can freely combine raw file descriptor adoption with other lws server and client features.

Becuase raw file events have their own callback reasons, the handlers can be integrated in a single protocol that also handles http and ws server and client callbacks without conflict.

build

 $ cmake . && make

usage

 $ ./lws-minimal-raw-file /proc/self/fd/0
[2018/03/22 10:48:53:9709] USER: LWS minimal raw file
[2018/03/22 10:48:53:9876] NOTICE: Creating Vhost 'default' port -2, 1 protocols, IPv6 off
[2018/03/22 10:48:55:0037] NOTICE: LWS_CALLBACK_RAW_ADOPT_FILE

[2018/03/22 10:48:55:9370] NOTICE: LWS_CALLBACK_RAW_RX_FILE
[2018/03/22 10:48:55:9377] NOTICE: 
[2018/03/22 10:48:55:9408] NOTICE: 0000: 0A                                                 .               

The example logs above show the result of typing the Enter key.