27 #define LWS_RECOMMENDED_MIN_HEADER_SPACE 2048
53 LWS_VISIBLE LWS_EXTERN
const char *
54 lws_get_mimetype(
const char *file,
const struct lws_http_mount *m);
74 LWS_VISIBLE LWS_EXTERN
int
75 lws_serve_http_file(
struct lws *wsi,
const char *file,
const char *content_type,
76 const char *other_headers,
int other_headers_len);
78 LWS_VISIBLE LWS_EXTERN
int
79 lws_serve_http_file_fragment(
struct lws *wsi);
84 HTTP_STATUS_CONTINUE = 100,
87 HTTP_STATUS_NO_CONTENT = 204,
88 HTTP_STATUS_PARTIAL_CONTENT = 206,
90 HTTP_STATUS_MOVED_PERMANENTLY = 301,
91 HTTP_STATUS_FOUND = 302,
92 HTTP_STATUS_SEE_OTHER = 303,
93 HTTP_STATUS_NOT_MODIFIED = 304,
95 HTTP_STATUS_BAD_REQUEST = 400,
96 HTTP_STATUS_UNAUTHORIZED,
97 HTTP_STATUS_PAYMENT_REQUIRED,
98 HTTP_STATUS_FORBIDDEN,
99 HTTP_STATUS_NOT_FOUND,
100 HTTP_STATUS_METHOD_NOT_ALLOWED,
101 HTTP_STATUS_NOT_ACCEPTABLE,
102 HTTP_STATUS_PROXY_AUTH_REQUIRED,
103 HTTP_STATUS_REQUEST_TIMEOUT,
104 HTTP_STATUS_CONFLICT,
106 HTTP_STATUS_LENGTH_REQUIRED,
107 HTTP_STATUS_PRECONDITION_FAILED,
108 HTTP_STATUS_REQ_ENTITY_TOO_LARGE,
109 HTTP_STATUS_REQ_URI_TOO_LONG,
110 HTTP_STATUS_UNSUPPORTED_MEDIA_TYPE,
111 HTTP_STATUS_REQ_RANGE_NOT_SATISFIABLE,
112 HTTP_STATUS_EXPECTATION_FAILED,
114 HTTP_STATUS_INTERNAL_SERVER_ERROR = 500,
115 HTTP_STATUS_NOT_IMPLEMENTED,
116 HTTP_STATUS_BAD_GATEWAY,
117 HTTP_STATUS_SERVICE_UNAVAILABLE,
118 HTTP_STATUS_GATEWAY_TIMEOUT,
119 HTTP_STATUS_HTTP_VERSION_NOT_SUPPORTED,
141 typedef const char *(*lws_process_html_state_cb)(
void *data,
int index);
159 LWS_VISIBLE LWS_EXTERN
int
215 enum lws_token_indexes {
218 #if defined(LWS_WITH_HTTP_UNCOMMON_HEADERS)
219 WSI_TOKEN_OPTIONS_URI,
222 WSI_TOKEN_CONNECTION,
225 #if defined(LWS_ROLE_WS)
229 #if defined(LWS_ROLE_WS)
230 WSI_TOKEN_EXTENSIONS,
238 #if defined(LWS_ROLE_H2)
239 WSI_TOKEN_HTTP2_SETTINGS,
241 WSI_TOKEN_HTTP_ACCEPT,
242 #if defined(LWS_WITH_HTTP_UNCOMMON_HEADERS)
243 WSI_TOKEN_HTTP_AC_REQUEST_HEADERS,
245 WSI_TOKEN_HTTP_IF_MODIFIED_SINCE,
246 WSI_TOKEN_HTTP_IF_NONE_MATCH,
247 WSI_TOKEN_HTTP_ACCEPT_ENCODING,
248 WSI_TOKEN_HTTP_ACCEPT_LANGUAGE,
249 WSI_TOKEN_HTTP_PRAGMA,
250 WSI_TOKEN_HTTP_CACHE_CONTROL,
251 WSI_TOKEN_HTTP_AUTHORIZATION,
252 WSI_TOKEN_HTTP_COOKIE,
253 WSI_TOKEN_HTTP_CONTENT_LENGTH,
254 WSI_TOKEN_HTTP_CONTENT_TYPE,
256 WSI_TOKEN_HTTP_RANGE,
257 #if defined(LWS_WITH_HTTP_UNCOMMON_HEADERS) || defined(LWS_ROLE_H2)
258 WSI_TOKEN_HTTP_REFERER,
260 #if defined(LWS_ROLE_WS)
265 #if defined(LWS_ROLE_H2)
266 WSI_TOKEN_HTTP_COLON_AUTHORITY,
267 WSI_TOKEN_HTTP_COLON_METHOD,
268 WSI_TOKEN_HTTP_COLON_PATH,
269 WSI_TOKEN_HTTP_COLON_SCHEME,
270 WSI_TOKEN_HTTP_COLON_STATUS,
273 #if defined(LWS_WITH_HTTP_UNCOMMON_HEADERS) || defined(LWS_ROLE_H2)
274 WSI_TOKEN_HTTP_ACCEPT_CHARSET,
276 WSI_TOKEN_HTTP_ACCEPT_RANGES,
277 #if defined(LWS_WITH_HTTP_UNCOMMON_HEADERS) || defined(LWS_ROLE_H2)
278 WSI_TOKEN_HTTP_ACCESS_CONTROL_ALLOW_ORIGIN,
281 WSI_TOKEN_HTTP_ALLOW,
282 WSI_TOKEN_HTTP_CONTENT_DISPOSITION,
283 WSI_TOKEN_HTTP_CONTENT_ENCODING,
284 WSI_TOKEN_HTTP_CONTENT_LANGUAGE,
285 WSI_TOKEN_HTTP_CONTENT_LOCATION,
286 WSI_TOKEN_HTTP_CONTENT_RANGE,
288 WSI_TOKEN_HTTP_EXPECT,
289 WSI_TOKEN_HTTP_EXPIRES,
291 WSI_TOKEN_HTTP_IF_MATCH,
292 WSI_TOKEN_HTTP_IF_RANGE,
293 WSI_TOKEN_HTTP_IF_UNMODIFIED_SINCE,
294 WSI_TOKEN_HTTP_LAST_MODIFIED,
296 WSI_TOKEN_HTTP_LOCATION,
297 #if defined(LWS_WITH_HTTP_UNCOMMON_HEADERS) || defined(LWS_ROLE_H2)
298 WSI_TOKEN_HTTP_MAX_FORWARDS,
299 WSI_TOKEN_HTTP_PROXY_AUTHENTICATE,
300 WSI_TOKEN_HTTP_PROXY_AUTHORIZATION,
302 WSI_TOKEN_HTTP_REFRESH,
303 WSI_TOKEN_HTTP_RETRY_AFTER,
304 WSI_TOKEN_HTTP_SERVER,
305 WSI_TOKEN_HTTP_SET_COOKIE,
306 #if defined(LWS_WITH_HTTP_UNCOMMON_HEADERS) || defined(LWS_ROLE_H2)
307 WSI_TOKEN_HTTP_STRICT_TRANSPORT_SECURITY,
309 WSI_TOKEN_HTTP_TRANSFER_ENCODING,
310 #if defined(LWS_WITH_HTTP_UNCOMMON_HEADERS) || defined(LWS_ROLE_H2)
311 WSI_TOKEN_HTTP_USER_AGENT,
314 WSI_TOKEN_HTTP_WWW_AUTHENTICATE,
316 #if defined(LWS_WITH_HTTP_UNCOMMON_HEADERS)
319 WSI_TOKEN_DELETE_URI,
322 WSI_TOKEN_HTTP_URI_ARGS,
323 #if defined(LWS_WITH_HTTP_UNCOMMON_HEADERS)
325 WSI_TOKEN_HTTP_X_REAL_IP,
328 WSI_TOKEN_X_FORWARDED_FOR,
331 #if defined(LWS_WITH_HTTP_UNCOMMON_HEADERS) || defined(LWS_ROLE_H2)
333 WSI_TOKEN_REPLAY_NONCE,
335 #if defined(LWS_ROLE_H2)
336 WSI_TOKEN_COLON_PROTOCOL,
338 WSI_TOKEN_X_AUTH_TOKEN,
345 _WSI_TOKEN_CLIENT_SENT_PROTOCOLS,
346 _WSI_TOKEN_CLIENT_PEER_ADDRESS,
347 _WSI_TOKEN_CLIENT_URI,
348 _WSI_TOKEN_CLIENT_HOST,
349 _WSI_TOKEN_CLIENT_ORIGIN,
350 _WSI_TOKEN_CLIENT_METHOD,
351 _WSI_TOKEN_CLIENT_IFACE,
352 _WSI_TOKEN_CLIENT_ALPN,
359 #if defined(LWS_WITH_CUSTOM_HEADERS)
360 WSI_TOKEN_UNKNOWN_VALUE_PART,
363 WSI_TOKEN_SKIPPING_SAW_CR,
364 WSI_PARSING_COMPLETE,
365 WSI_INIT_TOKEN_MUXURL,
372 enum lws_h2_settings {
373 H2SET_HEADER_TABLE_SIZE = 1,
375 H2SET_MAX_CONCURRENT_STREAMS,
376 H2SET_INITIAL_WINDOW_SIZE,
377 H2SET_MAX_FRAME_SIZE,
378 H2SET_MAX_HEADER_LIST_SIZE,
380 H2SET_ENABLE_CONNECT_PROTOCOL,
390 LWS_VISIBLE LWS_EXTERN
const unsigned char *
401 LWS_VISIBLE LWS_EXTERN
int LWS_WARN_UNUSED_RESULT
413 LWS_VISIBLE LWS_EXTERN
int LWS_WARN_UNUSED_RESULT
431 LWS_VISIBLE LWS_EXTERN
int
432 lws_hdr_copy(
struct lws *wsi,
char *dest,
int len,
enum lws_token_indexes h);
451 LWS_VISIBLE LWS_EXTERN
int
453 enum lws_token_indexes h,
int frag_idx);
471 LWS_VISIBLE LWS_EXTERN
int
492 LWS_VISIBLE LWS_EXTERN
int
506 LWS_VISIBLE LWS_EXTERN
const char *
526 #define LWSAHH_CODE_MASK ((1 << 16) - 1)
527 #define LWSAHH_FLAG_NO_SERVER_NAME (1 << 30)
543 LWS_VISIBLE LWS_EXTERN
int LWS_WARN_UNUSED_RESULT
545 unsigned int code,
unsigned char **p,
559 LWS_VISIBLE LWS_EXTERN
int LWS_WARN_UNUSED_RESULT
561 const unsigned char *value,
int length,
562 unsigned char **p,
unsigned char *end);
576 LWS_VISIBLE LWS_EXTERN
int LWS_WARN_UNUSED_RESULT
578 const unsigned char *value,
int length,
579 unsigned char **p,
unsigned char *end);
590 LWS_VISIBLE LWS_EXTERN
int LWS_WARN_UNUSED_RESULT
592 lws_filepos_t content_length,
593 unsigned char **p,
unsigned char *end);
603 LWS_VISIBLE LWS_EXTERN
int LWS_WARN_UNUSED_RESULT
618 LWS_VISIBLE LWS_EXTERN
int LWS_WARN_UNUSED_RESULT
620 unsigned char **p,
unsigned char *end);
622 #define LWS_ILLEGAL_HTTP_CONTENT_LEN ((lws_filepos_t)-1ll)
650 LWS_VISIBLE LWS_EXTERN
int LWS_WARN_UNUSED_RESULT
652 const char *content_type, lws_filepos_t content_len,
653 unsigned char **p,
unsigned char *end);
664 LWSHUMETH_COLON_PATH,
680 LWS_VISIBLE LWS_EXTERN
int LWS_WARN_UNUSED_RESULT
706 LWS_VISIBLE LWS_EXTERN
const char *
707 lws_urlencode(
char *escaped,
const char *
string,
int len);
730 LWS_VISIBLE LWS_EXTERN
int
731 lws_urldecode(
char *
string,
const char *escaped,
int len);
743 LWS_VISIBLE LWS_EXTERN
int
744 lws_return_http_status(
struct lws *wsi,
unsigned int code,
745 const char *html_body);
759 LWS_VISIBLE LWS_EXTERN
int LWS_WARN_UNUSED_RESULT
760 lws_http_redirect(
struct lws *wsi,
int code,
const unsigned char *loc,
int len,
761 unsigned char **p,
unsigned char *end);
771 LWS_VISIBLE LWS_EXTERN
int LWS_WARN_UNUSED_RESULT
772 lws_http_transaction_completed(
struct lws *wsi);
781 LWS_VISIBLE LWS_EXTERN
int
782 lws_http_headers_detach(
struct lws *wsi);
792 LWS_VISIBLE LWS_EXTERN
int
793 lws_http_mark_sse(
struct lws *wsi);
810 LWS_VISIBLE LWS_EXTERN
int
811 lws_h2_client_stream_long_poll_rxonly(
struct lws *wsi);
838 LWS_VISIBLE LWS_EXTERN
int
839 lws_http_compression_apply(
struct lws *wsi,
const char *name,
840 unsigned char **p,
unsigned char *end,
char decomp);
850 LWS_VISIBLE LWS_EXTERN
int
851 lws_http_is_redirected_to_get(
struct lws *wsi);
878 #define LWS_H2_STREAM_SID -1
879 LWS_VISIBLE LWS_EXTERN
int
880 lws_h2_update_peer_txcredit(
struct lws *wsi,
int sid,
int bump);
894 LWS_VISIBLE LWS_EXTERN
int
895 lws_h2_get_peer_txcredit_estimate(
struct lws *wsi);