picohttpparser.h (3537B)
1 /* 2 * Copyright (c) 2009-2014 Kazuho Oku, Tokuhiro Matsuno, Daisuke Murase, 3 * Shigeo Mitsunari 4 * 5 * The software is licensed under either the MIT License (below) or the Perl 6 * license. 7 * 8 * Permission is hereby granted, free of charge, to any person obtaining a copy 9 * of this software and associated documentation files (the "Software"), to 10 * deal in the Software without restriction, including without limitation the 11 * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or 12 * sell copies of the Software, and to permit persons to whom the Software is 13 * furnished to do so, subject to the following conditions: 14 * 15 * The above copyright notice and this permission notice shall be included in 16 * all copies or substantial portions of the Software. 17 * 18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 19 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 21 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 22 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 23 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS 24 * IN THE SOFTWARE. 25 */ 26 27 #ifndef picohttpparser_h 28 #define picohttpparser_h 29 30 #include <stdint.h> 31 #include <sys/types.h> 32 33 #ifdef _MSC_VER 34 #define ssize_t intptr_t 35 #endif 36 37 #ifdef __cplusplus 38 extern "C" { 39 #endif 40 41 /* contains name and value of a header (name == NULL if is a continuing line 42 * of a multiline header */ 43 struct phr_header { 44 const char *name; 45 size_t name_len; 46 const char *value; 47 size_t value_len; 48 }; 49 50 /* returns number of bytes consumed if successful, -2 if request is partial, 51 * -1 if failed */ 52 int phr_parse_request(const char *buf, size_t len, const char **method, size_t *method_len, const char **path, size_t *path_len, 53 int *minor_version, struct phr_header *headers, size_t *num_headers, size_t last_len); 54 55 /* ditto */ 56 int phr_parse_response(const char *_buf, size_t len, int *minor_version, int *status, const char **msg, size_t *msg_len, 57 struct phr_header *headers, size_t *num_headers, size_t last_len); 58 59 /* ditto */ 60 int phr_parse_headers(const char *buf, size_t len, struct phr_header *headers, size_t *num_headers, size_t last_len); 61 62 /* should be zero-filled before start */ 63 struct phr_chunked_decoder { 64 size_t bytes_left_in_chunk; /* number of bytes left in current chunk */ 65 char consume_trailer; /* if trailing headers should be consumed */ 66 char _hex_count; 67 char _state; 68 uint64_t _total_read; 69 uint64_t _total_overhead; 70 }; 71 72 /* the function rewrites the buffer given as (buf, bufsz) removing the chunked- 73 * encoding headers. When the function returns without an error, bufsz is 74 * updated to the length of the decoded data available. Applications should 75 * repeatedly call the function while it returns -2 (incomplete) every time 76 * supplying newly arrived data. If the end of the chunked-encoded data is 77 * found, the function returns a non-negative number indicating the number of 78 * octets left undecoded, that starts from the offset returned by `*bufsz`. 79 * Returns -1 on error. 80 */ 81 ssize_t phr_decode_chunked(struct phr_chunked_decoder *decoder, char *buf, size_t *bufsz); 82 83 /* returns if the chunked decoder is in middle of chunked data */ 84 int phr_decode_chunked_is_in_data(struct phr_chunked_decoder *decoder); 85 86 #ifdef __cplusplus 87 } 88 #endif 89 90 #endif