lws-http.h

/*
 * 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
 *
 * included from libwebsockets.h
 */
 
/* minimal space for typical headers and CSP stuff */
 
#define LWS_RECOMMENDED_MIN_HEADER_SPACE 2048
 
 
 
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 {
        unsigned 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,
#if defined(LWS_WITH_CUSTOM_HEADERS)
        WSI_TOKEN_UNKNOWN_VALUE_PART,
#endif
        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 int
lws_hdr_custom_length(struct lws *wsi, const char *name, int nlen);
 
LWS_VISIBLE LWS_EXTERN int
lws_hdr_custom_copy(struct lws *wsi, char *dst, int len, const char *name,
                    int nlen);
 
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);
 
LWS_VISIBLE LWS_EXTERN int LWS_WARN_UNUSED_RESULT
lws_http_get_uri_and_method(struct lws *wsi, char **puri_ptr, int *puri_len);
 
 
 
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 int
lws_http_headers_detach(struct lws *wsi);
 
LWS_VISIBLE LWS_EXTERN int
lws_http_mark_sse(struct lws *wsi);
 
LWS_VISIBLE int
lws_http_compression_apply(struct lws *wsi, const char *name,
                           unsigned char **p, unsigned char *end, char decomp);