1 2 /* 3 * Copyright (C) Igor Sysoev 4 * Copyright (C) NGINX, Inc. 5 */ 6 7 #ifndef _NXT_HTTP_H_INCLUDED_ 8 #define _NXT_HTTP_H_INCLUDED_ 9 10 #include <nxt_regex.h> 11 12 13 typedef enum { 14 NXT_HTTP_UNSET = -1, 15 NXT_HTTP_INVALID = 0, 16 17 NXT_HTTP_CONTINUE = 100, 18 NXT_HTTP_SWITCHING_PROTOCOLS = 101, 19 20 NXT_HTTP_OK = 200, 21 NXT_HTTP_NO_CONTENT = 204, 22 23 NXT_HTTP_MULTIPLE_CHOICES = 300, 24 NXT_HTTP_MOVED_PERMANENTLY = 301, 25 NXT_HTTP_FOUND = 302, 26 NXT_HTTP_SEE_OTHER = 303, 27 NXT_HTTP_NOT_MODIFIED = 304, 28 NXT_HTTP_TEMPORARY_REDIRECT = 307, 29 NXT_HTTP_PERMANENT_REDIRECT = 308, 30 31 NXT_HTTP_BAD_REQUEST = 400, 32 NXT_HTTP_FORBIDDEN = 403, 33 NXT_HTTP_NOT_FOUND = 404, 34 NXT_HTTP_METHOD_NOT_ALLOWED = 405, 35 NXT_HTTP_REQUEST_TIMEOUT = 408, 36 NXT_HTTP_LENGTH_REQUIRED = 411, 37 NXT_HTTP_PAYLOAD_TOO_LARGE = 413, 38 NXT_HTTP_URI_TOO_LONG = 414, 39 NXT_HTTP_UPGRADE_REQUIRED = 426, 40 NXT_HTTP_REQUEST_HEADER_FIELDS_TOO_LARGE = 431, 41 42 NXT_HTTP_TO_HTTPS = 497, 43 44 NXT_HTTP_INTERNAL_SERVER_ERROR = 500, 45 NXT_HTTP_NOT_IMPLEMENTED = 501, 46 NXT_HTTP_BAD_GATEWAY = 502, 47 NXT_HTTP_SERVICE_UNAVAILABLE = 503, 48 NXT_HTTP_GATEWAY_TIMEOUT = 504, 49 NXT_HTTP_VERSION_NOT_SUPPORTED = 505, 50 NXT_HTTP_SERVER_ERROR_MAX = 599, 51 52 NXT_HTTP_STATUS_MAX = 999, 53 } nxt_http_status_t; 54 55 56 typedef enum { 57 NXT_HTTP_TE_NONE = 0, 58 NXT_HTTP_TE_CHUNKED = 1, 59 NXT_HTTP_TE_UNSUPPORTED = 2, 60 } nxt_http_te_t; 61 62 63 typedef enum { 64 NXT_HTTP_PROTO_H1 = 0, 65 NXT_HTTP_PROTO_H2, 66 NXT_HTTP_PROTO_DEVNULL, 67 } nxt_http_protocol_t; 68 69 70 typedef struct { 71 nxt_work_handler_t ready_handler; 72 nxt_work_handler_t error_handler; 73 } nxt_http_request_state_t; 74 75 76 typedef struct nxt_h1proto_s nxt_h1proto_t; 77 78 struct nxt_h1p_websocket_timer_s { 79 nxt_timer_t timer; 80 nxt_h1proto_t *h1p; 81 nxt_msec_t keepalive_interval; 82 }; 83 84 85 typedef union { 86 void *any; 87 nxt_h1proto_t *h1; 88 } nxt_http_proto_t; 89 90 91 #define nxt_http_field_name_set(_field, _name) \ 92 do { \ 93 (_field)->name_length = nxt_length(_name); \ 94 (_field)->name = (u_char *) _name; \ 95 } while (0) 96 97 98 #define nxt_http_field_set(_field, _name, _value) \ 99 do { \ 100 (_field)->name_length = nxt_length(_name); \ 101 (_field)->value_length = nxt_length(_value); \ 102 (_field)->name = (u_char *) _name; \ 103 (_field)->value = (u_char *) _value; \ 104 } while (0) 105 106 107 typedef struct { 108 nxt_list_t *fields; 109 nxt_http_field_t *date; 110 nxt_http_field_t *content_type; 111 nxt_http_field_t *content_length; 112 nxt_off_t content_length_n; 113 } nxt_http_response_t; 114 115 116 typedef struct nxt_upstream_server_s nxt_upstream_server_t; 117 118 typedef struct { 119 nxt_http_proto_t proto; 120 nxt_http_request_t *request; 121 nxt_upstream_server_t *server; 122 nxt_list_t *fields; 123 nxt_buf_t *body; 124 125 nxt_http_status_t status:16; 126 nxt_http_protocol_t protocol:8; /* 2 bits */ 127 uint8_t header_received; /* 1 bit */ 128 uint8_t closed; /* 1 bit */ 129 } nxt_http_peer_t; 130 131 132 struct nxt_http_request_s { 133 nxt_http_proto_t proto; 134 nxt_socket_conf_joint_t *conf; 135 136 nxt_mp_t *mem_pool; 137 138 nxt_buf_t *body; 139 nxt_buf_t *ws_frame; 140 nxt_buf_t *out; 141 const nxt_http_request_state_t *state; 142 143 nxt_str_t host; 144 nxt_str_t server_name; 145 nxt_str_t target; 146 nxt_str_t version; 147 nxt_str_t *method; 148 nxt_str_t *path; 149 nxt_str_t *args; 150 151 nxt_array_t *arguments; /* of nxt_http_name_value_t */ 152 nxt_array_t *cookies; /* of nxt_http_name_value_t */ 153 nxt_list_t *fields; 154 nxt_http_field_t *content_type; 155 nxt_http_field_t *content_length; 156 nxt_http_field_t *cookie; 157 nxt_http_field_t *referer; 158 nxt_http_field_t *user_agent; 159 nxt_http_field_t *authorization; 160 nxt_off_t content_length_n; 161 162 nxt_sockaddr_t *remote; 163 nxt_sockaddr_t *local; 164 void *tls; 165 nxt_task_t task; 166 167 nxt_timer_t timer; 168 void *timer_data; 169 170 nxt_var_query_t *var_query; 171 172 void *req_rpc_data; 173 174 #if (NXT_HAVE_REGEX) 175 nxt_regex_match_t *regex_match; 176 #endif 177 178 nxt_http_peer_t *peer; 179 nxt_buf_t *last; 180 181 nxt_queue_link_t app_link; /* nxt_app_t.ack_waiting_req */ 182 nxt_event_engine_t *engine; 183 nxt_work_t err_work; 184 185 nxt_http_response_t resp; 186 187 nxt_http_status_t status:16; 188 189 uint8_t pass_count; /* 8 bits */ 190 uint8_t app_target; 191 nxt_http_protocol_t protocol:8; /* 2 bits */ 192 uint8_t logged; /* 1 bit */ 193 uint8_t header_sent; /* 1 bit */ 194 uint8_t inconsistent; /* 1 bit */ 195 uint8_t error; /* 1 bit */ 196 uint8_t websocket_handshake; /* 1 bit */ 197 }; 198 199 200 typedef struct nxt_http_route_s nxt_http_route_t; 201 202 203 struct nxt_http_action_s { 204 nxt_http_action_t *(*handler)(nxt_task_t *task, 205 nxt_http_request_t *r, 206 nxt_http_action_t *action); 207 union { 208 nxt_http_route_t *route; 209 nxt_upstream_t *upstream; 210 uint32_t upstream_number; 211 nxt_http_status_t return_code; 212 nxt_var_t *var; 213 214 struct { 215 nxt_app_t *application; 216 nxt_int_t target; 217 } app; 218 219 struct { 220 nxt_http_action_t *fallback; 221 } share; 222 } u; 223 224 nxt_str_t name; 225 }; 226 227 228 typedef struct { 229 void (*body_read)(nxt_task_t *task, nxt_http_request_t *r); 230 void (*local_addr)(nxt_task_t *task, nxt_http_request_t *r); 231 void (*header_send)(nxt_task_t *task, nxt_http_request_t *r, 232 nxt_work_handler_t body_handler, void *data); 233 void (*send)(nxt_task_t *task, nxt_http_request_t *r, nxt_buf_t *out); 234 nxt_off_t (*body_bytes_sent)(nxt_task_t *task, nxt_http_proto_t proto); 235 void (*discard)(nxt_task_t *task, nxt_http_request_t *r, nxt_buf_t *last); 236 void (*close)(nxt_task_t *task, nxt_http_proto_t proto, 237 nxt_socket_conf_joint_t *joint); 238 239 void (*peer_connect)(nxt_task_t *task, nxt_http_peer_t *peer); 240 void (*peer_header_send)(nxt_task_t *task, nxt_http_peer_t *peer); 241 void (*peer_header_read)(nxt_task_t *task, nxt_http_peer_t *peer); 242 void (*peer_read)(nxt_task_t *task, nxt_http_peer_t *peer); 243 void (*peer_close)(nxt_task_t *task, nxt_http_peer_t *peer); 244 245 void (*ws_frame_start)(nxt_task_t *task, nxt_http_request_t *r, 246 nxt_buf_t *ws_frame); 247 } nxt_http_proto_table_t; 248 249 250 #define NXT_HTTP_DATE_LEN nxt_length("Wed, 31 Dec 1986 16:40:00 GMT") 251 252 nxt_inline u_char * 253 nxt_http_date(u_char *buf, struct tm *tm) 254 { 255 static const char *week[] = { "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", 256 "Sat" }; 257 258 static const char *month[] = { "Jan", "Feb", "Mar", "Apr", "May", "Jun", 259 "Jul", "Aug", "Sep", "Oct", "Nov", "Dec" }; 260 261 return nxt_sprintf(buf, buf + NXT_HTTP_DATE_LEN, 262 "%s, %02d %s %4d %02d:%02d:%02d GMT", 263 week[tm->tm_wday], tm->tm_mday, 264 month[tm->tm_mon], tm->tm_year + 1900, 265 tm->tm_hour, tm->tm_min, tm->tm_sec); 266 } 267 268 269 nxt_int_t nxt_http_init(nxt_task_t *task); 270 nxt_int_t nxt_h1p_init(nxt_task_t *task); 271 nxt_int_t nxt_http_response_hash_init(nxt_task_t *task); 272 273 void nxt_http_conn_init(nxt_task_t *task, void *obj, void *data); 274 nxt_http_request_t *nxt_http_request_create(nxt_task_t *task); 275 void nxt_http_request_error(nxt_task_t *task, nxt_http_request_t *r, 276 nxt_http_status_t status); 277 void nxt_http_request_read_body(nxt_task_t *task, nxt_http_request_t *r); 278 void nxt_http_request_header_send(nxt_task_t *task, nxt_http_request_t *r, 279 nxt_work_handler_t body_handler, void *data); 280 void nxt_http_request_ws_frame_start(nxt_task_t *task, nxt_http_request_t *r, 281 nxt_buf_t *ws_frame); 282 void nxt_http_request_send(nxt_task_t *task, nxt_http_request_t *r, 283 nxt_buf_t *out); 284 nxt_buf_t *nxt_http_buf_mem(nxt_task_t *task, nxt_http_request_t *r, 285 size_t size); 286 nxt_buf_t *nxt_http_buf_last(nxt_http_request_t *r); 287 void nxt_http_request_error_handler(nxt_task_t *task, void *obj, void *data); 288 void nxt_http_request_close_handler(nxt_task_t *task, void *obj, void *data); 289 290 nxt_int_t nxt_http_request_host(void *ctx, nxt_http_field_t *field, 291 uintptr_t data); 292 nxt_int_t nxt_http_request_field(void *ctx, nxt_http_field_t *field, 293 uintptr_t offset); 294 nxt_int_t nxt_http_request_content_length(void *ctx, nxt_http_field_t *field, 295 uintptr_t data); 296 297 nxt_http_routes_t *nxt_http_routes_create(nxt_task_t *task, 298 nxt_router_temp_conf_t *tmcf, nxt_conf_value_t *routes_conf); 299 nxt_http_action_t *nxt_http_action_create(nxt_task_t *task, 300 nxt_router_temp_conf_t *tmcf, nxt_str_t *name); 301 nxt_int_t nxt_http_routes_resolve(nxt_task_t *task, 302 nxt_router_temp_conf_t *tmcf); 303 nxt_int_t nxt_http_pass_segments(nxt_mp_t *mp, nxt_str_t *pass, 304 nxt_str_t *segments, nxt_uint_t n); 305 nxt_http_action_t *nxt_http_pass_application(nxt_task_t *task, 306 nxt_router_conf_t *rtcf, nxt_str_t *name); 307 308 nxt_int_t nxt_upstreams_create(nxt_task_t *task, nxt_router_temp_conf_t *tmcf, 309 nxt_conf_value_t *conf); 310 nxt_int_t nxt_upstreams_joint_create(nxt_router_temp_conf_t *tmcf, 311 nxt_upstream_t ***upstream_joint); 312 313 void nxt_http_request_action(nxt_task_t *task, nxt_http_request_t *r, 314 nxt_http_action_t *action); 315 316 nxt_http_action_t *nxt_http_return_handler(nxt_task_t *task, 317 nxt_http_request_t *r, nxt_http_action_t *action); 318 319 nxt_http_action_t *nxt_http_static_handler(nxt_task_t *task, 320 nxt_http_request_t *r, nxt_http_action_t *action); 321 nxt_int_t nxt_http_static_mtypes_init(nxt_mp_t *mp, nxt_lvlhsh_t *hash); 322 nxt_int_t nxt_http_static_mtypes_hash_add(nxt_mp_t *mp, nxt_lvlhsh_t *hash, 323 nxt_str_t *extension, nxt_str_t *type); 324 nxt_str_t *nxt_http_static_mtypes_hash_find(nxt_lvlhsh_t *hash, 325 nxt_str_t *extension); 326 327 nxt_http_action_t *nxt_http_application_handler(nxt_task_t *task, 328 nxt_http_request_t *r, nxt_http_action_t *action); 329 nxt_int_t nxt_upstream_find(nxt_upstreams_t *upstreams, nxt_str_t *name, 330 nxt_http_action_t *action); 331 nxt_http_action_t *nxt_upstream_proxy_handler(nxt_task_t *task, 332 nxt_http_request_t *r, nxt_upstream_t *upstream); 333 334 335 nxt_int_t nxt_http_proxy_create(nxt_mp_t *mp, nxt_http_action_t *action); 336 nxt_int_t nxt_http_proxy_date(void *ctx, nxt_http_field_t *field, 337 uintptr_t data); 338 nxt_int_t nxt_http_proxy_content_length(void *ctx, nxt_http_field_t *field, 339 uintptr_t data); 340 nxt_int_t nxt_http_proxy_skip(void *ctx, nxt_http_field_t *field, 341 uintptr_t data); 342 nxt_buf_t *nxt_http_proxy_buf_mem_alloc(nxt_task_t *task, nxt_http_request_t *r, 343 size_t size); 344 void nxt_http_proxy_buf_mem_free(nxt_task_t *task, nxt_http_request_t *r, 345 nxt_buf_t *b); 346 347 extern nxt_time_string_t nxt_http_date_cache; 348 349 extern nxt_lvlhsh_t nxt_response_fields_hash; 350 351 extern const nxt_http_proto_table_t nxt_http_proto[]; 352 353 void nxt_h1p_websocket_first_frame_start(nxt_task_t *task, 354 nxt_http_request_t *r, nxt_buf_t *ws_frame); 355 void nxt_h1p_websocket_frame_start(nxt_task_t *task, nxt_http_request_t *r, 356 nxt_buf_t *ws_frame); 357 void nxt_h1p_complete_buffers(nxt_task_t *task, nxt_h1proto_t *h1p, 358 nxt_bool_t all); 359 nxt_msec_t nxt_h1p_conn_request_timer_value(nxt_conn_t *c, uintptr_t data); 360 361 extern const nxt_conn_state_t nxt_h1p_idle_close_state; 362 363 #endif /* _NXT_HTTP_H_INCLUDED_ */ 364