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 b3131fdfdd cmakelist: Augean Stables refactor
Establish a new distributed CMake architecture with CMake code related to
a source directory moving to be in the subdir in its own CMakeLists.txt.
In particular, there's now one in ./lib which calls through to ones
further down the directory tree like ./lib/plat/xxx, ./lib/roles/xxx etc.

This cuts the main CMakelists.txt from 98KB -> 33KB, about a 66% reduction,
and it's much easier to maintain sub-CMakeLists.txt that are in the same
directory as the sources they manage, and conceal all the details that that
level.

Child CMakelists.txt become responsible for:

 - include_directories() definition (this is not supported by CMake
   directly, it passes it back up via PARENT_SCOPE vars in helper
   macros)

 - Addition child CMakeLists.txt inclusion, for example toplevel ->
   role -> role subdir

 - Source file addition to the build

 - Dependent library path resolution... this is now a private thing
   in the child CMakeLists.txt, it just passes back any adaptations
   to include_directories() and the LIB_LIST without filling the
   parent namespace with the details
2020-05-27 08:40:12 +01:00
..
CMakeLists.txt cmakelist: Augean Stables refactor 2020-05-27 08:40:12 +01:00
minimal-raw-file.c sul: all timed objects use a single pt sul list 2019-08-09 10:12:09 +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.