README.md
1# lws minimal secure streams proxy
2
3Operates as a secure streams proxy, by default on a listening unix domain socket
4"proxy.ss.lws" in the Linux abstract namespace.
5
6Give -p <port> to have it listen on a specific tcp port instead.
7
8## build
9
10```
11 $ cmake . && make
12```
13
14## usage
15
16Commandline option|Meaning
17---|---
18-d <loglevel>|Debug verbosity in decimal, eg, -d15
19-f| Force connecting to the wrong endpoint to check backoff retry flow
20-p <port>|If not given, proxy listens on a Unix Domain Socket, if given listen on specified tcp port
21-i <iface>|Optionally specify the UDS path (no -p) or network interface to bind to (if -p also given)
22
23```
24[2020/02/26 15:41:27:5768] U: LWS secure streams Proxy [-d<verb>]
25[2020/02/26 15:41:27:5770] N: lws_ss_policy_set: 2.064KiB, pad 70%: hardcoded
26[2020/02/26 15:41:27:5771] N: lws_tls_client_create_vhost_context: using mem client CA cert 1391
27[2020/02/26 15:41:27:8681] N: lws_ss_policy_set: 4.512KiB, pad 15%: updated
28[2020/02/26 15:41:27:8682] N: lws_tls_client_create_vhost_context: using mem client CA cert 837
29[2020/02/26 15:41:27:8683] N: lws_tls_client_create_vhost_context: using mem client CA cert 1043
30[2020/02/26 15:41:27:8684] N: lws_tls_client_create_vhost_context: using mem client CA cert 1167
31[2020/02/26 15:41:27:8684] N: lws_tls_client_create_vhost_context: using mem client CA cert 1391
32[2020/02/26 15:41:28:4226] N: ss_api_amazon_auth_rx: acquired 567-byte api.amazon.com auth token, exp 3600s
33```
34