xref: /aosp_15_r20/external/libwebsockets/minimal-examples/ws-client/minimal-ws-client-tx/README.md (revision 1c60b9aca93fdbc9b5f19b2d2194c91294b22281)
1*1c60b9acSAndroid Build Coastguard Worker# lws minimal ws client tx
2*1c60b9acSAndroid Build Coastguard Worker
3*1c60b9acSAndroid Build Coastguard WorkerThis demonstrates a ws "publisher" to go with the minimal-ws-broker example.
4*1c60b9acSAndroid Build Coastguard Worker
5*1c60b9acSAndroid Build Coastguard WorkerTwo threads are spawned that produce messages to be sent to the broker,
6*1c60b9acSAndroid Build Coastguard Workervia a local ringbuffer.  Locking is provided to make ringbuffer access threadsafe.
7*1c60b9acSAndroid Build Coastguard Worker
8*1c60b9acSAndroid Build Coastguard WorkerWhen a nailed-up client connection to the broker is established, the
9*1c60b9acSAndroid Build Coastguard Workerringbuffer is sent to the broker, which distributes the events to all
10*1c60b9acSAndroid Build Coastguard Workerconnected clients.
11*1c60b9acSAndroid Build Coastguard Worker
12*1c60b9acSAndroid Build Coastguard Worker## build
13*1c60b9acSAndroid Build Coastguard Worker
14*1c60b9acSAndroid Build Coastguard Worker```
15*1c60b9acSAndroid Build Coastguard Worker $ cmake . && make
16*1c60b9acSAndroid Build Coastguard Worker```
17*1c60b9acSAndroid Build Coastguard Worker
18*1c60b9acSAndroid Build Coastguard Worker## usage
19*1c60b9acSAndroid Build Coastguard Worker
20*1c60b9acSAndroid Build Coastguard WorkerThis example connects to ws-server/minimal-ws-broker, so you need to build and run
21*1c60b9acSAndroid Build Coastguard Workerthat in another terminal.
22*1c60b9acSAndroid Build Coastguard Worker
23*1c60b9acSAndroid Build Coastguard Worker```
24*1c60b9acSAndroid Build Coastguard Worker $ ./lws-minimal-ws-client-tx
25*1c60b9acSAndroid Build Coastguard Worker[2018/03/16 16:04:33:5774] USER: LWS minimal ws client tx
26*1c60b9acSAndroid Build Coastguard Worker[2018/03/16 16:04:33:5774] USER:   Run minimal-ws-broker and browse to that
27*1c60b9acSAndroid Build Coastguard Worker[2018/03/16 16:04:33:5774] NOTICE: Creating Vhost 'default' port -1, 1 protocols, IPv6 off
28*1c60b9acSAndroid Build Coastguard Worker[2018/03/16 16:04:34:5794] USER: callback_minimal_broker: established
29*1c60b9acSAndroid Build Coastguard Worker```
30*1c60b9acSAndroid Build Coastguard Worker
31*1c60b9acSAndroid Build Coastguard WorkerIf you open a browser on http://localhost:7681 , you will see the subscribed
32*1c60b9acSAndroid Build Coastguard Workermessages from the threads in this app via the broker app.
33*1c60b9acSAndroid Build Coastguard Worker
34