http-url.h revision 777776de3515b6721381d2230c4182b6401cdce1
#ifndef HTTP_URL_H
#define HTTP_URL_H
#include "net.h"
#include "uri-util.h"
#include "http-common.h"
struct http_request_target;
struct http_url {
/* server */
struct uri_host host;
in_port_t port;
/* userinfo (not parsed by default) */
const char *user;
const char *password;
/* path */
const char *path;
/* ?query (still encoded) */
const char *enc_query;
/* #fragment (still encoded) */
const char *enc_fragment;
bool have_ssl:1;
};
/*
* HTTP URL parsing
*/
enum http_url_parse_flags {
/* Scheme part 'http:' is already parsed externally. This implies that
this is an absolute HTTP URL. */
HTTP_URL_PARSE_SCHEME_EXTERNAL = 0x01,
/* Allow '#fragment' part in HTTP URL */
HTTP_URL_ALLOW_FRAGMENT_PART = 0x02,
/* Allow 'user:password@' part in HTTP URL */
HTTP_URL_ALLOW_USERINFO_PART = 0x04,
/* Allow URL to contain %00 */
HTTP_URL_ALLOW_PCT_NUL = 0x08,
};
int http_url_parse(const char *url, struct http_url *base,
enum http_url_parse_flags flags, pool_t pool,
struct http_url **url_r, const char **error_r);
int http_url_request_target_parse(const char *request_target,
const char *host_header, pool_t pool,
struct http_request_target *target, const char **error_r);
/*
* HTTP URL evaluation
*/
static inline in_port_t http_url_get_port_default(const struct http_url *url,
in_port_t default_port)
{
return (url->port != 0 ? url->port : default_port);
}
static inline in_port_t http_url_get_port(const struct http_url *url)
{
return http_url_get_port_default(url,
(url->have_ssl ? HTTPS_DEFAULT_PORT : HTTP_DEFAULT_PORT));
}
/*
* HTTP URL manipulation
*/
void http_url_copy_authority(pool_t pool, struct http_url *dest,
const struct http_url *src);
struct http_url *http_url_clone_authority(pool_t pool,
const struct http_url *src);
void http_url_copy(pool_t pool, struct http_url *dest,
const struct http_url *src);
void http_url_copy_with_userinfo(pool_t pool, struct http_url *dest,
const struct http_url *src);
struct http_url *http_url_clone(pool_t pool,const struct http_url *src);
struct http_url *http_url_clone_with_userinfo(pool_t pool,
const struct http_url *src);
/*
* HTTP URL construction
*/
const char *http_url_create(const struct http_url *url);
const char *http_url_create_host(const struct http_url *url);
const char *http_url_create_authority(const struct http_url *url);
const char *http_url_create_target(const struct http_url *url);
void http_url_escape_path(string_t *out, const char *data);
void http_url_escape_param(string_t *out, const char *data);
#endif