name : multipart_parser.h /* Based on node-formidable by Felix Geisendörfer * Igor Afonov - afonov@gmail.com - 2012 * MIT License - http://www.opensource.org/licenses/mit-license.php * @link https://github.com/libcat/libcat/blob/develop/deps/multipart_parser */ #ifndef _multipart_parser_h #define _multipart_parser_h #ifdef __cplusplus extern "C" { #endif #include <stdio.h> #include <stdlib.h> #include <ctype.h> typedef struct multipart_parser multipart_parser; typedef struct multipart_parser_settings multipart_parser_settings; typedef struct multipart_parser_state multipart_parser_state; typedef int (*multipart_data_cb)(multipart_parser *, const char *at, size_t length); typedef int (*multipart_notify_cb)(multipart_parser *); enum multipart_error { MPPE_OK = 0, MPPE_PAUSED, MPPE_UNKNOWN, MPPE_BOUNDARY_END_NO_CRLF, MPPE_BAD_START_BOUNDARY, MPPE_INVALID_HEADER_FIELD_CHAR, MPPE_INVALID_HEADER_VALUE_CHAR, MPPE_BAD_PART_END, MPPE_END_BOUNDARY_NO_DASH, MPPE_HEADER_VALUE_INCOMPLETE, }; #define MPPE_ERROR -1 // from RFC2046 #define BOUNDARY_MAX_LEN 70 struct multipart_parser { /* private holder for callbacks */ const multipart_parser_settings *settings; /* private internal index for matching boundary */ size_t index; /* public error unexpected char index */ size_t error_i; /* private boundary length + 2 ("--") */ unsigned char boundary_length; FILE *fp; void *data; /* private FSM state */ unsigned char state; /* public error reason */ unsigned char error_reason; /* private boundary storage: "--" + boundary */ char boundary[(2 + BOUNDARY_MAX_LEN) * 2 + 9]; /* public error expected char */ char error_expected; /* public error unexpected char */ char error_unexpected; }; struct multipart_parser_settings { /* * data callback called on header field coming * for example data is "Content-Type" with length 12 */ multipart_data_cb on_header_field; /* * data callback called on header value coming * for example data is "plain/text" with length 10 */ multipart_data_cb on_header_value; /* * data callback called on body data coming, * will be called repeatedly until data end */ multipart_data_cb on_part_data; /* * before "--" boundary */ multipart_notify_cb on_part_data_begin; /* * after all headers line "\r\n", before body */ multipart_notify_cb on_headers_complete; /* * after body, before next "--" boundary */ multipart_notify_cb on_part_data_end; /* * after last "--" boundary "--" */ multipart_notify_cb on_body_end; }; multipart_parser *multipart_parser_init(const char *boundary, size_t boundary_length, const multipart_parser_settings *settings); void multipart_parser_free(multipart_parser *p); /** * The multipart header must be complete, otherwise it will be parsed incorrectly */ ssize_t multipart_parser_execute(multipart_parser *p, const char *buf, size_t len); int multipart_parser_error_msg(multipart_parser *p, char *buf, size_t len); #ifdef __cplusplus } /* extern "C" */ #endif #endif