include/got_dial.h

   1 /*
   2  * Copyright (c) 2021 Stefan Sperling <stsp@openbsd.org>
   3  *
   4  * Permission to use, copy, modify, and distribute this software for any
   5  * purpose with or without fee is hereby granted, provided that the above
   6  * copyright notice and this permission notice appear in all copies.
   7  *
   8  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
   9  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  10  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  11  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  12  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  13  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  14  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  15  */
  16
  17 /*
  18  * Apply any unveil(2) operations required to support the given protocol,
  19  * as obtained from the 'proto' output parameter of got_dial_parse_uri().
  20  * This function must be called during initialization of the main program
  21  * if got_fetch.h or got_send.h funcionality will be used.
  22  */
  23 const struct got_error *got_dial_apply_unveil(const char *proto);
  24
  25 /*
  26  * Attempt to parse a URI into the following parts:
  27  * A protocol scheme, hostname, port number (as a string), path on server,
  28  * and a repository name. If the URI lacks some of this information return
  29  * default values where applicable.
  30  * The caller should dispose of the returned values with free(3).
  31  */
  32 const struct got_error *got_dial_parse_uri(char **proto, char **host,
  33     char **port, char **server_path, char **repo_name, const char *uri);