diff options
Diffstat (limited to 'web/server/h2o/libh2o/include/h2o/url.h')
-rw-r--r-- | web/server/h2o/libh2o/include/h2o/url.h | 147 |
1 files changed, 147 insertions, 0 deletions
diff --git a/web/server/h2o/libh2o/include/h2o/url.h b/web/server/h2o/libh2o/include/h2o/url.h new file mode 100644 index 00000000..231c9a26 --- /dev/null +++ b/web/server/h2o/libh2o/include/h2o/url.h @@ -0,0 +1,147 @@ +/* + * Copyright (c) 2014,2015 DeNA Co., Ltd. + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to + * deal in the Software without restriction, including without limitation the + * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or + * sell copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING + * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS + * IN THE SOFTWARE. + */ +#ifndef h2o__url_h +#define h2o__url_h + +#include <sys/un.h> +#include "h2o/memory.h" + +typedef struct st_h2o_url_scheme_t { + h2o_iovec_t name; + uint16_t default_port; +} h2o_url_scheme_t; + +extern const h2o_url_scheme_t H2O_URL_SCHEME_HTTP, H2O_URL_SCHEME_HTTPS; + +typedef struct st_h2o_url_t { + const h2o_url_scheme_t *scheme; + h2o_iovec_t authority; /* i.e. host:port */ + h2o_iovec_t host; + h2o_iovec_t path; + uint16_t _port; +} h2o_url_t; + +/** + * retrieves the port number from url + */ +static uint16_t h2o_url_get_port(const h2o_url_t *url); +/** + * removes "..", ".", decodes %xx from a path representation + * @param pool memory pool to be used in case the path contained references to directories + * @param path source path + * @param len source length + * @param returns offset of '?' within `path` if found, or SIZE_MAX if not + * @param indexes mapping the normalized version to the input version + * @return buffer pointing to source, or buffer pointing to an allocated chunk with normalized representation of the given path + */ +h2o_iovec_t h2o_url_normalize_path(h2o_mem_pool_t *pool, const char *path, size_t len, size_t *query_at, size_t **norm_indexes); +/** + * initializes URL object given scheme, authority, and path + * @param the output + * @param scheme scheme + * @param authority + * @param path + * @return 0 if successful + */ +static int h2o_url_init(h2o_url_t *url, const h2o_url_scheme_t *scheme, h2o_iovec_t authority, h2o_iovec_t path); +/** + * parses absolute URL (either http or https) + */ +int h2o_url_parse(const char *url, size_t url_len, h2o_url_t *result); +/** + * parses relative URL + */ +int h2o_url_parse_relative(const char *url, size_t url_len, h2o_url_t *result); +/** + * parses the authority and returns the next position (i.e. start of path) + * @return pointer to the end of hostport if successful, or NULL if failed. *port becomes the specified port number or 65535 if not + */ +const char *h2o_url_parse_hostport(const char *s, size_t len, h2o_iovec_t *host, uint16_t *port); +/** + * resolves the URL (stored to `dest` as well as returning the stringified representation (always allocated using pool) + */ +h2o_iovec_t h2o_url_resolve(h2o_mem_pool_t *pool, const h2o_url_t *base, const h2o_url_t *relative, h2o_url_t *dest); +/** + * resolves the path part of the URL (both the arguments are modified; the result is h2o_concat(*base, *relative)) + */ +void h2o_url_resolve_path(h2o_iovec_t *base, h2o_iovec_t *relative); +/** + * stringifies the URL + */ +static h2o_iovec_t h2o_url_stringify(h2o_mem_pool_t *pool, const h2o_url_t *url); +/** + * copies a URL object (null-terminates all the string elements) + */ +void h2o_url_copy(h2o_mem_pool_t *pool, h2o_url_t *dest, const h2o_url_t *src); +/** + * extracts sockaddr_un from host and returns NULL (or returns an error string if failed) + */ +const char *h2o_url_host_to_sun(h2o_iovec_t host, struct sockaddr_un *sa); +extern const char *h2o_url_host_to_sun_err_is_not_unix_socket; + +/* inline definitions */ + +inline int h2o_url_init(h2o_url_t *url, const h2o_url_scheme_t *scheme, h2o_iovec_t authority, h2o_iovec_t path) +{ + if (h2o_url_parse_hostport(authority.base, authority.len, &url->host, &url->_port) != authority.base + authority.len) + return -1; + url->scheme = scheme; + url->authority = authority; + url->path = path; + return 0; +} + +inline uint16_t h2o_url_get_port(const h2o_url_t *url) +{ + return url->_port != 65535 ? url->_port : url->scheme->default_port; +} + +inline h2o_iovec_t h2o_url_stringify(h2o_mem_pool_t *pool, const h2o_url_t *url) +{ + h2o_url_t tmp; + return h2o_url_resolve(pool, url, NULL, &tmp); +} + +static inline int h2o_url_host_is_unix_path(h2o_iovec_t host) +{ + if (host.len < 5) { + return 0; + } + return h2o_memis(host.base, 5, H2O_STRLIT("unix:")); +} + +/** + * Compares to hostnames, taking into account whether they contain a + * unix path (the comparison will be case sensitive) or not. + */ +static inline int h2o_url_hosts_are_equal(const h2o_url_t *url_a, const h2o_url_t *url_b) +{ + if (url_a->host.len != url_b->host.len) + return 0; + + if (h2o_url_host_is_unix_path(url_a->host)) + return h2o_memis(url_a->host.base, url_a->host.len, url_b->host.base, url_b->host.len); + else + return h2o_lcstris(url_a->host.base, url_a->host.len, url_b->host.base, url_b->host.len); +} + +#endif |