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. Since GnuTLS 3.5.0 this function can be used to override the builtin URLs.

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: https://www.gnutls.org

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

https://www.gnutls.org/manual/

Info

3.6.9 gnutls