NAME

       gnutls_register_custom_url - API function

SYNOPSIS

       #include <gnutls/urls.h>

       int gnutls_register_custom_url(const gnutls_custom_url_st * st);

ARGUMENTS

       const gnutls_custom_url_st * st
                   A gnutls_custom_url_st structure

DESCRIPTION

       Register    a    custom    URL.    This    will    affect    the    following   functions:
       gnutls_url_is_supported(),     gnutls_privkey_import_url(),      gnutls_pubkey_import_url,
       gnutls_x509_crt_import_url()    and   all   functions   that   depend   on   them,   e.g.,
       gnutls_certificate_set_x509_key_file2().

       The provided structure and callback functions must be valid throughout the lifetime of the
       process. The registration of an existing URL type will fail with GNUTLS_E_INVALID_REQUEST.

       This function is not thread safe.

RETURNS

       returns zero if the given structure was imported or a negative value otherwise.

SINCE

       3.4.0

REPORTING BUGS

       Report bugs to <bugs@gnutls.org>.
       Home page: http://www.gnutls.org

COPYRIGHT

       Copyright © 2014-2021 Free Software Foundation, Inc., and others.
       Copying  and distribution of this file, with or without modification, are permitted in any
       medium without royalty provided the copyright notice and this notice are preserved.

SEE ALSO

       The  full  documentation  for  gnutls  is  maintained  as  a  Texinfo  manual.    If   the
       /usr/share/doc/gnutls/ directory does not contain the HTML form visit

       http://www.gnutls.org/manual/