| 1 | /*
|
|---|
| 2 | Unix SMB/CIFS implementation.
|
|---|
| 3 |
|
|---|
| 4 | HTTP library
|
|---|
| 5 |
|
|---|
| 6 | Copyright (C) 2013 Samuel Cabrero <samuelcabrero@kernevil.me>
|
|---|
| 7 |
|
|---|
| 8 | This program is free software; you can redistribute it and/or modify
|
|---|
| 9 | it under the terms of the GNU General Public License as published by
|
|---|
| 10 | the Free Software Foundation; either version 3 of the License, or
|
|---|
| 11 | (at your option) any later version.
|
|---|
| 12 |
|
|---|
| 13 | This program is distributed in the hope that it will be useful,
|
|---|
| 14 | but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|---|
| 15 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|---|
| 16 | GNU General Public License for more details.
|
|---|
| 17 |
|
|---|
| 18 | You should have received a copy of the GNU General Public License
|
|---|
| 19 | along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|---|
| 20 | */
|
|---|
| 21 |
|
|---|
| 22 | #ifndef _HTTP_H_
|
|---|
| 23 | #define _HTTP_H_
|
|---|
| 24 |
|
|---|
| 25 | #include <limits.h>
|
|---|
| 26 | #include <sys/uio.h>
|
|---|
| 27 |
|
|---|
| 28 | #include <tevent.h>
|
|---|
| 29 | #include "lib/tsocket/tsocket.h"
|
|---|
| 30 |
|
|---|
| 31 | /* Response codes */
|
|---|
| 32 | #define HTTP_OK 200 /* request completed ok */
|
|---|
| 33 | #define HTTP_NOCONTENT 204 /* request does not have content */
|
|---|
| 34 | #define HTTP_MOVEPERM 301 /* uri moved permanently */
|
|---|
| 35 | #define HTTP_MOVETEMP 302 /* uri moved temporarily */
|
|---|
| 36 | #define HTTP_NOTMODIFIED 304 /* page was not modified from last */
|
|---|
| 37 | #define HTTP_BADREQUEST 400 /* invalid http request was made */
|
|---|
| 38 | #define HTTP_NOTFOUND 404 /* could not find content for uri */
|
|---|
| 39 | #define HTTP_BADMETHOD 405 /* method not allowed for this uri */
|
|---|
| 40 | #define HTTP_ENTITYTOOLARGE 413 /* */
|
|---|
| 41 | #define HTTP_EXPECTATIONFAILED 417 /* can't handle this expectation */
|
|---|
| 42 | #define HTTP_INTERNAL 500 /* internal error */
|
|---|
| 43 | #define HTTP_NOTIMPLEMENTED 501 /* not implemented */
|
|---|
| 44 | #define HTTP_SERVUNAVAIL 503 /* server is not available */
|
|---|
| 45 |
|
|---|
| 46 | #define HTTP_MAX_HEADER_SIZE UINT_MAX
|
|---|
| 47 |
|
|---|
| 48 | struct cli_credentials;
|
|---|
| 49 | struct loadparm_ctx;
|
|---|
| 50 |
|
|---|
| 51 | enum http_cmd_type {
|
|---|
| 52 | HTTP_REQ_GET = 1 << 0,
|
|---|
| 53 | HTTP_REQ_POST = 1 << 1,
|
|---|
| 54 | HTTP_REQ_HEAD = 1 << 2,
|
|---|
| 55 | HTTP_REQ_PUT = 1 << 3,
|
|---|
| 56 | HTTP_REQ_DELETE = 1 << 4,
|
|---|
| 57 | HTTP_REQ_OPTIONS = 1 << 5,
|
|---|
| 58 | HTTP_REQ_TRACE = 1 << 6,
|
|---|
| 59 | HTTP_REQ_CONNECT = 1 << 7,
|
|---|
| 60 | HTTP_REQ_PATCH = 1 << 8,
|
|---|
| 61 | HTTP_REQ_RPC_IN_DATA = 1 << 9,
|
|---|
| 62 | HTTP_REQ_RPC_OUT_DATA = 1 << 10,
|
|---|
| 63 | };
|
|---|
| 64 |
|
|---|
| 65 | enum http_auth_method {
|
|---|
| 66 | HTTP_AUTH_BASIC=1,
|
|---|
| 67 | HTTP_AUTH_NTLM,
|
|---|
| 68 | };
|
|---|
| 69 |
|
|---|
| 70 | struct http_header {
|
|---|
| 71 | struct http_header *next, *prev;
|
|---|
| 72 | char *key;
|
|---|
| 73 | char *value;
|
|---|
| 74 | };
|
|---|
| 75 |
|
|---|
| 76 | struct http_request {
|
|---|
| 77 | enum http_cmd_type type; /* HTTP command type */
|
|---|
| 78 | char major; /* HTTP version major number */
|
|---|
| 79 | char minor; /* HTTP version minor number */
|
|---|
| 80 | char *uri; /* URI after HTTP request was parsed */
|
|---|
| 81 | struct http_header *headers;
|
|---|
| 82 | size_t headers_size;
|
|---|
| 83 | unsigned int response_code; /* HTTP response code */
|
|---|
| 84 | char *response_code_line; /* Readable response */
|
|---|
| 85 | DATA_BLOB body;
|
|---|
| 86 | };
|
|---|
| 87 |
|
|---|
| 88 | /* HTTP header handling functions */
|
|---|
| 89 | int http_remove_header(struct http_header **, const char *);
|
|---|
| 90 | int http_add_header(TALLOC_CTX *, struct http_header **, const char *, const char *);
|
|---|
| 91 | int http_replace_header(TALLOC_CTX *, struct http_header **, const char *, const char *);
|
|---|
| 92 |
|
|---|
| 93 | /* HTTP request */
|
|---|
| 94 | struct tevent_req *http_send_request_send(TALLOC_CTX *,
|
|---|
| 95 | struct tevent_context *,
|
|---|
| 96 | struct tstream_context *,
|
|---|
| 97 | struct tevent_queue *,
|
|---|
| 98 | struct http_request *);
|
|---|
| 99 | NTSTATUS http_send_request_recv(struct tevent_req *);
|
|---|
| 100 |
|
|---|
| 101 | /* HTTP response */
|
|---|
| 102 | struct tevent_req *http_read_response_send(TALLOC_CTX *,
|
|---|
| 103 | struct tevent_context *,
|
|---|
| 104 | struct tstream_context *);
|
|---|
| 105 | NTSTATUS http_read_response_recv(struct tevent_req *,
|
|---|
| 106 | TALLOC_CTX *,
|
|---|
| 107 | struct http_request **);
|
|---|
| 108 |
|
|---|
| 109 | /* HTTP authenticated request */
|
|---|
| 110 | struct tevent_req *http_send_auth_request_send(TALLOC_CTX *,
|
|---|
| 111 | struct tevent_context *,
|
|---|
| 112 | struct tstream_context *,
|
|---|
| 113 | struct tevent_queue *,
|
|---|
| 114 | struct http_request *,
|
|---|
| 115 | struct cli_credentials *,
|
|---|
| 116 | struct loadparm_context *,
|
|---|
| 117 | enum http_auth_method);
|
|---|
| 118 | NTSTATUS http_send_auth_request_recv(struct tevent_req *);
|
|---|
| 119 |
|
|---|
| 120 | #endif /* _HTTP_H_ */
|
|---|
