/*
 * Copyright (c) 2021 Stefan Sperling <stsp@openbsd.org>
 *
 * Permission to use, copy, modify, and distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */

/*
 * Apply any unveil(2) operations required to support the given protocol,
 * as obtained from the 'proto' output parameter of got_dial_parse_uri().
 * This function must be called during initialization of the main program
 * if got_fetch.h or got_send.h funcionality will be used.
 */
const struct got_error *got_dial_apply_unveil(const char *proto);

/*
 * Attempt to parse a URI into the following parts:
 * A protocol scheme, hostname, port number (as a string), path on server,
 * and a repository name. If the URI lacks some of this information return
 * default values where applicable.
 * The caller should dispose of the returned values with free(3).
 */
const struct got_error *got_dial_parse_uri(char **proto, char **host,
    char **port, char **server_path, char **repo_name, const char *uri);