2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
54
55
56
57
60#define LWS_SS_MTU 1540
65#if defined(STANDALONE)
66#define lws_context lws_context_standalone
67struct lws_context_standalone;
71
72
73
74
75
81
100
101
102
103
104
107
109
123
126
129
132
136
137
138
146} lws_ss_state_return_t;
149
150
151
152
153
154
159
160
161
162
163
164
170
180typedef lws_ss_state_return_t (*lws_sscb_rx)(
void *userobj,
const uint8_t *buf,
181 size_t len,
int flags);
182typedef lws_ss_state_return_t (*lws_sscb_tx)(
void *userobj,
184 uint8_t *buf, size_t *len,
186typedef lws_ss_state_return_t (*lws_sscb_state)(
void *userobj,
void *h_src,
187 lws_ss_constate_t state,
190#if defined(LWS_WITH_SECURE_STREAMS_BUFFER_DUMP)
191typedef void (*lws_ss_buffer_dump_cb)(
void *userobj,
const uint8_t *buf,
192 size_t len,
int done);
201
204
206#if defined(LWS_WITH_SECURE_STREAMS_CPP)
209
212#if defined(LWS_WITH_SYS_FAULT_INJECTION)
215
222
225
226
227#if defined(LWS_WITH_SECURE_STREAMS_BUFFER_DUMP)
233
234
235
236
237
238
241
242
246
247
248
249
250
254#define LWS_SS_USER_TYPEDEF
256 struct lws_ss_handle *ss;
259#define LWS_SS_INFO(_streamtype, _type)
260 const lws_ss_info_t ssi_##_type = {
261 .handle_offset = offsetof(_type, ss),
262 .opaque_user_data_offset = offsetof(_type, opaque_data),
263 .user_alloc = sizeof(_type),
264 .streamtype = _streamtype,
266#define lws_ss_from_user(_u) (_u)->ss
267#define lws_ss_opaque_from_user(_u) (_u)->opaque_data
268#define lws_ss_cx_from_user(_u) lws_ss_get_context((_u)->ss)
270#if defined(LWS_SS_USE_SSPC)
271#define lws_context_info_defaults(_x, _y) _lws_context_info_defaults(_x, NULL)
273#define lws_context_info_defaults(_x, _y) _lws_context_info_defaults(_x, _y)
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312LWS_VISIBLE LWS_EXTERN
int LWS_WARN_UNUSED_RESULT
313lws_ss_create(
struct lws_context *context,
int tsi,
const lws_ss_info_t *ssi,
314 void *opaque_user_data,
struct lws_ss_handle **ppss,
315 void *reserved,
const char **ppayload_fmt);
318
319
320
321
322
323
324LWS_VISIBLE LWS_EXTERN
void
328
329
330
331
332
333
334
335
336
337
338LWS_VISIBLE LWS_EXTERN lws_ss_state_return_t LWS_WARN_UNUSED_RESULT
339lws_ss_request_tx(
struct lws_ss_handle *pss);
342
343
344
345
346
347
348
349
350
351
352
353
354LWS_VISIBLE LWS_EXTERN lws_ss_state_return_t LWS_WARN_UNUSED_RESULT
355lws_ss_request_tx_len(
struct lws_ss_handle *pss,
unsigned long len);
358
359
360
361
362
363
364
365
366
367
368
369
370LWS_VISIBLE LWS_EXTERN lws_ss_state_return_t LWS_WARN_UNUSED_RESULT
371lws_ss_client_connect(
struct lws_ss_handle *h);
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389LWS_VISIBLE LWS_EXTERN
int
393
394
395
396
397
398
399LWS_VISIBLE LWS_EXTERN
const char *
403
404
405
406
407
408
409
410LWS_VISIBLE LWS_EXTERN
struct lws_context *
413#define LWSSS_TIMEOUT_FROM_POLICY 0
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430LWS_VISIBLE LWS_EXTERN
void
434
435
436
437
438
439
440LWS_VISIBLE LWS_EXTERN
void
444
445
446
447
448
449
450
451
452LWS_VISIBLE LWS_EXTERN
void *
456
457
458
459
460
461
462
463
464
465
466
467
468LWS_VISIBLE LWS_EXTERN
const char *
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497LWS_VISIBLE LWS_EXTERN
int LWS_WARN_UNUSED_RESULT
498lws_ss_set_metadata(
struct lws_ss_handle *h,
const char *name,
499 const void *value, size_t len);
502
503
504
505
506
507
508
509
510
511
512
513LWS_VISIBLE LWS_EXTERN
int LWS_WARN_UNUSED_RESULT
514lws_ss_alloc_set_metadata(
struct lws_ss_handle *h,
const char *name,
515 const void *value, size_t len);
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544LWS_VISIBLE LWS_EXTERN
int
546 const void **value, size_t *len);
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567LWS_VISIBLE LWS_EXTERN
void
573
574
575
576
577
578
579
580
581
582
583
584LWS_VISIBLE LWS_EXTERN
void
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613LWS_VISIBLE LWS_EXTERN
void
615 lws_sscb_state state);
618
619
620
621
622
623
624
625
626LWS_VISIBLE LWS_EXTERN
int
630
631
632
633
634
635
636
637
638
639LWS_VISIBLE LWS_EXTERN
int
642LWS_VISIBLE LWS_EXTERN
const char *
646#if defined(LWS_WITH_SECURE_STREAMS_AUTH_SIGV4)
648
649
650
651
652
653
654
655
656
657
658
660LWS_VISIBLE LWS_EXTERN
int
661lws_ss_sigv4_set_aws_key(
struct lws_context* context, uint8_t idx,
662 const char * keyid,
const char * key);
665
666
667
668
669
670
671
672
673
674
675
676
677
678
680LWS_VISIBLE LWS_EXTERN
int
681lws_aws_filesystem_credentials_helper(
const char *path,
const char *kid,
682 const char *ak,
char **aws_keyid,
687#if defined(STANDALONE)
uint8_t sss_protocol_version
int manual_initial_tx_credit
size_t opaque_user_data_offset
LWS_VISIBLE LWS_EXTERN void lws_ss_destroy(struct lws_ss_handle **ppss)
LWS_VISIBLE LWS_EXTERN void lws_ss_change_handlers(struct lws_ss_handle *h, lws_sscb_rx rx, lws_sscb_tx tx, lws_sscb_state state)
LWS_VISIBLE LWS_EXTERN int lws_ss_add_peer_tx_credit(struct lws_ss_handle *h, int32_t add)
LWS_VISIBLE LWS_EXTERN const char * lws_ss_rideshare(struct lws_ss_handle *h)
void(* lws_sssfec_cb)(struct lws_ss_handle *h, void *arg)
LWS_VISIBLE LWS_EXTERN int lws_ss_proxy_create(struct lws_context *context, const char *bind, int port)
LWS_VISIBLE LWS_EXTERN void lws_ss_start_timeout(struct lws_ss_handle *h, unsigned int timeout_ms)
LWS_VISIBLE LWS_EXTERN const char * lws_ss_tag(struct lws_ss_handle *h)
LWS_VISIBLE LWS_EXTERN const char * lws_ss_state_name(int state)
LWS_VISIBLE LWS_EXTERN void lws_ss_cancel_timeout(struct lws_ss_handle *h)
LWS_VISIBLE LWS_EXTERN struct lws_context * lws_ss_get_context(struct lws_ss_handle *h)
LWS_VISIBLE LWS_EXTERN void lws_ss_server_foreach_client(struct lws_ss_handle *h, lws_sssfec_cb cb, void *arg)
LWS_VISIBLE LWS_EXTERN int lws_ss_get_est_peer_tx_credit(struct lws_ss_handle *h)
LWS_VISIBLE LWS_EXTERN void * lws_ss_to_user_object(struct lws_ss_handle *h)
uint32_t lws_ss_tx_ordinal_t
LWS_VISIBLE LWS_EXTERN void lws_ss_server_ack(struct lws_ss_handle *h, int nack)
LWS_VISIBLE LWS_EXTERN int lws_ss_get_metadata(struct lws_ss_handle *h, const char *name, const void **value, size_t *len)
@ LWSSS_FLAG_RELATED_START
@ LWSSSINFLAGS_REGISTER_SINK
@ LWSSSINFLAGS_ACCEPTED_SINK
@ LWSSSSRET_DISCONNECT_ME
@ LWSSSCS_QOS_NACK_REMOTE
@ LWSSSCS_EVENT_WAIT_CANCELLED
@ LWSSSCS_ALL_RETRIES_FAILED
@ LWSSSCS_UPSTREAM_LINK_RETRY