libwebsockets.h

Go to the documentation of this file.

/*
 * libwebsockets - small server side websockets and web server implementation
 *
 * Copyright (C) 2010-2018 Andy Green <andy@warmcat.com>
 *
 *  This library is free software; you can redistribute it and/or
 *  modify it under the terms of the GNU Lesser General Public
 *  License as published by the Free Software Foundation:
 *  version 2.1 of the License.
 *
 *  This library is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *  Lesser General Public License for more details.
 *
 *  You should have received a copy of the GNU Lesser General Public
 *  License along with this library; if not, write to the Free Software
 *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
 *  MA  02110-1301  USA
 */

#ifndef LIBWEBSOCKET_H_3060898B846849FF9F88F5DB59B5950C
#define LIBWEBSOCKET_H_3060898B846849FF9F88F5DB59B5950C

#ifdef __cplusplus
#include <cstddef>
#include <cstdarg>

extern "C" {
#else
#include <stdarg.h>
#endif

#include <string.h>
#include <stdlib.h>

#include "lws_config.h"

/*
 * CARE: everything using cmake defines needs to be below here
 */

#if defined(LWS_HAS_INTPTR_T)
#include <stdint.h>
#define lws_intptr_t intptr_t
#else
typedef unsigned long long lws_intptr_t;
#endif

#if defined(WIN32) || defined(_WIN32)
#ifndef WIN32_LEAN_AND_MEAN
#define WIN32_LEAN_AND_MEAN
#endif

#include <winsock2.h>
#include <ws2tcpip.h>
#include <stddef.h>
#include <basetsd.h>
#include <io.h>
#ifndef _WIN32_WCE
#include <fcntl.h>
#else
#define _O_RDONLY       0x0000
#define O_RDONLY        _O_RDONLY
#endif

#define LWS_INLINE __inline
#define LWS_VISIBLE
#define LWS_WARN_UNUSED_RESULT
#define LWS_WARN_DEPRECATED
#define LWS_FORMAT(string_index)

#ifdef LWS_DLL
#ifdef LWS_INTERNAL
#define LWS_EXTERN extern __declspec(dllexport)
#else
#define LWS_EXTERN extern __declspec(dllimport)
#endif
#else
#define LWS_EXTERN
#endif

#define LWS_INVALID_FILE INVALID_HANDLE_VALUE
#define LWS_O_RDONLY _O_RDONLY
#define LWS_O_WRONLY _O_WRONLY
#define LWS_O_CREAT _O_CREAT
#define LWS_O_TRUNC _O_TRUNC

#ifndef __func__
#define __func__ __FUNCTION__
#endif

#else /* NOT WIN32 */
#include <unistd.h>
#if defined(LWS_HAVE_SYS_CAPABILITY_H) && defined(LWS_HAVE_LIBCAP)
#include <sys/capability.h>
#endif

#if defined(__NetBSD__) || defined(__FreeBSD__) || defined(__QNX__) || defined(__OpenBSD__)
#include <sys/socket.h>
#include <netinet/in.h>
#endif

#define LWS_INLINE inline
#define LWS_O_RDONLY O_RDONLY
#define LWS_O_WRONLY O_WRONLY
#define LWS_O_CREAT O_CREAT
#define LWS_O_TRUNC O_TRUNC

#if !defined(LWS_PLAT_OPTEE) && !defined(OPTEE_TA) && !defined(LWS_WITH_ESP32)
#include <poll.h>
#include <netdb.h>
#define LWS_INVALID_FILE -1
#else
#define getdtablesize() (30)
#if defined(LWS_WITH_ESP32)
#define LWS_INVALID_FILE NULL
#else
#define LWS_INVALID_FILE NULL
#endif
#endif

#if defined(__GNUC__)

/* warn_unused_result attribute only supported by GCC 3.4 or later */
#if __GNUC__ >= 4 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 4)
#define LWS_WARN_UNUSED_RESULT __attribute__((warn_unused_result))
#else
#define LWS_WARN_UNUSED_RESULT
#endif

#define LWS_VISIBLE __attribute__((visibility("default")))
#define LWS_WARN_DEPRECATED __attribute__ ((deprecated))
#define LWS_FORMAT(string_index) __attribute__ ((format(printf, string_index, string_index+1)))
#else
#define LWS_VISIBLE
#define LWS_WARN_UNUSED_RESULT
#define LWS_WARN_DEPRECATED
#define LWS_FORMAT(string_index)
#endif

#if defined(__ANDROID__)
#include <netinet/in.h>
#include <unistd.h>
#define getdtablesize() sysconf(_SC_OPEN_MAX)
#endif

#endif

#if defined(LWS_WITH_LIBEV)
#include <ev.h>
#endif /* LWS_WITH_LIBEV */
#ifdef LWS_WITH_LIBUV
#include <uv.h>
#ifdef LWS_HAVE_UV_VERSION_H
#include <uv-version.h>
#endif
#ifdef LWS_HAVE_NEW_UV_VERSION_H
#include <uv/version.h>
#endif
#endif /* LWS_WITH_LIBUV */
#if defined(LWS_WITH_LIBEVENT)
#include <event2/event.h>
#endif /* LWS_WITH_LIBEVENT */

#ifndef LWS_EXTERN
#define LWS_EXTERN extern
#endif

#ifdef _WIN32
#define random rand
#else
#if !defined(OPTEE_TA)
#include <sys/time.h>
#include <unistd.h>
#endif
#endif

#if defined(LWS_WITH_TLS)

#ifdef USE_WOLFSSL
#ifdef USE_OLD_CYASSL
#ifdef _WIN32
/*
 * Include user-controlled settings for windows from
 * <wolfssl-root>/IDE/WIN/user_settings.h
 */
#include <IDE/WIN/user_settings.h>
#include <cyassl/ctaocrypt/settings.h>
#else
#include <cyassl/options.h>
#endif
#include <cyassl/openssl/ssl.h>
#include <cyassl/error-ssl.h>

#else
#ifdef _WIN32
/*
 * Include user-controlled settings for windows from
 * <wolfssl-root>/IDE/WIN/user_settings.h
 */
#include <IDE/WIN/user_settings.h>
#include <wolfssl/wolfcrypt/settings.h>
#else
#include <wolfssl/options.h>
#endif
#include <wolfssl/openssl/ssl.h>
#include <wolfssl/error-ssl.h>
#endif /* not USE_OLD_CYASSL */
#else
#if defined(LWS_WITH_MBEDTLS)
#if defined(LWS_WITH_ESP32)
/* this filepath is passed to us but without quotes or <> */
#undef MBEDTLS_CONFIG_FILE
#define MBEDTLS_CONFIG_FILE <mbedtls/esp_config.h>
#endif
#include <mbedtls/ssl.h>
#else
#include <openssl/ssl.h>
#if !defined(LWS_WITH_MBEDTLS)
#include <openssl/err.h>
#endif
#endif
#endif /* not USE_WOLFSSL */
#endif

/*
 * Helpers for pthread mutex in user code... if lws is built for
 * multiple service threads, these resolve to pthread mutex
 * operations.  In the case LWS_MAX_SMP is 1 (the default), they
 * are all NOPs and no pthread type or api is referenced.
 */

#if LWS_MAX_SMP > 1

#include <pthread.h>

#define lws_pthread_mutex(name) pthread_mutex_t name;

static LWS_INLINE void
lws_pthread_mutex_init(pthread_mutex_t *lock)
{
        pthread_mutex_init(lock, NULL);
}

static LWS_INLINE void
lws_pthread_mutex_destroy(pthread_mutex_t *lock)
{
        pthread_mutex_destroy(lock);
}

static LWS_INLINE void
lws_pthread_mutex_lock(pthread_mutex_t *lock)
{
        pthread_mutex_lock(lock);
}

static LWS_INLINE void
lws_pthread_mutex_unlock(pthread_mutex_t *lock)
{
        pthread_mutex_unlock(lock);
}

#else
#define lws_pthread_mutex(name)
#define lws_pthread_mutex_init(_a)
#define lws_pthread_mutex_destroy(_a)
#define lws_pthread_mutex_lock(_a)
#define lws_pthread_mutex_unlock(_a)
#endif


#define CONTEXT_PORT_NO_LISTEN -1
#define CONTEXT_PORT_NO_LISTEN_SERVER -2


enum lws_log_levels {
        LLL_ERR = 1 << 0,
        LLL_WARN = 1 << 1,
        LLL_NOTICE = 1 << 2,
        LLL_INFO = 1 << 3,
        LLL_DEBUG = 1 << 4,
        LLL_PARSER = 1 << 5,
        LLL_HEADER = 1 << 6,
        LLL_EXT = 1 << 7,
        LLL_CLIENT = 1 << 8,
        LLL_LATENCY = 1 << 9,
        LLL_USER = 1 << 10,

        LLL_COUNT = 11 /* set to count of valid flags */
};

LWS_VISIBLE LWS_EXTERN void _lws_log(int filter, const char *format, ...) LWS_FORMAT(2);
LWS_VISIBLE LWS_EXTERN void _lws_logv(int filter, const char *format, va_list vl);
LWS_VISIBLE LWS_EXTERN int
lwsl_timestamp(int level, char *p, int len);

/* these guys are unconditionally included */

#define lwsl_err(...) _lws_log(LLL_ERR, __VA_ARGS__)
#define lwsl_user(...) _lws_log(LLL_USER, __VA_ARGS__)

#if !defined(LWS_WITH_NO_LOGS)
/* notice and warn are usually included by being compiled in */
#define lwsl_warn(...) _lws_log(LLL_WARN, __VA_ARGS__)
#define lwsl_notice(...) _lws_log(LLL_NOTICE, __VA_ARGS__)
#endif
/*
 *  weaker logging can be deselected by telling CMake to build in RELEASE mode
 *  that gets rid of the overhead of checking while keeping _warn and _err
 *  active
 */

#ifdef _DEBUG
#if defined(LWS_WITH_NO_LOGS)
/* notice, warn and log are always compiled in */
#define lwsl_warn(...) _lws_log(LLL_WARN, __VA_ARGS__)
#define lwsl_notice(...) _lws_log(LLL_NOTICE, __VA_ARGS__)
#endif
#define lwsl_info(...) _lws_log(LLL_INFO, __VA_ARGS__)
#define lwsl_debug(...) _lws_log(LLL_DEBUG, __VA_ARGS__)
#define lwsl_parser(...) _lws_log(LLL_PARSER, __VA_ARGS__)
#define lwsl_header(...)  _lws_log(LLL_HEADER, __VA_ARGS__)
#define lwsl_ext(...)  _lws_log(LLL_EXT, __VA_ARGS__)
#define lwsl_client(...) _lws_log(LLL_CLIENT, __VA_ARGS__)
#define lwsl_latency(...) _lws_log(LLL_LATENCY, __VA_ARGS__)

#else /* no debug */
#if defined(LWS_WITH_NO_LOGS)
#define lwsl_warn(...) do {} while(0)
#define lwsl_notice(...) do {} while(0)
#endif
#define lwsl_info(...) do {} while(0)
#define lwsl_debug(...) do {} while(0)
#define lwsl_parser(...) do {} while(0)
#define lwsl_header(...) do {} while(0)
#define lwsl_ext(...) do {} while(0)
#define lwsl_client(...) do {} while(0)
#define lwsl_latency(...) do {} while(0)

#endif

#define lwsl_hexdump_err(...) lwsl_hexdump_level(LLL_ERR, __VA_ARGS__)
#define lwsl_hexdump_warn(...) lwsl_hexdump_level(LLL_WARN, __VA_ARGS__)
#define lwsl_hexdump_notice(...) lwsl_hexdump_level(LLL_NOTICE, __VA_ARGS__)
#define lwsl_hexdump_info(...) lwsl_hexdump_level(LLL_INFO, __VA_ARGS__)
#define lwsl_hexdump_debug(...) lwsl_hexdump_level(LLL_DEBUG, __VA_ARGS__)

LWS_VISIBLE LWS_EXTERN void
lwsl_hexdump_level(int level, const void *vbuf, size_t len);

LWS_VISIBLE LWS_EXTERN void
lwsl_hexdump(const void *buf, size_t len);

static LWS_INLINE int lws_is_be(void) {
        const int probe = ~0xff;

        return *(const char *)&probe;
}

LWS_VISIBLE LWS_EXTERN void
lws_set_log_level(int level,
                  void (*log_emit_function)(int level, const char *line));

LWS_VISIBLE LWS_EXTERN void
lwsl_emit_syslog(int level, const char *line);

LWS_VISIBLE LWS_EXTERN int
lwsl_visible(int level);



#include <stddef.h>

#ifndef lws_container_of
#define lws_container_of(P,T,M) ((T *)((char *)(P) - offsetof(T, M)))
#endif

struct lws;

typedef int64_t lws_usec_t;

/* api change list for user code to test against */

#define LWS_FEATURE_SERVE_HTTP_FILE_HAS_OTHER_HEADERS_ARG

/* the struct lws_protocols has the id field present */
#define LWS_FEATURE_PROTOCOLS_HAS_ID_FIELD

/* you can call lws_get_peer_write_allowance */
#define LWS_FEATURE_PROTOCOLS_HAS_PEER_WRITE_ALLOWANCE

/* extra parameter introduced in 917f43ab821 */
#define LWS_FEATURE_SERVE_HTTP_FILE_HAS_OTHER_HEADERS_LEN

/* File operations stuff exists */
#define LWS_FEATURE_FOPS


#if defined(_WIN32)
typedef SOCKET lws_sockfd_type;
typedef HANDLE lws_filefd_type;

struct lws_pollfd {
        lws_sockfd_type fd; 
        SHORT events; 
        SHORT revents; 
};
#define LWS_POLLHUP (FD_CLOSE)
#define LWS_POLLIN (FD_READ | FD_ACCEPT)
#define LWS_POLLOUT (FD_WRITE)
#else


#if defined(LWS_WITH_ESP32)

typedef int lws_sockfd_type;
typedef int lws_filefd_type;

struct pollfd {
        lws_sockfd_type fd; 
        short events; 
        short revents; 
};
#define POLLIN          0x0001
#define POLLPRI         0x0002
#define POLLOUT         0x0004
#define POLLERR         0x0008
#define POLLHUP         0x0010
#define POLLNVAL        0x0020

#include <freertos/FreeRTOS.h>
#include <freertos/event_groups.h>
#include <string.h>
#include "esp_wifi.h"
#include "esp_system.h"
#include "esp_event.h"
#include "esp_event_loop.h"
#include "nvs.h"
#include "driver/gpio.h"
#include "esp_spi_flash.h"
#include "freertos/timers.h"

#if !defined(CONFIG_FREERTOS_HZ)
#define CONFIG_FREERTOS_HZ 100
#endif

typedef TimerHandle_t uv_timer_t;
typedef void uv_cb_t(uv_timer_t *);
typedef void * uv_handle_t;

struct timer_mapping {
        uv_cb_t *cb;
        uv_timer_t *t;
};

#define UV_VERSION_MAJOR 1

#define lws_uv_getloop(a, b) (NULL)

static LWS_INLINE void uv_timer_init(void *l, uv_timer_t *t)
{
        (void)l;
        *t = NULL;
}

extern void esp32_uvtimer_cb(TimerHandle_t t);

static LWS_INLINE void uv_timer_start(uv_timer_t *t, uv_cb_t *cb, int first, int rep)
{
        struct timer_mapping *tm = (struct timer_mapping *)malloc(sizeof(*tm));

        if (!tm)
                return;

        tm->t = t;
        tm->cb = cb;

        *t = xTimerCreate("x", pdMS_TO_TICKS(first), !!rep, tm,
                          (TimerCallbackFunction_t)esp32_uvtimer_cb);
        xTimerStart(*t, 0);
}

static LWS_INLINE void uv_timer_stop(uv_timer_t *t)
{
        xTimerStop(*t, 0);
}

static LWS_INLINE void uv_close(uv_handle_t *h, void *v)
{
        free(pvTimerGetTimerID((uv_timer_t)h));
        xTimerDelete(*(uv_timer_t *)h, 0);
}

/* ESP32 helper declarations */

#include <mdns.h>
#include <esp_partition.h>

#define LWS_PLUGIN_STATIC
#define LWS_MAGIC_REBOOT_TYPE_ADS 0x50001ffc
#define LWS_MAGIC_REBOOT_TYPE_REQ_FACTORY 0xb00bcafe
#define LWS_MAGIC_REBOOT_TYPE_FORCED_FACTORY 0xfaceb00b
#define LWS_MAGIC_REBOOT_TYPE_FORCED_FACTORY_BUTTON 0xf0cedfac


/* user code provides these */

extern void
lws_esp32_identify_physical_device(void);

/* lws-plat-esp32 provides these */

typedef void (*lws_cb_scan_done)(uint16_t count, wifi_ap_record_t *recs, void *arg);

enum genled_state {
        LWSESP32_GENLED__INIT,
        LWSESP32_GENLED__LOST_NETWORK,
        LWSESP32_GENLED__NO_NETWORK,
        LWSESP32_GENLED__CONN_AP,
        LWSESP32_GENLED__GOT_IP,
        LWSESP32_GENLED__OK,
};

struct lws_group_member {
        struct lws_group_member *next;
        uint64_t last_seen;
        char model[16];
        char role[16];
        char host[32];
        char mac[20];
        int width, height;
        struct ip4_addr addr;
        struct ip6_addr addrv6;
        uint8_t flags;
};

#define LWS_SYSTEM_GROUP_MEMBER_ADD             1
#define LWS_SYSTEM_GROUP_MEMBER_CHANGE          2
#define LWS_SYSTEM_GROUP_MEMBER_REMOVE          3

#define LWS_GROUP_FLAG_SELF 1

struct lws_esp32 {
        char sta_ip[16];
        char sta_mask[16];
        char sta_gw[16];
        char serial[16];
        char opts[16];
        char model[16];
        char group[16];
        char role[16];
        char ssid[4][64];
        char password[4][64];
        char active_ssid[64];
        char access_pw[16];
        char hostname[32];
        char mac[20];
        char le_dns[64];
        char le_email[64];
        char region;
        char inet;
        char conn_ap;

        enum genled_state genled;
        uint64_t genled_t;

        lws_cb_scan_done scan_consumer;
        void *scan_consumer_arg;
        struct lws_group_member *first;
        int extant_group_members;

        char acme;
        char upload;

        volatile char button_is_down;
};

struct lws_esp32_image {
        uint32_t romfs;
        uint32_t romfs_len;
        uint32_t json;
        uint32_t json_len;
};

extern struct lws_esp32 lws_esp32;
struct lws_vhost;

extern esp_err_t
lws_esp32_event_passthru(void *ctx, system_event_t *event);
extern void
lws_esp32_wlan_config(void);
extern void
lws_esp32_wlan_start_ap(void);
extern void
lws_esp32_wlan_start_station(void);
struct lws_context_creation_info;
extern void
lws_esp32_set_creation_defaults(struct lws_context_creation_info *info);
extern struct lws_context *
lws_esp32_init(struct lws_context_creation_info *, struct lws_vhost **pvh);
extern int
lws_esp32_wlan_nvs_get(int retry);
extern esp_err_t
lws_nvs_set_str(nvs_handle handle, const char* key, const char* value);
extern void
lws_esp32_restart_guided(uint32_t type);
extern const esp_partition_t *
lws_esp_ota_get_boot_partition(void);
extern int
lws_esp32_get_image_info(const esp_partition_t *part, struct lws_esp32_image *i, char *json, int json_len);
extern int
lws_esp32_leds_network_indication(void);

extern uint32_t lws_esp32_get_reboot_type(void);
extern uint16_t lws_esp32_sine_interp(int n);

/* required in external code by esp32 plat (may just return if no leds) */
extern void lws_esp32_leds_timer_cb(TimerHandle_t th);
#else
typedef int lws_sockfd_type;
typedef int lws_filefd_type;
#endif

#define lws_pollfd pollfd
#define LWS_POLLHUP (POLLHUP|POLLERR)
#define LWS_POLLIN (POLLIN)
#define LWS_POLLOUT (POLLOUT)
#endif


#if (defined(WIN32) || defined(_WIN32)) && !defined(__MINGW32__)
/* ... */
#define ssize_t SSIZE_T
#endif

#if defined(WIN32) && defined(LWS_HAVE__STAT32I64)
#include <sys/types.h>
#include <sys/stat.h>
#endif

#if defined(LWS_HAVE_STDINT_H)
#include <stdint.h>
#else
#if defined(WIN32) || defined(_WIN32)
/* !!! >:-[  */
typedef unsigned __int32 uint32_t;
typedef unsigned __int16 uint16_t;
typedef unsigned __int8 uint8_t;
#else
typedef unsigned int uint32_t;
typedef unsigned short uint16_t;
typedef unsigned char uint8_t;
#endif
#endif

typedef unsigned long long lws_filepos_t;
typedef long long lws_fileofs_t;
typedef uint32_t lws_fop_flags_t;

struct lws_pollargs {
        lws_sockfd_type fd;     
        int events;             
        int prev_events;        
};

struct lws_tokens;
struct lws_token_limits;


/*
 * NOTE: These public enums are part of the abi.  If you want to add one,
 * add it at where specified so existing users are unaffected.
 */
enum lws_close_status {
        LWS_CLOSE_STATUS_NOSTATUS                               =    0,
        LWS_CLOSE_STATUS_NORMAL                                 = 1000,
        LWS_CLOSE_STATUS_GOINGAWAY                              = 1001,
        LWS_CLOSE_STATUS_PROTOCOL_ERR                           = 1002,
        LWS_CLOSE_STATUS_UNACCEPTABLE_OPCODE                    = 1003,
        LWS_CLOSE_STATUS_RESERVED                               = 1004,
        LWS_CLOSE_STATUS_NO_STATUS                              = 1005,
        LWS_CLOSE_STATUS_ABNORMAL_CLOSE                         = 1006,
        LWS_CLOSE_STATUS_INVALID_PAYLOAD                        = 1007,
        LWS_CLOSE_STATUS_POLICY_VIOLATION                       = 1008,
        LWS_CLOSE_STATUS_MESSAGE_TOO_LARGE                      = 1009,
        LWS_CLOSE_STATUS_EXTENSION_REQUIRED                     = 1010,
        LWS_CLOSE_STATUS_UNEXPECTED_CONDITION                   = 1011,
        LWS_CLOSE_STATUS_TLS_FAILURE                            = 1015,
        LWS_CLOSE_STATUS_CLIENT_TRANSACTION_DONE                = 2000,

        /****** add new things just above ---^ ******/

        LWS_CLOSE_STATUS_NOSTATUS_CONTEXT_DESTROY               = 9999,
};

LWS_VISIBLE LWS_EXTERN void
lws_close_reason(struct lws *wsi, enum lws_close_status status,
                 unsigned char *buf, size_t len);


struct lws;
struct lws_context;
/* needed even with extensions disabled for create context */
struct lws_extension;



struct lws_ssl_info {
        int where;
        int ret;
};

enum lws_cert_update_state {
        LWS_CUS_IDLE,
        LWS_CUS_STARTING,
        LWS_CUS_SUCCESS,
        LWS_CUS_FAILED,

        LWS_CUS_CREATE_KEYS,
        LWS_CUS_REG,
        LWS_CUS_AUTH,
        LWS_CUS_CHALLENGE,
        LWS_CUS_CREATE_REQ,
        LWS_CUS_REQ,
        LWS_CUS_CONFIRM,
        LWS_CUS_ISSUE,
};

enum {
        LWS_TLS_REQ_ELEMENT_COUNTRY,
        LWS_TLS_REQ_ELEMENT_STATE,
        LWS_TLS_REQ_ELEMENT_LOCALITY,
        LWS_TLS_REQ_ELEMENT_ORGANIZATION,
        LWS_TLS_REQ_ELEMENT_COMMON_NAME,
        LWS_TLS_REQ_ELEMENT_EMAIL,

        LWS_TLS_REQ_ELEMENT_COUNT,

        LWS_TLS_SET_DIR_URL = LWS_TLS_REQ_ELEMENT_COUNT,
        LWS_TLS_SET_AUTH_PATH,
        LWS_TLS_SET_CERT_PATH,
        LWS_TLS_SET_KEY_PATH,

        LWS_TLS_TOTAL_COUNT
};

struct lws_acme_cert_aging_args {
        struct lws_vhost *vh;
        const char *element_overrides[LWS_TLS_TOTAL_COUNT]; /* NULL = use pvo */
};

/*
 * NOTE: These public enums are part of the abi.  If you want to add one,
 * add it at where specified so existing users are unaffected.
 */
enum lws_callback_reasons {

        /* ---------------------------------------------------------------------
         * ----- Callbacks related to wsi and protocol binding lifecycle -----
         */

        LWS_CALLBACK_PROTOCOL_INIT                              = 27,
        LWS_CALLBACK_PROTOCOL_DESTROY                           = 28,
        LWS_CALLBACK_WSI_CREATE                                 = 29,
        LWS_CALLBACK_WSI_DESTROY                                = 30,
        LWS_CALLBACK_HTTP_BIND_PROTOCOL                         = 49,
        LWS_CALLBACK_HTTP_DROP_PROTOCOL                         = 50,
        /* ---------------------------------------------------------------------
         * ----- Callbacks related to Server TLS -----
         */

        LWS_CALLBACK_OPENSSL_LOAD_EXTRA_CLIENT_VERIFY_CERTS     = 21,
        LWS_CALLBACK_OPENSSL_LOAD_EXTRA_SERVER_VERIFY_CERTS     = 22,
        LWS_CALLBACK_OPENSSL_PERFORM_CLIENT_CERT_VERIFICATION   = 23,
        LWS_CALLBACK_OPENSSL_CONTEXT_REQUIRES_PRIVATE_KEY       = 37,
        LWS_CALLBACK_SSL_INFO                                   = 67,
        /* ---------------------------------------------------------------------
         * ----- Callbacks related to Client TLS -----
         */

        LWS_CALLBACK_OPENSSL_PERFORM_SERVER_CERT_VERIFICATION = 58,
        /* ---------------------------------------------------------------------
         * ----- Callbacks related to HTTP Server  -----
         */

        LWS_CALLBACK_SERVER_NEW_CLIENT_INSTANTIATED             = 19,
        LWS_CALLBACK_HTTP                                       = 12,
        LWS_CALLBACK_HTTP_BODY                                  = 13,
        LWS_CALLBACK_HTTP_BODY_COMPLETION                       = 14,
        LWS_CALLBACK_HTTP_FILE_COMPLETION                       = 15,
        LWS_CALLBACK_HTTP_WRITEABLE                             = 16,
        LWS_CALLBACK_CLOSED_HTTP                                =  5,
        LWS_CALLBACK_FILTER_HTTP_CONNECTION                     = 18,
        LWS_CALLBACK_ADD_HEADERS                                = 53,
        LWS_CALLBACK_CHECK_ACCESS_RIGHTS                        = 51,
        LWS_CALLBACK_PROCESS_HTML                               = 52,
        /* ---------------------------------------------------------------------
         * ----- Callbacks related to HTTP Client  -----
         */

        LWS_CALLBACK_ESTABLISHED_CLIENT_HTTP                    = 44,
        LWS_CALLBACK_CLOSED_CLIENT_HTTP                         = 45,
        LWS_CALLBACK_RECEIVE_CLIENT_HTTP_READ                   = 48,
        LWS_CALLBACK_RECEIVE_CLIENT_HTTP                        = 46,
        LWS_CALLBACK_COMPLETED_CLIENT_HTTP                      = 47,
        LWS_CALLBACK_CLIENT_HTTP_WRITEABLE                      = 57,
        /* ---------------------------------------------------------------------
         * ----- Callbacks related to Websocket Server -----
         */

        LWS_CALLBACK_ESTABLISHED                                =  0,
        LWS_CALLBACK_CLOSED                                     =  4,
        LWS_CALLBACK_SERVER_WRITEABLE                           = 11,
        LWS_CALLBACK_RECEIVE                                    =  6,
        LWS_CALLBACK_RECEIVE_PONG                               =  7,
        LWS_CALLBACK_WS_PEER_INITIATED_CLOSE                    = 38,
        LWS_CALLBACK_FILTER_PROTOCOL_CONNECTION                 = 20,
        LWS_CALLBACK_CONFIRM_EXTENSION_OKAY                     = 25,
        /* ---------------------------------------------------------------------
         * ----- Callbacks related to Websocket Client -----
         */

        LWS_CALLBACK_CLIENT_CONNECTION_ERROR                    =  1,
        LWS_CALLBACK_CLIENT_FILTER_PRE_ESTABLISH                =  2,
        LWS_CALLBACK_CLIENT_ESTABLISHED                         =  3,
        LWS_CALLBACK_CLIENT_CLOSED                              =  75,
        LWS_CALLBACK_CLIENT_APPEND_HANDSHAKE_HEADER             = 24,
        LWS_CALLBACK_CLIENT_RECEIVE                             =  8,
        LWS_CALLBACK_CLIENT_RECEIVE_PONG                        =  9,
        LWS_CALLBACK_CLIENT_WRITEABLE                           = 10,
        LWS_CALLBACK_CLIENT_CONFIRM_EXTENSION_SUPPORTED         = 26,
        LWS_CALLBACK_WS_EXT_DEFAULTS                            = 39,
        LWS_CALLBACK_FILTER_NETWORK_CONNECTION                  = 17,
        /* ---------------------------------------------------------------------
         * ----- Callbacks related to external poll loop integration  -----
         */

        LWS_CALLBACK_GET_THREAD_ID                              = 31,
        /* external poll() management support */
        LWS_CALLBACK_ADD_POLL_FD                                = 32,
        LWS_CALLBACK_DEL_POLL_FD                                = 33,
        LWS_CALLBACK_CHANGE_MODE_POLL_FD                        = 34,
        LWS_CALLBACK_LOCK_POLL                                  = 35,
        LWS_CALLBACK_UNLOCK_POLL                                = 36,
        /* ---------------------------------------------------------------------
         * ----- Callbacks related to CGI serving -----
         */

        LWS_CALLBACK_CGI                                        = 40,
        LWS_CALLBACK_CGI_TERMINATED                             = 41,
        LWS_CALLBACK_CGI_STDIN_DATA                             = 42,
        LWS_CALLBACK_CGI_STDIN_COMPLETED                        = 43,
        LWS_CALLBACK_CGI_PROCESS_ATTACH                         = 70,
        /* ---------------------------------------------------------------------
         * ----- Callbacks related to Generic Sessions -----
         */

        LWS_CALLBACK_SESSION_INFO                               = 54,
        LWS_CALLBACK_GS_EVENT                                   = 55,
        LWS_CALLBACK_HTTP_PMO                                   = 56,
        /* ---------------------------------------------------------------------
         * ----- Callbacks related to RAW sockets -----
         */

        LWS_CALLBACK_RAW_RX                                     = 59,
        LWS_CALLBACK_RAW_CLOSE                                  = 60,
        LWS_CALLBACK_RAW_WRITEABLE                              = 61,
        LWS_CALLBACK_RAW_ADOPT                                  = 62,
        /* ---------------------------------------------------------------------
         * ----- Callbacks related to RAW file handles -----
         */

        LWS_CALLBACK_RAW_ADOPT_FILE                             = 63,
        LWS_CALLBACK_RAW_RX_FILE                                = 64,
        LWS_CALLBACK_RAW_WRITEABLE_FILE                         = 65,
        LWS_CALLBACK_RAW_CLOSE_FILE                             = 66,
        /* ---------------------------------------------------------------------
         * ----- Callbacks related to generic wsi events -----
         */

        LWS_CALLBACK_TIMER                                      = 73,
        LWS_CALLBACK_EVENT_WAIT_CANCELLED                       = 71,
        LWS_CALLBACK_CHILD_CLOSING                              = 69,
        LWS_CALLBACK_CHILD_WRITE_VIA_PARENT                     = 68,
        /* ---------------------------------------------------------------------
         * ----- Callbacks related to TLS certificate management -----
         */

        LWS_CALLBACK_VHOST_CERT_AGING                           = 72,
        LWS_CALLBACK_VHOST_CERT_UPDATE                          = 74,
        /****** add new things just above ---^ ******/

        LWS_CALLBACK_USER = 1000,
};



typedef int
lws_callback_function(struct lws *wsi, enum lws_callback_reasons reason,
                    void *user, void *in, size_t len);

#define LWS_CB_REASON_AUX_BF__CGI               1
#define LWS_CB_REASON_AUX_BF__PROXY             2
#define LWS_CB_REASON_AUX_BF__CGI_CHUNK_END     4
#define LWS_CB_REASON_AUX_BF__CGI_HEADERS       8

struct lws_vhost;


#if defined(LWS_WITH_TLS)

#if defined(LWS_WITH_MBEDTLS)
#include <mbedtls/sha1.h>
#include <mbedtls/sha256.h>
#include <mbedtls/sha512.h>
#endif

enum lws_genhash_types {
        LWS_GENHASH_TYPE_SHA1,
        LWS_GENHASH_TYPE_SHA256,
        LWS_GENHASH_TYPE_SHA384,
        LWS_GENHASH_TYPE_SHA512,
};

enum lws_genhmac_types {
        LWS_GENHMAC_TYPE_SHA256,
        LWS_GENHMAC_TYPE_SHA384,
        LWS_GENHMAC_TYPE_SHA512,
};

#define LWS_GENHASH_LARGEST 64

struct lws_genhash_ctx {
        uint8_t type;
#if defined(LWS_WITH_MBEDTLS)
        union {
                mbedtls_sha1_context sha1;
                mbedtls_sha256_context sha256;
                mbedtls_sha512_context sha512; /* 384 also uses this */
                const mbedtls_md_info_t *hmac;
        } u;
#else
        const EVP_MD *evp_type;
        EVP_MD_CTX *mdctx;
#endif
};

struct lws_genhmac_ctx {
        uint8_t type;
#if defined(LWS_WITH_MBEDTLS)
        const mbedtls_md_info_t *hmac;
        mbedtls_md_context_t ctx;
#else
        const EVP_MD *evp_type;
        EVP_MD_CTX *ctx;
#endif
};

LWS_VISIBLE LWS_EXTERN size_t LWS_WARN_UNUSED_RESULT
lws_genhash_size(enum lws_genhash_types type);

LWS_VISIBLE LWS_EXTERN size_t LWS_WARN_UNUSED_RESULT
lws_genhmac_size(enum lws_genhmac_types type);

LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
lws_genhash_init(struct lws_genhash_ctx *ctx, enum lws_genhash_types type);

LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
lws_genhash_update(struct lws_genhash_ctx *ctx, const void *in, size_t len);

LWS_VISIBLE LWS_EXTERN int
lws_genhash_destroy(struct lws_genhash_ctx *ctx, void *result);

LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
lws_genhmac_init(struct lws_genhmac_ctx *ctx, enum lws_genhmac_types type,
                const uint8_t *key, size_t key_len);

LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
lws_genhmac_update(struct lws_genhmac_ctx *ctx, const void *in, size_t len);

LWS_VISIBLE LWS_EXTERN int
lws_genhmac_destroy(struct lws_genhmac_ctx *ctx, void *result);


enum enum_jwk_tok {
        JWK_KEY_E,
        JWK_KEY_N,
        JWK_KEY_D,
        JWK_KEY_P,
        JWK_KEY_Q,
        JWK_KEY_DP,
        JWK_KEY_DQ,
        JWK_KEY_QI,
        JWK_KTY, /* also serves as count of real elements */
        JWK_KEY,
};

#define LWS_COUNT_RSA_ELEMENTS JWK_KTY

struct lws_genrsa_ctx {
#if defined(LWS_WITH_MBEDTLS)
        mbedtls_rsa_context *ctx;
#else
        BIGNUM *bn[LWS_COUNT_RSA_ELEMENTS];
        RSA *rsa;
#endif
};

struct lws_genrsa_element {
        uint8_t *buf;
        uint16_t len;
};

struct lws_genrsa_elements {
        struct lws_genrsa_element e[LWS_COUNT_RSA_ELEMENTS];
};

LWS_VISIBLE LWS_EXTERN void
lws_jwk_destroy_genrsa_elements(struct lws_genrsa_elements *el);

LWS_VISIBLE LWS_EXTERN int
lws_genrsa_create(struct lws_genrsa_ctx *ctx, struct lws_genrsa_elements *el);

LWS_VISIBLE LWS_EXTERN int
lws_genrsa_new_keypair(struct lws_context *context, struct lws_genrsa_ctx *ctx,
                       struct lws_genrsa_elements *el, int bits);

LWS_VISIBLE LWS_EXTERN int
lws_genrsa_public_decrypt(struct lws_genrsa_ctx *ctx, const uint8_t *in,
                          size_t in_len, uint8_t *out, size_t out_max);

LWS_VISIBLE LWS_EXTERN int
lws_genrsa_public_verify(struct lws_genrsa_ctx *ctx, const uint8_t *in,
                         enum lws_genhash_types hash_type,
                         const uint8_t *sig, size_t sig_len);

LWS_VISIBLE LWS_EXTERN int
lws_genrsa_public_sign(struct lws_genrsa_ctx *ctx, const uint8_t *in,
                         enum lws_genhash_types hash_type, uint8_t *sig,
                         size_t sig_len);

LWS_VISIBLE LWS_EXTERN void
lws_genrsa_destroy(struct lws_genrsa_ctx *ctx);

LWS_VISIBLE LWS_EXTERN int
lws_genrsa_render_pkey_asn1(struct lws_genrsa_ctx *ctx, int _private,
                            uint8_t *pkey_asn1, size_t pkey_asn1_len);


struct lws_jwk {
        char keytype[5];                
        struct lws_genrsa_elements el;  
};

LWS_VISIBLE LWS_EXTERN int
lws_jwk_import(struct lws_jwk *s, const char *in, size_t len);

LWS_VISIBLE LWS_EXTERN void
lws_jwk_destroy(struct lws_jwk *s);

LWS_VISIBLE LWS_EXTERN int
lws_jwk_export(struct lws_jwk *s, int _private, char *p, size_t len);

LWS_VISIBLE int
lws_jwk_load(struct lws_jwk *s, const char *filename);

LWS_VISIBLE int
lws_jwk_save(struct lws_jwk *s, const char *filename);

LWS_VISIBLE int
lws_jwk_rfc7638_fingerprint(struct lws_jwk *s, char *digest32);



LWS_VISIBLE LWS_EXTERN int
lws_jws_confirm_sig(const char *in, size_t len, struct lws_jwk *jwk);

LWS_VISIBLE LWS_EXTERN int
lws_jws_sign_from_b64(const char *b64_hdr, size_t hdr_len, const char *b64_pay,
                      size_t pay_len, char *b64_sig, size_t sig_len,
                      enum lws_genhash_types hash_type, struct lws_jwk *jwk);

LWS_VISIBLE LWS_EXTERN int
lws_jws_create_packet(struct lws_jwk *jwk, const char *payload, size_t len,
                      const char *nonce, char *out, size_t out_len);

LWS_VISIBLE LWS_EXTERN int
lws_jws_base64_enc(const char *in, size_t in_len, char *out, size_t out_max);
#endif


/*
 * NOTE: These public enums are part of the abi.  If you want to add one,
 * add it at where specified so existing users are unaffected.
 */
enum lws_extension_callback_reasons {
        LWS_EXT_CB_CONSTRUCT                            =  4,
        LWS_EXT_CB_CLIENT_CONSTRUCT                     =  5,
        LWS_EXT_CB_DESTROY                              =  8,
        LWS_EXT_CB_PACKET_TX_PRESEND                    = 12,
        LWS_EXT_CB_PAYLOAD_TX                           = 21,
        LWS_EXT_CB_PAYLOAD_RX                           = 22,
        LWS_EXT_CB_OPTION_DEFAULT                       = 23,
        LWS_EXT_CB_OPTION_SET                           = 24,
        LWS_EXT_CB_OPTION_CONFIRM                       = 25,
        LWS_EXT_CB_NAMED_OPTION_SET                     = 26,

        /****** add new things just above ---^ ******/
};

enum lws_ext_options_types {
        EXTARG_NONE, 
        EXTARG_DEC,  
        EXTARG_OPT_DEC 
        /* Add new things just above here ---^
         * This is part of the ABI, don't needlessly break compatibility */
};

struct lws_ext_options {
        const char *name; 
        enum lws_ext_options_types type; 
        /* Add new things just above here ---^
         * This is part of the ABI, don't needlessly break compatibility */
};

struct lws_ext_option_arg {
        const char *option_name; 
        int option_index; 
        const char *start; 
        int len; 
};

typedef 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);

struct lws_extension {
        const char *name; 
        lws_extension_callback_function *callback; 
        const char *client_offer; 
        /* Add new things just above here ---^
         * This is part of the ABI, don't needlessly break compatibility */
};

LWS_VISIBLE LWS_EXTERN int
lws_set_extension_option(struct lws *wsi, const char *ext_name,
                         const char *opt_name, const char *opt_val);

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);

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);

/*
 * The internal exts are part of the public abi
 * If we add more extensions, publish the callback here  ------v
 */


struct lws_protocols {
        const char *name;
        lws_callback_function *callback;
        size_t per_session_data_size;
        size_t rx_buffer_size;
        unsigned int id;
        void *user; 
        size_t tx_packet_size;
        /* Add new things just above here ---^
         * This is part of the ABI, don't needlessly break compatibility */
};

LWS_VISIBLE LWS_EXTERN const struct lws_protocols *
lws_vhost_name_to_protocol(struct lws_vhost *vh, const char *name);

LWS_VISIBLE LWS_EXTERN const struct lws_protocols *
lws_get_protocol(struct lws *wsi);

LWS_VISIBLE LWS_EXTERN const struct lws_protocols *
lws_protocol_get(struct lws *wsi) LWS_WARN_DEPRECATED;

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 void *
lws_protocol_vh_priv_get(struct lws_vhost *vhost, const struct lws_protocols *prot);

LWS_VISIBLE LWS_EXTERN void *
lws_adjust_protocol_psds(struct lws *wsi, size_t new_size);

LWS_VISIBLE LWS_EXTERN int
lws_finalize_startup(struct lws_context *context);

LWS_VISIBLE LWS_EXTERN const struct lws_protocol_vhost_options *
lws_pvo_search(const struct lws_protocol_vhost_options *pvo, const char *name);

LWS_VISIBLE LWS_EXTERN int
lws_protocol_init(struct lws_context *context);

#ifdef LWS_WITH_PLUGINS

/* PLUGINS implies LIBUV */

#define LWS_PLUGIN_API_MAGIC 180

struct lws_plugin_capability {
        unsigned int api_magic; 
        const struct lws_protocols *protocols; 
        int count_protocols; 
        const struct lws_extension *extensions; 
        int count_extensions; 
};

typedef int (*lws_plugin_init_func)(struct lws_context *,
                                    struct lws_plugin_capability *);
typedef int (*lws_plugin_destroy_func)(struct lws_context *);

struct lws_plugin {
        struct lws_plugin *list; 
#if (UV_VERSION_MAJOR > 0)
        uv_lib_t lib; 
#else
        void *l; 
#endif
        char name[64]; 
        struct lws_plugin_capability caps; 
};

#endif




#define LWSGS_EMAIL_CONTENT_SIZE 16384

/* SHA-1 binary and hexified versions */
typedef struct { unsigned char bin[20]; } lwsgw_hash_bin;
typedef struct { char id[41];  } lwsgw_hash;

enum lwsgs_auth_bits {
        LWSGS_AUTH_LOGGED_IN = 1, 
        LWSGS_AUTH_ADMIN = 2,   
        LWSGS_AUTH_VERIFIED = 4,  
        LWSGS_AUTH_FORGOT_FLOW = 8,     
};

struct lws_session_info {
        char username[32]; 
        char email[100]; 
        char ip[72]; 
        unsigned int mask; 
        char session[42]; 
};

enum lws_gs_event {
        LWSGSE_CREATED, 
        LWSGSE_DELETED  
};

struct lws_gs_event_args {
        enum lws_gs_event event; 
        const char *username; 
        const char *email; 
};




/*
 * NOTE: These public enums are part of the abi.  If you want to add one,
 * add it at where specified so existing users are unaffected.
 */

enum lws_context_options {
        LWS_SERVER_OPTION_REQUIRE_VALID_OPENSSL_CLIENT_CERT     = (1 << 1) |
                                                                  (1 << 12),
        LWS_SERVER_OPTION_SKIP_SERVER_CANONICAL_NAME            = (1 << 2),
        LWS_SERVER_OPTION_ALLOW_NON_SSL_ON_SSL_PORT             = (1 << 3) |
                                                                  (1 << 12),
        LWS_SERVER_OPTION_LIBEV                                 = (1 << 4),
        LWS_SERVER_OPTION_DISABLE_IPV6                          = (1 << 5),
        LWS_SERVER_OPTION_DISABLE_OS_CA_CERTS                   = (1 << 6),
        LWS_SERVER_OPTION_PEER_CERT_NOT_REQUIRED                = (1 << 7),
        LWS_SERVER_OPTION_VALIDATE_UTF8                         = (1 << 8),
        LWS_SERVER_OPTION_SSL_ECDH                              = (1 << 9) |
                                                                  (1 << 12),
        LWS_SERVER_OPTION_LIBUV                                 = (1 << 10),
        LWS_SERVER_OPTION_REDIRECT_HTTP_TO_HTTPS                = (1 << 11) |
                                                                  (1 << 12),
        LWS_SERVER_OPTION_DO_SSL_GLOBAL_INIT                    = (1 << 12),
        LWS_SERVER_OPTION_EXPLICIT_VHOSTS                       = (1 << 13),
        LWS_SERVER_OPTION_UNIX_SOCK                             = (1 << 14),
        LWS_SERVER_OPTION_STS                                   = (1 << 15),
        LWS_SERVER_OPTION_IPV6_V6ONLY_MODIFY                    = (1 << 16),
        LWS_SERVER_OPTION_IPV6_V6ONLY_VALUE                     = (1 << 17),
        LWS_SERVER_OPTION_UV_NO_SIGSEGV_SIGFPE_SPIN             = (1 << 18),
        LWS_SERVER_OPTION_JUST_USE_RAW_ORIGIN                   = (1 << 19),
        LWS_SERVER_OPTION_FALLBACK_TO_RAW                       = (1 << 20),
        LWS_SERVER_OPTION_LIBEVENT                              = (1 << 21),
        LWS_SERVER_OPTION_ONLY_RAW                              = (1 << 22),
        LWS_SERVER_OPTION_ALLOW_LISTEN_SHARE                    = (1 << 23),
        LWS_SERVER_OPTION_CREATE_VHOST_SSL_CTX                  = (1 << 24),
        LWS_SERVER_OPTION_SKIP_PROTOCOL_INIT                    = (1 << 25),
        LWS_SERVER_OPTION_IGNORE_MISSING_CERT                   = (1 << 26),
        /****** add new things just above ---^ ******/
};

#define lws_check_opt(c, f) (((c) & (f)) == (f))

struct lws_plat_file_ops;

struct lws_context_creation_info {
        int port;
        const char *iface;
        const struct lws_protocols *protocols;
        const struct lws_extension *extensions;
        const struct lws_token_limits *token_limits;
        const char *ssl_private_key_password;
        const char *ssl_cert_filepath;
        const char *ssl_private_key_filepath;
        const char *ssl_ca_filepath;
        const char *ssl_cipher_list;
        const char *http_proxy_address;
        unsigned int http_proxy_port;
        int gid;
        int uid;
        unsigned int options;
        void *user;
        int ka_time;
        int ka_probes;
        int ka_interval;
#if defined(LWS_WITH_TLS) && !defined(LWS_WITH_MBEDTLS)
        SSL_CTX *provided_client_ssl_ctx;
#else /* maintain structure layout either way */
        void *provided_client_ssl_ctx; 
#endif

        short max_http_header_data;
        short max_http_header_pool;
        unsigned int count_threads;
        unsigned int fd_limit_per_thread;
        unsigned int timeout_secs;
        const char *ecdh_curve;
        const char *vhost_name;
        const char * const *plugin_dirs;
        const struct lws_protocol_vhost_options *pvo;
        int keepalive_timeout;
        const char *log_filepath;
        const struct lws_http_mount *mounts;
        const char *server_string;
        unsigned int pt_serv_buf_size;
        unsigned int max_http_header_data2;
        long ssl_options_set;
        long ssl_options_clear;
        unsigned short ws_ping_pong_interval;
        const struct lws_protocol_vhost_options *headers;
        const struct lws_protocol_vhost_options *reject_service_keywords;
        void *external_baggage_free_on_destroy;
        const char *client_ssl_private_key_password;
        const char *client_ssl_cert_filepath;
        const char *client_ssl_private_key_filepath;
        const char *client_ssl_ca_filepath;
        const char *client_ssl_cipher_list;
        const struct lws_plat_file_ops *fops;
        int simultaneous_ssl_restriction;
        const char *socks_proxy_address;
        unsigned int socks_proxy_port;
#if defined(LWS_HAVE_SYS_CAPABILITY_H) && defined(LWS_HAVE_LIBCAP)
        cap_value_t caps[4];
        char count_caps;
#endif
        int bind_iface;
        int ssl_info_event_mask;
        unsigned int timeout_secs_ah_idle;
        unsigned short ip_limit_ah;
        unsigned short ip_limit_wsi;
        uint32_t        http2_settings[7];
        const char *error_document_404;
        const char *alpn;
        void **foreign_loops;
        void (*signal_cb)(void *event_lib_handle, int signum);
        /* Add new things just above here ---^
         * This is part of the ABI, don't needlessly break compatibility
         *
         * The below is to ensure later library versions with new
         * members added above will see 0 (default) even if the app
         * was not built against the newer headers.
         */
        struct lws_context **pcontext;
        void *_unused[4]; 
};

LWS_VISIBLE LWS_EXTERN struct lws_context *
lws_create_context(const struct lws_context_creation_info *info);


LWS_VISIBLE LWS_EXTERN void
lws_context_destroy(struct lws_context *context);

typedef int (*lws_reload_func)(void);

LWS_VISIBLE LWS_EXTERN void
lws_context_deprecate(struct lws_context *context, lws_reload_func cb);

LWS_VISIBLE LWS_EXTERN int
lws_context_is_deprecated(struct lws_context *context);

LWS_VISIBLE LWS_EXTERN int
lws_set_proxy(struct lws_vhost *vhost, const char *proxy);

LWS_VISIBLE LWS_EXTERN int
lws_set_socks(struct lws_vhost *vhost, const char *socks);

struct lws_vhost;

LWS_VISIBLE LWS_EXTERN struct lws_vhost *
lws_create_vhost(struct lws_context *context,
                 const struct lws_context_creation_info *info);

LWS_VISIBLE LWS_EXTERN void
lws_vhost_destroy(struct lws_vhost *vh);

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 int
lwsws_get_config_vhosts(struct lws_context *context,
                        struct lws_context_creation_info *info, const char *d,
                        char **config_strings, int *len);

LWS_VISIBLE LWS_EXTERN struct lws_vhost *
lws_vhost_get(struct lws *wsi) LWS_WARN_DEPRECATED;

LWS_VISIBLE LWS_EXTERN struct lws_vhost *
lws_get_vhost(struct lws *wsi);

LWS_VISIBLE LWS_EXTERN const char *
lws_get_vhost_name(struct lws_vhost *vhost);

LWS_VISIBLE LWS_EXTERN int
lws_get_vhost_port(struct lws_vhost *vhost);

LWS_VISIBLE LWS_EXTERN void *
lws_get_vhost_user(struct lws_vhost *vhost);

LWS_VISIBLE LWS_EXTERN const char *
lws_get_vhost_iface(struct lws_vhost *vhost);

LWS_VISIBLE LWS_EXTERN int
lws_json_dump_vhost(const struct lws_vhost *vh, char *buf, int len);

LWS_VISIBLE LWS_EXTERN int
lws_json_dump_context(const struct lws_context *context, char *buf, int len,
                      int hide_vhosts);

LWS_VISIBLE LWS_EXTERN void *
lws_vhost_user(struct lws_vhost *vhost);

LWS_VISIBLE LWS_EXTERN void *
lws_context_user(struct lws_context *context);


struct lws_protocol_vhost_options {
        const struct lws_protocol_vhost_options *next; 
        const struct lws_protocol_vhost_options *options; 
        const char *name; 
        const char *value; 
};

enum lws_mount_protocols {
        LWSMPRO_HTTP            = 0, 
        LWSMPRO_HTTPS           = 1, 
        LWSMPRO_FILE            = 2, 
        LWSMPRO_CGI             = 3, 
        LWSMPRO_REDIR_HTTP      = 4, 
        LWSMPRO_REDIR_HTTPS     = 5, 
        LWSMPRO_CALLBACK        = 6, 
};

struct lws_http_mount {
        const struct lws_http_mount *mount_next;
        const char *mountpoint;
        const char *origin;
        const char *def;
        const char *protocol;
        const struct lws_protocol_vhost_options *cgienv;
        const struct lws_protocol_vhost_options *extra_mimetypes;
        const struct lws_protocol_vhost_options *interpret;
        int cgi_timeout;
        int cache_max_age;
        unsigned int auth_mask;
        unsigned int cache_reusable:1; 
        unsigned int cache_revalidate:1; 
        unsigned int cache_intermediaries:1; 
        unsigned char origin_protocol; 
        unsigned char mountpoint_len; 
        const char *basic_auth_login_file;
        /* Add new things just above here ---^
         * This is part of the ABI, don't needlessly break compatibility
         *
         * The below is to ensure later library versions with new
         * members added above will see 0 (default) even if the app
         * was not built against the newer headers.
         */

        void *_unused[2]; 
};


enum lws_client_connect_ssl_connection_flags {
        LCCSCF_USE_SSL                          = (1 << 0),
        LCCSCF_ALLOW_SELFSIGNED                 = (1 << 1),
        LCCSCF_SKIP_SERVER_CERT_HOSTNAME_CHECK  = (1 << 2),
        LCCSCF_ALLOW_EXPIRED                    = (1 << 3),

        LCCSCF_PIPELINE                         = (1 << 16),
};

struct lws_client_connect_info {
        struct lws_context *context;
        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;
        const void *client_exts;
        const char *method;
        struct lws *parent_wsi;
        const char *uri_replace_from;
        const char *uri_replace_to;
        struct lws_vhost *vhost;
        struct lws **pwsi;
        const char *iface;
        const char *local_protocol_name;
        /* Add new things just above here ---^
         * This is part of the ABI, don't needlessly break compatibility
         *
         * The below is to ensure later library versions with new
         * members added above will see 0 (default) even if the app
         * was not built against the newer headers.
         */
        const char *alpn;
        /* NULL: allow lws default ALPN list, from vhost if present or from
         *       list of roles built into lws
         * non-NULL: require one from provided comma-separated list of alpn
         *           tokens
         */

        void *_unused[4]; 
};

LWS_VISIBLE LWS_EXTERN struct lws *
lws_client_connect_via_info(struct lws_client_connect_info * ccinfo);

/* deprecated, use lws_client_connect_via_info() */
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;
/* deprecated, use lws_client_connect_via_info() */
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;

LWS_VISIBLE LWS_EXTERN int
lws_init_vhost_client_ssl(const struct lws_context_creation_info *info,
                          struct lws_vhost *vhost);
LWS_VISIBLE LWS_EXTERN int
lws_http_client_read(struct lws *wsi, char **buf, int *len);

LWS_VISIBLE LWS_EXTERN unsigned int
lws_http_client_http_response(struct lws *wsi);

LWS_VISIBLE LWS_EXTERN void
lws_client_http_body_pending(struct lws *wsi, int something_left_to_send);



LWS_VISIBLE LWS_EXTERN int
lws_service(struct lws_context *context, int timeout_ms);

LWS_VISIBLE LWS_EXTERN int
lws_service_tsi(struct lws_context *context, int timeout_ms, int tsi);

LWS_VISIBLE LWS_EXTERN void
lws_cancel_service_pt(struct lws *wsi);

LWS_VISIBLE LWS_EXTERN void
lws_cancel_service(struct lws_context *context);

LWS_VISIBLE LWS_EXTERN int
lws_service_fd(struct lws_context *context, struct lws_pollfd *pollfd);

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);

/* Backwards compatibility */
#define lws_plat_service_tsi lws_service_tsi

LWS_VISIBLE LWS_EXTERN int
lws_handle_POLLOUT_event(struct lws *wsi, struct lws_pollfd *pollfd);




LWS_VISIBLE LWS_EXTERN const char *
lws_get_mimetype(const char *file, const struct lws_http_mount *m);

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 int
lws_serve_http_file_fragment(struct lws *wsi);


enum http_status {
        HTTP_STATUS_CONTINUE                                    = 100,

        HTTP_STATUS_OK                                          = 200,
        HTTP_STATUS_NO_CONTENT                                  = 204,
        HTTP_STATUS_PARTIAL_CONTENT                             = 206,

        HTTP_STATUS_MOVED_PERMANENTLY                           = 301,
        HTTP_STATUS_FOUND                                       = 302,
        HTTP_STATUS_SEE_OTHER                                   = 303,
        HTTP_STATUS_NOT_MODIFIED                                = 304,

        HTTP_STATUS_BAD_REQUEST                                 = 400,
        HTTP_STATUS_UNAUTHORIZED,
        HTTP_STATUS_PAYMENT_REQUIRED,
        HTTP_STATUS_FORBIDDEN,
        HTTP_STATUS_NOT_FOUND,
        HTTP_STATUS_METHOD_NOT_ALLOWED,
        HTTP_STATUS_NOT_ACCEPTABLE,
        HTTP_STATUS_PROXY_AUTH_REQUIRED,
        HTTP_STATUS_REQUEST_TIMEOUT,
        HTTP_STATUS_CONFLICT,
        HTTP_STATUS_GONE,
        HTTP_STATUS_LENGTH_REQUIRED,
        HTTP_STATUS_PRECONDITION_FAILED,
        HTTP_STATUS_REQ_ENTITY_TOO_LARGE,
        HTTP_STATUS_REQ_URI_TOO_LONG,
        HTTP_STATUS_UNSUPPORTED_MEDIA_TYPE,
        HTTP_STATUS_REQ_RANGE_NOT_SATISFIABLE,
        HTTP_STATUS_EXPECTATION_FAILED,

        HTTP_STATUS_INTERNAL_SERVER_ERROR                       = 500,
        HTTP_STATUS_NOT_IMPLEMENTED,
        HTTP_STATUS_BAD_GATEWAY,
        HTTP_STATUS_SERVICE_UNAVAILABLE,
        HTTP_STATUS_GATEWAY_TIMEOUT,
        HTTP_STATUS_HTTP_VERSION_NOT_SUPPORTED,
};

struct lws_process_html_args {
        char *p; 
        int len; 
        int max_len; 
        int final; 
        int chunked; 
};

typedef const char *(*lws_process_html_state_cb)(void *data, int index);

struct lws_process_html_state {
        char *start; 
        char swallow[16]; 
        int pos; 
        void *data; 
        const char * const *vars; 
        int count_vars; 
        lws_process_html_state_cb replace; 
};

LWS_VISIBLE LWS_EXTERN int
lws_chunked_html_process(struct lws_process_html_args *args,
                         struct lws_process_html_state *s);


struct lws_tokens {
        char *token; 
        int len; 
};

/* enum lws_token_indexes
 * these have to be kept in sync with lextable.h / minilex.c
 *
 * NOTE: These public enums are part of the abi.  If you want to add one,
 * add it at where specified so existing users are unaffected.
 */
enum lws_token_indexes {
        WSI_TOKEN_GET_URI                                       =  0,
        WSI_TOKEN_POST_URI                                      =  1,
        WSI_TOKEN_OPTIONS_URI                                   =  2,
        WSI_TOKEN_HOST                                          =  3,
        WSI_TOKEN_CONNECTION                                    =  4,
        WSI_TOKEN_UPGRADE                                       =  5,
        WSI_TOKEN_ORIGIN                                        =  6,
        WSI_TOKEN_DRAFT                                         =  7,
        WSI_TOKEN_CHALLENGE                                     =  8,
        WSI_TOKEN_EXTENSIONS                                    =  9,
        WSI_TOKEN_KEY1                                          = 10,
        WSI_TOKEN_KEY2                                          = 11,
        WSI_TOKEN_PROTOCOL                                      = 12,
        WSI_TOKEN_ACCEPT                                        = 13,
        WSI_TOKEN_NONCE                                         = 14,
        WSI_TOKEN_HTTP                                          = 15,
        WSI_TOKEN_HTTP2_SETTINGS                                = 16,
        WSI_TOKEN_HTTP_ACCEPT                                   = 17,
        WSI_TOKEN_HTTP_AC_REQUEST_HEADERS                       = 18,
        WSI_TOKEN_HTTP_IF_MODIFIED_SINCE                        = 19,
        WSI_TOKEN_HTTP_IF_NONE_MATCH                            = 20,
        WSI_TOKEN_HTTP_ACCEPT_ENCODING                          = 21,
        WSI_TOKEN_HTTP_ACCEPT_LANGUAGE                          = 22,
        WSI_TOKEN_HTTP_PRAGMA                                   = 23,
        WSI_TOKEN_HTTP_CACHE_CONTROL                            = 24,
        WSI_TOKEN_HTTP_AUTHORIZATION                            = 25,
        WSI_TOKEN_HTTP_COOKIE                                   = 26,
        WSI_TOKEN_HTTP_CONTENT_LENGTH                           = 27,
        WSI_TOKEN_HTTP_CONTENT_TYPE                             = 28,
        WSI_TOKEN_HTTP_DATE                                     = 29,
        WSI_TOKEN_HTTP_RANGE                                    = 30,
        WSI_TOKEN_HTTP_REFERER                                  = 31,
        WSI_TOKEN_KEY                                           = 32,
        WSI_TOKEN_VERSION                                       = 33,
        WSI_TOKEN_SWORIGIN                                      = 34,

        WSI_TOKEN_HTTP_COLON_AUTHORITY                          = 35,
        WSI_TOKEN_HTTP_COLON_METHOD                             = 36,
        WSI_TOKEN_HTTP_COLON_PATH                               = 37,
        WSI_TOKEN_HTTP_COLON_SCHEME                             = 38,
        WSI_TOKEN_HTTP_COLON_STATUS                             = 39,

        WSI_TOKEN_HTTP_ACCEPT_CHARSET                           = 40,
        WSI_TOKEN_HTTP_ACCEPT_RANGES                            = 41,
        WSI_TOKEN_HTTP_ACCESS_CONTROL_ALLOW_ORIGIN              = 42,
        WSI_TOKEN_HTTP_AGE                                      = 43,
        WSI_TOKEN_HTTP_ALLOW                                    = 44,
        WSI_TOKEN_HTTP_CONTENT_DISPOSITION                      = 45,
        WSI_TOKEN_HTTP_CONTENT_ENCODING                         = 46,
        WSI_TOKEN_HTTP_CONTENT_LANGUAGE                         = 47,
        WSI_TOKEN_HTTP_CONTENT_LOCATION                         = 48,
        WSI_TOKEN_HTTP_CONTENT_RANGE                            = 49,
        WSI_TOKEN_HTTP_ETAG                                     = 50,
        WSI_TOKEN_HTTP_EXPECT                                   = 51,
        WSI_TOKEN_HTTP_EXPIRES                                  = 52,
        WSI_TOKEN_HTTP_FROM                                     = 53,
        WSI_TOKEN_HTTP_IF_MATCH                                 = 54,
        WSI_TOKEN_HTTP_IF_RANGE                                 = 55,
        WSI_TOKEN_HTTP_IF_UNMODIFIED_SINCE                      = 56,
        WSI_TOKEN_HTTP_LAST_MODIFIED                            = 57,
        WSI_TOKEN_HTTP_LINK                                     = 58,
        WSI_TOKEN_HTTP_LOCATION                                 = 59,
        WSI_TOKEN_HTTP_MAX_FORWARDS                             = 60,
        WSI_TOKEN_HTTP_PROXY_AUTHENTICATE                       = 61,
        WSI_TOKEN_HTTP_PROXY_AUTHORIZATION                      = 62,
        WSI_TOKEN_HTTP_REFRESH                                  = 63,
        WSI_TOKEN_HTTP_RETRY_AFTER                              = 64,
        WSI_TOKEN_HTTP_SERVER                                   = 65,
        WSI_TOKEN_HTTP_SET_COOKIE                               = 66,
        WSI_TOKEN_HTTP_STRICT_TRANSPORT_SECURITY                = 67,
        WSI_TOKEN_HTTP_TRANSFER_ENCODING                        = 68,
        WSI_TOKEN_HTTP_USER_AGENT                               = 69,
        WSI_TOKEN_HTTP_VARY                                     = 70,
        WSI_TOKEN_HTTP_VIA                                      = 71,
        WSI_TOKEN_HTTP_WWW_AUTHENTICATE                         = 72,

        WSI_TOKEN_PATCH_URI                                     = 73,
        WSI_TOKEN_PUT_URI                                       = 74,
        WSI_TOKEN_DELETE_URI                                    = 75,

        WSI_TOKEN_HTTP_URI_ARGS                                 = 76,
        WSI_TOKEN_PROXY                                         = 77,
        WSI_TOKEN_HTTP_X_REAL_IP                                = 78,
        WSI_TOKEN_HTTP1_0                                       = 79,
        WSI_TOKEN_X_FORWARDED_FOR                               = 80,
        WSI_TOKEN_CONNECT                                       = 81,
        WSI_TOKEN_HEAD_URI                                      = 82,
        WSI_TOKEN_TE                                            = 83,
        WSI_TOKEN_REPLAY_NONCE                                  = 84,
        WSI_TOKEN_COLON_PROTOCOL                                = 85,
        WSI_TOKEN_X_AUTH_TOKEN                                  = 86,

        /****** add new things just above ---^ ******/

        /* use token storage to stash these internally, not for
         * user use */

        _WSI_TOKEN_CLIENT_SENT_PROTOCOLS,
        _WSI_TOKEN_CLIENT_PEER_ADDRESS,
        _WSI_TOKEN_CLIENT_URI,
        _WSI_TOKEN_CLIENT_HOST,
        _WSI_TOKEN_CLIENT_ORIGIN,
        _WSI_TOKEN_CLIENT_METHOD,
        _WSI_TOKEN_CLIENT_IFACE,
        _WSI_TOKEN_CLIENT_ALPN,

        /* always last real token index*/
        WSI_TOKEN_COUNT,

        /* parser state additions, no storage associated */
        WSI_TOKEN_NAME_PART,
        WSI_TOKEN_SKIPPING,
        WSI_TOKEN_SKIPPING_SAW_CR,
        WSI_PARSING_COMPLETE,
        WSI_INIT_TOKEN_MUXURL,
};

struct lws_token_limits {
        unsigned short token_limit[WSI_TOKEN_COUNT]; 
};

LWS_VISIBLE LWS_EXTERN const unsigned char *
lws_token_to_string(enum lws_token_indexes token);

LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
lws_hdr_total_length(struct lws *wsi, enum lws_token_indexes h);

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_hdr_copy(struct lws *wsi, char *dest, int len, enum lws_token_indexes h);

LWS_VISIBLE LWS_EXTERN int
lws_hdr_copy_fragment(struct lws *wsi, char *dest, int len,
                      enum lws_token_indexes h, int frag_idx);

LWS_VISIBLE LWS_EXTERN const char *
lws_get_urlarg_by_name(struct lws *wsi, const char *name, char *buf, int len);


#define LWSAHH_CODE_MASK                        ((1 << 16) - 1)
#define LWSAHH_FLAG_NO_SERVER_NAME              (1 << 30)

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 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);
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);
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
lws_add_http_header_content_length(struct lws *wsi,
                                   lws_filepos_t content_length,
                                   unsigned char **p, unsigned char *end);
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
lws_finalize_http_header(struct lws *wsi, unsigned char **p,
                         unsigned char *end);

LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
lws_finalize_write_http_header(struct lws *wsi, unsigned char *start,
                               unsigned char **p, unsigned char *end);

#define LWS_ILLEGAL_HTTP_CONTENT_LEN ((lws_filepos_t)-1ll)

LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
lws_add_http_common_headers(struct lws *wsi, unsigned int code,
                            const char *content_type, lws_filepos_t content_len,
                            unsigned char **p, unsigned char *end);


enum lws_spa_fileupload_states {
        LWS_UFS_CONTENT,
        LWS_UFS_FINAL_CONTENT,
        LWS_UFS_OPEN
};

typedef int (*lws_spa_fileupload_cb)(void *data, const char *name,
                        const char *filename, char *buf, int len,
                        enum lws_spa_fileupload_states state);

struct lws_spa;

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 int
lws_spa_process(struct lws_spa *spa, const char *in, int len);

LWS_VISIBLE LWS_EXTERN int
lws_spa_finalize(struct lws_spa *spa);

LWS_VISIBLE LWS_EXTERN int
lws_spa_get_length(struct lws_spa *spa, int n);

LWS_VISIBLE LWS_EXTERN const char *
lws_spa_get_string(struct lws_spa *spa, int n);

LWS_VISIBLE LWS_EXTERN int
lws_spa_destroy(struct lws_spa *spa);


LWS_VISIBLE LWS_EXTERN const char *
lws_urlencode(char *escaped, const char *string, int len);

/*
 * URLDECODE 1 / 2
 *
 * This simple urldecode only operates until the first '\0' and requires the
 * data to exist all at once
 */
LWS_VISIBLE LWS_EXTERN int
lws_urldecode(char *string, const char *escaped, int len);

LWS_VISIBLE LWS_EXTERN int
lws_return_http_status(struct lws *wsi, unsigned int code,
                       const char *html_body);

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);

LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
lws_http_transaction_completed(struct lws *wsi);


LWS_VISIBLE LWS_EXTERN const char *
lws_sql_purify(char *escaped, const char *string, int len);

LWS_VISIBLE LWS_EXTERN const char *
lws_json_purify(char *escaped, const char *string, int len);

LWS_VISIBLE LWS_EXTERN void
lws_filename_purify_inplace(char *filename);

LWS_VISIBLE LWS_EXTERN int
lws_plat_write_cert(struct lws_vhost *vhost, int is_key, int fd, void *buf,
                        int len);
LWS_VISIBLE LWS_EXTERN int
lws_plat_write_file(const char *filename, void *buf, int len);

LWS_VISIBLE LWS_EXTERN int
lws_plat_read_file(const char *filename, void *buf, int len);

LWS_VISIBLE LWS_EXTERN int
lws_plat_recommended_rsa_bits(void);

#ifdef LWS_WITH_LIBUV
/*
 * Any direct libuv allocations in lws protocol handlers must participate in the
 * lws reference counting scheme.  Two apis are provided:
 *
 * - lws_libuv_static_refcount_add(handle, context) to mark the handle with
 *  a pointer to the context and increment the global uv object counter
 *
 * - lws_libuv_static_refcount_del() which should be used as the close callback
 *   for your own libuv objects declared in the protocol scope.
 *
 * Using the apis allows lws to detach itself from a libuv loop completely
 * cleanly and at the moment all of its libuv objects have completed close.
 */

LWS_VISIBLE LWS_EXTERN uv_loop_t *
lws_uv_getloop(struct lws_context *context, int tsi);

LWS_VISIBLE LWS_EXTERN void
lws_libuv_static_refcount_add(uv_handle_t *, struct lws_context *context);

LWS_VISIBLE LWS_EXTERN void
lws_libuv_static_refcount_del(uv_handle_t *);

#endif /* LWS_WITH_LIBUV */

#if defined(LWS_WITH_ESP32)
#define lws_libuv_static_refcount_add(_a, _b)
#define lws_libuv_static_refcount_del NULL
#endif



/*
 * NOTE: These public enums are part of the abi.  If you want to add one,
 * add it at where specified so existing users are unaffected.
 */
enum pending_timeout {
        NO_PENDING_TIMEOUT                                      =  0,
        PENDING_TIMEOUT_AWAITING_PROXY_RESPONSE                 =  1,
        PENDING_TIMEOUT_AWAITING_CONNECT_RESPONSE               =  2,
        PENDING_TIMEOUT_ESTABLISH_WITH_SERVER                   =  3,
        PENDING_TIMEOUT_AWAITING_SERVER_RESPONSE                =  4,
        PENDING_TIMEOUT_AWAITING_PING                           =  5,
        PENDING_TIMEOUT_CLOSE_ACK                               =  6,
        PENDING_TIMEOUT_UNUSED1                                 =  7,
        PENDING_TIMEOUT_SENT_CLIENT_HANDSHAKE                   =  8,
        PENDING_TIMEOUT_SSL_ACCEPT                              =  9,
        PENDING_TIMEOUT_HTTP_CONTENT                            = 10,
        PENDING_TIMEOUT_AWAITING_CLIENT_HS_SEND                 = 11,
        PENDING_FLUSH_STORED_SEND_BEFORE_CLOSE                  = 12,
        PENDING_TIMEOUT_SHUTDOWN_FLUSH                          = 13,
        PENDING_TIMEOUT_CGI                                     = 14,
        PENDING_TIMEOUT_HTTP_KEEPALIVE_IDLE                     = 15,
        PENDING_TIMEOUT_WS_PONG_CHECK_SEND_PING                 = 16,
        PENDING_TIMEOUT_WS_PONG_CHECK_GET_PONG                  = 17,
        PENDING_TIMEOUT_CLIENT_ISSUE_PAYLOAD                    = 18,
        PENDING_TIMEOUT_AWAITING_SOCKS_GREETING_REPLY           = 19,
        PENDING_TIMEOUT_AWAITING_SOCKS_CONNECT_REPLY            = 20,
        PENDING_TIMEOUT_AWAITING_SOCKS_AUTH_REPLY               = 21,
        PENDING_TIMEOUT_KILLED_BY_SSL_INFO                      = 22,
        PENDING_TIMEOUT_KILLED_BY_PARENT                        = 23,
        PENDING_TIMEOUT_CLOSE_SEND                              = 24,
        PENDING_TIMEOUT_HOLDING_AH                              = 25,
        PENDING_TIMEOUT_UDP_IDLE                                = 26,
        PENDING_TIMEOUT_CLIENT_CONN_IDLE                        = 27,
        PENDING_TIMEOUT_LAGGING                                 = 28,

        /****** add new things just above ---^ ******/

        PENDING_TIMEOUT_USER_REASON_BASE                        = 1000
};

#define LWS_TO_KILL_ASYNC -1

#define LWS_TO_KILL_SYNC -2

LWS_VISIBLE LWS_EXTERN void
lws_set_timeout(struct lws *wsi, enum pending_timeout reason, int secs);

#define LWS_SET_TIMER_USEC_CANCEL ((lws_usec_t)-1ll)
#define LWS_USEC_PER_SEC (1000000ll)

LWS_VISIBLE LWS_EXTERN void
lws_set_timer_usecs(struct lws *wsi, lws_usec_t usecs);

/*
 * lws_timed_callback_vh_protocol() - calls back a protocol on a vhost after
 *                                      the specified delay
 *
 * \param vh:    the vhost to call back
 * \param protocol: the protocol to call back
 * \param reason: callback reason
 * \param secs: how many seconds in the future to do the callback.  Set to
 *              -1 to cancel the timer callback.
 *
 * Callback the specified protocol with a fake wsi pointing to the specified
 * vhost and protocol, with the specified reason, at the specified time in the
 * future.
 *
 * Returns 0 if OK.
 */
LWS_VISIBLE LWS_EXTERN int
lws_timed_callback_vh_protocol(struct lws_vhost *vh,
                               const struct lws_protocols *prot,
                               int reason, int secs);

#if !defined(LWS_SIZEOFPTR)
#define LWS_SIZEOFPTR ((int)sizeof (void *))
#endif

#if defined(__x86_64__)
#define _LWS_PAD_SIZE 16        /* Intel recommended for best performance */
#else
#define _LWS_PAD_SIZE LWS_SIZEOFPTR   /* Size of a pointer on the target arch */
#endif
#define _LWS_PAD(n) (((n) % _LWS_PAD_SIZE) ? \
                ((n) + (_LWS_PAD_SIZE - ((n) % _LWS_PAD_SIZE))) : (n))
/* last 2 is for lws-meta */
#define LWS_PRE _LWS_PAD(4 + 10 + 2)
/* used prior to 1.7 and retained for backward compatibility */
#define LWS_SEND_BUFFER_PRE_PADDING LWS_PRE
#define LWS_SEND_BUFFER_POST_PADDING 0

#define LWS_WRITE_RAW LWS_WRITE_HTTP

/*
 * NOTE: These public enums are part of the abi.  If you want to add one,
 * add it at where specified so existing users are unaffected.
 */
enum lws_write_protocol {
        LWS_WRITE_TEXT                                          = 0,
        LWS_WRITE_BINARY                                        = 1,
        LWS_WRITE_CONTINUATION                                  = 2,
        LWS_WRITE_HTTP                                          = 3,
        /* LWS_WRITE_CLOSE is handled by lws_close_reason() */
        LWS_WRITE_PING                                          = 5,
        LWS_WRITE_PONG                                          = 6,

        /* Same as write_http but we know this write ends the transaction */
        LWS_WRITE_HTTP_FINAL                                    = 7,

        /* HTTP2 */

        LWS_WRITE_HTTP_HEADERS                                  = 8,
        LWS_WRITE_HTTP_HEADERS_CONTINUATION                     = 9,
        /****** add new things just above ---^ ******/

        /* flags */

        LWS_WRITE_NO_FIN = 0x40,
        LWS_WRITE_H2_STREAM_END = 0x80,
        LWS_WRITE_CLIENT_IGNORE_XOR_MASK = 0x80
};

/* used with LWS_CALLBACK_CHILD_WRITE_VIA_PARENT */

struct lws_write_passthru {
        struct lws *wsi;
        unsigned char *buf;
        size_t len;
        enum lws_write_protocol wp;
};


LWS_VISIBLE LWS_EXTERN int
lws_write(struct lws *wsi, unsigned char *buf, size_t len,
          enum lws_write_protocol protocol);

/* helper for case where buffer may be const */
#define lws_write_http(wsi, buf, len) \
        lws_write(wsi, (unsigned char *)(buf), len, LWS_WRITE_HTTP)

/* helper for multi-frame ws message flags */
static LWS_INLINE int
lws_write_ws_flags(int initial, int is_start, int is_end)
{
        int r;

        if (is_start)
                r = initial;
        else
                r = LWS_WRITE_CONTINUATION;

        if (!is_end)
                r |= LWS_WRITE_NO_FIN;

        return r;
}


LWS_VISIBLE LWS_EXTERN int
lws_callback_on_writable(struct lws *wsi);

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 int
lws_callback_on_writable_all_protocol_vhost(const struct lws_vhost *vhost,
                                      const struct lws_protocols *protocol);

LWS_VISIBLE LWS_EXTERN int
lws_callback_all_protocol(struct lws_context *context,
                          const struct lws_protocols *protocol, int reason);

LWS_VISIBLE LWS_EXTERN int
lws_callback_all_protocol_vhost(struct lws_vhost *vh,
                          const struct lws_protocols *protocol, int reason)
LWS_WARN_DEPRECATED;

LWS_VISIBLE int
lws_callback_all_protocol_vhost_args(struct lws_vhost *vh,
                          const struct lws_protocols *protocol, int reason,
                          void *argp, size_t len);

LWS_VISIBLE LWS_EXTERN int
lws_callback_vhost_protocols(struct lws *wsi, int reason, void *in, int len)
LWS_WARN_DEPRECATED;

LWS_VISIBLE LWS_EXTERN int
lws_callback_vhost_protocols_vhost(struct lws_vhost *vh, int reason, void *in,
                                   size_t len);

LWS_VISIBLE LWS_EXTERN int
lws_callback_http_dummy(struct lws *wsi, enum lws_callback_reasons reason,
                    void *user, void *in, size_t len);

LWS_VISIBLE LWS_EXTERN lws_sockfd_type
lws_get_socket_fd(struct lws *wsi);

LWS_VISIBLE LWS_EXTERN lws_fileofs_t
lws_get_peer_write_allowance(struct lws *wsi);

enum {
        /*
         * Flags for enable and disable rxflow with reason bitmap and with
         * backwards-compatible single bool
         */
        LWS_RXFLOW_REASON_USER_BOOL             = (1 << 0),
        LWS_RXFLOW_REASON_HTTP_RXBUFFER         = (1 << 6),
        LWS_RXFLOW_REASON_H2_PPS_PENDING        = (1 << 7),

        LWS_RXFLOW_REASON_APPLIES               = (1 << 14),
        LWS_RXFLOW_REASON_APPLIES_ENABLE_BIT    = (1 << 13),
        LWS_RXFLOW_REASON_APPLIES_ENABLE        = LWS_RXFLOW_REASON_APPLIES |
                                                  LWS_RXFLOW_REASON_APPLIES_ENABLE_BIT,
        LWS_RXFLOW_REASON_APPLIES_DISABLE       = LWS_RXFLOW_REASON_APPLIES,
        LWS_RXFLOW_REASON_FLAG_PROCESS_NOW      = (1 << 12),

};

LWS_VISIBLE LWS_EXTERN int
lws_rx_flow_control(struct lws *wsi, int enable);

LWS_VISIBLE LWS_EXTERN void
lws_rx_flow_allow_all_protocol(const struct lws_context *context,
                               const struct lws_protocols *protocol);

LWS_VISIBLE LWS_EXTERN size_t
lws_remaining_packet_payload(struct lws *wsi);



LWS_VISIBLE LWS_EXTERN struct lws *
lws_adopt_socket(struct lws_context *context, lws_sockfd_type accept_fd);
LWS_VISIBLE LWS_EXTERN struct lws *
lws_adopt_socket_vhost(struct lws_vhost *vh, lws_sockfd_type accept_fd);

typedef enum {
        LWS_ADOPT_RAW_FILE_DESC = 0,    /* convenience constant */
        LWS_ADOPT_HTTP = 1,             /* flag: absent implies RAW */
        LWS_ADOPT_SOCKET = 2,           /* flag: absent implies file descr */
        LWS_ADOPT_ALLOW_SSL = 4,        /* flag: if set requires LWS_ADOPT_SOCKET */
        LWS_ADOPT_WS_PARENTIO = 8,      /* flag: ws mode parent handles IO
                                         *   if given must be only flag
                                         *   wsi put directly into ws mode */
        LWS_ADOPT_FLAG_UDP = 16,        /* flag: socket is UDP */

        LWS_ADOPT_RAW_SOCKET_UDP = LWS_ADOPT_SOCKET | LWS_ADOPT_FLAG_UDP,
} lws_adoption_type;

typedef union {
        lws_sockfd_type sockfd;
        lws_filefd_type filefd;
} lws_sock_file_fd_type;

#if !defined(LWS_WITH_ESP32)
struct lws_udp {
        struct sockaddr sa;
        socklen_t salen;

        struct sockaddr sa_pending;
        socklen_t salen_pending;
};
#endif

/*
* lws_adopt_descriptor_vhost() - adopt foreign socket or file descriptor
* if socket descriptor, should already have been accepted from listen socket
*
* \param vhost: lws vhost
* \param type: OR-ed combinations of lws_adoption_type flags
* \param fd: union with either .sockfd or .filefd set
* \param vh_prot_name: NULL or vh protocol name to bind raw connection to
* \param parent: NULL or struct lws to attach new_wsi to as a child
*
* Either returns new wsi bound to accept_fd, or closes accept_fd and
* returns NULL, having cleaned up any new wsi pieces.
*
* If LWS_ADOPT_SOCKET is set, LWS adopts the socket in http serving mode, it's
* ready to accept an upgrade to ws or just serve http.
*
* parent may be NULL, if given it should be an existing wsi that will become the
* parent of the new wsi created by this call.
*/
LWS_VISIBLE LWS_EXTERN struct lws *
lws_adopt_descriptor_vhost(struct lws_vhost *vh, lws_adoption_type type,
                           lws_sock_file_fd_type fd, const char *vh_prot_name,
                           struct lws *parent);

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);
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);

#define LWS_CAUDP_BIND 1

LWS_VISIBLE LWS_EXTERN struct lws *
lws_create_adopt_udp(struct lws_vhost *vhost, int port, int flags,
                     const char *protocol_name, struct lws *parent_wsi);


LWS_VISIBLE LWS_EXTERN const char * LWS_WARN_UNUSED_RESULT
lws_canonical_hostname(struct lws_context *context);

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);

LWS_VISIBLE LWS_EXTERN const char *
lws_get_peer_simple(struct lws *wsi, char *name, int namelen);


#define LWS_ITOSA_NOT_EXIST -1
#define LWS_ITOSA_NOT_USABLE -2
#define LWS_ITOSA_USABLE 0
#if !defined(LWS_WITH_ESP32)

LWS_VISIBLE LWS_EXTERN int
lws_interface_to_sa(int ipv6, const char *ifname, struct sockaddr_in *addr,
                    size_t addrlen);
#endif


#define lws_start_foreach_ll(type, it, start)\
{ \
        type it = start; \
        while (it) {

#define lws_end_foreach_ll(it, nxt) \
                it = it->nxt; \
        } \
}

#define lws_start_foreach_llp(type, it, start)\
{ \
        type it = &(start); \
        while (*(it)) {

#define lws_start_foreach_llp_safe(type, it, start, nxt)\
{ \
        type it = &(start); \
        type next; \
        while (*(it)) { \
                next = &((*(it))->nxt); \


#define lws_end_foreach_llp(it, nxt) \
                it = &(*(it))->nxt; \
        } \
}

#define lws_end_foreach_llp_safe(it) \
                it = next; \
        } \
}

#define lws_ll_fwd_insert(\
        ___new_object,  /* pointer to new object */ \
        ___m_list,      /* member for next list object ptr */ \
        ___list_head    /* list head */ \
                ) {\
                ___new_object->___m_list = ___list_head; \
                ___list_head = ___new_object; \
        }

#define lws_ll_fwd_remove(\
        ___type,        /* type of listed object */ \
        ___m_list,      /* member for next list object ptr */ \
        ___target,      /* object to remove from list */ \
        ___list_head    /* list head */ \
        ) { \
                lws_start_foreach_llp(___type **, ___ppss, ___list_head) { \
                        if (*___ppss == ___target) { \
                                *___ppss = ___target->___m_list; \
                                break; \
                        } \
                } lws_end_foreach_llp(___ppss, ___m_list); \
        }

/*
 * doubly linked-list
 */

struct lws_dll { /* abstract */
        struct lws_dll *prev;
        struct lws_dll *next;
};

/*
 * these all point to the composed list objects... you have to use the
 * lws_container_of() helper to recover the start of the containing struct
 */

LWS_VISIBLE LWS_EXTERN void
lws_dll_add_front(struct lws_dll *d, struct lws_dll *phead);

LWS_VISIBLE LWS_EXTERN void
lws_dll_remove(struct lws_dll *d);

struct lws_dll_lws { /* typed as struct lws * */
        struct lws_dll_lws *prev;
        struct lws_dll_lws *next;
};

#define lws_dll_is_null(___dll) (!(___dll)->prev && !(___dll)->next)

static LWS_INLINE void
lws_dll_lws_add_front(struct lws_dll_lws *_a, struct lws_dll_lws *_head)
{
        lws_dll_add_front((struct lws_dll *)_a, (struct lws_dll *)_head);
}

static LWS_INLINE void
lws_dll_lws_remove(struct lws_dll_lws *_a)
{
        lws_dll_remove((struct lws_dll *)_a);
}

/*
 * these are safe against the current container object getting deleted,
 * since the hold his next in a temp and go to that next.  ___tmp is
 * the temp.
 */

#define lws_start_foreach_dll_safe(___type, ___it, ___tmp, ___start) \
{ \
        ___type ___it = ___start; \
        while (___it) { \
                ___type ___tmp = (___it)->next;

#define lws_end_foreach_dll_safe(___it, ___tmp) \
                ___it = ___tmp; \
        } \
}

#define lws_start_foreach_dll(___type, ___it, ___start) \
{ \
        ___type ___it = ___start; \
        while (___it) {

#define lws_end_foreach_dll(___it) \
                ___it = (___it)->next; \
        } \
}

struct lws_buflist;

LWS_VISIBLE LWS_EXTERN int
lws_buflist_append_segment(struct lws_buflist **head, const uint8_t *buf,
                           size_t len);
LWS_VISIBLE LWS_EXTERN size_t
lws_buflist_next_segment_len(struct lws_buflist **head, uint8_t **buf);
LWS_VISIBLE LWS_EXTERN int
lws_buflist_use_segment(struct lws_buflist **head, size_t len);
LWS_VISIBLE LWS_EXTERN void
lws_buflist_destroy_all_segments(struct lws_buflist **head);

void
lws_buflist_describe(struct lws_buflist **head, void *id);

#define lws_ptr_diff(head, tail) \
                        ((int)((char *)(head) - (char *)(tail)))

LWS_VISIBLE LWS_EXTERN int
lws_snprintf(char *str, size_t size, const char *format, ...) LWS_FORMAT(3);

LWS_VISIBLE LWS_EXTERN char *
lws_strncpy(char *dest, const char *src, size_t size);

LWS_VISIBLE LWS_EXTERN int
lws_get_random(struct lws_context *context, void *buf, int len);
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
lws_daemonize(const char *_lock_path);
LWS_VISIBLE LWS_EXTERN const char * LWS_WARN_UNUSED_RESULT
lws_get_library_version(void);

LWS_VISIBLE LWS_EXTERN void *
lws_wsi_user(struct lws *wsi);

LWS_VISIBLE LWS_EXTERN void
lws_set_wsi_user(struct lws *wsi, void *user);

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 const char *
lws_cmdline_option(int argc, const char **argv, const char *val);

LWS_VISIBLE LWS_EXTERN unsigned long
lws_now_secs(void);

LWS_VISIBLE LWS_EXTERN int
lws_compare_time_t(struct lws_context *context, time_t t1, time_t t2);

LWS_VISIBLE LWS_EXTERN struct lws_context * LWS_WARN_UNUSED_RESULT
lws_get_context(const struct lws *wsi);

LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
lws_get_vhost_listen_port(struct lws_vhost *vhost);

LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
lws_get_count_threads(struct lws_context *context);

LWS_VISIBLE LWS_EXTERN struct lws * LWS_WARN_UNUSED_RESULT
lws_get_parent(const struct lws *wsi);

LWS_VISIBLE LWS_EXTERN struct lws * LWS_WARN_UNUSED_RESULT
lws_get_child(const struct lws *wsi);

LWS_VISIBLE LWS_EXTERN const struct lws_udp * LWS_WARN_UNUSED_RESULT
lws_get_udp(const struct lws *wsi);

LWS_VISIBLE LWS_EXTERN void
lws_set_parent_carries_io(struct lws *wsi);

LWS_VISIBLE LWS_EXTERN void *
lws_get_opaque_parent_data(const struct lws *wsi);

LWS_VISIBLE LWS_EXTERN void
lws_set_opaque_parent_data(struct lws *wsi, void *data);

LWS_VISIBLE LWS_EXTERN int
lws_get_child_pending_on_writable(const struct lws *wsi);

LWS_VISIBLE LWS_EXTERN void
lws_clear_child_pending_on_writable(struct lws *wsi);

LWS_VISIBLE LWS_EXTERN int
lws_get_close_length(struct lws *wsi);

LWS_VISIBLE LWS_EXTERN unsigned char *
lws_get_close_payload(struct lws *wsi);

LWS_VISIBLE LWS_EXTERN
struct lws *lws_get_network_wsi(struct lws *wsi);

LWS_VISIBLE LWS_EXTERN void
lws_set_allocator(void *(*realloc)(void *ptr, size_t size, const char *reason));


LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
lws_send_pipe_choked(struct lws *wsi);

LWS_VISIBLE LWS_EXTERN int
lws_is_final_fragment(struct lws *wsi);

LWS_VISIBLE LWS_EXTERN int
lws_is_first_fragment(struct lws *wsi);

LWS_VISIBLE LWS_EXTERN unsigned char
lws_get_reserved_bits(struct lws *wsi);

LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
lws_partial_buffered(struct lws *wsi);

LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
lws_frame_is_binary(struct lws *wsi);

LWS_VISIBLE LWS_EXTERN int
lws_is_ssl(struct lws *wsi);
LWS_VISIBLE LWS_EXTERN int
lws_is_cgi(struct lws *wsi);


struct lws_wifi_scan { /* generic wlan scan item */
        struct lws_wifi_scan *next;
        char ssid[32];
        int32_t rssi; /* divide by .count to get db */
        uint8_t bssid[6];
        uint8_t count;
        uint8_t channel;
        uint8_t authmode;
};

#if defined(LWS_WITH_TLS) && !defined(LWS_WITH_MBEDTLS)

LWS_VISIBLE LWS_EXTERN SSL*
lws_get_ssl(struct lws *wsi);
#endif

enum lws_tls_cert_info {
        LWS_TLS_CERT_INFO_VALIDITY_FROM,
        LWS_TLS_CERT_INFO_VALIDITY_TO,
        LWS_TLS_CERT_INFO_COMMON_NAME,
        LWS_TLS_CERT_INFO_ISSUER_NAME,
        LWS_TLS_CERT_INFO_USAGE,
        LWS_TLS_CERT_INFO_VERIFIED,
        LWS_TLS_CERT_INFO_OPAQUE_PUBLIC_KEY,
};

union lws_tls_cert_info_results {
        unsigned int verified;
        time_t time;
        unsigned int usage;
        struct {
                int len;
                /* KEEP LAST... notice the [64] is only there because
                 * name[] is not allowed in a union.  The actual length of
                 * name[] is arbitrary and is passed into the api using the
                 * len parameter.  Eg
                 *
                 * char big[1024];
                 * union lws_tls_cert_info_results *buf =
                 *      (union lws_tls_cert_info_results *)big;
                 *
                 * lws_tls_peer_cert_info(wsi, type, buf, sizeof(big) -
                 *                        sizeof(*buf) + sizeof(buf->ns.name));
                 */
                char name[64];
        } ns;
};

LWS_VISIBLE LWS_EXTERN int
lws_tls_peer_cert_info(struct lws *wsi, enum lws_tls_cert_info type,
                       union lws_tls_cert_info_results *buf, size_t len);

LWS_VISIBLE LWS_EXTERN int
lws_tls_vhost_cert_info(struct lws_vhost *vhost, enum lws_tls_cert_info type,
                        union lws_tls_cert_info_results *buf, size_t len);

LWS_VISIBLE LWS_EXTERN int
lws_tls_acme_sni_cert_create(struct lws_vhost *vhost, const char *san_a,
                             const char *san_b);

LWS_VISIBLE LWS_EXTERN int
lws_tls_acme_sni_csr_create(struct lws_context *context, const char *elements[],
                            uint8_t *csr, size_t csr_len, char **privkey_pem,
                            size_t *privkey_len);

LWS_VISIBLE LWS_EXTERN int
lws_tls_cert_updated(struct lws_context *context, const char *certpath,
                     const char *keypath,
                     const char *mem_cert, size_t len_mem_cert,
                     const char *mem_privkey, size_t len_mem_privkey);

struct lws_ring;

LWS_VISIBLE LWS_EXTERN struct lws_ring *
lws_ring_create(size_t element_len, size_t count,
                void (*destroy_element)(void *element));

LWS_VISIBLE LWS_EXTERN void
lws_ring_destroy(struct lws_ring *ring);

LWS_VISIBLE LWS_EXTERN size_t
lws_ring_get_count_free_elements(struct lws_ring *ring);

LWS_VISIBLE LWS_EXTERN size_t
lws_ring_get_count_waiting_elements(struct lws_ring *ring, uint32_t *tail);

LWS_VISIBLE LWS_EXTERN size_t
lws_ring_insert(struct lws_ring *ring, const void *src, size_t max_count);

LWS_VISIBLE LWS_EXTERN size_t
lws_ring_consume(struct lws_ring *ring, uint32_t *tail, void *dest,
                 size_t max_count);

LWS_VISIBLE LWS_EXTERN const void *
lws_ring_get_element(struct lws_ring *ring, uint32_t *tail);

LWS_VISIBLE LWS_EXTERN void
lws_ring_update_oldest_tail(struct lws_ring *ring, uint32_t tail);

LWS_VISIBLE LWS_EXTERN uint32_t
lws_ring_get_oldest_tail(struct lws_ring *ring);

LWS_VISIBLE LWS_EXTERN int
lws_ring_next_linear_insert_range(struct lws_ring *ring, void **start,
                                  size_t *bytes);

LWS_VISIBLE LWS_EXTERN void
lws_ring_bump_head(struct lws_ring *ring, size_t bytes);

LWS_VISIBLE LWS_EXTERN void
lws_ring_dump(struct lws_ring *ring, uint32_t *tail);

/*
 * This is a helper that combines the common pattern of needing to consume
 * some ringbuffer elements, move the consumer tail on, and check if that
 * has moved any ringbuffer elements out of scope, because it was the last
 * consumer that had not already consumed them.
 *
 * Elements that go out of scope because the oldest tail is now after them
 * get garbage-collected by calling the destroy_element callback on them
 * defined when the ringbuffer was created.
 */

#define lws_ring_consume_and_update_oldest_tail(\
                ___ring,    /* the lws_ring object */ \
                ___type,    /* type of objects with tails */ \
                ___ptail,   /* ptr to tail of obj with tail doing consuming */ \
                ___count,   /* count of payload objects being consumed */ \
                ___list_head,   /* head of list of objects with tails */ \
                ___mtail,   /* member name of tail in ___type */ \
                ___mlist  /* member name of next list member ptr in ___type */ \
        ) { \
                int ___n, ___m; \
        \
        ___n = lws_ring_get_oldest_tail(___ring) == *(___ptail); \
        lws_ring_consume(___ring, ___ptail, NULL, ___count); \
        if (___n) { \
                uint32_t ___oldest; \
                ___n = 0; \
                ___oldest = *(___ptail); \
                lws_start_foreach_llp(___type **, ___ppss, ___list_head) { \
                        ___m = lws_ring_get_count_waiting_elements( \
                                        ___ring, &(*___ppss)->tail); \
                        if (___m >= ___n) { \
                                ___n = ___m; \
                                ___oldest = (*___ppss)->tail; \
                        } \
                } lws_end_foreach_llp(___ppss, ___mlist); \
        \
                lws_ring_update_oldest_tail(___ring, ___oldest); \
        } \
}

/*
 * This does the same as the lws_ring_consume_and_update_oldest_tail()
 * helper, but for the simpler case there is only one consumer, so one
 * tail, and that tail is always the oldest tail.
 */

#define lws_ring_consume_single_tail(\
                ___ring,  /* the lws_ring object */ \
                ___ptail, /* ptr to tail of obj with tail doing consuming */ \
                ___count  /* count of payload objects being consumed */ \
        ) { \
        lws_ring_consume(___ring, ___ptail, NULL, ___count); \
        lws_ring_update_oldest_tail(___ring, *(___ptail)); \
}

#ifdef LWS_SHA1_USE_OPENSSL_NAME
#define lws_SHA1 SHA1
#else

LWS_VISIBLE LWS_EXTERN unsigned char *
lws_SHA1(const unsigned char *d, size_t n, unsigned char *md);
#endif

LWS_VISIBLE LWS_EXTERN int
lws_b64_encode_string(const char *in, int in_len, char *out, int out_size);
LWS_VISIBLE LWS_EXTERN int
lws_b64_encode_string_url(const char *in, int in_len, char *out, int out_size);
LWS_VISIBLE LWS_EXTERN int
lws_b64_decode_string(const char *in, char *out, int out_size);
LWS_VISIBLE LWS_EXTERN int
lws_b64_decode_string_len(const char *in, int in_len, char *out, int out_size);


enum lws_enum_stdinouterr {
        LWS_STDIN = 0,
        LWS_STDOUT = 1,
        LWS_STDERR = 2,
};

enum lws_cgi_hdr_state {
        LCHS_HEADER,
        LCHS_CR1,
        LCHS_LF1,
        LCHS_CR2,
        LCHS_LF2,
        LHCS_RESPONSE,
        LHCS_DUMP_HEADERS,
        LHCS_PAYLOAD,
        LCHS_SINGLE_0A,
};

struct lws_cgi_args {
        struct lws **stdwsi; 
        enum lws_enum_stdinouterr ch; 
        unsigned char *data; 
        enum lws_cgi_hdr_state hdr_state; 
        int len; 
};

#ifdef LWS_WITH_CGI

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 int
lws_cgi_write_split_stdout_headers(struct lws *wsi);

LWS_VISIBLE LWS_EXTERN int
lws_cgi_kill(struct lws *wsi);

LWS_VISIBLE LWS_EXTERN struct lws *
lws_cgi_get_stdwsi(struct lws *wsi, enum lws_enum_stdinouterr ch);

#endif



#if defined(LWS_WITH_ESP32)
/* sdk preprocessor defs? compiler issue? gets confused with member names */
#define LWS_FOP_OPEN            _open
#define LWS_FOP_CLOSE           _close
#define LWS_FOP_SEEK_CUR        _seek_cur
#define LWS_FOP_READ            _read
#define LWS_FOP_WRITE           _write
#else
#define LWS_FOP_OPEN            open
#define LWS_FOP_CLOSE           close
#define LWS_FOP_SEEK_CUR        seek_cur
#define LWS_FOP_READ            read
#define LWS_FOP_WRITE           write
#endif

#define LWS_FOP_FLAGS_MASK                 ((1 << 23) - 1)
#define LWS_FOP_FLAG_COMPR_ACCEPTABLE_GZIP (1 << 24)
#define LWS_FOP_FLAG_COMPR_IS_GZIP         (1 << 25)
#define LWS_FOP_FLAG_MOD_TIME_VALID        (1 << 26)
#define LWS_FOP_FLAG_VIRTUAL               (1 << 27)

struct lws_plat_file_ops;

struct lws_fop_fd {
        lws_filefd_type                 fd;
        const struct lws_plat_file_ops  *fops;
        void                            *filesystem_priv;
        lws_filepos_t                   pos;
        lws_filepos_t                   len;
        lws_fop_flags_t                 flags;
        uint32_t                        mod_time;
};
typedef struct lws_fop_fd *lws_fop_fd_t;

struct lws_fops_index {
        const char *sig;        /* NULL or vfs signature, eg, ".zip/" */
        uint8_t len;            /* length of above string */
};

struct lws_plat_file_ops {
        lws_fop_fd_t (*LWS_FOP_OPEN)(const struct lws_plat_file_ops *fops,
                                     const char *filename, const char *vpath,
                                     lws_fop_flags_t *flags);
        int (*LWS_FOP_CLOSE)(lws_fop_fd_t *fop_fd);
        lws_fileofs_t (*LWS_FOP_SEEK_CUR)(lws_fop_fd_t fop_fd,
                                          lws_fileofs_t offset_from_cur_pos);
        int (*LWS_FOP_READ)(lws_fop_fd_t fop_fd, lws_filepos_t *amount,
                            uint8_t *buf, lws_filepos_t len);
        int (*LWS_FOP_WRITE)(lws_fop_fd_t fop_fd, lws_filepos_t *amount,
                             uint8_t *buf, lws_filepos_t len);
        struct lws_fops_index fi[3];
        const struct lws_plat_file_ops *next;
        /* Add new things just above here ---^
         * This is part of the ABI, don't needlessly break compatibility */
};

LWS_VISIBLE LWS_EXTERN struct lws_plat_file_ops * LWS_WARN_UNUSED_RESULT
lws_get_fops(struct lws_context *context);
LWS_VISIBLE LWS_EXTERN void
lws_set_fops(struct lws_context *context, const struct lws_plat_file_ops *fops);
LWS_VISIBLE LWS_EXTERN lws_filepos_t LWS_WARN_UNUSED_RESULT
lws_vfs_tell(lws_fop_fd_t fop_fd);
LWS_VISIBLE LWS_EXTERN lws_filepos_t LWS_WARN_UNUSED_RESULT
lws_vfs_get_length(lws_fop_fd_t fop_fd);
LWS_VISIBLE LWS_EXTERN uint32_t LWS_WARN_UNUSED_RESULT
lws_vfs_get_mod_time(lws_fop_fd_t fop_fd);
LWS_VISIBLE LWS_EXTERN lws_fileofs_t
lws_vfs_file_seek_set(lws_fop_fd_t fop_fd, lws_fileofs_t offset);
LWS_VISIBLE LWS_EXTERN lws_fileofs_t
lws_vfs_file_seek_end(lws_fop_fd_t fop_fd, lws_fileofs_t offset);

extern struct lws_plat_file_ops fops_zip;

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);

static LWS_INLINE int
lws_vfs_file_close(lws_fop_fd_t *fop_fd)
{
        return (*fop_fd)->fops->LWS_FOP_CLOSE(fop_fd);
}

static LWS_INLINE lws_fileofs_t
lws_vfs_file_seek_cur(lws_fop_fd_t fop_fd, lws_fileofs_t offset)
{
        return fop_fd->fops->LWS_FOP_SEEK_CUR(fop_fd, offset);
}
static LWS_INLINE int LWS_WARN_UNUSED_RESULT
lws_vfs_file_read(lws_fop_fd_t fop_fd, lws_filepos_t *amount,
                   uint8_t *buf, lws_filepos_t len)
{
        return fop_fd->fops->LWS_FOP_READ(fop_fd, amount, buf, len);
}
static LWS_INLINE int LWS_WARN_UNUSED_RESULT
lws_vfs_file_write(lws_fop_fd_t fop_fd, lws_filepos_t *amount,
                    uint8_t *buf, lws_filepos_t len)
{
        return fop_fd->fops->LWS_FOP_WRITE(fop_fd, amount, buf, len);
}

/* these are the platform file operations implementations... they can
 * be called directly and used in fops arrays
 */

LWS_VISIBLE LWS_EXTERN lws_fop_fd_t
_lws_plat_file_open(const struct lws_plat_file_ops *fops, const char *filename,
                    const char *vpath, lws_fop_flags_t *flags);
LWS_VISIBLE LWS_EXTERN int
_lws_plat_file_close(lws_fop_fd_t *fop_fd);
LWS_VISIBLE LWS_EXTERN lws_fileofs_t
_lws_plat_file_seek_cur(lws_fop_fd_t fop_fd, lws_fileofs_t offset);
LWS_VISIBLE LWS_EXTERN int
_lws_plat_file_read(lws_fop_fd_t fop_fd, lws_filepos_t *amount,
                    uint8_t *buf, lws_filepos_t len);
LWS_VISIBLE LWS_EXTERN int
_lws_plat_file_write(lws_fop_fd_t fop_fd, lws_filepos_t *amount,
                     uint8_t *buf, lws_filepos_t len);

LWS_VISIBLE LWS_EXTERN int
lws_alloc_vfs_file(struct lws_context *context, const char *filename,
                   uint8_t **buf, lws_filepos_t *amount);

#ifdef LWS_WITH_SMTP

enum lwsgs_smtp_states {
        LGSSMTP_IDLE, 
        LGSSMTP_CONNECTING, 
        LGSSMTP_CONNECTED, 
        LGSSMTP_SENT_HELO, 
        LGSSMTP_SENT_FROM, 
        LGSSMTP_SENT_TO, 
        LGSSMTP_SENT_DATA, 
        LGSSMTP_SENT_BODY, 
        LGSSMTP_SENT_QUIT, 
};

struct lws_email {
        void *data;
        uv_loop_t *loop;
        char email_smtp_ip[32]; 
        char email_helo[32];    
        char email_from[100];   
        char email_to[100];     
        unsigned int max_content_size;
        /* Fill all the callbacks before init */

        int (*on_next)(struct lws_email *email);
        int (*on_sent)(struct lws_email *email);
        int (*on_get_body)(struct lws_email *email, char *buf, int len);
        /* private things */
        uv_timer_t timeout_email; 
        enum lwsgs_smtp_states estate; 
        uv_connect_t email_connect_req; 
        uv_tcp_t email_client; 
        time_t email_connect_started; 
        char email_buf[256]; 
        char *content; 
};

LWS_VISIBLE LWS_EXTERN int
lws_email_init(struct lws_email *email, uv_loop_t *loop, int max_content);

LWS_VISIBLE LWS_EXTERN void
lws_email_check(struct lws_email *email);
LWS_VISIBLE LWS_EXTERN void
lws_email_destroy(struct lws_email *email);

#endif



struct lejp_ctx;

#define LWS_ARRAY_SIZE(_x) (sizeof(_x) / sizeof(_x[0]))
#define LEJP_FLAG_WS_KEEP 64
#define LEJP_FLAG_WS_COMMENTLINE 32

enum lejp_states {
        LEJP_IDLE = 0,
        LEJP_MEMBERS = 1,
        LEJP_M_P = 2,
        LEJP_MP_STRING = LEJP_FLAG_WS_KEEP | 3,
        LEJP_MP_STRING_ESC = LEJP_FLAG_WS_KEEP | 4,
        LEJP_MP_STRING_ESC_U1 = LEJP_FLAG_WS_KEEP | 5,
        LEJP_MP_STRING_ESC_U2 = LEJP_FLAG_WS_KEEP | 6,
        LEJP_MP_STRING_ESC_U3 = LEJP_FLAG_WS_KEEP | 7,
        LEJP_MP_STRING_ESC_U4 = LEJP_FLAG_WS_KEEP | 8,
        LEJP_MP_DELIM = 9,
        LEJP_MP_VALUE = 10,
        LEJP_MP_VALUE_NUM_INT = LEJP_FLAG_WS_KEEP | 11,
        LEJP_MP_VALUE_NUM_EXP = LEJP_FLAG_WS_KEEP | 12,
        LEJP_MP_VALUE_TOK = LEJP_FLAG_WS_KEEP | 13,
        LEJP_MP_COMMA_OR_END = 14,
        LEJP_MP_ARRAY_END = 15,
};

enum lejp_reasons {
        LEJP_CONTINUE = -1,
        LEJP_REJECT_IDLE_NO_BRACE = -2,
        LEJP_REJECT_MEMBERS_NO_CLOSE = -3,
        LEJP_REJECT_MP_NO_OPEN_QUOTE = -4,
        LEJP_REJECT_MP_STRING_UNDERRUN = -5,
        LEJP_REJECT_MP_ILLEGAL_CTRL = -6,
        LEJP_REJECT_MP_STRING_ESC_ILLEGAL_ESC = -7,
        LEJP_REJECT_ILLEGAL_HEX = -8,
        LEJP_REJECT_MP_DELIM_MISSING_COLON = -9,
        LEJP_REJECT_MP_DELIM_BAD_VALUE_START = -10,
        LEJP_REJECT_MP_VAL_NUM_INT_NO_FRAC = -11,
        LEJP_REJECT_MP_VAL_NUM_FORMAT = -12,
        LEJP_REJECT_MP_VAL_NUM_EXP_BAD_EXP = -13,
        LEJP_REJECT_MP_VAL_TOK_UNKNOWN = -14,
        LEJP_REJECT_MP_C_OR_E_UNDERF = -15,
        LEJP_REJECT_MP_C_OR_E_NOTARRAY = -16,
        LEJP_REJECT_MP_ARRAY_END_MISSING = -17,
        LEJP_REJECT_STACK_OVERFLOW = -18,
        LEJP_REJECT_MP_DELIM_ISTACK = -19,
        LEJP_REJECT_NUM_TOO_LONG = -20,
        LEJP_REJECT_MP_C_OR_E_NEITHER = -21,
        LEJP_REJECT_UNKNOWN = -22,
        LEJP_REJECT_CALLBACK = -23
};

#define LEJP_FLAG_CB_IS_VALUE 64

enum lejp_callbacks {
        LEJPCB_CONSTRUCTED      = 0,
        LEJPCB_DESTRUCTED       = 1,

        LEJPCB_START            = 2,
        LEJPCB_COMPLETE         = 3,
        LEJPCB_FAILED           = 4,

        LEJPCB_PAIR_NAME        = 5,

        LEJPCB_VAL_TRUE         = LEJP_FLAG_CB_IS_VALUE | 6,
        LEJPCB_VAL_FALSE        = LEJP_FLAG_CB_IS_VALUE | 7,
        LEJPCB_VAL_NULL         = LEJP_FLAG_CB_IS_VALUE | 8,
        LEJPCB_VAL_NUM_INT      = LEJP_FLAG_CB_IS_VALUE | 9,
        LEJPCB_VAL_NUM_FLOAT    = LEJP_FLAG_CB_IS_VALUE | 10,
        LEJPCB_VAL_STR_START    = 11, /* notice handle separately */
        LEJPCB_VAL_STR_CHUNK    = LEJP_FLAG_CB_IS_VALUE | 12,
        LEJPCB_VAL_STR_END      = LEJP_FLAG_CB_IS_VALUE | 13,

        LEJPCB_ARRAY_START      = 14,
        LEJPCB_ARRAY_END        = 15,

        LEJPCB_OBJECT_START     = 16,
        LEJPCB_OBJECT_END       = 17
};

LWS_EXTERN signed char _lejp_callback(struct lejp_ctx *ctx, char reason);

typedef signed char (*lejp_callback)(struct lejp_ctx *ctx, char reason);

#ifndef LEJP_MAX_DEPTH
#define LEJP_MAX_DEPTH 12
#endif
#ifndef LEJP_MAX_INDEX_DEPTH
#define LEJP_MAX_INDEX_DEPTH 5
#endif
#ifndef LEJP_MAX_PATH
#define LEJP_MAX_PATH 128
#endif
#ifndef LEJP_STRING_CHUNK
/* must be >= 30 to assemble floats */
#define LEJP_STRING_CHUNK 254
#endif

enum num_flags {
        LEJP_SEEN_MINUS = (1 << 0),
        LEJP_SEEN_POINT = (1 << 1),
        LEJP_SEEN_POST_POINT = (1 << 2),
        LEJP_SEEN_EXP = (1 << 3)
};

struct _lejp_stack {
        char s; /* lejp_state stack*/
        char p; /* path length */
        char i; /* index array length */
        char b; /* user bitfield */
};

struct lejp_ctx {

        /* sorted by type for most compact alignment
         *
         * pointers
         */

        signed char (*callback)(struct lejp_ctx *ctx, char reason);
        void *user;
        const char * const *paths;

        /* arrays */

        struct _lejp_stack st[LEJP_MAX_DEPTH];
        uint16_t i[LEJP_MAX_INDEX_DEPTH]; /* index array */
        uint16_t wild[LEJP_MAX_INDEX_DEPTH]; /* index array */
        char path[LEJP_MAX_PATH];
        char buf[LEJP_STRING_CHUNK + 1];

        /* int */

        uint32_t line;

        /* short */

        uint16_t uni;

        /* char */

        uint8_t npos;
        uint8_t dcount;
        uint8_t f;
        uint8_t sp; /* stack head */
        uint8_t ipos; /* index stack depth */
        uint8_t ppos;
        uint8_t count_paths;
        uint8_t path_match;
        uint8_t path_match_len;
        uint8_t wildcount;
};

LWS_VISIBLE LWS_EXTERN void
lejp_construct(struct lejp_ctx *ctx,
               signed char (*callback)(struct lejp_ctx *ctx, char reason),
               void *user, const char * const *paths, unsigned char paths_count);

LWS_VISIBLE LWS_EXTERN void
lejp_destruct(struct lejp_ctx *ctx);

LWS_VISIBLE LWS_EXTERN int
lejp_parse(struct lejp_ctx *ctx, const unsigned char *json, int len);

LWS_VISIBLE LWS_EXTERN void
lejp_change_callback(struct lejp_ctx *ctx,
                     signed char (*callback)(struct lejp_ctx *ctx, char reason));

LWS_VISIBLE LWS_EXTERN int
lejp_get_wildcard(struct lejp_ctx *ctx, int wildcard, char *dest, int len);

/*
 * Stats are all uint64_t numbers that start at 0.
 * Index names here have the convention
 *
 *  _C_ counter
 *  _B_ byte count
 *  _MS_ millisecond count
 */

enum {
        LWSSTATS_C_CONNECTIONS, 
        LWSSTATS_C_API_CLOSE, 
        LWSSTATS_C_API_READ, 
        LWSSTATS_C_API_LWS_WRITE, 
        LWSSTATS_C_API_WRITE, 
        LWSSTATS_C_WRITE_PARTIALS, 
        LWSSTATS_C_WRITEABLE_CB_REQ, 
        LWSSTATS_C_WRITEABLE_CB_EFF_REQ, 
        LWSSTATS_C_WRITEABLE_CB, 
        LWSSTATS_C_SSL_CONNECTIONS_FAILED, 
        LWSSTATS_C_SSL_CONNECTIONS_ACCEPTED, 
        LWSSTATS_C_SSL_CONNECTIONS_ACCEPT_SPIN, 
        LWSSTATS_C_SSL_CONNS_HAD_RX, 
        LWSSTATS_C_TIMEOUTS, 
        LWSSTATS_C_SERVICE_ENTRY, 
        LWSSTATS_B_READ, 
        LWSSTATS_B_WRITE, 
        LWSSTATS_B_PARTIALS_ACCEPTED_PARTS, 
        LWSSTATS_MS_SSL_CONNECTIONS_ACCEPTED_DELAY, 
        LWSSTATS_MS_WRITABLE_DELAY, 
        LWSSTATS_MS_WORST_WRITABLE_DELAY, 
        LWSSTATS_MS_SSL_RX_DELAY, 
        LWSSTATS_C_PEER_LIMIT_AH_DENIED, 
        LWSSTATS_C_PEER_LIMIT_WSI_DENIED, 
        /* Add new things just above here ---^
         * This is part of the ABI, don't needlessly break compatibility */
        LWSSTATS_SIZE
};

#if defined(LWS_WITH_STATS)

LWS_VISIBLE LWS_EXTERN uint64_t
lws_stats_get(struct lws_context *context, int index);
LWS_VISIBLE LWS_EXTERN void
lws_stats_log_dump(struct lws_context *context);
#else
static LWS_INLINE uint64_t
lws_stats_get(struct lws_context *context, int index) { (void)context; (void)index;  return 0; }
static LWS_INLINE void
lws_stats_log_dump(struct lws_context *context) { (void)context; }
#endif

#ifdef __cplusplus
}
#endif

#endif