Linux Manuals session 3

NAME gnutls_psk_client_get_hint – API function SYNOPSIS #include <gnutls/gnutls.h> const char * gnutls_psk_client_get_hint(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls session DESCRIPTION The PSK identity hint may give the client help in deciding which username to use. This should only be called in case of PSK authentication and in case of a client. RETURNS the identity…

NAME gnutls_psk_allocate_server_credentials – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_psk_allocate_server_credentials(gnutls_psk_server_credentials_t * sc); ARGUMENTS gnutls_psk_server_credentials_t * sc is a pointer to a gnutls_psk_server_credentials_t structure. DESCRIPTION This structure is complex enough to manipulate directly thus this helper function is provided in order to allocate it. RETURNS On success, GNUTLS_E_SUCCESS (0) is returned, otherwise an error code is…

NAME gnutls_psk_allocate_client_credentials – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_psk_allocate_client_credentials(gnutls_psk_client_credentials_t * sc); ARGUMENTS gnutls_psk_client_credentials_t * sc is a pointer to a gnutls_psk_server_credentials_t structure. DESCRIPTION This structure is complex enough to manipulate directly thus this helper function is provided in order to allocate it. RETURNS On success, GNUTLS_E_SUCCESS (0) is returned, otherwise an error code is…

NAME gnutls_protocol_set_priority – API function SYNOPSIS #include <gnutls/compat.h> int gnutls_protocol_set_priority(gnutls_session_t session, const int * list); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. const int * list is a 0 terminated list of gnutls_protocol_t elements. DESCRIPTION Sets the priority on the protocol versions supported by gnutls. This function actually enables or disables protocols. Newer protocol versions…

NAME gnutls_protocol_list – API function SYNOPSIS #include <gnutls/gnutls.h> const gnutls_protocol_t * gnutls_protocol_list( void); ARGUMENTS void DESCRIPTION Get a list of supported protocols, e.g. SSL 3.0, TLS 1.0 etc. This function is not thread safe. RETURNS a (0)-terminated list of gnutls_protocol_t integers indicating the available protocols. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page:…

NAME gnutls_protocol_get_version – API function SYNOPSIS #include <gnutls/gnutls.h> gnutls_protocol_t gnutls_protocol_get_version(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION Get TLS version, a gnutls_protocol_t value. RETURNS The version of the currently used protocol. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright © 2001-2014 Free Software Foundation, Inc.. Copying and distribution…

NAME gnutls_protocol_get_name – API function SYNOPSIS #include <gnutls/gnutls.h> const char * gnutls_protocol_get_name(gnutls_protocol_t version); ARGUMENTS gnutls_protocol_t version is a (gnutls) version number DESCRIPTION Convert a gnutls_protocol_t value to a string. RETURNS a string that contains the name of the specified TLS version (e.g., "TLS1.0"), or NULL. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page:…

NAME gnutls_protocol_get_id – API function SYNOPSIS #include <gnutls/gnutls.h> gnutls_protocol_t gnutls_protocol_get_id(const char * name); ARGUMENTS const char * name is a protocol name DESCRIPTION The names are compared in a case insensitive way. RETURNS an id of the specified protocol, or GNUTLS_VERSION_UNKNOWN on error. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT…

NAME gnutls_privkey_verify_params – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_privkey_verify_params(gnutls_privkey_t key); ARGUMENTS gnutls_privkey_t key should contain a gnutls_privkey_t structure DESCRIPTION This function will verify the private key parameters. RETURNS On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. SINCE 3.3.0 REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright…

NAME gnutls_privkey_status – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_privkey_status(gnutls_privkey_t key); ARGUMENTS gnutls_privkey_t key Holds the key DESCRIPTION Checks the status of the private key token. This function is an actual wrapper over gnutls_pkcs11_privkey_status(), and if the private key is a PKCS 11 token it will check whether it is inserted or not. RETURNS this…

NAME gnutls_privkey_sign_raw_data – API function SYNOPSIS #include <gnutls/compat.h> int gnutls_privkey_sign_raw_data(gnutls_privkey_t key, unsigned flags, const gnutls_datum_t * data, gnutls_datum_t * signature); ARGUMENTS gnutls_privkey_t key Holds the key unsigned flags should be zero const gnutls_datum_t * data holds the data to be signed gnutls_datum_t * signature will contain the signature allocate with gnutls_malloc() DESCRIPTION This function will…

NAME gnutls_privkey_sign_hash – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_privkey_sign_hash(gnutls_privkey_t signer, gnutls_digest_algorithm_t hash_algo, unsigned int flags, const gnutls_datum_t * hash_data, gnutls_datum_t * signature); ARGUMENTS gnutls_privkey_t signer Holds the signer’s key gnutls_digest_algorithm_t hash_algo The hash algorithm used unsigned int flags Zero or one of gnutls_privkey_flags_t const gnutls_datum_t * hash_data holds the data to be signed gnutls_datum_t…

NAME gnutls_privkey_sign_data – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_privkey_sign_data(gnutls_privkey_t signer, gnutls_digest_algorithm_t hash, unsigned int flags, const gnutls_datum_t * data, gnutls_datum_t * signature); ARGUMENTS gnutls_privkey_t signer Holds the key gnutls_digest_algorithm_t hash should be a digest algorithm unsigned int flags Zero or one of gnutls_privkey_flags_t const gnutls_datum_t * data holds the data to be signed gnutls_datum_t…

NAME gnutls_privkey_set_pin_function – API function SYNOPSIS #include <gnutls/abstract.h> void gnutls_privkey_set_pin_function(gnutls_privkey_t key, gnutls_pin_callback_t fn, void * userdata); ARGUMENTS gnutls_privkey_t key A key of type gnutls_privkey_t gnutls_pin_callback_t fn the callback void * userdata data associated with the callback DESCRIPTION This function will set a callback function to be used when required to access the object. This function…

NAME gnutls_privkey_init – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_privkey_init(gnutls_privkey_t * key); ARGUMENTS gnutls_privkey_t * key The structure to be initialized DESCRIPTION This function will initialize an private key structure. RETURNS On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. SINCE 2.12.0 REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org…

NAME gnutls_privkey_import_x509_raw – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_privkey_import_x509_raw(gnutls_privkey_t pkey, const gnutls_datum_t * data, gnutls_x509_crt_fmt_t format, const char * password, unsigned int flags); ARGUMENTS gnutls_privkey_t pkey The private key const gnutls_datum_t * data The private key data to be imported gnutls_x509_crt_fmt_t format The format of the private key const char * password A password…

NAME gnutls_privkey_import_x509 – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_privkey_import_x509(gnutls_privkey_t pkey, gnutls_x509_privkey_t key, unsigned int flags); ARGUMENTS gnutls_privkey_t pkey The private key gnutls_x509_privkey_t key The private key to be imported unsigned int flags Flags for the import DESCRIPTION This function will import the given private key to the abstract gnutls_privkey_t structure. The gnutls_x509_privkey_t object must…

NAME gnutls_privkey_import_url – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_privkey_import_url(gnutls_privkey_t key, const char * url, unsigned int flags); ARGUMENTS gnutls_privkey_t key A key of type gnutls_privkey_t const char * url A PKCS 11 url unsigned int flags should be zero DESCRIPTION This function will import a PKCS11 or TPM URL as a private key. The…

NAME gnutls_privkey_import_tpm_url – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_privkey_import_tpm_url(gnutls_privkey_t pkey, const char * url, const char * srk_password, const char * key_password, unsigned int flags); ARGUMENTS gnutls_privkey_t pkey The private key const char * url The URL of the TPM key to be imported const char * srk_password The password for the SRK key…

NAME gnutls_privkey_import_tpm_raw – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_privkey_import_tpm_raw(gnutls_privkey_t pkey, const gnutls_datum_t * fdata, gnutls_tpmkey_fmt_t format, const char * srk_password, const char * key_password, unsigned int flags); ARGUMENTS gnutls_privkey_t pkey The private key const gnutls_datum_t * fdata The TPM key to be imported gnutls_tpmkey_fmt_t format The format of the private key const char *…