libwebsockets
Lightweight C library for HTML5 websockets
libwebsockets.h
Go to the documentation of this file.
1 /*
2  * libwebsockets - small server side websockets and web server implementation
3  *
4  * Copyright (C) 2010-2016 Andy Green <andy@warmcat.com>
5  *
6  * This library is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation:
9  * version 2.1 of the License.
10  *
11  * This library is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with this library; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
19  * MA 02110-1301 USA
20  */
21 
24 #ifndef LIBWEBSOCKET_H_3060898B846849FF9F88F5DB59B5950C
25 #define LIBWEBSOCKET_H_3060898B846849FF9F88F5DB59B5950C
26 
27 #ifdef __cplusplus
28 #include <cstddef>
29 #include <cstdarg>
30 #
31 extern "C" {
32 #else
33 #include <stdarg.h>
34 #endif
35 
36 #if defined(LWS_WITH_ESP8266)
37 struct sockaddr_in;
38 #define LWS_POSIX 0
39 #else
40 #define LWS_POSIX 1
41 #endif
42 
43 #include "lws_config.h"
44 
45 #if defined(WIN32) || defined(_WIN32)
46 #ifndef WIN32_LEAN_AND_MEAN
47 #define WIN32_LEAN_AND_MEAN
48 #endif
49 
50 #include <winsock2.h>
51 #include <ws2tcpip.h>
52 #include <stddef.h>
53 #include <basetsd.h>
54 #ifndef _WIN32_WCE
55 #include <fcntl.h>
56 #else
57 #define _O_RDONLY 0x0000
58 #define O_RDONLY _O_RDONLY
59 #endif
60 
61 // Visual studio older than 2015 and WIN_CE has only _stricmp
62 #if (defined(_MSC_VER) && _MSC_VER < 1900) || defined(_WIN32_WCE)
63 #define strcasecmp _stricmp
64 #elif !defined(__MINGW32__)
65 #define strcasecmp stricmp
66 #endif
67 #define getdtablesize() 30000
68 
69 #define LWS_INLINE __inline
70 #define LWS_VISIBLE
71 #define LWS_WARN_UNUSED_RESULT
72 #define LWS_WARN_DEPRECATED
73 #define LWS_FORMAT(string_index)
74 
75 #ifdef LWS_DLL
76 #ifdef LWS_INTERNAL
77 #define LWS_EXTERN extern __declspec(dllexport)
78 #else
79 #define LWS_EXTERN extern __declspec(dllimport)
80 #endif
81 #else
82 #define LWS_EXTERN
83 #endif
84 
85 #define LWS_INVALID_FILE INVALID_HANDLE_VALUE
86 #define LWS_O_RDONLY _O_RDONLY
87 
88 #if !defined(__MINGW32__) && (!defined(_MSC_VER) || _MSC_VER < 1900) /* Visual Studio 2015 already defines this in <stdio.h> */
89 #define lws_snprintf _snprintf
90 #endif
91 
92 #ifndef __func__
93 #define __func__ __FUNCTION__
94 #endif
95 
96 #if !defined(__MINGW32__) &&(!defined(_MSC_VER) || _MSC_VER < 1900) && !defined(snprintf)
97 #define snprintf(buf,len, format,...) _snprintf_s(buf, len,len, format, __VA_ARGS__)
98 #endif
99 
100 #else /* NOT WIN32 */
101 #include <unistd.h>
102 
103 #if defined(__NetBSD__) || defined(__FreeBSD__)
104 #include <netinet/in.h>
105 #endif
106 
107 #define LWS_INLINE inline
108 #define LWS_O_RDONLY O_RDONLY
109 
110 #if !defined(LWS_WITH_ESP8266) && !defined(OPTEE_TA) && !defined(LWS_WITH_ESP32)
111 #include <poll.h>
112 #include <netdb.h>
113 #define LWS_INVALID_FILE -1
114 #else
115 #define getdtablesize() (20)
116 #if defined(LWS_WITH_ESP32)
117 #define LWS_INVALID_FILE NULL
118 #else
119 #define LWS_INVALID_FILE NULL
120 #endif
121 #endif
122 
123 #if defined(__GNUC__)
124 
125 /* warn_unused_result attribute only supported by GCC 3.4 or later */
126 #if __GNUC__ >= 4 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 4)
127 #define LWS_WARN_UNUSED_RESULT __attribute__((warn_unused_result))
128 #else
129 #define LWS_WARN_UNUSED_RESULT
130 #endif
131 
132 #define LWS_VISIBLE __attribute__((visibility("default")))
133 #define LWS_WARN_DEPRECATED __attribute__ ((deprecated))
134 #define LWS_FORMAT(string_index) __attribute__ ((format(printf, string_index, string_index+1)))
135 #else
136 #define LWS_VISIBLE
137 #define LWS_WARN_UNUSED_RESULT
138 #define LWS_WARN_DEPRECATED
139 #define LWS_FORMAT(string_index)
140 #endif
141 
142 #if defined(__ANDROID__)
143 #include <unistd.h>
144 #define getdtablesize() sysconf(_SC_OPEN_MAX)
145 #endif
146 
147 #endif
148 
149 #ifdef LWS_USE_LIBEV
150 #include <ev.h>
151 #endif /* LWS_USE_LIBEV */
152 #ifdef LWS_USE_LIBUV
153 #include <uv.h>
154 #ifdef LWS_HAVE_UV_VERSION_H
155 #include <uv-version.h>
156 #endif
157 #endif /* LWS_USE_LIBUV */
158 
159 #ifndef LWS_EXTERN
160 #define LWS_EXTERN extern
161 #endif
162 
163 #ifdef _WIN32
164 #define random rand
165 #else
166 #if !defined(OPTEE_TA)
167 #include <sys/time.h>
168 #include <unistd.h>
169 #endif
170 #endif
171 
172 #ifdef LWS_OPENSSL_SUPPORT
173 
174 #ifdef USE_WOLFSSL
175 #ifdef USE_OLD_CYASSL
176 #include <cyassl/openssl/ssl.h>
177 #include <cyassl/error-ssl.h>
178 #else
179 #include <wolfssl/openssl/ssl.h>
180 #include <wolfssl/error-ssl.h>
181 #endif /* not USE_OLD_CYASSL */
182 #else
183 #include <openssl/ssl.h>
184 #if !defined(LWS_WITH_ESP32)
185 #include <openssl/err.h>
186 #endif
187 #endif /* not USE_WOLFSSL */
188 #endif
189 
190 
191 #define CONTEXT_PORT_NO_LISTEN -1
192 #define CONTEXT_PORT_NO_LISTEN_SERVER -2
193 
204 
206 enum lws_log_levels {
207  LLL_ERR = 1 << 0,
208  LLL_WARN = 1 << 1,
209  LLL_NOTICE = 1 << 2,
210  LLL_INFO = 1 << 3,
211  LLL_DEBUG = 1 << 4,
212  LLL_PARSER = 1 << 5,
213  LLL_HEADER = 1 << 6,
214  LLL_EXT = 1 << 7,
215  LLL_CLIENT = 1 << 8,
216  LLL_LATENCY = 1 << 9,
217  LLL_USER = 1 << 10,
218 
219  LLL_COUNT = 11 /* set to count of valid flags */
220 };
221 
222 LWS_VISIBLE LWS_EXTERN void _lws_log(int filter, const char *format, ...) LWS_FORMAT(2);
223 LWS_VISIBLE LWS_EXTERN void _lws_logv(int filter, const char *format, va_list vl);
233 LWS_VISIBLE LWS_EXTERN int
234 lwsl_timestamp(int level, char *p, int len);
235 
236 /* these guys are unconditionally included */
237 
238 #define lwsl_err(...) _lws_log(LLL_ERR, __VA_ARGS__)
239 #define lwsl_user(...) _lws_log(LLL_USER, __VA_ARGS__)
240 
241 #if !defined(LWS_WITH_NO_LOGS)
242 /* notice and warn are usually included by being compiled in */
243 #define lwsl_warn(...) _lws_log(LLL_WARN, __VA_ARGS__)
244 #define lwsl_notice(...) _lws_log(LLL_NOTICE, __VA_ARGS__)
245 #endif
246 /*
247  * weaker logging can be deselected by telling CMake to build in RELEASE mode
248  * that gets rid of the overhead of checking while keeping _warn and _err
249  * active
250  */
251 
252 #if defined(LWS_WITH_ESP8266)
253 #undef _DEBUG
254 #endif
255 
256 #ifdef _DEBUG
257 #if defined(LWS_WITH_NO_LOGS)
258 /* notice, warn and log are always compiled in */
259 #define lwsl_warn(...) _lws_log(LLL_WARN, __VA_ARGS__)
260 #define lwsl_notice(...) _lws_log(LLL_NOTICE, __VA_ARGS__)
261 #endif
262 #define lwsl_info(...) _lws_log(LLL_INFO, __VA_ARGS__)
263 #define lwsl_debug(...) _lws_log(LLL_DEBUG, __VA_ARGS__)
264 #define lwsl_parser(...) _lws_log(LLL_PARSER, __VA_ARGS__)
265 #define lwsl_header(...) _lws_log(LLL_HEADER, __VA_ARGS__)
266 #define lwsl_ext(...) _lws_log(LLL_EXT, __VA_ARGS__)
267 #define lwsl_client(...) _lws_log(LLL_CLIENT, __VA_ARGS__)
268 #define lwsl_latency(...) _lws_log(LLL_LATENCY, __VA_ARGS__)
269 
275 LWS_VISIBLE LWS_EXTERN void lwsl_hexdump(void *buf, size_t len);
276 
277 #else /* no debug */
278 #if defined(LWS_WITH_NO_LOGS)
279 #define lwsl_warn(...) do {} while(0)
280 #define lwsl_notice(...) do {} while(0)
281 #endif
282 #define lwsl_info(...) do {} while(0)
283 #define lwsl_debug(...) do {} while(0)
284 #define lwsl_parser(...) do {} while(0)
285 #define lwsl_header(...) do {} while(0)
286 #define lwsl_ext(...) do {} while(0)
287 #define lwsl_client(...) do {} while(0)
288 #define lwsl_latency(...) do {} while(0)
289 #define lwsl_hexdump(a, b)
290 
291 #endif
292 
293 static LWS_INLINE int lws_is_be(void) {
294  const int probe = ~0xff;
295 
296  return *(const char *)&probe;
297 }
298 
309 LWS_VISIBLE LWS_EXTERN void
310 lws_set_log_level(int level,
311  void (*log_emit_function)(int level, const char *line));
312 
322 LWS_VISIBLE LWS_EXTERN void
323 lwsl_emit_syslog(int level, const char *line);
324 
334 LWS_VISIBLE LWS_EXTERN int
335 lwsl_visible(int level);
336 
338 
339 
340 #include <stddef.h>
341 
342 #ifndef lws_container_of
343 #define lws_container_of(P,T,M) ((T *)((char *)(P) - offsetof(T, M)))
344 #endif
345 
346 
347 struct lws;
348 #ifndef ARRAY_SIZE
349 #define ARRAY_SIZE(x) (sizeof(x) / sizeof(x[0]))
350 #endif
351 
352 /* api change list for user code to test against */
353 
354 #define LWS_FEATURE_SERVE_HTTP_FILE_HAS_OTHER_HEADERS_ARG
355 
356 /* the struct lws_protocols has the id field present */
357 #define LWS_FEATURE_PROTOCOLS_HAS_ID_FIELD
358 
359 /* you can call lws_get_peer_write_allowance */
360 #define LWS_FEATURE_PROTOCOLS_HAS_PEER_WRITE_ALLOWANCE
361 
362 /* extra parameter introduced in 917f43ab821 */
363 #define LWS_FEATURE_SERVE_HTTP_FILE_HAS_OTHER_HEADERS_LEN
364 
365 /* File operations stuff exists */
366 #define LWS_FEATURE_FOPS
367 
368 
369 #if defined(_WIN32)
370 typedef SOCKET lws_sockfd_type;
371 typedef HANDLE lws_filefd_type;
372 #define lws_sockfd_valid(sfd) (!!sfd)
373 struct lws_pollfd {
374  lws_sockfd_type fd;
375  SHORT events;
376  SHORT revents;
377 };
378 #define LWS_POLLHUP (FD_CLOSE)
379 #define LWS_POLLIN (FD_READ | FD_ACCEPT)
380 #define LWS_POLLOUT (FD_WRITE)
381 #else
382 
383 
384 #if defined(LWS_WITH_ESP8266)
385 
386 #include <user_interface.h>
387 #include <espconn.h>
388 
389 typedef struct espconn * lws_sockfd_type;
390 typedef void * lws_filefd_type;
391 #define lws_sockfd_valid(sfd) (!!sfd)
392 struct pollfd {
393  lws_sockfd_type fd;
394  short events;
395  short revents;
396 };
397 #define POLLIN 0x0001
398 #define POLLPRI 0x0002
399 #define POLLOUT 0x0004
400 #define POLLERR 0x0008
401 #define POLLHUP 0x0010
402 #define POLLNVAL 0x0020
403 
404 struct lws_vhost;
405 
406 lws_sockfd_type esp8266_create_tcp_listen_socket(struct lws_vhost *vh);
407 void esp8266_tcp_stream_accept(lws_sockfd_type fd, struct lws *wsi);
408 
409 #include <os_type.h>
410 #include <osapi.h>
411 #include "ets_sys.h"
412 
413 int ets_snprintf(char *str, size_t size, const char *format, ...) LWS_FORMAT(3);
414 #define snprintf ets_snprintf
415 
416 typedef os_timer_t uv_timer_t;
417 typedef void uv_cb_t(uv_timer_t *);
418 
419 void os_timer_disarm(void *);
420 void os_timer_setfn(os_timer_t *, os_timer_func_t *, void *);
421 
422 void ets_timer_arm_new(os_timer_t *, int, int, int);
423 
424 //void os_timer_arm(os_timer_t *, int, int);
425 
426 #define UV_VERSION_MAJOR 1
427 
428 #define lws_uv_getloop(a, b) (NULL)
429 
430 static inline void uv_timer_init(void *l, uv_timer_t *t)
431 {
432  (void)l;
433  memset(t, 0, sizeof(*t));
434  os_timer_disarm(t);
435 }
436 
437 static inline void uv_timer_start(uv_timer_t *t, uv_cb_t *cb, int first, int rep)
438 {
439  os_timer_setfn(t, (os_timer_func_t *)cb, t);
440  /* ms, repeat */
441  os_timer_arm(t, first, !!rep);
442 }
443 
444 static inline void uv_timer_stop(uv_timer_t *t)
445 {
446  os_timer_disarm(t);
447 }
448 
449 #else
450 #if defined(LWS_WITH_ESP32)
451 
452 typedef int lws_sockfd_type;
453 typedef int lws_filefd_type;
454 #define lws_sockfd_valid(sfd) (sfd >= 0)
455 struct pollfd {
456  lws_sockfd_type fd;
457  short events;
458  short revents;
459 };
460 #define POLLIN 0x0001
461 #define POLLPRI 0x0002
462 #define POLLOUT 0x0004
463 #define POLLERR 0x0008
464 #define POLLHUP 0x0010
465 #define POLLNVAL 0x0020
466 
467 #include <freertos/FreeRTOS.h>
468 #include <freertos/event_groups.h>
469 #include <string.h>
470 #include "esp_wifi.h"
471 #include "esp_system.h"
472 #include "esp_event.h"
473 #include "esp_event_loop.h"
474 #include "nvs.h"
475 #include "driver/gpio.h"
476 #include "esp_spi_flash.h"
477 #include "freertos/timers.h"
478 
479 #if !defined(CONFIG_FREERTOS_HZ)
480 #define CONFIG_FREERTOS_HZ 100
481 #endif
482 
483 typedef TimerHandle_t uv_timer_t;
484 typedef void uv_cb_t(uv_timer_t *);
485 typedef void * uv_handle_t;
486 
488  uv_cb_t *cb;
489  uv_timer_t *t;
490 };
491 
492 #define UV_VERSION_MAJOR 1
493 
494 #define lws_uv_getloop(a, b) (NULL)
495 
496 static inline void uv_timer_init(void *l, uv_timer_t *t)
497 {
498  (void)l;
499  *t = NULL;
500 }
501 
502 extern void esp32_uvtimer_cb(TimerHandle_t t);
503 
504 static inline void uv_timer_start(uv_timer_t *t, uv_cb_t *cb, int first, int rep)
505 {
506  struct timer_mapping *tm = malloc(sizeof(*tm));
507 
508  if (!tm)
509  return;
510 
511  tm->t = t;
512  tm->cb = cb;
513 
514  *t = xTimerCreate("x", pdMS_TO_TICKS(first), !!rep, tm,
515  (TimerCallbackFunction_t)esp32_uvtimer_cb);
516  xTimerStart(*t, 0);
517 }
518 
519 static inline void uv_timer_stop(uv_timer_t *t)
520 {
521  xTimerStop(*t, 0);
522 }
523 
524 static inline void uv_close(uv_handle_t *h, void *v)
525 {
526  free(pvTimerGetTimerID((uv_timer_t)h));
527  xTimerDelete(*(uv_timer_t *)h, 0);
528 }
529 
530 /* ESP32 helper declarations */
531 
532 #define LWS_PLUGIN_STATIC
533 
534 /* user code provides these */
535 
536 extern char lws_esp32_model[16];
537 
538 extern int
539 lws_esp32_is_booting_in_ap_mode(void);
540 extern void
541 lws_esp32_identify_physical_device(void);
542 
543 /* lws-plat-esp32 provides these */
544 
545 extern void (*lws_cb_scan_done)(void *);
546 extern void *lws_cb_scan_done_arg;
547 
548 extern char lws_esp32_serial[], lws_esp32_force_ap, lws_esp32_region;
549 
550 extern esp_err_t
551 lws_esp32_event_passthru(void *ctx, system_event_t *event);
552 extern void
553 lws_esp32_wlan_config(void);
554 extern void
555 lws_esp32_wlan_start(void);
557 extern struct lws_context *
558 lws_esp32_init(struct lws_context_creation_info *, unsigned int _romfs);
559 
560 #else
561 typedef int lws_sockfd_type;
562 typedef int lws_filefd_type;
563 #define lws_sockfd_valid(sfd) (sfd >= 0)
564 #endif
565 #endif
566 
567 #define lws_pollfd pollfd
568 #define LWS_POLLHUP (POLLHUP|POLLERR)
569 #define LWS_POLLIN (POLLIN)
570 #define LWS_POLLOUT (POLLOUT)
571 #endif
572 
575 struct lws_pollargs {
576  lws_sockfd_type fd;
577  int events;
579 };
580 
581 struct lws_tokens;
582 struct lws_token_limits;
583 
591 
593 /*
594  * NOTE: These public enums are part of the abi. If you want to add one,
595  * add it at where specified so existing users are unaffected.
596  */
599  LWS_CLOSE_STATUS_NOSTATUS = 0,
661  /****** add new things just above ---^ ******/
662 
663  LWS_CLOSE_STATUS_NOSTATUS_CONTEXT_DESTROY = 9999,
664 };
665 
678 LWS_VISIBLE LWS_EXTERN void
679 lws_close_reason(struct lws *wsi, enum lws_close_status status,
680  unsigned char *buf, size_t len);
681 
683 
684 struct lws;
685 struct lws_context;
686 /* needed even with extensions disabled for create context */
687 struct lws_extension;
688 
700 
702 
703 /*
704  * NOTE: These public enums are part of the abi. If you want to add one,
705  * add it at where specified so existing users are unaffected.
706  */
950  /* external poll() management support */
1013  LWS_CALLBACK_WS_EXT_DEFAULTS = 39,
1016  LWS_CALLBACK_CGI = 40,
1018  LWS_CALLBACK_CGI_TERMINATED = 41,
1020  LWS_CALLBACK_CGI_STDIN_DATA = 42,
1022  LWS_CALLBACK_CGI_STDIN_COMPLETED = 43,
1024  LWS_CALLBACK_ESTABLISHED_CLIENT_HTTP = 44,
1026  LWS_CALLBACK_CLOSED_CLIENT_HTTP = 45,
1028  LWS_CALLBACK_RECEIVE_CLIENT_HTTP = 46,
1030  LWS_CALLBACK_COMPLETED_CLIENT_HTTP = 47,
1032  LWS_CALLBACK_RECEIVE_CLIENT_HTTP_READ = 48,
1034  LWS_CALLBACK_HTTP_BIND_PROTOCOL = 49,
1036  LWS_CALLBACK_HTTP_DROP_PROTOCOL = 50,
1038  LWS_CALLBACK_CHECK_ACCESS_RIGHTS = 51,
1040  LWS_CALLBACK_PROCESS_HTML = 52,
1042  LWS_CALLBACK_ADD_HEADERS = 53,
1044  LWS_CALLBACK_SESSION_INFO = 54,
1047  LWS_CALLBACK_GS_EVENT = 55,
1110  /****** add new things just above ---^ ******/
1111 
1114 };
1115 
1116 
1117 
1133 typedef int
1134 lws_callback_function(struct lws *wsi, enum lws_callback_reasons reason,
1135  void *user, void *in, size_t len);
1137 
1147 
1149 /*
1150  * NOTE: These public enums are part of the abi. If you want to add one,
1151  * add it at where specified so existing users are unaffected.
1152  */
1153 enum lws_extension_callback_reasons {
1154  LWS_EXT_CB_SERVER_CONTEXT_CONSTRUCT = 0,
1155  LWS_EXT_CB_CLIENT_CONTEXT_CONSTRUCT = 1,
1156  LWS_EXT_CB_SERVER_CONTEXT_DESTRUCT = 2,
1157  LWS_EXT_CB_CLIENT_CONTEXT_DESTRUCT = 3,
1158  LWS_EXT_CB_CONSTRUCT = 4,
1159  LWS_EXT_CB_CLIENT_CONSTRUCT = 5,
1160  LWS_EXT_CB_CHECK_OK_TO_REALLY_CLOSE = 6,
1161  LWS_EXT_CB_CHECK_OK_TO_PROPOSE_EXTENSION = 7,
1162  LWS_EXT_CB_DESTROY = 8,
1163  LWS_EXT_CB_DESTROY_ANY_WSI_CLOSING = 9,
1164  LWS_EXT_CB_ANY_WSI_ESTABLISHED = 10,
1165  LWS_EXT_CB_PACKET_RX_PREPARSE = 11,
1166  LWS_EXT_CB_PACKET_TX_PRESEND = 12,
1167  LWS_EXT_CB_PACKET_TX_DO_SEND = 13,
1168  LWS_EXT_CB_HANDSHAKE_REPLY_TX = 14,
1169  LWS_EXT_CB_FLUSH_PENDING_TX = 15,
1170  LWS_EXT_CB_EXTENDED_PAYLOAD_RX = 16,
1171  LWS_EXT_CB_CAN_PROXY_CLIENT_CONNECTION = 17,
1172  LWS_EXT_CB_1HZ = 18,
1173  LWS_EXT_CB_REQUEST_ON_WRITEABLE = 19,
1174  LWS_EXT_CB_IS_WRITEABLE = 20,
1175  LWS_EXT_CB_PAYLOAD_TX = 21,
1176  LWS_EXT_CB_PAYLOAD_RX = 22,
1177  LWS_EXT_CB_OPTION_DEFAULT = 23,
1178  LWS_EXT_CB_OPTION_SET = 24,
1179  LWS_EXT_CB_OPTION_CONFIRM = 25,
1180  LWS_EXT_CB_NAMED_OPTION_SET = 26,
1181 
1182  /****** add new things just above ---^ ******/
1183 };
1184 
1191  /* Add new things just above here ---^
1192  * This is part of the ABI, don't needlessly break compatibility */
1193 };
1194 
1200  const char *name;
1203  /* Add new things just above here ---^
1204  * This is part of the ABI, don't needlessly break compatibility */
1205 };
1206 
1209  const char *option_name;
1211  const char *start;
1212  int len;
1213 };
1214 
1275 typedef int
1276 lws_extension_callback_function(struct lws_context *context,
1277  const struct lws_extension *ext, struct lws *wsi,
1278  enum lws_extension_callback_reasons reason,
1279  void *user, void *in, size_t len);
1280 
1283  const char *name;
1285  const char *client_offer;
1287  /* Add new things just above here ---^
1288  * This is part of the ABI, don't needlessly break compatibility */
1289 };
1290 
1299 LWS_VISIBLE LWS_EXTERN int
1300 lws_set_extension_option(struct lws *wsi, const char *ext_name,
1301  const char *opt_name, const char *opt_val);
1302 
1303 #ifndef LWS_NO_EXTENSIONS
1304 /* lws_get_internal_extensions() - DEPRECATED
1305  *
1306  * \Deprecated There is no longer a set internal extensions table. The table is provided
1307  * by user code along with application-specific settings. See the test
1308  * client and server for how to do.
1309  */
1310 static LWS_INLINE LWS_WARN_DEPRECATED const struct lws_extension *
1311 lws_get_internal_extensions(void) { return NULL; }
1312 
1323 LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
1324 lws_ext_parse_options(const struct lws_extension *ext, struct lws *wsi,
1325  void *ext_user, const struct lws_ext_options *opts,
1326  const char *o, int len);
1327 #endif
1328 
1341 LWS_EXTERN
1343  struct lws_context *context, const struct lws_extension *ext,
1344  struct lws *wsi, enum lws_extension_callback_reasons reason,
1345  void *user, void *in, size_t len);
1346 
1347 /*
1348  * The internal exts are part of the public abi
1349  * If we add more extensions, publish the callback here ------v
1350  */
1352 
1368 
1373  const char *name;
1394  unsigned int id;
1401  void *user;
1404  /* Add new things just above here ---^
1405  * This is part of the ABI, don't needlessly break compatibility */
1406 };
1407 
1408 struct lws_vhost;
1409 
1418 LWS_VISIBLE LWS_EXTERN const struct lws_protocols *
1419 lws_vhost_name_to_protocol(struct lws_vhost *vh, const char *name);
1420 
1430 LWS_VISIBLE LWS_EXTERN const struct lws_protocols *
1431 lws_get_protocol(struct lws *wsi);
1432 
1434 LWS_VISIBLE LWS_EXTERN const struct lws_protocols *
1435 lws_protocol_get(struct lws *wsi) LWS_WARN_DEPRECATED;
1436 
1447 LWS_VISIBLE LWS_EXTERN void *
1448 lws_protocol_vh_priv_zalloc(struct lws_vhost *vhost, const struct lws_protocols *prot,
1449  int size);
1450 
1460 LWS_VISIBLE LWS_EXTERN void *
1461 lws_protocol_vh_priv_get(struct lws_vhost *vhost, const struct lws_protocols *prot);
1462 
1471 LWS_VISIBLE LWS_EXTERN int
1472 lws_finalize_startup(struct lws_context *context);
1473 
1474 LWS_VISIBLE LWS_EXTERN int
1475 lws_protocol_init(struct lws_context *context);
1476 
1477 #ifdef LWS_WITH_PLUGINS
1478 
1479 /* PLUGINS implies LIBUV */
1480 
1481 #define LWS_PLUGIN_API_MAGIC 180
1482 
1485  unsigned int api_magic;
1486  const struct lws_protocols *protocols;
1488  const struct lws_extension *extensions;
1490 };
1491 
1492 typedef int (*lws_plugin_init_func)(struct lws_context *,
1493  struct lws_plugin_capability *);
1494 typedef int (*lws_plugin_destroy_func)(struct lws_context *);
1495 
1497 struct lws_plugin {
1498  struct lws_plugin *list;
1499 #if (UV_VERSION_MAJOR > 0)
1500  uv_lib_t lib;
1501 #else
1502  void *l;
1503 #endif
1504  char name[64];
1506 };
1507 
1508 #endif
1509 
1511 
1512 
1521 
1523 #define LWSGS_EMAIL_CONTENT_SIZE 16384
1524 
1526 /* SHA-1 binary and hexified versions */
1528 typedef struct { unsigned char bin[20]; } lwsgw_hash_bin;
1530 typedef struct { char id[41]; } lwsgw_hash;
1531 
1538 };
1539 
1542  char username[32];
1543  char email[100];
1544  char ip[72];
1545  unsigned int mask;
1547  char session[42];
1548 };
1549 
1554 };
1555 
1558  enum lws_gs_event event;
1559  const char *username;
1560  const char *email;
1561 };
1562 
1564 
1565 
1579 
1581 /*
1582  * NOTE: These public enums are part of the abi. If you want to add one,
1583  * add it at where specified so existing users are unaffected.
1584  */
1585 
1589  (1 << 12),
1596  (1 << 12),
1612  (1 << 12),
1617  (1 << 12),
1650  /****** add new things just above ---^ ******/
1651 };
1652 
1653 #define lws_check_opt(c, f) (((c) & (f)) == (f))
1654 
1655 struct lws_plat_file_ops;
1656 
1667  int port;
1672  const char *iface;
1679  const struct lws_protocols *protocols;
1683  const struct lws_extension *extensions;
1691  const char *ssl_cert_filepath;
1701  const char *ssl_ca_filepath;
1703  const char *ssl_cipher_list;
1707  const char *http_proxy_address;
1710  unsigned int http_proxy_port;
1712  int gid;
1714  int uid;
1716  unsigned int options;
1718  void *user;
1721  int ka_time;
1731 #ifdef LWS_OPENSSL_SUPPORT
1737 #else /* maintain structure layout either way */
1739 #endif
1740 
1751  unsigned int count_threads;
1753  unsigned int fd_limit_per_thread;
1757  unsigned int timeout_secs;
1762  const char *ecdh_curve;
1764  const char *vhost_name;
1768  const char * const *plugin_dirs;
1777  const char *log_filepath;
1780  const struct lws_http_mount *mounts;
1782  const char *server_string;
1785  unsigned int pt_serv_buf_size;
1800  unsigned short ws_ping_pong_interval;
1831 #ifdef LWS_OPENSSL_SUPPORT
1832 
1852 #endif
1853 
1854  const struct lws_plat_file_ops *fops;
1862  /* Add new things just above here ---^
1863  * This is part of the ABI, don't needlessly break compatibility
1864  *
1865  * The below is to ensure later library versions with new
1866  * members added above will see 0 (default) even if the app
1867  * was not built against the newer headers.
1868  */
1869 
1870  void *_unused[8];
1871 };
1872 
1907 LWS_VISIBLE LWS_EXTERN struct lws_context *
1909 
1918 LWS_VISIBLE LWS_EXTERN void
1919 lws_context_destroy(struct lws_context *context);
1920 
1921 LWS_VISIBLE LWS_EXTERN void
1922 lws_context_destroy2(struct lws_context *context);
1923 
1924 typedef int (*lws_reload_func)(void);
1925 
1950 LWS_VISIBLE LWS_EXTERN void
1951 lws_context_deprecate(struct lws_context *context, lws_reload_func cb);
1952 
1953 LWS_VISIBLE LWS_EXTERN int
1954 lws_context_is_deprecated(struct lws_context *context);
1955 
1973 LWS_VISIBLE LWS_EXTERN int
1974 lws_set_proxy(struct lws_vhost *vhost, const char *proxy);
1975 
1976 
1977 struct lws_vhost;
1978 
1988 LWS_EXTERN LWS_VISIBLE struct lws_vhost *
1989 lws_create_vhost(struct lws_context *context,
1990  struct lws_context_creation_info *info);
1991 
2006 LWS_VISIBLE LWS_EXTERN int
2007 lwsws_get_config_globals(struct lws_context_creation_info *info, const char *d,
2008  char **config_strings, int *len);
2009 
2025 LWS_VISIBLE LWS_EXTERN int
2026 lwsws_get_config_vhosts(struct lws_context *context,
2027  struct lws_context_creation_info *info, const char *d,
2028  char **config_strings, int *len);
2029 
2031 LWS_VISIBLE LWS_EXTERN struct lws_vhost *
2032 lws_vhost_get(struct lws *wsi) LWS_WARN_DEPRECATED;
2033 
2039 LWS_VISIBLE LWS_EXTERN struct lws_vhost *
2040 lws_get_vhost(struct lws *wsi);
2041 
2049 LWS_VISIBLE LWS_EXTERN int
2050 lws_json_dump_vhost(const struct lws_vhost *vh, char *buf, int len);
2051 
2059 LWS_VISIBLE LWS_EXTERN int
2060 lws_json_dump_context(const struct lws_context *context, char *buf, int len,
2061  int hide_vhosts);
2062 
2072 LWS_VISIBLE LWS_EXTERN void *
2073 lws_context_user(struct lws_context *context);
2074 
2080 
2090  const char *name;
2091  const char *value;
2092 };
2093 
2106 };
2107 
2115  const char *mountpoint;
2117  const char *origin;
2119  const char *def;
2121  const char *protocol;
2137  unsigned int auth_mask;
2140  unsigned int cache_reusable:1;
2141  unsigned int cache_revalidate:1;
2142  unsigned int cache_intermediaries:1;
2144  unsigned char origin_protocol;
2145  unsigned char mountpoint_len;
2150  /* Add new things just above here ---^
2151  * This is part of the ABI, don't needlessly break compatibility
2152  *
2153  * The below is to ensure later library versions with new
2154  * members added above will see 0 (default) even if the app
2155  * was not built against the newer headers.
2156  */
2157 
2158  void *_unused[2];
2159 };
2162 
2168 
2176  LCCSCF_USE_SSL = (1 << 0),
2177  LCCSCF_ALLOW_SELFSIGNED = (1 << 1),
2178  LCCSCF_SKIP_SERVER_CERT_HOSTNAME_CHECK = (1 << 2),
2179  LCCSCF_ALLOW_EXPIRED = (1 << 3)
2180 };
2181 
2186  struct lws_context *context;
2188  const char *address;
2190  int port;
2194  const char *path;
2196  const char *host;
2198  const char *origin;
2200  const char *protocol;
2204  void *userdata;
2206  const void *client_exts;
2208  const char *method;
2211  struct lws *parent_wsi;
2215  const char *uri_replace_from;
2218  const char *uri_replace_to;
2220  struct lws_vhost *vhost;
2222  struct lws **pwsi;
2234  /* Add new things just above here ---^
2235  * This is part of the ABI, don't needlessly break compatibility
2236  *
2237  * The below is to ensure later library versions with new
2238  * members added above will see 0 (default) even if the app
2239  * was not built against the newer headers.
2240  */
2241 
2242  void *_unused[4];
2243 };
2244 
2252 LWS_VISIBLE LWS_EXTERN struct lws *
2254 
2275 /* deprecated, use lws_client_connect_via_info() */
2276 LWS_VISIBLE LWS_EXTERN struct lws * LWS_WARN_UNUSED_RESULT
2277 lws_client_connect(struct lws_context *clients, const char *address,
2278  int port, int ssl_connection, const char *path,
2279  const char *host, const char *origin, const char *protocol,
2280  int ietf_version_or_minus_one) LWS_WARN_DEPRECATED;
2281 /* deprecated, use lws_client_connect_via_info() */
2302 LWS_VISIBLE LWS_EXTERN struct lws * LWS_WARN_UNUSED_RESULT
2303 lws_client_connect_extended(struct lws_context *clients, const char *address,
2304  int port, int ssl_connection, const char *path,
2305  const char *host, const char *origin,
2306  const char *protocol, int ietf_version_or_minus_one,
2307  void *userdata) LWS_WARN_DEPRECATED;
2308 
2334 LWS_VISIBLE LWS_EXTERN int
2336  struct lws_vhost *vhost);
2337 
2358 LWS_VISIBLE LWS_EXTERN int
2359 lws_http_client_read(struct lws *wsi, char **buf, int *len);
2360 
2368 LWS_VISIBLE LWS_EXTERN unsigned int
2369 lws_http_client_http_response(struct lws *wsi);
2370 
2371 LWS_VISIBLE LWS_EXTERN void
2372 lws_client_http_body_pending(struct lws *wsi, int something_left_to_send);
2373 
2394 
2403 
2436 LWS_VISIBLE LWS_EXTERN int
2437 lws_service(struct lws_context *context, int timeout_ms);
2438 
2450 LWS_VISIBLE LWS_EXTERN int
2451 lws_service_tsi(struct lws_context *context, int timeout_ms, int tsi);
2452 
2468 LWS_VISIBLE LWS_EXTERN void
2469 lws_cancel_service_pt(struct lws *wsi);
2470 
2482 LWS_VISIBLE LWS_EXTERN void
2483 lws_cancel_service(struct lws_context *context);
2484 
2511 LWS_VISIBLE LWS_EXTERN int
2512 lws_service_fd(struct lws_context *context, struct lws_pollfd *pollfd);
2513 
2523 LWS_VISIBLE LWS_EXTERN int
2524 lws_service_fd_tsi(struct lws_context *context, struct lws_pollfd *pollfd,
2525  int tsi);
2526 
2544 LWS_VISIBLE LWS_EXTERN int
2545 lws_service_adjust_timeout(struct lws_context *context, int timeout_ms, int tsi);
2546 
2547 /* Backwards compatibility */
2548 #define lws_plat_service_tsi lws_service_tsi
2549 
2551 
2557 
2564 
2576 LWS_VISIBLE LWS_EXTERN const char *
2577 lws_get_mimetype(const char *file, const struct lws_http_mount *m);
2578 
2597 LWS_VISIBLE LWS_EXTERN int
2598 lws_serve_http_file(struct lws *wsi, const char *file, const char *content_type,
2599  const char *other_headers, int other_headers_len);
2600 
2601 LWS_VISIBLE LWS_EXTERN int
2602 lws_serve_http_file_fragment(struct lws *wsi);
2604 
2615 
2616 enum http_status {
2617  HTTP_STATUS_OK = 200,
2618  HTTP_STATUS_NO_CONTENT = 204,
2619  HTTP_STATUS_PARTIAL_CONTENT = 206,
2620 
2621  HTTP_STATUS_MOVED_PERMANENTLY = 301,
2622  HTTP_STATUS_FOUND = 302,
2623  HTTP_STATUS_SEE_OTHER = 303,
2624  HTTP_STATUS_NOT_MODIFIED = 304,
2625 
2626  HTTP_STATUS_BAD_REQUEST = 400,
2627  HTTP_STATUS_UNAUTHORIZED,
2628  HTTP_STATUS_PAYMENT_REQUIRED,
2629  HTTP_STATUS_FORBIDDEN,
2630  HTTP_STATUS_NOT_FOUND,
2631  HTTP_STATUS_METHOD_NOT_ALLOWED,
2632  HTTP_STATUS_NOT_ACCEPTABLE,
2633  HTTP_STATUS_PROXY_AUTH_REQUIRED,
2634  HTTP_STATUS_REQUEST_TIMEOUT,
2635  HTTP_STATUS_CONFLICT,
2636  HTTP_STATUS_GONE,
2637  HTTP_STATUS_LENGTH_REQUIRED,
2638  HTTP_STATUS_PRECONDITION_FAILED,
2639  HTTP_STATUS_REQ_ENTITY_TOO_LARGE,
2640  HTTP_STATUS_REQ_URI_TOO_LONG,
2641  HTTP_STATUS_UNSUPPORTED_MEDIA_TYPE,
2642  HTTP_STATUS_REQ_RANGE_NOT_SATISFIABLE,
2643  HTTP_STATUS_EXPECTATION_FAILED,
2644 
2645  HTTP_STATUS_INTERNAL_SERVER_ERROR = 500,
2646  HTTP_STATUS_NOT_IMPLEMENTED,
2647  HTTP_STATUS_BAD_GATEWAY,
2648  HTTP_STATUS_SERVICE_UNAVAILABLE,
2649  HTTP_STATUS_GATEWAY_TIMEOUT,
2650  HTTP_STATUS_HTTP_VERSION_NOT_SUPPORTED,
2651 };
2652 
2654  char *p;
2655  int len;
2656  int max_len;
2657  int final;
2658 };
2659 
2660 typedef const char *(*lws_process_html_state_cb)(void *data, int index);
2661 
2663  char *start;
2664  char swallow[16];
2665  int pos;
2666  void *data;
2667  const char * const *vars;
2670  lws_process_html_state_cb replace;
2671 };
2672 
2677 LWS_VISIBLE LWS_EXTERN int
2679  struct lws_process_html_state *s);
2681 
2714 
2722 struct lws_tokens {
2723  char *token;
2725 };
2726 
2727 /* enum lws_token_indexes
2728  * these have to be kept in sync with lextable.h / minilex.c
2729  *
2730  * NOTE: These public enums are part of the abi. If you want to add one,
2731  * add it at where specified so existing users are unaffected.
2732  */
2733 enum lws_token_indexes {
2734  WSI_TOKEN_GET_URI = 0,
2735  WSI_TOKEN_POST_URI = 1,
2736  WSI_TOKEN_OPTIONS_URI = 2,
2737  WSI_TOKEN_HOST = 3,
2738  WSI_TOKEN_CONNECTION = 4,
2739  WSI_TOKEN_UPGRADE = 5,
2740  WSI_TOKEN_ORIGIN = 6,
2741  WSI_TOKEN_DRAFT = 7,
2742  WSI_TOKEN_CHALLENGE = 8,
2743  WSI_TOKEN_EXTENSIONS = 9,
2744  WSI_TOKEN_KEY1 = 10,
2745  WSI_TOKEN_KEY2 = 11,
2746  WSI_TOKEN_PROTOCOL = 12,
2747  WSI_TOKEN_ACCEPT = 13,
2748  WSI_TOKEN_NONCE = 14,
2749  WSI_TOKEN_HTTP = 15,
2750  WSI_TOKEN_HTTP2_SETTINGS = 16,
2751  WSI_TOKEN_HTTP_ACCEPT = 17,
2752  WSI_TOKEN_HTTP_AC_REQUEST_HEADERS = 18,
2753  WSI_TOKEN_HTTP_IF_MODIFIED_SINCE = 19,
2754  WSI_TOKEN_HTTP_IF_NONE_MATCH = 20,
2755  WSI_TOKEN_HTTP_ACCEPT_ENCODING = 21,
2756  WSI_TOKEN_HTTP_ACCEPT_LANGUAGE = 22,
2757  WSI_TOKEN_HTTP_PRAGMA = 23,
2758  WSI_TOKEN_HTTP_CACHE_CONTROL = 24,
2759  WSI_TOKEN_HTTP_AUTHORIZATION = 25,
2760  WSI_TOKEN_HTTP_COOKIE = 26,
2761  WSI_TOKEN_HTTP_CONTENT_LENGTH = 27,
2762  WSI_TOKEN_HTTP_CONTENT_TYPE = 28,
2763  WSI_TOKEN_HTTP_DATE = 29,
2764  WSI_TOKEN_HTTP_RANGE = 30,
2765  WSI_TOKEN_HTTP_REFERER = 31,
2766  WSI_TOKEN_KEY = 32,
2767  WSI_TOKEN_VERSION = 33,
2768  WSI_TOKEN_SWORIGIN = 34,
2769 
2770  WSI_TOKEN_HTTP_COLON_AUTHORITY = 35,
2771  WSI_TOKEN_HTTP_COLON_METHOD = 36,
2772  WSI_TOKEN_HTTP_COLON_PATH = 37,
2773  WSI_TOKEN_HTTP_COLON_SCHEME = 38,
2774  WSI_TOKEN_HTTP_COLON_STATUS = 39,
2775 
2776  WSI_TOKEN_HTTP_ACCEPT_CHARSET = 40,
2777  WSI_TOKEN_HTTP_ACCEPT_RANGES = 41,
2778  WSI_TOKEN_HTTP_ACCESS_CONTROL_ALLOW_ORIGIN = 42,
2779  WSI_TOKEN_HTTP_AGE = 43,
2780  WSI_TOKEN_HTTP_ALLOW = 44,
2781  WSI_TOKEN_HTTP_CONTENT_DISPOSITION = 45,
2782  WSI_TOKEN_HTTP_CONTENT_ENCODING = 46,
2783  WSI_TOKEN_HTTP_CONTENT_LANGUAGE = 47,
2784  WSI_TOKEN_HTTP_CONTENT_LOCATION = 48,
2785  WSI_TOKEN_HTTP_CONTENT_RANGE = 49,
2786  WSI_TOKEN_HTTP_ETAG = 50,
2787  WSI_TOKEN_HTTP_EXPECT = 51,
2788  WSI_TOKEN_HTTP_EXPIRES = 52,
2789  WSI_TOKEN_HTTP_FROM = 53,
2790  WSI_TOKEN_HTTP_IF_MATCH = 54,
2791  WSI_TOKEN_HTTP_IF_RANGE = 55,
2792  WSI_TOKEN_HTTP_IF_UNMODIFIED_SINCE = 56,
2793  WSI_TOKEN_HTTP_LAST_MODIFIED = 57,
2794  WSI_TOKEN_HTTP_LINK = 58,
2795  WSI_TOKEN_HTTP_LOCATION = 59,
2796  WSI_TOKEN_HTTP_MAX_FORWARDS = 60,
2797  WSI_TOKEN_HTTP_PROXY_AUTHENTICATE = 61,
2798  WSI_TOKEN_HTTP_PROXY_AUTHORIZATION = 62,
2799  WSI_TOKEN_HTTP_REFRESH = 63,
2800  WSI_TOKEN_HTTP_RETRY_AFTER = 64,
2801  WSI_TOKEN_HTTP_SERVER = 65,
2802  WSI_TOKEN_HTTP_SET_COOKIE = 66,
2803  WSI_TOKEN_HTTP_STRICT_TRANSPORT_SECURITY = 67,
2804  WSI_TOKEN_HTTP_TRANSFER_ENCODING = 68,
2805  WSI_TOKEN_HTTP_USER_AGENT = 69,
2806  WSI_TOKEN_HTTP_VARY = 70,
2807  WSI_TOKEN_HTTP_VIA = 71,
2808  WSI_TOKEN_HTTP_WWW_AUTHENTICATE = 72,
2809 
2810  WSI_TOKEN_PATCH_URI = 73,
2811  WSI_TOKEN_PUT_URI = 74,
2812  WSI_TOKEN_DELETE_URI = 75,
2813 
2814  WSI_TOKEN_HTTP_URI_ARGS = 76,
2815  WSI_TOKEN_PROXY = 77,
2816  WSI_TOKEN_HTTP_X_REAL_IP = 78,
2817  WSI_TOKEN_HTTP1_0 = 79,
2818  WSI_TOKEN_X_FORWARDED_FOR = 80,
2819  WSI_TOKEN_CONNECT = 81,
2820  /****** add new things just above ---^ ******/
2821 
2822  /* use token storage to stash these internally, not for
2823  * user use */
2824 
2825  _WSI_TOKEN_CLIENT_SENT_PROTOCOLS,
2826  _WSI_TOKEN_CLIENT_PEER_ADDRESS,
2827  _WSI_TOKEN_CLIENT_URI,
2828  _WSI_TOKEN_CLIENT_HOST,
2829  _WSI_TOKEN_CLIENT_ORIGIN,
2830  _WSI_TOKEN_CLIENT_METHOD,
2831 
2832  /* always last real token index*/
2833  WSI_TOKEN_COUNT,
2834 
2835  /* parser state additions, no storage associated */
2836  WSI_TOKEN_NAME_PART,
2837  WSI_TOKEN_SKIPPING,
2838  WSI_TOKEN_SKIPPING_SAW_CR,
2839  WSI_PARSING_COMPLETE,
2840  WSI_INIT_TOKEN_MUXURL,
2841 };
2842 
2844  unsigned short token_limit[WSI_TOKEN_COUNT];
2845 };
2846 
2852 LWS_VISIBLE LWS_EXTERN const unsigned char *
2853 lws_token_to_string(enum lws_token_indexes token);
2854 
2855 
2864 LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
2865 lws_hdr_total_length(struct lws *wsi, enum lws_token_indexes h);
2866 
2876 LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
2877 lws_hdr_fragment_length(struct lws *wsi, enum lws_token_indexes h, int frag_idx);
2878 
2892 LWS_VISIBLE LWS_EXTERN int
2893 lws_hdr_copy(struct lws *wsi, char *dest, int len, enum lws_token_indexes h);
2894 
2912 LWS_VISIBLE LWS_EXTERN int
2913 lws_hdr_copy_fragment(struct lws *wsi, char *dest, int len,
2914  enum lws_token_indexes h, int frag_idx);
2915 
2926 LWS_VISIBLE LWS_EXTERN const char *
2927 lws_get_urlarg_by_name(struct lws *wsi, const char *name, char *buf, int len);
2929 
2944 
2946 #define LWSAHH_CODE_MASK ((1 << 16) - 1)
2947 #define LWSAHH_FLAG_NO_SERVER_NAME (1 << 30)
2948 
2963 LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
2964 lws_add_http_header_status(struct lws *wsi,
2965  unsigned int code, unsigned char **p,
2966  unsigned char *end);
2979 LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
2980 lws_add_http_header_by_name(struct lws *wsi, const unsigned char *name,
2981  const unsigned char *value, int length,
2982  unsigned char **p, unsigned char *end);
2996 LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
2997 lws_add_http_header_by_token(struct lws *wsi, enum lws_token_indexes token,
2998  const unsigned char *value, int length,
2999  unsigned char **p, unsigned char *end);
3010 LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
3011 lws_add_http_header_content_length(struct lws *wsi,
3012  unsigned long content_length,
3013  unsigned char **p, unsigned char *end);
3023 LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
3024 lws_finalize_http_header(struct lws *wsi, unsigned char **p,
3025  unsigned char *end);
3027 
3046 
3056 };
3057 
3071 typedef int (*lws_spa_fileupload_cb)(void *data, const char *name,
3072  const char *filename, char *buf, int len,
3073  enum lws_spa_fileupload_states state);
3074 
3077 struct lws_spa;
3078 
3097 LWS_VISIBLE LWS_EXTERN struct lws_spa *
3098 lws_spa_create(struct lws *wsi, const char * const *param_names,
3099  int count_params, int max_storage, lws_spa_fileupload_cb opt_cb,
3100  void *opt_data);
3101 
3109 LWS_VISIBLE LWS_EXTERN int
3110 lws_spa_process(struct lws_spa *spa, const char *in, int len);
3111 
3117 LWS_VISIBLE LWS_EXTERN int
3118 lws_spa_finalize(struct lws_spa *spa);
3119 
3126 LWS_VISIBLE LWS_EXTERN int
3127 lws_spa_get_length(struct lws_spa *spa, int n);
3128 
3134 LWS_VISIBLE LWS_EXTERN const char *
3135 lws_spa_get_string(struct lws_spa *spa, int n);
3136 
3142 LWS_VISIBLE LWS_EXTERN int
3143 lws_spa_destroy(struct lws_spa *spa);
3145 
3156 
3167 LWS_VISIBLE LWS_EXTERN const char *
3168 lws_urlencode(char *escaped, const char *string, int len);
3169 
3170 /*
3171  * URLDECODE 1 / 2
3172  *
3173  * This simple urldecode only operates until the first '\0' and requires the
3174  * data to exist all at once
3175  */
3188 LWS_VISIBLE LWS_EXTERN int
3189 lws_urldecode(char *string, const char *escaped, int len);
3191 
3200 LWS_VISIBLE LWS_EXTERN int
3201 lws_return_http_status(struct lws *wsi, unsigned int code,
3202  const char *html_body);
3203 
3214 LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
3215 lws_http_redirect(struct lws *wsi, int code, const unsigned char *loc, int len,
3216  unsigned char **p, unsigned char *end);
3217 
3226 LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
3227 lws_http_transaction_completed(struct lws *wsi);
3229 
3237 
3248 LWS_VISIBLE LWS_EXTERN const char *
3249 lws_sql_purify(char *escaped, const char *string, int len);
3250 
3261 LWS_VISIBLE LWS_EXTERN const char *
3262 lws_json_purify(char *escaped, const char *string, int len);
3264 
3271 
3273 #ifdef LWS_USE_LIBEV
3274 typedef void (lws_ev_signal_cb_t)(EV_P_ struct ev_signal *w, int revents);
3275 
3276 LWS_VISIBLE LWS_EXTERN int
3277 lws_ev_sigint_cfg(struct lws_context *context, int use_ev_sigint,
3278  lws_ev_signal_cb_t *cb);
3279 
3280 LWS_VISIBLE LWS_EXTERN int
3281 lws_ev_initloop(struct lws_context *context, struct ev_loop *loop, int tsi);
3282 
3283 LWS_VISIBLE LWS_EXTERN void
3284 lws_ev_sigint_cb(struct ev_loop *loop, struct ev_signal *watcher, int revents);
3285 #endif /* LWS_USE_LIBEV */
3286 
3288 
3295 #ifdef LWS_USE_LIBUV
3297 LWS_VISIBLE LWS_EXTERN int
3298 lws_uv_sigint_cfg(struct lws_context *context, int use_uv_sigint,
3299  uv_signal_cb cb);
3300 
3301 LWS_VISIBLE LWS_EXTERN void
3302 lws_libuv_run(const struct lws_context *context, int tsi);
3303 
3304 LWS_VISIBLE LWS_EXTERN void
3305 lws_libuv_stop(struct lws_context *context);
3306 
3307 LWS_VISIBLE LWS_EXTERN void
3308 lws_libuv_stop_without_kill(const struct lws_context *context, int tsi);
3309 
3310 LWS_VISIBLE LWS_EXTERN int
3311 lws_uv_initloop(struct lws_context *context, uv_loop_t *loop, int tsi);
3312 
3313 LWS_VISIBLE LWS_EXTERN uv_loop_t *
3314 lws_uv_getloop(struct lws_context *context, int tsi);
3315 
3316 LWS_VISIBLE LWS_EXTERN void
3317 lws_uv_sigint_cb(uv_signal_t *watcher, int signum);
3318 #endif /* LWS_USE_LIBUV */
3319 
3326 
3327 /*
3328  * NOTE: These public enums are part of the abi. If you want to add one,
3329  * add it at where specified so existing users are unaffected.
3330  */
3331 enum pending_timeout {
3332  NO_PENDING_TIMEOUT = 0,
3333  PENDING_TIMEOUT_AWAITING_PROXY_RESPONSE = 1,
3334  PENDING_TIMEOUT_AWAITING_CONNECT_RESPONSE = 2,
3335  PENDING_TIMEOUT_ESTABLISH_WITH_SERVER = 3,
3336  PENDING_TIMEOUT_AWAITING_SERVER_RESPONSE = 4,
3337  PENDING_TIMEOUT_AWAITING_PING = 5,
3338  PENDING_TIMEOUT_CLOSE_ACK = 6,
3339  PENDING_TIMEOUT_AWAITING_EXTENSION_CONNECT_RESPONSE = 7,
3340  PENDING_TIMEOUT_SENT_CLIENT_HANDSHAKE = 8,
3341  PENDING_TIMEOUT_SSL_ACCEPT = 9,
3342  PENDING_TIMEOUT_HTTP_CONTENT = 10,
3343  PENDING_TIMEOUT_AWAITING_CLIENT_HS_SEND = 11,
3344  PENDING_FLUSH_STORED_SEND_BEFORE_CLOSE = 12,
3345  PENDING_TIMEOUT_SHUTDOWN_FLUSH = 13,
3346  PENDING_TIMEOUT_CGI = 14,
3347  PENDING_TIMEOUT_HTTP_KEEPALIVE_IDLE = 15,
3348  PENDING_TIMEOUT_WS_PONG_CHECK_SEND_PING = 16,
3349  PENDING_TIMEOUT_WS_PONG_CHECK_GET_PONG = 17,
3350  PENDING_TIMEOUT_CLIENT_ISSUE_PAYLOAD = 18,
3351 
3352  /****** add new things just above ---^ ******/
3353 };
3354 
3364 LWS_VISIBLE LWS_EXTERN void
3365 lws_set_timeout(struct lws *wsi, enum pending_timeout reason, int secs);
3367 
3373 #if !defined(LWS_SIZEOFPTR)
3374 #define LWS_SIZEOFPTR (sizeof (void *))
3375 #endif
3376 #if !defined(u_int64_t)
3377 #define u_int64_t unsigned long long
3378 #endif
3379 
3380 #if defined(__x86_64__)
3381 #define _LWS_PAD_SIZE 16 /* Intel recommended for best performance */
3382 #else
3383 #define _LWS_PAD_SIZE LWS_SIZEOFPTR /* Size of a pointer on the target arch */
3384 #endif
3385 #define _LWS_PAD(n) (((n) % _LWS_PAD_SIZE) ? \
3386  ((n) + (_LWS_PAD_SIZE - ((n) % _LWS_PAD_SIZE))) : (n))
3387 #define LWS_PRE _LWS_PAD(4 + 10)
3388 /* used prior to 1.7 and retained for backward compatibility */
3389 #define LWS_SEND_BUFFER_PRE_PADDING LWS_PRE
3390 #define LWS_SEND_BUFFER_POST_PADDING 0
3391 
3392 /*
3393  * NOTE: These public enums are part of the abi. If you want to add one,
3394  * add it at where specified so existing users are unaffected.
3395  */
3410  /* LWS_WRITE_CLOSE is handled by lws_close_reason() */
3411  LWS_WRITE_PING = 5,
3412  LWS_WRITE_PONG = 6,
3413 
3414  /* Same as write_http but we know this write ends the transaction */
3415  LWS_WRITE_HTTP_FINAL = 7,
3416 
3417  /* HTTP2 */
3418 
3426  /****** add new things just above ---^ ******/
3427 
3428  /* flags */
3429 
3437 };
3438 
3439 
3526 LWS_VISIBLE LWS_EXTERN int
3527 lws_write(struct lws *wsi, unsigned char *buf, size_t len,
3528  enum lws_write_protocol protocol);
3529 
3530 /* helper for case where buffer may be const */
3531 #define lws_write_http(wsi, buf, len) \
3532  lws_write(wsi, (unsigned char *)(buf), len, LWS_WRITE_HTTP)
3533 
3553 
3566 LWS_VISIBLE LWS_EXTERN int
3567 lws_callback_on_writable(struct lws *wsi);
3568 
3582 LWS_VISIBLE LWS_EXTERN int
3583 lws_callback_on_writable_all_protocol(const struct lws_context *context,
3584  const struct lws_protocols *protocol);
3585 
3599 LWS_VISIBLE LWS_EXTERN int
3600 lws_callback_on_writable_all_protocol_vhost(const struct lws_vhost *vhost,
3601  const struct lws_protocols *protocol);
3602 
3619 LWS_VISIBLE LWS_EXTERN int
3620 lws_callback_all_protocol(struct lws_context *context,
3621  const struct lws_protocols *protocol, int reason);
3622 
3635 LWS_VISIBLE LWS_EXTERN int
3636 lws_callback_all_protocol_vhost(struct lws_vhost *vh,
3637  const struct lws_protocols *protocol, int reason);
3638 
3652 LWS_VISIBLE LWS_EXTERN int
3653 lws_callback_vhost_protocols(struct lws *wsi, int reason, void *in, int len);
3654 
3655 LWS_VISIBLE LWS_EXTERN int
3656 lws_callback_http_dummy(struct lws *wsi, enum lws_callback_reasons reason,
3657  void *user, void *in, size_t len);
3658 
3666 LWS_VISIBLE LWS_EXTERN int
3667 lws_get_socket_fd(struct lws *wsi);
3668 
3690 LWS_VISIBLE LWS_EXTERN size_t
3691 lws_get_peer_write_allowance(struct lws *wsi);
3693 
3704 LWS_VISIBLE LWS_EXTERN int
3705 lws_rx_flow_control(struct lws *wsi, int enable);
3706 
3716 LWS_VISIBLE LWS_EXTERN void
3717 lws_rx_flow_allow_all_protocol(const struct lws_context *context,
3718  const struct lws_protocols *protocol);
3719 
3736 LWS_VISIBLE LWS_EXTERN size_t
3737 lws_remaining_packet_payload(struct lws *wsi);
3738 
3739 
3748 
3762 LWS_VISIBLE LWS_EXTERN struct lws *
3763 lws_adopt_socket(struct lws_context *context, lws_sockfd_type accept_fd);
3776 LWS_VISIBLE LWS_EXTERN struct lws *
3777 lws_adopt_socket_vhost(struct lws_vhost *vh, lws_sockfd_type accept_fd);
3778 
3779 typedef enum {
3780  LWS_ADOPT_RAW_FILE_DESC = 0, /* convenience constant */
3781  LWS_ADOPT_HTTP = 1, /* flag: absent implies RAW */
3782  LWS_ADOPT_SOCKET = 2, /* flag: absent implies file descr */
3783  LWS_ADOPT_ALLOW_SSL = 4 /* flag: if set requires LWS_ADOPT_SOCKET */
3784 } lws_adoption_type;
3785 
3786 typedef union {
3787  lws_sockfd_type sockfd;
3788  lws_filefd_type filefd;
3790 
3791 /*
3792 * lws_adopt_descriptor_vhost() - adopt foreign socket or file descriptor
3793 * if socket descriptor, should already have been accepted from listen socket
3794 *
3795 * \param vhost: lws vhost
3796 * \param type: OR-ed combinations of lws_adoption_type flags
3797 * \param fd: union with either .sockfd or .filefd set
3798 * \param vh_prot_name: NULL or vh protocol name to bind raw connection to
3799 * \param parent: NULL or struct lws to attach new_wsi to as a child
3800 *
3801 * Either returns new wsi bound to accept_fd, or closes accept_fd and
3802 * returns NULL, having cleaned up any new wsi pieces.
3803 *
3804 * If LWS_ADOPT_SOCKET is set, LWS adopts the socket in http serving mode, it's
3805 * ready to accept an upgrade to ws or just serve http.
3806 *
3807 * parent may be NULL, if given it should be an existing wsi that will become the
3808 * parent of the new wsi created by this call.
3809 */
3810 LWS_VISIBLE struct lws *
3811 lws_adopt_descriptor_vhost(struct lws_vhost *vh, lws_adoption_type type,
3812  lws_sock_file_fd_type fd, const char *vh_prot_name,
3813  struct lws *parent);
3814 
3838 LWS_VISIBLE LWS_EXTERN struct lws *
3839 lws_adopt_socket_readbuf(struct lws_context *context, lws_sockfd_type accept_fd,
3840  const char *readbuf, size_t len);
3864 LWS_VISIBLE LWS_EXTERN struct lws *
3865 lws_adopt_socket_vhost_readbuf(struct lws_vhost *vhost, lws_sockfd_type accept_fd,
3866  const char *readbuf, size_t len);
3868 
3874 
3885 LWS_VISIBLE LWS_EXTERN const char * LWS_WARN_UNUSED_RESULT
3886 lws_canonical_hostname(struct lws_context *context);
3887 
3902 LWS_VISIBLE LWS_EXTERN void
3903 lws_get_peer_addresses(struct lws *wsi, lws_sockfd_type fd, char *name,
3904  int name_len, char *rip, int rip_len);
3905 
3916 LWS_VISIBLE LWS_EXTERN const char *
3917 lws_get_peer_simple(struct lws *wsi, char *name, int namelen);
3918 #if !defined(LWS_WITH_ESP8266) && !defined(LWS_WITH_ESP32)
3919 
3930 LWS_VISIBLE LWS_EXTERN int
3931 lws_interface_to_sa(int ipv6, const char *ifname, struct sockaddr_in *addr,
3932  size_t addrlen);
3934 #endif
3935 
3941 
3954 LWS_VISIBLE LWS_EXTERN int
3955 lws_snprintf(char *str, size_t size, const char *format, ...) LWS_FORMAT(3);
3956 
3968 LWS_VISIBLE LWS_EXTERN int
3969 lws_get_random(struct lws_context *context, void *buf, int len);
3977 LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
3978 lws_daemonize(const char *_lock_path);
3984 LWS_VISIBLE LWS_EXTERN const char * LWS_WARN_UNUSED_RESULT
3986 
3993 LWS_VISIBLE LWS_EXTERN void *
3994 lws_wsi_user(struct lws *wsi);
3995 
4006 LWS_VISIBLE LWS_EXTERN void
4007 lws_set_wsi_user(struct lws *wsi, void *user);
4008 
4020 LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
4021 lws_parse_uri(char *p, const char **prot, const char **ads, int *port,
4022  const char **path);
4023 
4027 LWS_VISIBLE LWS_EXTERN unsigned long
4028 lws_now_secs(void);
4029 
4039 LWS_VISIBLE LWS_EXTERN struct lws_context * LWS_WARN_UNUSED_RESULT
4040 lws_get_context(const struct lws *wsi);
4041 
4051 LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
4052 lws_get_count_threads(struct lws_context *context);
4053 
4061 LWS_VISIBLE LWS_EXTERN struct lws * LWS_WARN_UNUSED_RESULT
4062 lws_get_parent(const struct lws *wsi);
4063 
4070 LWS_VISIBLE LWS_EXTERN struct lws * LWS_WARN_UNUSED_RESULT
4071 lws_get_child(const struct lws *wsi);
4072 
4073 
4074 /*
4075  * \deprecated DEPRECATED Note: this is not normally needed as a user api.
4076  * It's provided in case it is
4077  * useful when integrating with other app poll loop service code.
4078  */
4079 LWS_VISIBLE LWS_EXTERN int
4080 lws_read(struct lws *wsi, unsigned char *buf, size_t len);
4081 
4089 LWS_VISIBLE LWS_EXTERN void
4090 lws_set_allocator(void *(*realloc)(void *ptr, size_t size));
4092 
4098 
4105 LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
4106 lws_send_pipe_choked(struct lws *wsi);
4107 
4112 LWS_VISIBLE LWS_EXTERN int
4113 lws_is_final_fragment(struct lws *wsi);
4114 
4119 LWS_VISIBLE LWS_EXTERN unsigned char
4120 lws_get_reserved_bits(struct lws *wsi);
4121 
4138 LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
4139 lws_partial_buffered(struct lws *wsi);
4140 
4150 LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
4151 lws_frame_is_binary(struct lws *wsi);
4152 
4161 LWS_VISIBLE LWS_EXTERN int
4162 lws_is_ssl(struct lws *wsi);
4167 LWS_VISIBLE LWS_EXTERN int
4168 lws_is_cgi(struct lws *wsi);
4169 
4170 #ifdef LWS_OPENSSL_SUPPORT
4171 
4177 LWS_VISIBLE LWS_EXTERN SSL*
4178 lws_get_ssl(struct lws *wsi);
4179 #endif
4180 
4182 
4188 #ifdef LWS_SHA1_USE_OPENSSL_NAME
4190 #define lws_SHA1 SHA1
4191 #else
4192 
4201 LWS_VISIBLE LWS_EXTERN unsigned char *
4202 lws_SHA1(const unsigned char *d, size_t n, unsigned char *md);
4203 #endif
4204 
4214 LWS_VISIBLE LWS_EXTERN int
4215 lws_b64_encode_string(const char *in, int in_len, char *out, int out_size);
4225 LWS_VISIBLE LWS_EXTERN int
4226 lws_b64_decode_string(const char *in, char *out, int out_size);
4228 
4229 
4239 #ifdef LWS_WITH_CGI
4240 enum lws_enum_stdinouterr {
4241  LWS_STDIN = 0,
4242  LWS_STDOUT = 1,
4243  LWS_STDERR = 2,
4244 };
4245 
4246 enum lws_cgi_hdr_state {
4247  LCHS_HEADER,
4248  LCHS_CR1,
4249  LCHS_LF1,
4250  LCHS_CR2,
4251  LCHS_LF2,
4252  LHCS_PAYLOAD,
4253  LCHS_SINGLE_0A,
4254 };
4255 
4257  struct lws **stdwsi;
4258  enum lws_enum_stdinouterr ch;
4259  unsigned char *data;
4260  enum lws_cgi_hdr_state hdr_state;
4261  int len;
4262 };
4263 
4264 
4274 LWS_VISIBLE LWS_EXTERN int
4275 lws_cgi(struct lws *wsi, const char * const *exec_array,
4276  int script_uri_path_len, int timeout_secs,
4277  const struct lws_protocol_vhost_options *mp_cgienv);
4278 
4284 LWS_VISIBLE LWS_EXTERN int
4285 lws_cgi_write_split_stdout_headers(struct lws *wsi);
4286 
4292 LWS_VISIBLE LWS_EXTERN int
4293 lws_cgi_kill(struct lws *wsi);
4294 #endif
4295 
4297 
4314 
4321 #if defined(LWS_WITH_ESP32)
4322 /* sdk preprocessor defs? compiler issue? gets confused with member names */
4323 #define LWS_FOP_OPEN _open
4324 #define LWS_FOP_CLOSE _close
4325 #define LWS_FOP_SEEK_CUR _seek_cur
4326 #define LWS_FOP_READ _read
4327 #define LWS_FOP_WRITE _write
4328 #else
4329 #define LWS_FOP_OPEN open
4330 #define LWS_FOP_CLOSE close
4331 #define LWS_FOP_SEEK_CUR seek_cur
4332 #define LWS_FOP_READ read
4333 #define LWS_FOP_WRITE write
4334 #endif
4335 
4336 #define LWS_FOP_FLAGS_MASK ((1 << 23) - 1)
4337 #define LWS_FOP_FLAG_COMPR_ACCEPTABLE_GZIP (1 << 24)
4338 #define LWS_FOP_FLAG_COMPR_IS_GZIP (1 << 25)
4339 #define LWS_FOP_FLAG_MOD_TIME_VALID (1 << 26)
4340 #define LWS_FOP_FLAG_VIRTUAL (1 << 27)
4341 
4342 struct lws_plat_file_ops;
4343 
4344 #if (defined(WIN32) || defined(_WIN32)) && !defined(__MINGW32__)
4345 /* ... */
4346 #if !defined(ssize_t)
4347 typedef SSIZE_T ssize_t;
4348 #endif
4349 #endif
4350 
4351 #if defined(LWS_HAVE_STDINT_H)
4352 #include <stdint.h>
4353 #else
4354 #if defined(WIN32) || defined(_WIN32)
4355 /* !!! >:-[ */
4356 typedef unsigned __int32 uint32_t;
4357 typedef unsigned __int16 uint16_t;
4358 typedef unsigned __int8 uint8_t;
4359 #else
4360 typedef unsigned int uint32_t;
4361 typedef unsigned short uint16_t;
4362 typedef unsigned char uint8_t;
4363 #endif
4364 #endif
4365 
4366 typedef size_t lws_filepos_t;
4367 typedef ssize_t lws_fileofs_t;
4368 typedef uint32_t lws_fop_flags_t;
4369 
4370 struct lws_fop_fd {
4371  lws_filefd_type fd;
4373  const struct lws_plat_file_ops *fops;
4377  lws_filepos_t pos;
4379  lws_filepos_t len;
4381  lws_fop_flags_t flags;
4383  uint32_t mod_time;
4386 };
4387 typedef struct lws_fop_fd *lws_fop_fd_t;
4388 
4390  const char *sig; /* NULL or vfs signature, eg, ".zip/" */
4391  uint8_t len; /* length of above string */
4392 };
4393 
4395  lws_fop_fd_t (*LWS_FOP_OPEN)(const struct lws_plat_file_ops *fops,
4396  const char *filename, const char *vpath,
4397  lws_fop_flags_t *flags);
4407  int (*LWS_FOP_CLOSE)(lws_fop_fd_t *fop_fd);
4409  lws_fileofs_t (*LWS_FOP_SEEK_CUR)(lws_fop_fd_t fop_fd,
4410  lws_fileofs_t offset_from_cur_pos);
4412  int (*LWS_FOP_READ)(lws_fop_fd_t fop_fd, lws_filepos_t *amount,
4413  uint8_t *buf, lws_filepos_t len);
4415  int (*LWS_FOP_WRITE)(lws_fop_fd_t fop_fd, lws_filepos_t *amount,
4416  uint8_t *buf, lws_filepos_t len);
4419  struct lws_fops_index fi[3];
4422  const struct lws_plat_file_ops *next;
4425  /* Add new things just above here ---^
4426  * This is part of the ABI, don't needlessly break compatibility */
4427 };
4428 
4434 LWS_VISIBLE LWS_EXTERN struct lws_plat_file_ops * LWS_WARN_UNUSED_RESULT
4435 lws_get_fops(struct lws_context *context);
4436 LWS_VISIBLE LWS_EXTERN void
4437 lws_set_fops(struct lws_context *context, const struct lws_plat_file_ops *fops);
4443 LWS_VISIBLE LWS_EXTERN lws_filepos_t LWS_WARN_UNUSED_RESULT
4444 lws_vfs_tell(lws_fop_fd_t fop_fd);
4450 LWS_VISIBLE LWS_EXTERN lws_filepos_t LWS_WARN_UNUSED_RESULT
4451 lws_vfs_get_length(lws_fop_fd_t fop_fd);
4457 LWS_VISIBLE LWS_EXTERN uint32_t LWS_WARN_UNUSED_RESULT
4458 lws_vfs_get_mod_time(lws_fop_fd_t fop_fd);
4465 LWS_VISIBLE LWS_EXTERN lws_fileofs_t
4466 lws_vfs_file_seek_set(lws_fop_fd_t fop_fd, lws_fileofs_t offset);
4473 LWS_VISIBLE LWS_EXTERN lws_fileofs_t
4474 lws_vfs_file_seek_end(lws_fop_fd_t fop_fd, lws_fileofs_t offset);
4475 
4476 extern struct lws_plat_file_ops fops_zip;
4477 
4492 LWS_VISIBLE LWS_EXTERN lws_fop_fd_t LWS_WARN_UNUSED_RESULT
4493 lws_vfs_file_open(const struct lws_plat_file_ops *fops, const char *vfs_path,
4494  lws_fop_flags_t *flags);
4495 
4501 static LWS_INLINE int
4502 lws_vfs_file_close(lws_fop_fd_t *fop_fd)
4503 {
4504  return (*fop_fd)->fops->LWS_FOP_CLOSE(fop_fd);
4505 }
4506 
4514 static LWS_INLINE lws_fileofs_t
4515 lws_vfs_file_seek_cur(lws_fop_fd_t fop_fd, lws_fileofs_t offset)
4516 {
4517  return fop_fd->fops->LWS_FOP_SEEK_CUR(fop_fd, offset);
4518 }
4527 static LWS_INLINE int LWS_WARN_UNUSED_RESULT
4528 lws_vfs_file_read(lws_fop_fd_t fop_fd, lws_filepos_t *amount,
4529  uint8_t *buf, lws_filepos_t len)
4530 {
4531  return fop_fd->fops->LWS_FOP_READ(fop_fd, amount, buf, len);
4532 }
4541 static LWS_INLINE int LWS_WARN_UNUSED_RESULT
4542 lws_vfs_file_write(lws_fop_fd_t fop_fd, lws_filepos_t *amount,
4543  uint8_t *buf, lws_filepos_t len)
4544 {
4545  return fop_fd->fops->LWS_FOP_WRITE(fop_fd, amount, buf, len);
4546 }
4547 
4548 /* these are the platform file operations implementations... they can
4549  * be called directly and used in fops arrays
4550  */
4551 
4552 LWS_VISIBLE LWS_EXTERN lws_fop_fd_t
4553 _lws_plat_file_open(const struct lws_plat_file_ops *fops, const char *filename,
4554  const char *vpath, lws_fop_flags_t *flags);
4555 LWS_VISIBLE LWS_EXTERN int
4556 _lws_plat_file_close(lws_fop_fd_t *fop_fd);
4557 LWS_VISIBLE LWS_EXTERN lws_fileofs_t
4558 _lws_plat_file_seek_cur(lws_fop_fd_t fop_fd, lws_fileofs_t offset);
4559 LWS_VISIBLE LWS_EXTERN int
4560 _lws_plat_file_read(lws_fop_fd_t fop_fd, lws_filepos_t *amount,
4561  uint8_t *buf, lws_filepos_t len);
4562 LWS_VISIBLE LWS_EXTERN int
4563 _lws_plat_file_write(lws_fop_fd_t fop_fd, lws_filepos_t *amount,
4564  uint8_t *buf, lws_filepos_t len);
4565 
4567 
4599 #ifdef LWS_WITH_SMTP
4600 
4612 };
4613 
4615 struct lws_email {
4616  void *data;
4618  uv_loop_t *loop;
4621  char email_smtp_ip[32];
4622  char email_helo[32];
4623  char email_from[100];
4624  char email_to[100];
4626  unsigned int max_content_size;
4629  /* Fill all the callbacks before init */
4630 
4631  int (*on_next)(struct lws_email *email);
4636  int (*on_sent)(struct lws_email *email);
4641  int (*on_get_body)(struct lws_email *email, char *buf, int len);
4647  /* private things */
4648  uv_timer_t timeout_email;
4650  uv_connect_t email_connect_req;
4651  uv_tcp_t email_client;
4653  char email_buf[256];
4654  char *content;
4655 };
4656 
4666 LWS_VISIBLE LWS_EXTERN int
4667 lws_email_init(struct lws_email *email, uv_loop_t *loop, int max_content);
4668 
4677 LWS_VISIBLE LWS_EXTERN void
4678 lws_email_check(struct lws_email *email);
4686 LWS_VISIBLE LWS_EXTERN void
4687 lws_email_destroy(struct lws_email *email);
4688 
4689 #endif
4690 
4691 
4692 #ifdef __cplusplus
4693 }
4694 #endif
4695 
4696 #endif
LWS_VISIBLE LWS_EXTERN int lws_spa_destroy(struct lws_spa *spa)
LWS_VISIBLE LWS_EXTERN const char * lws_json_purify(char *escaped, const char *string, int len)
Definition: libwebsockets.h:4256
size_t rx_buffer_size
Definition: libwebsockets.h:1385
LWS_VISIBLE LWS_EXTERN struct lws_spa * lws_spa_create(struct lws *wsi, const char *const *param_names, int count_params, int max_storage, lws_spa_fileupload_cb opt_cb, void *opt_data)
LWS_VISIBLE LWS_EXTERN struct lws_vhost * lws_vhost_get(struct lws *wsi) LWS_WARN_DEPRECATED
Definition: libwebsockets.h:815
Definition: libwebsockets.h:943
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT lws_daemonize(const char *_lock_path)
Definition: libwebsockets.h:2102
Definition: libwebsockets.h:3407
Definition: libwebsockets.h:4605
LWS_VISIBLE LWS_EXTERN struct lws * lws_adopt_socket_readbuf(struct lws_context *context, lws_sockfd_type accept_fd, const char *readbuf, size_t len)
unsigned int auth_mask
Definition: libwebsockets.h:2137
Definition: libwebsockets.h:3786
Definition: libwebsockets.h:3430
void * data
Definition: libwebsockets.h:4616
const char * uri_replace_from
Definition: libwebsockets.h:2215
lws_callback_reasons
Definition: libwebsockets.h:708
LWS_VISIBLE LWS_EXTERN int lws_hdr_copy_fragment(struct lws *wsi, char *dest, int len, enum lws_token_indexes h, int frag_idx)
lwsgs_auth_bits
Definition: libwebsockets.h:1533
LWS_VISIBLE LWS_EXTERN void lws_close_reason(struct lws *wsi, enum lws_close_status status, unsigned char *buf, size_t len)
LWS_VISIBLE LWS_EXTERN void lws_email_destroy(struct lws_email *email)
LWS_VISIBLE LWS_EXTERN int lws_urldecode(char *string, const char *escaped, int len)
Definition: libwebsockets.h:941
Definition: libwebsockets.h:1189
unsigned int id
Definition: libwebsockets.h:1394
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT lws_hdr_total_length(struct lws *wsi, enum lws_token_indexes h)
Definition: libwebsockets.h:1187
Definition: libwebsockets.h:846
LWS_VISIBLE LWS_EXTERN int lws_service_fd_tsi(struct lws_context *context, struct lws_pollfd *pollfd, int tsi)
LWS_VISIBLE LWS_EXTERN int lws_service_adjust_timeout(struct lws_context *context, int timeout_ms, int tsi)
LWS_VISIBLE LWS_EXTERN lws_fop_fd_t LWS_WARN_UNUSED_RESULT lws_vfs_file_open(const struct lws_plat_file_ops *fops, const char *vfs_path, lws_fop_flags_t *flags)
LWS_VISIBLE LWS_EXTERN struct lws *LWS_WARN_UNUSED_RESULT lws_get_parent(const struct lws *wsi)
LWS_VISIBLE LWS_EXTERN size_t lws_get_peer_write_allowance(struct lws *wsi)
LWS_VISIBLE LWS_EXTERN struct lws * lws_adopt_socket_vhost(struct lws_vhost *vh, lws_sockfd_type accept_fd)
Definition: libwebsockets.h:792
LWS_VISIBLE LWS_EXTERN const char *LWS_WARN_UNUSED_RESULT lws_get_library_version(void)
int(* on_sent)(struct lws_email *email)
Definition: libwebsockets.h:4636
Definition: libwebsockets.h:1528
struct lws ** pwsi
Definition: libwebsockets.h:2222
Definition: libwebsockets.h:826
const char * path
Definition: libwebsockets.h:2194
LWS_VISIBLE LWS_EXTERN size_t lws_remaining_packet_payload(struct lws *wsi)
Definition: libwebsockets.h:627
Definition: libwebsockets.h:1484
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT lws_ext_parse_options(const struct lws_extension *ext, struct lws *wsi, void *ext_user, const struct lws_ext_options *opts, const char *o, int len)
const char * client_ssl_private_key_password
Definition: libwebsockets.h:1834
time_t email_connect_started
Definition: libwebsockets.h:4652
lws_close_status
Definition: libwebsockets.h:598
unsigned int cache_intermediaries
Definition: libwebsockets.h:2142
LWS_VISIBLE LWS_EXTERN int lws_callback_all_protocol(struct lws_context *context, const struct lws_protocols *protocol, int reason)
Definition: libwebsockets.h:638
int token_len
Definition: libwebsockets.h:2724
const struct lws_http_mount * mounts
Definition: libwebsockets.h:1780
Definition: libwebsockets.h:967
LWS_VISIBLE LWS_EXTERN struct lws_context *LWS_WARN_UNUSED_RESULT lws_get_context(const struct lws *wsi)
const char * value
Definition: libwebsockets.h:2091
Definition: libwebsockets.h:3052
Definition: libwebsockets.h:4610
const char * username
Definition: libwebsockets.h:1559
LWS_VISIBLE LWS_EXTERN struct lws * lws_client_connect_via_info(struct lws_client_connect_info *ccinfo)
const char * protocol
Definition: libwebsockets.h:2121
const struct lws_plat_file_ops * fops
Definition: libwebsockets.h:4373
Definition: libwebsockets.h:4389
struct lws ** stdwsi
Definition: libwebsockets.h:4257
LWS_VISIBLE LWS_EXTERN int lws_json_dump_vhost(const struct lws_vhost *vh, char *buf, int len)
Definition: libwebsockets.h:913
LWS_VISIBLE LWS_EXTERN const char * lws_get_mimetype(const char *file, const struct lws_http_mount *m)
Definition: libwebsockets.h:1530
int cache_max_age
Definition: libwebsockets.h:2135
long ssl_options_clear
Definition: libwebsockets.h:1798
Definition: libwebsockets.h:806
Definition: libwebsockets.h:1666
const char * client_ssl_private_key_filepath
Definition: libwebsockets.h:1840
LWS_VISIBLE LWS_EXTERN void lws_context_destroy(struct lws_context *context)
Definition: libwebsockets.h:654
char * start
Definition: libwebsockets.h:2663
LWS_VISIBLE LWS_EXTERN int lws_snprintf(char *str, size_t size, const char *format,...) LWS_FORMAT(3)
LWS_VISIBLE LWS_EXTERN void lws_set_allocator(void *(*realloc)(void *ptr, size_t size))
lws_callback_function * callback
Definition: libwebsockets.h:1376
Definition: libwebsockets.h:3397
LWS_VISIBLE LWS_EXTERN void lws_context_deprecate(struct lws_context *context, lws_reload_func cb)
int(* LWS_FOP_CLOSE)(lws_fop_fd_t *fop_fd)
Definition: libwebsockets.h:4407
LWS_VISIBLE LWS_EXTERN int lws_get_socket_fd(struct lws *wsi)
Definition: libwebsockets.h:1004
const char * protocol
Definition: libwebsockets.h:2200
Definition: libwebsockets.h:993
LWS_VISIBLE LWS_EXTERN lws_filepos_t LWS_WARN_UNUSED_RESULT lws_vfs_tell(lws_fop_fd_t fop_fd)
unsigned int pt_serv_buf_size
Definition: libwebsockets.h:1785
LWS_VISIBLE LWS_EXTERN struct lws * lws_adopt_socket(struct lws_context *context, lws_sockfd_type accept_fd)
int len
Definition: libwebsockets.h:2655
int ka_time
Definition: libwebsockets.h:1721
Definition: libwebsockets.h:1604
LWS_VISIBLE LWS_EXTERN int lws_callback_on_writable_all_protocol(const struct lws_context *context, const struct lws_protocols *protocol)
LWS_VISIBLE LWS_EXTERN void lws_set_log_level(int level, void(*log_emit_function)(int level, const char *line))
unsigned short ws_ping_pong_interval
Definition: libwebsockets.h:1800
int count_extensions
Definition: libwebsockets.h:1489
Definition: libwebsockets.h:3401
int port
Definition: libwebsockets.h:2190
struct lws_context * context
Definition: libwebsockets.h:2186
Definition: libwebsockets.h:1536
const char * client_ssl_cert_filepath
Definition: libwebsockets.h:1836
int ietf_version_or_minus_one
Definition: libwebsockets.h:2202
LWS_VISIBLE LWS_EXTERN int lws_callback_all_protocol_vhost(struct lws_vhost *vh, const struct lws_protocols *protocol, int reason)
Definition: libwebsockets.h:4603
Definition: libwebsockets.h:2087
LWS_VISIBLE LWS_EXTERN int lws_callback_on_writable(struct lws *wsi)
const char *const * vars
Definition: libwebsockets.h:2667
LWS_VISIBLE LWS_EXTERN SSL * lws_get_ssl(struct lws *wsi)
Definition: libwebsockets.h:606
Definition: libwebsockets.h:2185
LWS_VISIBLE LWS_EXTERN lws_filepos_t LWS_WARN_UNUSED_RESULT lws_vfs_get_length(lws_fop_fd_t fop_fd)
Definition: libwebsockets.h:1634
int lws_extension_callback_function(struct lws_context *context, const struct lws_extension *ext, struct lws *wsi, enum lws_extension_callback_reasons reason, void *user, void *in, size_t len)
Definition: libwebsockets.h:1276
int len
Definition: libwebsockets.h:1212
Definition: libwebsockets.h:2112
int(* LWS_FOP_WRITE)(lws_fop_fd_t fop_fd, lws_filepos_t *amount, uint8_t *buf, lws_filepos_t len)
Definition: libwebsockets.h:4415
const char * def
Definition: libwebsockets.h:2119
Definition: libwebsockets.h:767
Definition: libwebsockets.h:1616
lws_filepos_t len
Definition: libwebsockets.h:4379
lws_context_options
Definition: libwebsockets.h:1587
Definition: libwebsockets.h:945
Definition: libwebsockets.h:1553
Definition: libwebsockets.h:1622
Definition: libwebsockets.h:933
const char * option_name
Definition: libwebsockets.h:1209
Definition: libwebsockets.h:2100
lws_sockfd_type fd
Definition: libwebsockets.h:576
LWS_VISIBLE LWS_EXTERN int lws_json_dump_context(const struct lws_context *context, char *buf, int len, int hide_vhosts)
const char * ssl_private_key_password
Definition: libwebsockets.h:1689
short events
Definition: libwebsockets.h:394
Definition: libwebsockets.h:1497
const struct lws_extension * extensions
Definition: libwebsockets.h:1488
const struct lws_http_mount * mount_next
Definition: libwebsockets.h:2113
LWS_VISIBLE LWS_EXTERN void lws_set_timeout(struct lws *wsi, enum pending_timeout reason, int secs)
void * userdata
Definition: libwebsockets.h:2204
Definition: libwebsockets.h:764
Definition: libwebsockets.h:951
LWS_VISIBLE LWS_EXTERN int lws_service_tsi(struct lws_context *context, int timeout_ms, int tsi)
unsigned char * data
Definition: libwebsockets.h:4259
const struct lws_protocol_vhost_options * extra_mimetypes
Definition: libwebsockets.h:2128
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT lws_finalize_http_header(struct lws *wsi, unsigned char **p, unsigned char *end)
Definition: libwebsockets.h:757
LWS_VISIBLE LWS_EXTERN const char * lws_urlencode(char *escaped, const char *string, int len)
Definition: libwebsockets.h:838
uv_loop_t * loop
Definition: libwebsockets.h:4618
Definition: libwebsockets.h:936
Definition: libwebsockets.h:3433
unsigned int cache_reusable
Definition: libwebsockets.h:2140
int pos
Definition: libwebsockets.h:2665
struct lws_plugin * list
Definition: libwebsockets.h:1498
LWS_VISIBLE LWS_EXTERN struct lws *LWS_WARN_UNUSED_RESULT lws_client_connect_extended(struct lws_context *clients, const char *address, int port, int ssl_connection, const char *path, const char *host, const char *origin, const char *protocol, int ietf_version_or_minus_one, void *userdata) LWS_WARN_DEPRECATED
short max_http_header_data
Definition: libwebsockets.h:1741
LWS_VISIBLE LWS_EXTERN int lws_spa_process(struct lws_spa *spa, const char *in, int len)
const char * client_ssl_cipher_list
Definition: libwebsockets.h:1848
void * provided_client_ssl_ctx
Definition: libwebsockets.h:1738
LWS_VISIBLE LWS_EXTERN struct lws_vhost * lws_get_vhost(struct lws *wsi)
LWS_VISIBLE LWS_EXTERN void lwsl_emit_syslog(int level, const char *line)
const struct lws_protocols * protocols
Definition: libwebsockets.h:1486
Definition: libwebsockets.h:1188
int ka_probes
Definition: libwebsockets.h:1724
const char * origin
Definition: libwebsockets.h:2198
SHORT revents
Definition: libwebsockets.h:376
const char * method
Definition: libwebsockets.h:2208
LWS_VISIBLE LWS_EXTERN const char * lws_spa_get_string(struct lws_spa *spa, int n)
Definition: libwebsockets.h:1282
LWS_VISIBLE LWS_EXTERN int lws_callback_on_writable_all_protocol_vhost(const struct lws_vhost *vhost, const struct lws_protocols *protocol)
Definition: libwebsockets.h:973
unsigned char origin_protocol
Definition: libwebsockets.h:2144
const char * log_filepath
Definition: libwebsockets.h:1777
Definition: libwebsockets.h:813
unsigned int max_content_size
Definition: libwebsockets.h:4626
int option_index
Definition: libwebsockets.h:1210
LWS_VISIBLE LWS_EXTERN struct lws *LWS_WARN_UNUSED_RESULT lws_get_child(const struct lws *wsi)
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT lws_add_http_header_by_token(struct lws *wsi, enum lws_token_indexes token, const unsigned char *value, int length, unsigned char **p, unsigned char *end)
Definition: libwebsockets.h:809
const char * uri_replace_to
Definition: libwebsockets.h:2218
struct lws * parent_wsi
Definition: libwebsockets.h:2211
LWS_VISIBLE LWS_EXTERN int lws_b64_decode_string(const char *in, char *out, int out_size)
enum lwsgs_smtp_states estate
Definition: libwebsockets.h:4649
LWS_VISIBLE LWS_EXTERN int lws_spa_finalize(struct lws_spa *spa)
Definition: libwebsockets.h:709
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT lws_get_count_threads(struct lws_context *context)
const char *const * plugin_dirs
Definition: libwebsockets.h:1768
char name[64]
Definition: libwebsockets.h:1504
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT lws_hdr_fragment_length(struct lws *wsi, enum lws_token_indexes h, int frag_idx)
LWS_VISIBLE LWS_EXTERN int lws_cgi_kill(struct lws *wsi)
char email_buf[256]
Definition: libwebsockets.h:4653
LWS_VISIBLE LWS_EXTERN int lws_is_ssl(struct lws *wsi)
Definition: libwebsockets.h:1593
uv_lib_t lib
Definition: libwebsockets.h:1500
LWS_VISIBLE LWS_EXTERN void lws_get_peer_addresses(struct lws *wsi, lws_sockfd_type fd, char *name, int name_len, char *rip, int rip_len)
Definition: libwebsockets.h:4604
LWS_VISIBLE LWS_EXTERN int lws_is_cgi(struct lws *wsi)
lws_filefd_type fd
Definition: libwebsockets.h:4371
int ssl_connection
Definition: libwebsockets.h:2192
Definition: libwebsockets.h:1552
SSL_CTX * provided_client_ssl_ctx
Definition: libwebsockets.h:1732
LWS_VISIBLE LWS_EXTERN int lws_rx_flow_control(struct lws *wsi, int enable)
lws_fileofs_t(* LWS_FOP_SEEK_CUR)(lws_fop_fd_t fop_fd, lws_fileofs_t offset_from_cur_pos)
Definition: libwebsockets.h:4409
Definition: libwebsockets.h:2653
LWS_VISIBLE LWS_EXTERN struct lws_plat_file_ops *LWS_WARN_UNUSED_RESULT lws_get_fops(struct lws_context *context)
Definition: libwebsockets.h:575
const struct lws_protocol_vhost_options * cgienv
Definition: libwebsockets.h:2124
const char * name
Definition: libwebsockets.h:2090
unsigned char mountpoint_len
Definition: libwebsockets.h:2145
Definition: libwebsockets.h:3404
Definition: libwebsockets.h:1611
lws_sockfd_type fd
Definition: libwebsockets.h:374
Definition: libwebsockets.h:2101
LWS_VISIBLE LWS_EXTERN int lws_is_final_fragment(struct lws *wsi)
const struct lws_extension * extensions
Definition: libwebsockets.h:1683
Definition: libwebsockets.h:1595
LWS_VISIBLE LWS_EXTERN void * lws_protocol_vh_priv_zalloc(struct lws_vhost *vhost, const struct lws_protocols *prot, int size)
LWS_VISIBLE LWS_EXTERN lws_fileofs_t lws_vfs_file_seek_end(lws_fop_fd_t fop_fd, lws_fileofs_t offset)
Definition: libwebsockets.h:1600
lws_ext_options_types
Definition: libwebsockets.h:1186
const struct lws_protocols * protocols
Definition: libwebsockets.h:1679
LWS_VISIBLE LWS_EXTERN int lwsws_get_config_globals(struct lws_context_creation_info *info, const char *d, char **config_strings, int *len)
LWS_VISIBLE LWS_EXTERN void * lws_wsi_user(struct lws *wsi)
Definition: libwebsockets.h:1097
LWS_VISIBLE LWS_EXTERN unsigned long lws_now_secs(void)
LWS_VISIBLE LWS_EXTERN const char * lws_get_peer_simple(struct lws *wsi, char *name, int namelen)
const char * start
Definition: libwebsockets.h:1211
Definition: libwebsockets.h:1093
const char * ssl_cipher_list
Definition: libwebsockets.h:1703
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT lws_add_http_header_by_name(struct lws *wsi, const unsigned char *name, const unsigned char *value, int length, unsigned char **p, unsigned char *end)
Definition: libwebsockets.h:1647
const char * mountpoint
Definition: libwebsockets.h:2115
const char * http_proxy_address
Definition: libwebsockets.h:1707
const struct lws_plat_file_ops * fops
Definition: libwebsockets.h:1854
void * filesystem_priv
Definition: libwebsockets.h:4375
lws_fop_flags_t flags
Definition: libwebsockets.h:4381
const char * ssl_cert_filepath
Definition: libwebsockets.h:1691
const char * ecdh_curve
Definition: libwebsockets.h:1762
int cgi_timeout
Definition: libwebsockets.h:2133
Definition: libwebsockets.h:4370
Definition: libwebsockets.h:2103
Definition: libwebsockets.h:1537
Definition: libwebsockets.h:392
Definition: libwebsockets.h:632
LWS_VISIBLE LWS_EXTERN unsigned char lws_get_reserved_bits(struct lws *wsi)
LWS_VISIBLE LWS_EXTERN unsigned char * lws_SHA1(const unsigned char *d, size_t n, unsigned char *md)
LWS_VISIBLE LWS_EXTERN int lwsl_visible(int level)
LWS_VISIBLE LWS_EXTERN const unsigned char * lws_token_to_string(enum lws_token_indexes token)
LWS_VISIBLE LWS_EXTERN int lws_set_extension_option(struct lws *wsi, const char *ext_name, const char *opt_name, const char *opt_val)
Definition: libwebsockets.h:777
LWS_VISIBLE LWS_EXTERN int lws_cgi(struct lws *wsi, const char *const *exec_array, int script_uri_path_len, int timeout_secs, const struct lws_protocol_vhost_options *mp_cgienv)
LWS_VISIBLE LWS_EXTERN struct lws *LWS_WARN_UNUSED_RESULT lws_client_connect(struct lws_context *clients, const char *address, int port, int ssl_connection, const char *path, const char *host, const char *origin, const char *protocol, int ietf_version_or_minus_one) LWS_WARN_DEPRECATED
Definition: libwebsockets.h:811
LWS_VISIBLE LWS_EXTERN int lwsws_get_config_vhosts(struct lws_context *context, struct lws_context_creation_info *info, const char *d, char **config_strings, int *len)
Definition: libwebsockets.h:1620
LWS_VISIBLE LWS_EXTERN int lws_http_client_read(struct lws *wsi, char **buf, int *len)
LWS_VISIBLE LWS_EXTERN int lwsl_timestamp(int level, char *p, int len)
unsigned int cache_revalidate
Definition: libwebsockets.h:2141
Definition: libwebsockets.h:1095
Definition: libwebsockets.h:1049
Definition: libwebsockets.h:1632
uv_timer_t timeout_email
Definition: libwebsockets.h:4648
Definition: libwebsockets.h:1602
short max_http_header_pool
Definition: libwebsockets.h:1744
LWS_VISIBLE LWS_EXTERN int lws_chunked_html_process(struct lws_process_html_args *args, struct lws_process_html_state *s)
char * p
Definition: libwebsockets.h:2654
size_t per_session_data_size
Definition: libwebsockets.h:1380
Definition: libwebsockets.h:616
const struct lws_protocol_vhost_options * reject_service_keywords
Definition: libwebsockets.h:1816
lws_filepos_t pos
Definition: libwebsockets.h:4377
lwsgs_smtp_states
Definition: libwebsockets.h:4602
Definition: libwebsockets.h:1614
Definition: libwebsockets.h:889
LWS_VISIBLE LWS_EXTERN struct lws * lws_adopt_socket_vhost_readbuf(struct lws_vhost *vhost, lws_sockfd_type accept_fd, const char *readbuf, size_t len)
Definition: libwebsockets.h:775
Definition: libwebsockets.h:1372
Definition: libwebsockets.h:621
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT lws_http_redirect(struct lws *wsi, int code, const unsigned char *loc, int len, unsigned char **p, unsigned char *end)
unsigned int count_threads
Definition: libwebsockets.h:1751
const char * email
Definition: libwebsockets.h:1560
LWS_VISIBLE LWS_EXTERN int lws_get_random(struct lws_context *context, void *buf, int len)
Definition: libwebsockets.h:603
uv_connect_t email_connect_req
Definition: libwebsockets.h:4650
const char * server_string
Definition: libwebsockets.h:1782
Definition: libwebsockets.h:1625
SHORT events
Definition: libwebsockets.h:375
Definition: libwebsockets.h:780
Definition: libwebsockets.h:1609
const char * vhost_name
Definition: libwebsockets.h:1764
Definition: libwebsockets.h:2104
LWS_VISIBLE LWS_EXTERN const struct lws_protocols * lws_get_protocol(struct lws *wsi)
Definition: libwebsockets.h:1535
Definition: libwebsockets.h:1557
unsigned int fd_limit_per_thread
Definition: libwebsockets.h:1753
LWS_VISIBLE LWS_EXTERN int lws_cgi_write_split_stdout_headers(struct lws *wsi)
lws_gs_event
Definition: libwebsockets.h:1551
LWS_VISIBLE LWS_EXTERN int lws_finalize_startup(struct lws_context *context)
int ka_interval
Definition: libwebsockets.h:1728
Definition: libwebsockets.h:1534
int uid
Definition: libwebsockets.h:1714
Definition: libwebsockets.h:3054
LWS_VISIBLE LWS_EXTERN int lws_b64_encode_string(const char *in, int in_len, char *out, int out_size)
LWS_VISIBLE LWS_EXTERN void * lws_context_user(struct lws_context *context)
const char * name
Definition: libwebsockets.h:1373
LWS_VISIBLE LWS_EXTERN int lws_init_vhost_client_ssl(const struct lws_context_creation_info *info, struct lws_vhost *vhost)
Definition: libwebsockets.h:1099
Definition: libwebsockets.h:4608
unsigned int http_proxy_port
Definition: libwebsockets.h:1710
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT lws_partial_buffered(struct lws *wsi)
unsigned int timeout_secs
Definition: libwebsockets.h:1757
int port
Definition: libwebsockets.h:1667
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT lws_parse_uri(char *p, const char **prot, const char **ads, int *port, const char **path)
LWS_VISIBLE LWS_EXTERN lws_fileofs_t lws_vfs_file_seek_set(lws_fop_fd_t fop_fd, lws_fileofs_t offset)
unsigned int options
Definition: libwebsockets.h:1716
LWS_VISIBLE LWS_EXTERN int lws_spa_get_length(struct lws_spa *spa, int n)
const struct lws_protocol_vhost_options * options
Definition: libwebsockets.h:2089
int prev_events
Definition: libwebsockets.h:578
int keepalive_timeout
Definition: libwebsockets.h:1774
Definition: libwebsockets.h:1541
Definition: libwebsockets.h:1107
Definition: libwebsockets.h:1199
const struct lws_protocol_vhost_options * headers
Definition: libwebsockets.h:1812
Definition: libwebsockets.h:2843
LWS_VISIBLE LWS_EXTERN int lws_write(struct lws *wsi, unsigned char *buf, size_t len, enum lws_write_protocol protocol)
int(* LWS_FOP_READ)(lws_fop_fd_t fop_fd, lws_filepos_t *amount, uint8_t *buf, lws_filepos_t len)
Definition: libwebsockets.h:4412
const struct lws_protocol_vhost_options * pvo
Definition: libwebsockets.h:1771
const char * basic_auth_login_file
Definition: libwebsockets.h:2147
const char * host
Definition: libwebsockets.h:2196
Definition: libwebsockets.h:1208
Definition: libwebsockets.h:642
LWS_VISIBLE LWS_EXTERN const struct lws_protocols * lws_vhost_name_to_protocol(struct lws_vhost *vh, const char *name)
int len
Definition: libwebsockets.h:4261
LWS_VISIBLE LWS_EXTERN const char * lws_get_urlarg_by_name(struct lws *wsi, const char *name, char *buf, int len)
const char * iface
Definition: libwebsockets.h:1672
Definition: libwebsockets.h:4394
LWS_VISIBLE LWS_EXTERN void lwsl_hexdump(void *buf, size_t len)
Definition: libwebsockets.h:1054
lws_spa_fileupload_states
Definition: libwebsockets.h:3049
LWS_VISIBLE LWS_EXTERN int lws_service_fd(struct lws_context *context, struct lws_pollfd *pollfd)
LWS_VISIBLE LWS_EXTERN int lws_callback_vhost_protocols(struct lws *wsi, int reason, void *in, int len)
Definition: libwebsockets.h:600
Definition: libwebsockets.h:609
LWS_VISIBLE LWS_EXTERN const char * lws_sql_purify(char *escaped, const char *string, int len)
uv_tcp_t email_client
Definition: libwebsockets.h:4651
Definition: libwebsockets.h:373
Definition: libwebsockets.h:1105
Definition: libwebsockets.h:713
lws_write_protocol
Definition: libwebsockets.h:3396
const char * client_offer
Definition: libwebsockets.h:1285
const struct lws_plat_file_ops * next
Definition: libwebsockets.h:4422
LWS_VISIBLE LWS_EXTERN void lws_cancel_service(struct lws_context *context)
Definition: libwebsockets.h:3050
Definition: libwebsockets.h:614
Definition: libwebsockets.h:487
const char * origin
Definition: libwebsockets.h:2117
const char * name
Definition: libwebsockets.h:1200
LWS_VISIBLE LWS_EXTERN int lws_serve_http_file(struct lws *wsi, const char *file, const char *content_type, const char *other_headers, int other_headers_len)
LWS_VISIBLE LWS_EXTERN void lws_email_check(struct lws_email *email)
LWS_VISIBLE LWS_EXTERN int lws_set_proxy(struct lws_vhost *vhost, const char *proxy)
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT lws_frame_is_binary(struct lws *wsi)
LWS_VISIBLE LWS_EXTERN int lws_hdr_copy(struct lws *wsi, char *dest, int len, enum lws_token_indexes h)
Definition: libwebsockets.h:790
const char * name
Definition: libwebsockets.h:1283
Definition: libwebsockets.h:4607
short revents
Definition: libwebsockets.h:395
lws_extension_callback_function * callback
Definition: libwebsockets.h:1284
long ssl_options_set
Definition: libwebsockets.h:1796
Definition: libwebsockets.h:1112
LWS_VISIBLE LWS_EXTERN const struct lws_protocols * lws_protocol_get(struct lws *wsi) LWS_WARN_DEPRECATED
unsigned int mask
Definition: libwebsockets.h:1545
LWS_VISIBLE LWS_EXTERN int lws_email_init(struct lws_email *email, uv_loop_t *loop, int max_content)
const void * client_exts
Definition: libwebsockets.h:2206
uint32_t mod_time
Definition: libwebsockets.h:4383
lws_mount_protocols
Definition: libwebsockets.h:2098
LWS_EXTERN int lws_extension_callback_pm_deflate(struct lws_context *context, const struct lws_extension *ext, struct lws *wsi, enum lws_extension_callback_reasons reason, void *user, void *in, size_t len)
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT lws_add_http_header_content_length(struct lws *wsi, unsigned long content_length, unsigned char **p, unsigned char *end)
const char * client_ssl_ca_filepath
Definition: libwebsockets.h:1846
lws_sockfd_type fd
Definition: libwebsockets.h:393
unsigned int max_http_header_data2
Definition: libwebsockets.h:1791
Definition: libwebsockets.h:2099
LWS_VISIBLE LWS_EXTERN int lws_return_http_status(struct lws *wsi, unsigned int code, const char *html_body)
LWS_EXTERN LWS_VISIBLE struct lws_vhost * lws_create_vhost(struct lws_context *context, struct lws_context_creation_info *info)
const struct lws_protocol_vhost_options * interpret
Definition: libwebsockets.h:2130
void * external_baggage_free_on_destroy
Definition: libwebsockets.h:1823
LWS_VISIBLE LWS_EXTERN int lws_service(struct lws_context *context, int timeout_ms)
LWS_VISIBLE LWS_EXTERN void lws_set_wsi_user(struct lws *wsi, void *user)
Definition: libwebsockets.h:1607
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT lws_http_transaction_completed(struct lws *wsi)
int count_vars
Definition: libwebsockets.h:2668
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT lws_add_http_header_status(struct lws *wsi, unsigned int code, unsigned char **p, unsigned char *end)
LWS_VISIBLE LWS_EXTERN uint32_t LWS_WARN_UNUSED_RESULT lws_vfs_get_mod_time(lws_fop_fd_t fop_fd)
Definition: libwebsockets.h:2722
LWS_VISIBLE LWS_EXTERN struct lws_context * lws_create_context(struct lws_context_creation_info *info)
Definition: libwebsockets.h:769
void * data
Definition: libwebsockets.h:2666
char * content
Definition: libwebsockets.h:4654
LWS_VISIBLE LWS_EXTERN int lws_interface_to_sa(int ipv6, const char *ifname, struct sockaddr_in *addr, size_t addrlen)
const struct lws_token_limits * token_limits
Definition: libwebsockets.h:1686
Definition: libwebsockets.h:4615
const char * address
Definition: libwebsockets.h:2188
void * user
Definition: libwebsockets.h:1401
int events
Definition: libwebsockets.h:577
LWS_VISIBLE LWS_EXTERN unsigned int lws_http_client_http_response(struct lws *wsi)
int(* on_get_body)(struct lws_email *email, char *buf, int len)
Definition: libwebsockets.h:4641
Definition: libwebsockets.h:2105
void * user
Definition: libwebsockets.h:1718
Definition: libwebsockets.h:4611
Definition: libwebsockets.h:3419
char * token
Definition: libwebsockets.h:2723
LWS_VISIBLE LWS_EXTERN void * lws_protocol_vh_priv_get(struct lws_vhost *vhost, const struct lws_protocols *prot)
int count_protocols
Definition: libwebsockets.h:1487
Definition: libwebsockets.h:1101
void * l
Definition: libwebsockets.h:1502
const char * ssl_private_key_filepath
Definition: libwebsockets.h:1695
Definition: libwebsockets.h:1640
int max_len
Definition: libwebsockets.h:2656
Definition: libwebsockets.h:771
const struct lws_protocol_vhost_options * next
Definition: libwebsockets.h:2088
Definition: libwebsockets.h:782
LWS_VISIBLE LWS_EXTERN void lws_rx_flow_allow_all_protocol(const struct lws_context *context, const struct lws_protocols *protocol)
Definition: libwebsockets.h:2662
LWS_VISIBLE LWS_EXTERN const char *LWS_WARN_UNUSED_RESULT lws_canonical_hostname(struct lws_context *context)
Definition: libwebsockets.h:981
const char * ssl_ca_filepath
Definition: libwebsockets.h:1701
Definition: libwebsockets.h:1103
lws_client_connect_ssl_connection_flags
Definition: libwebsockets.h:2175
int gid
Definition: libwebsockets.h:1712
struct lws_vhost * vhost
Definition: libwebsockets.h:2220
int lws_callback_function(struct lws *wsi, enum lws_callback_reasons reason, void *user, void *in, size_t len)
Definition: libwebsockets.h:1134
LWS_VISIBLE LWS_EXTERN void lws_cancel_service_pt(struct lws *wsi)
Definition: libwebsockets.h:1627
Definition: libwebsockets.h:650
Definition: libwebsockets.h:4606
unsigned int api_magic
Definition: libwebsockets.h:1485
Definition: libwebsockets.h:1630
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT lws_send_pipe_choked(struct lws *wsi)
Definition: libwebsockets.h:4609
int(* lws_spa_fileupload_cb)(void *data, const char *name, const char *filename, char *buf, int len, enum lws_spa_fileupload_states state)
Definition: libwebsockets.h:3071