1 /* 2 * Copyright 2008-2019 Max Kellermann <max.kellermann@gmail.com> 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions 6 * are met: 7 * 8 * - Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * 11 * - Redistributions in binary form must reproduce the above copyright 12 * notice, this list of conditions and the following disclaimer in the 13 * documentation and/or other materials provided with the 14 * distribution. 15 * 16 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 17 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 18 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 19 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 20 * FOUNDATION OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 22 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 23 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 25 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 27 * OF THE POSSIBILITY OF SUCH DAMAGE. 28 */ 29 30 #ifndef URI_UTIL_HXX 31 #define URI_UTIL_HXX 32 33 #include <string> 34 35 /** 36 * Returns true if this is a safe "local" URI: 37 * 38 * - non-empty 39 * - does not begin or end with a slash 40 * - no double slashes 41 * - no path component begins with a dot 42 */ 43 [[gnu::pure]] 44 bool 45 uri_safe_local(const char *uri) noexcept; 46 47 /** 48 * Removes HTTP username and password from the URI. This may be 49 * useful for displaying an URI without disclosing secrets. Returns 50 * an empty string if nothing needs to be removed, or if the URI is 51 * not recognized. 52 */ 53 [[gnu::pure]] 54 std::string 55 uri_remove_auth(const char *uri) noexcept; 56 57 /** 58 * Remove dot segments in the URI. For example, uri_squash_dot_segments 59 * ("foo/bar/.././")=="foo/". 60 */ 61 [[gnu::pure]] 62 std::string 63 uri_squash_dot_segments(const char *uri) noexcept; 64 65 #endif 66