1/* $OpenBSD: http.h,v 1.17 2024/03/24 10:53:27 job Exp $ */ 2 3/* 4 * Copyright (c) 2012 - 2015 Reyk Floeter <reyk@openbsd.org> 5 * 6 * Permission to use, copy, modify, and distribute this software for any 7 * purpose with or without fee is hereby granted, provided that the above 8 * copyright notice and this permission notice appear in all copies. 9 * 10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 13 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 15 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 16 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 17 */ 18 19#ifndef HTTP_H 20#define HTTP_H 21 22#define HTTP_PORT 80 23#define HTTPS_PORT 443 24 25enum httpmethod { 26 HTTP_METHOD_NONE = 0, 27 28 /* HTTP/1.1, RFC 7231 */ 29 HTTP_METHOD_GET, 30 HTTP_METHOD_HEAD, 31 HTTP_METHOD_POST, 32 HTTP_METHOD_PUT, 33 HTTP_METHOD_DELETE, 34 HTTP_METHOD_OPTIONS, 35 HTTP_METHOD_TRACE, 36 HTTP_METHOD_CONNECT, 37 38 /* WebDAV, RFC 4918 */ 39 HTTP_METHOD_PROPFIND, 40 HTTP_METHOD_PROPPATCH, 41 HTTP_METHOD_MKCOL, 42 HTTP_METHOD_COPY, 43 HTTP_METHOD_MOVE, 44 HTTP_METHOD_LOCK, 45 HTTP_METHOD_UNLOCK, 46 47 /* WebDAV Versioning Extension, RFC 3253 */ 48 HTTP_METHOD_VERSION_CONTROL, 49 HTTP_METHOD_REPORT, 50 HTTP_METHOD_CHECKOUT, 51 HTTP_METHOD_CHECKIN, 52 HTTP_METHOD_UNCHECKOUT, 53 HTTP_METHOD_MKWORKSPACE, 54 HTTP_METHOD_UPDATE, 55 HTTP_METHOD_LABEL, 56 HTTP_METHOD_MERGE, 57 HTTP_METHOD_BASELINE_CONTROL, 58 HTTP_METHOD_MKACTIVITY, 59 60 /* WebDAV Ordered Collections, RFC 3648 */ 61 HTTP_METHOD_ORDERPATCH, 62 63 /* WebDAV Access Control, RFC 3744 */ 64 HTTP_METHOD_ACL, 65 66 /* WebDAV Redirect Reference Resources, RFC 4437 */ 67 HTTP_METHOD_MKREDIRECTREF, 68 HTTP_METHOD_UPDATEREDIRECTREF, 69 70 /* WebDAV Search, RFC 5323 */ 71 HTTP_METHOD_SEARCH, 72 73 /* PATCH, RFC 5789 */ 74 HTTP_METHOD_PATCH, 75 76 /* Server response (internal value) */ 77 HTTP_METHOD_RESPONSE 78}; 79 80struct http_method { 81 enum httpmethod method_id; 82 const char *method_name; 83}; 84#define HTTP_METHODS { \ 85 { HTTP_METHOD_GET, "GET" }, \ 86 { HTTP_METHOD_HEAD, "HEAD" }, \ 87 { HTTP_METHOD_POST, "POST" }, \ 88 { HTTP_METHOD_PUT, "PUT" }, \ 89 { HTTP_METHOD_DELETE, "DELETE" }, \ 90 { HTTP_METHOD_OPTIONS, "OPTIONS" }, \ 91 { HTTP_METHOD_TRACE, "TRACE" }, \ 92 { HTTP_METHOD_CONNECT, "CONNECT" }, \ 93 { HTTP_METHOD_PROPFIND, "PROPFIND" }, \ 94 { HTTP_METHOD_PROPPATCH, "PROPPATCH" }, \ 95 { HTTP_METHOD_MKCOL, "MKCOL" }, \ 96 { HTTP_METHOD_COPY, "COPY" }, \ 97 { HTTP_METHOD_MOVE, "MOVE" }, \ 98 { HTTP_METHOD_LOCK, "LOCK" }, \ 99 { HTTP_METHOD_UNLOCK, "UNLOCK" }, \ 100 { HTTP_METHOD_VERSION_CONTROL, "VERSION-CONTROL" }, \ 101 { HTTP_METHOD_REPORT, "REPORT" }, \ 102 { HTTP_METHOD_CHECKOUT, "CHECKOUT" }, \ 103 { HTTP_METHOD_CHECKIN, "CHECKIN" }, \ 104 { HTTP_METHOD_UNCHECKOUT, "UNCHECKOUT" }, \ 105 { HTTP_METHOD_MKWORKSPACE, "MKWORKSPACE" }, \ 106 { HTTP_METHOD_UPDATE, "UPDATE" }, \ 107 { HTTP_METHOD_LABEL, "LABEL" }, \ 108 { HTTP_METHOD_MERGE, "MERGE" }, \ 109 { HTTP_METHOD_BASELINE_CONTROL, "BASELINE-CONTROL" }, \ 110 { HTTP_METHOD_MKACTIVITY, "MKACTIVITY" }, \ 111 { HTTP_METHOD_ORDERPATCH, "ORDERPATCH" }, \ 112 { HTTP_METHOD_ACL, "ACL" }, \ 113 { HTTP_METHOD_MKREDIRECTREF, "MKREDIRECTREF" }, \ 114 { HTTP_METHOD_UPDATEREDIRECTREF, "UPDATEREDIRECTREF" }, \ 115 { HTTP_METHOD_SEARCH, "SEARCH" }, \ 116 { HTTP_METHOD_PATCH, "PATCH" }, \ 117 { HTTP_METHOD_NONE, NULL } \ 118} 119 120struct http_error { 121 int error_code; 122 const char *error_name; 123}; 124 125/* 126 * HTTP status codes based on IANA assignments (2014-06-11 version): 127 * https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml 128 * plus legacy (306) and non-standard (420). 129 */ 130#define HTTP_ERRORS { \ 131 { 100, "Continue" }, \ 132 { 101, "Switching Protocols" }, \ 133 { 102, "Processing" }, \ 134 { 103, "Early Hints" }, \ 135 /* 104-199 unassigned */ \ 136 { 200, "OK" }, \ 137 { 201, "Created" }, \ 138 { 202, "Accepted" }, \ 139 { 203, "Non-Authoritative Information" }, \ 140 { 204, "No Content" }, \ 141 { 205, "Reset Content" }, \ 142 { 206, "Partial Content" }, \ 143 { 207, "Multi-Status" }, \ 144 { 208, "Already Reported" }, \ 145 /* 209-225 unassigned */ \ 146 { 226, "IM Used" }, \ 147 /* 227-299 unassigned */ \ 148 { 300, "Multiple Choices" }, \ 149 { 301, "Moved Permanently" }, \ 150 { 302, "Found" }, \ 151 { 303, "See Other" }, \ 152 { 304, "Not Modified" }, \ 153 { 305, "Use Proxy" }, \ 154 { 306, "Switch Proxy" }, \ 155 { 307, "Temporary Redirect" }, \ 156 { 308, "Permanent Redirect" }, \ 157 /* 309-399 unassigned */ \ 158 { 400, "Bad Request" }, \ 159 { 401, "Unauthorized" }, \ 160 { 402, "Payment Required" }, \ 161 { 403, "Forbidden" }, \ 162 { 404, "Not Found" }, \ 163 { 405, "Method Not Allowed" }, \ 164 { 406, "Not Acceptable" }, \ 165 { 407, "Proxy Authentication Required" }, \ 166 { 408, "Request Timeout" }, \ 167 { 409, "Conflict" }, \ 168 { 410, "Gone" }, \ 169 { 411, "Length Required" }, \ 170 { 412, "Precondition Failed" }, \ 171 { 413, "Payload Too Large" }, \ 172 { 414, "URI Too Long" }, \ 173 { 415, "Unsupported Media Type" }, \ 174 { 416, "Range Not Satisfiable" }, \ 175 { 417, "Expectation Failed" }, \ 176 { 418, "I'm a teapot" }, \ 177 /* 419-421 unassigned */ \ 178 { 420, "Enhance Your Calm" }, \ 179 { 422, "Unprocessable Content" }, \ 180 { 423, "Locked" }, \ 181 { 424, "Failed Dependency" }, \ 182 { 425, "Too Early" }, \ 183 { 426, "Upgrade Required" }, \ 184 /* 427 unassigned */ \ 185 { 428, "Precondition Required" }, \ 186 { 429, "Too Many Requests" }, \ 187 /* 430 unassigned */ \ 188 { 431, "Request Header Fields Too Large" }, \ 189 /* 432-450 unassigned */ \ 190 { 451, "Unavailable For Legal Reasons" }, \ 191 /* 452-499 unassigned */ \ 192 { 500, "Internal Server Error" }, \ 193 { 501, "Not Implemented" }, \ 194 { 502, "Bad Gateway" }, \ 195 { 503, "Service Unavailable" }, \ 196 { 504, "Gateway Timeout" }, \ 197 { 505, "HTTP Version Not Supported" }, \ 198 { 506, "Variant Also Negotiates" }, \ 199 { 507, "Insufficient Storage" }, \ 200 { 508, "Loop Detected" }, \ 201 /* 509 unassigned */ \ 202 { 510, "Not Extended" }, \ 203 { 511, "Network Authentication Required" }, \ 204 /* 512-599 unassigned */ \ 205 { 0, NULL } \ 206} 207 208struct http_mediatype { 209 char *media_name; 210 char *media_type; 211 char *media_subtype; 212}; 213/* 214 * Some default media types based on (2014-08-04 version): 215 * https://www.iana.org/assignments/media-types/media-types.xhtml 216 */ 217#define MEDIA_TYPES { \ 218 { "css", "text", "css" }, \ 219 { "html", "text", "html" }, \ 220 { "txt", "text", "plain" }, \ 221 { "gif", "image", "gif" }, \ 222 { "jpeg", "image", "jpeg" }, \ 223 { "jpg", "image", "jpeg" }, \ 224 { "png", "image", "png" }, \ 225 { "svg", "image", "svg+xml" }, \ 226 { "js", "application", "javascript" }, \ 227 { NULL } \ 228} 229 230/* Used during runtime */ 231struct http_descriptor { 232 struct kv http_pathquery; 233 struct kv http_matchquery; 234#define http_path http_pathquery.kv_key 235#define http_query http_pathquery.kv_value 236#define http_rescode http_pathquery.kv_key 237#define http_resmesg http_pathquery.kv_value 238#define query_key http_matchquery.kv_key 239#define query_val http_matchquery.kv_value 240 241 char *http_host; 242 enum httpmethod http_method; 243 int http_chunked; 244 char *http_version; 245 unsigned int http_status; 246 247 /* Rewritten path and query remain NULL if not used */ 248 char *http_path_alias; 249 char *http_query_alias; 250 char *http_path_orig; 251 252 /* A tree of headers and attached lists for repeated headers. */ 253 struct kv *http_lastheader; 254 struct kvtree http_headers; 255}; 256 257#endif /* HTTP_H */ 258