/* Unix SMB/CIFS implementation. HTTP library Copyright (C) 2013 Samuel Cabrero This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . */ #ifndef _HTTP_H_ #define _HTTP_H_ #include #include #include #include "lib/tsocket/tsocket.h" /* Response codes */ #define HTTP_OK 200 /* request completed ok */ #define HTTP_NOCONTENT 204 /* request does not have content */ #define HTTP_MOVEPERM 301 /* uri moved permanently */ #define HTTP_MOVETEMP 302 /* uri moved temporarily */ #define HTTP_NOTMODIFIED 304 /* page was not modified from last */ #define HTTP_BADREQUEST 400 /* invalid http request was made */ #define HTTP_NOTFOUND 404 /* could not find content for uri */ #define HTTP_BADMETHOD 405 /* method not allowed for this uri */ #define HTTP_ENTITYTOOLARGE 413 /* */ #define HTTP_EXPECTATIONFAILED 417 /* can't handle this expectation */ #define HTTP_INTERNAL 500 /* internal error */ #define HTTP_NOTIMPLEMENTED 501 /* not implemented */ #define HTTP_SERVUNAVAIL 503 /* server is not available */ #define HTTP_MAX_HEADER_SIZE 0x1FFFF struct cli_credentials; enum http_cmd_type { HTTP_REQ_GET = 1 << 0, HTTP_REQ_POST = 1 << 1, HTTP_REQ_HEAD = 1 << 2, HTTP_REQ_PUT = 1 << 3, HTTP_REQ_DELETE = 1 << 4, HTTP_REQ_OPTIONS = 1 << 5, HTTP_REQ_TRACE = 1 << 6, HTTP_REQ_CONNECT = 1 << 7, HTTP_REQ_PATCH = 1 << 8, HTTP_REQ_RPC_IN_DATA = 1 << 9, HTTP_REQ_RPC_OUT_DATA = 1 << 10, }; enum http_auth_method { HTTP_AUTH_BASIC=1, HTTP_AUTH_NTLM, HTTP_AUTH_NEGOTIATE, }; struct http_header { struct http_header *next, *prev; char *key; char *value; }; struct http_request { enum http_cmd_type type; /* HTTP command type */ char major; /* HTTP version major number */ char minor; /* HTTP version minor number */ char *uri; /* URI after HTTP request was parsed */ struct http_header *headers; size_t headers_size; unsigned int response_code; /* HTTP response code */ char *response_code_line; /* Readable response */ uint64_t remaining_content_length; /* data not represent in body */ DATA_BLOB body; }; /* HTTP header handling functions */ int http_remove_header(struct http_header **, const char *); int http_add_header(TALLOC_CTX *, struct http_header **, const char *, const char *); int http_replace_header(TALLOC_CTX *, struct http_header **, const char *, const char *); /* HTTP(s) connect */ struct http_conn; struct tstream_tls_params; struct tevent_req *http_connect_send(TALLOC_CTX *mem_ctx, struct tevent_context *ev, const char *http_server, uint16_t http_port, struct cli_credentials *credentials, struct tstream_tls_params *tls_params); int http_connect_recv(struct tevent_req *req, TALLOC_CTX *mem_ctx, struct http_conn **http_conn); struct tevent_req *http_disconnect_send(TALLOC_CTX *mem_ctx, struct tevent_context *ev, struct http_conn *http_conn); int http_disconnect_recv(struct tevent_req *req); struct tevent_queue *http_conn_send_queue(struct http_conn *http_conn); struct tstream_context *http_conn_tstream(struct http_conn *http_conn); /* HTTP request */ struct tevent_req *http_send_request_send(TALLOC_CTX *, struct tevent_context *, struct http_conn *, struct http_request *); NTSTATUS http_send_request_recv(struct tevent_req *); /* HTTP response */ struct tevent_req *http_read_response_send(TALLOC_CTX *, struct tevent_context *, struct http_conn *, size_t max_content_length); NTSTATUS http_read_response_recv(struct tevent_req *, TALLOC_CTX *, struct http_request **); /* HTTP authenticated request */ struct tevent_req *http_send_auth_request_send(TALLOC_CTX *, struct tevent_context *, struct http_conn *, const struct http_request *, struct cli_credentials *, struct loadparm_context *, enum http_auth_method); NTSTATUS http_send_auth_request_recv(struct tevent_req *); #endif /* _HTTP_H_ */