diff options
Diffstat (limited to 'deps/node/deps/llhttp/include/llhttp.h')
-rw-r--r-- | deps/node/deps/llhttp/include/llhttp.h | 361 |
1 files changed, 0 insertions, 361 deletions
diff --git a/deps/node/deps/llhttp/include/llhttp.h b/deps/node/deps/llhttp/include/llhttp.h deleted file mode 100644 index 20f2af60..00000000 --- a/deps/node/deps/llhttp/include/llhttp.h +++ /dev/null @@ -1,361 +0,0 @@ -#ifndef INCLUDE_LLHTTP_H_ -#define INCLUDE_LLHTTP_H_ - -#define LLHTTP_VERSION_MAJOR 1 -#define LLHTTP_VERSION_MINOR 1 -#define LLHTTP_VERSION_PATCH 1 - -#ifndef INCLUDE_LLHTTP_ITSELF_H_ -#define INCLUDE_LLHTTP_ITSELF_H_ -#ifdef __cplusplus -extern "C" { -#endif - -#include <stdint.h> - -typedef struct llhttp__internal_s llhttp__internal_t; -struct llhttp__internal_s { - int32_t _index; - void* _span_pos0; - void* _span_cb0; - int32_t error; - const char* reason; - const char* error_pos; - void* data; - void* _current; - uint64_t content_length; - uint8_t type; - uint8_t method; - uint8_t http_major; - uint8_t http_minor; - uint8_t header_state; - uint8_t flags; - uint8_t upgrade; - uint16_t status_code; - uint8_t finish; - void* settings; -}; - -int llhttp__internal_init(llhttp__internal_t* s); -int llhttp__internal_execute(llhttp__internal_t* s, const char* p, const char* endp); - -#ifdef __cplusplus -} /* extern "C" */ -#endif -#endif /* INCLUDE_LLHTTP_ITSELF_H_ */ - -#ifndef LLLLHTTP_C_HEADERS_ -#define LLLLHTTP_C_HEADERS_ -#ifdef __cplusplus -extern "C" { -#endif - -enum llhttp_errno { - HPE_OK = 0, - HPE_INTERNAL = 1, - HPE_STRICT = 2, - HPE_LF_EXPECTED = 3, - HPE_UNEXPECTED_CONTENT_LENGTH = 4, - HPE_CLOSED_CONNECTION = 5, - HPE_INVALID_METHOD = 6, - HPE_INVALID_URL = 7, - HPE_INVALID_CONSTANT = 8, - HPE_INVALID_VERSION = 9, - HPE_INVALID_HEADER_TOKEN = 10, - HPE_INVALID_CONTENT_LENGTH = 11, - HPE_INVALID_CHUNK_SIZE = 12, - HPE_INVALID_STATUS = 13, - HPE_INVALID_EOF_STATE = 14, - HPE_CB_MESSAGE_BEGIN = 15, - HPE_CB_HEADERS_COMPLETE = 16, - HPE_CB_MESSAGE_COMPLETE = 17, - HPE_CB_CHUNK_HEADER = 18, - HPE_CB_CHUNK_COMPLETE = 19, - HPE_PAUSED = 20, - HPE_PAUSED_UPGRADE = 21, - HPE_USER = 22 -}; -typedef enum llhttp_errno llhttp_errno_t; - -enum llhttp_flags { - F_CONNECTION_KEEP_ALIVE = 0x1, - F_CONNECTION_CLOSE = 0x2, - F_CONNECTION_UPGRADE = 0x4, - F_CHUNKED = 0x8, - F_UPGRADE = 0x10, - F_CONTENT_LENGTH = 0x20, - F_SKIPBODY = 0x40, - F_TRAILING = 0x80 -}; -typedef enum llhttp_flags llhttp_flags_t; - -enum llhttp_type { - HTTP_BOTH = 0, - HTTP_REQUEST = 1, - HTTP_RESPONSE = 2 -}; -typedef enum llhttp_type llhttp_type_t; - -enum llhttp_finish { - HTTP_FINISH_SAFE = 0, - HTTP_FINISH_SAFE_WITH_CB = 1, - HTTP_FINISH_UNSAFE = 2 -}; -typedef enum llhttp_finish llhttp_finish_t; - -enum llhttp_method { - HTTP_DELETE = 0, - HTTP_GET = 1, - HTTP_HEAD = 2, - HTTP_POST = 3, - HTTP_PUT = 4, - HTTP_CONNECT = 5, - HTTP_OPTIONS = 6, - HTTP_TRACE = 7, - HTTP_COPY = 8, - HTTP_LOCK = 9, - HTTP_MKCOL = 10, - HTTP_MOVE = 11, - HTTP_PROPFIND = 12, - HTTP_PROPPATCH = 13, - HTTP_SEARCH = 14, - HTTP_UNLOCK = 15, - HTTP_BIND = 16, - HTTP_REBIND = 17, - HTTP_UNBIND = 18, - HTTP_ACL = 19, - HTTP_REPORT = 20, - HTTP_MKACTIVITY = 21, - HTTP_CHECKOUT = 22, - HTTP_MERGE = 23, - HTTP_MSEARCH = 24, - HTTP_NOTIFY = 25, - HTTP_SUBSCRIBE = 26, - HTTP_UNSUBSCRIBE = 27, - HTTP_PATCH = 28, - HTTP_PURGE = 29, - HTTP_MKCALENDAR = 30, - HTTP_LINK = 31, - HTTP_UNLINK = 32, - HTTP_SOURCE = 33 -}; -typedef enum llhttp_method llhttp_method_t; - -#define HTTP_ERRNO_MAP(XX) \ - XX(0, OK, OK) \ - XX(1, INTERNAL, INTERNAL) \ - XX(2, STRICT, STRICT) \ - XX(3, LF_EXPECTED, LF_EXPECTED) \ - XX(4, UNEXPECTED_CONTENT_LENGTH, UNEXPECTED_CONTENT_LENGTH) \ - XX(5, CLOSED_CONNECTION, CLOSED_CONNECTION) \ - XX(6, INVALID_METHOD, INVALID_METHOD) \ - XX(7, INVALID_URL, INVALID_URL) \ - XX(8, INVALID_CONSTANT, INVALID_CONSTANT) \ - XX(9, INVALID_VERSION, INVALID_VERSION) \ - XX(10, INVALID_HEADER_TOKEN, INVALID_HEADER_TOKEN) \ - XX(11, INVALID_CONTENT_LENGTH, INVALID_CONTENT_LENGTH) \ - XX(12, INVALID_CHUNK_SIZE, INVALID_CHUNK_SIZE) \ - XX(13, INVALID_STATUS, INVALID_STATUS) \ - XX(14, INVALID_EOF_STATE, INVALID_EOF_STATE) \ - XX(15, CB_MESSAGE_BEGIN, CB_MESSAGE_BEGIN) \ - XX(16, CB_HEADERS_COMPLETE, CB_HEADERS_COMPLETE) \ - XX(17, CB_MESSAGE_COMPLETE, CB_MESSAGE_COMPLETE) \ - XX(18, CB_CHUNK_HEADER, CB_CHUNK_HEADER) \ - XX(19, CB_CHUNK_COMPLETE, CB_CHUNK_COMPLETE) \ - XX(20, PAUSED, PAUSED) \ - XX(21, PAUSED_UPGRADE, PAUSED_UPGRADE) \ - XX(22, USER, USER) \ - - -#define HTTP_METHOD_MAP(XX) \ - XX(0, DELETE, DELETE) \ - XX(1, GET, GET) \ - XX(2, HEAD, HEAD) \ - XX(3, POST, POST) \ - XX(4, PUT, PUT) \ - XX(5, CONNECT, CONNECT) \ - XX(6, OPTIONS, OPTIONS) \ - XX(7, TRACE, TRACE) \ - XX(8, COPY, COPY) \ - XX(9, LOCK, LOCK) \ - XX(10, MKCOL, MKCOL) \ - XX(11, MOVE, MOVE) \ - XX(12, PROPFIND, PROPFIND) \ - XX(13, PROPPATCH, PROPPATCH) \ - XX(14, SEARCH, SEARCH) \ - XX(15, UNLOCK, UNLOCK) \ - XX(16, BIND, BIND) \ - XX(17, REBIND, REBIND) \ - XX(18, UNBIND, UNBIND) \ - XX(19, ACL, ACL) \ - XX(20, REPORT, REPORT) \ - XX(21, MKACTIVITY, MKACTIVITY) \ - XX(22, CHECKOUT, CHECKOUT) \ - XX(23, MERGE, MERGE) \ - XX(24, MSEARCH, M-SEARCH) \ - XX(25, NOTIFY, NOTIFY) \ - XX(26, SUBSCRIBE, SUBSCRIBE) \ - XX(27, UNSUBSCRIBE, UNSUBSCRIBE) \ - XX(28, PATCH, PATCH) \ - XX(29, PURGE, PURGE) \ - XX(30, MKCALENDAR, MKCALENDAR) \ - XX(31, LINK, LINK) \ - XX(32, UNLINK, UNLINK) \ - XX(33, SOURCE, SOURCE) \ - - - -#ifdef __cplusplus -} /* extern "C" */ -#endif -#endif /* LLLLHTTP_C_HEADERS_ */ - -#ifndef INCLUDE_LLHTTP_API_H_ -#define INCLUDE_LLHTTP_API_H_ -#ifdef __cplusplus -extern "C" { -#endif -#include <stddef.h> - -typedef llhttp__internal_t llhttp_t; -typedef struct llhttp_settings_s llhttp_settings_t; - -typedef int (*llhttp_data_cb)(llhttp_t*, const char *at, size_t length); -typedef int (*llhttp_cb)(llhttp_t*); - -struct llhttp_settings_s { - /* Possible return values 0, -1, `HPE_PAUSED` */ - llhttp_cb on_message_begin; - - llhttp_data_cb on_url; - llhttp_data_cb on_status; - llhttp_data_cb on_header_field; - llhttp_data_cb on_header_value; - - /* Possible return values: - * 0 - Proceed normally - * 1 - Assume that request/response has no body, and proceed to parsing the - * next message - * 2 - Assume absence of body (as above) and make `llhttp_execute()` return - * `HPE_PAUSED_UPGRADE` - * -1 - Error - * `HPE_PAUSED` - */ - llhttp_cb on_headers_complete; - - llhttp_data_cb on_body; - - /* Possible return values 0, -1, `HPE_PAUSED` */ - llhttp_cb on_message_complete; - - /* When on_chunk_header is called, the current chunk length is stored - * in parser->content_length. - * Possible return values 0, -1, `HPE_PAUSED` - */ - llhttp_cb on_chunk_header; - llhttp_cb on_chunk_complete; -}; - -/* Initialize the parser with specific type and user settings */ -void llhttp_init(llhttp_t* parser, llhttp_type_t type, - const llhttp_settings_t* settings); - -/* Initialize the settings object */ -void llhttp_settings_init(llhttp_settings_t* settings); - -/* Parse full or partial request/response, invoking user callbacks along the - * way. - * - * If any of `llhttp_data_cb` returns errno not equal to `HPE_OK` - the parsing - * interrupts, and such errno is returned from `llhttp_execute()`. If - * `HPE_PAUSED` was used as a errno, the execution can be resumed with - * `llhttp_resume()` call. - * - * In a special case of CONNECT/Upgrade request/response `HPE_PAUSED_UPGRADE` - * is returned after fully parsing the request/response. If the user wishes to - * continue parsing, they need to invoke `llhttp_resume_after_upgrade()`. - * - * NOTE: if this function ever returns a non-pause type error, it will continue - * to return the same error upon each successive call up until `llhttp_init()` - * call. - */ -llhttp_errno_t llhttp_execute(llhttp_t* parser, const char* data, size_t len); - -/* This method should be called when the other side has no further bytes to - * send (e.g. shutdown of readable side of the TCP connection.) - * - * Requests without `Content-Length` and other messages might require treating - * all incoming bytes as the part of the body, up to the last byte of the - * connection. This method will invoke `on_message_complete()` callback if the - * request was terminated safely. Otherwise a error code would be returned. - */ -llhttp_errno_t llhttp_finish(llhttp_t* parser); - -/* Returns `1` if the incoming message is parsed until the last byte, and has - * to be completed by calling `llhttp_finish()` on EOF - */ -int llhttp_message_needs_eof(const llhttp_t* parser); - -/* Returns `1` if there might be any other messages following the last that was - * successfuly parsed. - */ -int llhttp_should_keep_alive(const llhttp_t* parser); - -/* Make further calls of `llhttp_execute()` return `HPE_PAUSED` and set - * appropriate error reason. - * - * Important: do not call this from user callbacks! User callbacks must return - * `HPE_PAUSED` if pausing is required. - */ -void llhttp_pause(llhttp_t* parser); - -/* Might be called to resume the execution after the pause in user's callback. - * See `llhttp_execute()` above for details. - * - * Call this only if `llhttp_execute()` returns `HPE_PAUSED`. - */ -void llhttp_resume(llhttp_t* parser); - -/* Might be called to resume the execution after the pause in user's callback. - * See `llhttp_execute()` above for details. - * - * Call this only if `llhttp_execute()` returns `HPE_PAUSED_UPGRADE` - */ -void llhttp_resume_after_upgrade(llhttp_t* parser); - -/* Returns the latest return error */ -llhttp_errno_t llhttp_get_errno(const llhttp_t* parser); - -/* Returns the verbal explanation of the latest returned error. - * - * Note: User callback should set error reason when returning the error. See - * `llhttp_set_error_reason()` for details. - */ -const char* llhttp_get_error_reason(const llhttp_t* parser); - -/* Assign verbal description to the returned error. Must be called in user - * callbacks right before returning the errno. - * - * Note: `HPE_USER` error code might be useful in user callbacks. - */ -void llhttp_set_error_reason(llhttp_t* parser, const char* reason); - -/* Returns the pointer to the last parsed byte before the returned error. The - * pointer is relative to the `data` argument of `llhttp_execute()`. - * - * Note: this method might be useful for counting the number of parsed bytes. - */ -const char* llhttp_get_error_pos(const llhttp_t* parser); - -/* Returns textual name of error code */ -const char* llhttp_errno_name(llhttp_errno_t err); - -/* Returns textual name of HTTP method */ -const char* llhttp_method_name(llhttp_method_t method); - -#ifdef __cplusplus -} /* extern "C" */ -#endif -#endif /* INCLUDE_LLHTTP_API_H_ */ - -#endif /* INCLUDE_LLHTTP_H_ */ |