Author: Linux Manual

gnutls_psk_set_server_credentials_file – API function Synopsis#include <gnutls/gnutls.h> int gnutls_psk_set_server_credentials_file(gnutls_psk_server_credentials_t res, const char * password_file); Argumentsgnutls_psk_server_credentials_t res is a gnutls_psk_server_credentials_t structure. const char * password_file is the PSK password file (passwd.psk)DescriptionThis function sets the password file, in a gnutls_psk_server_credentials_t structure. This password file holds usernames and keys and will be used for PSK authentication. ReturnsOn success, GNUTLS_E_SUCCESS…

gnutls_psk_set_params_function – API function Synopsis#include <gnutls/gnutls.h> void gnutls_psk_set_params_function(gnutls_psk_server_credentials_t res, gnutls_params_function * func); Argumentsgnutls_psk_server_credentials_t res is a gnutls_psk_server_credentials_t structure gnutls_params_function * func is the function to be calledDescriptionThis function will set a callback in order for the server to get the Diffie-Hellman or RSA parameters for PSK authentication. The callback should return GNUTLS_E_SUCCESS (0) on success….

gnutls_psk_set_client_credentials_function – API function Synopsis#include <gnutls/gnutls.h> void gnutls_psk_set_client_credentials_function(gnutls_psk_client_credentials_t cred, gnutls_psk_client_credentials_function * func); Argumentsgnutls_psk_client_credentials_t cred is a gnutls_psk_server_credentials_t structure. gnutls_psk_client_credentials_function * func is the callback functionDescriptionThis function can be used to set a callback to retrieve the username and password for client PSK authentication. The callback’s function form is: int (*callback)(gnutls_session_t, char** username, gnutls_datum_t* key); The…

gnutls_psk_set_client_credentials – API function Synopsis#include <gnutls/gnutls.h> int gnutls_psk_set_client_credentials(gnutls_psk_client_credentials_t res, const char * username, const gnutls_datum_t * key, gnutls_psk_key_flags flags); Argumentsgnutls_psk_client_credentials_t res is a gnutls_psk_client_credentials_t structure. const char * username is the user’s zero-terminated userid const gnutls_datum_t * key is the user’s key gnutls_psk_key_flags flags indicate the format of the key, either GNUTLS_PSK_KEY_RAW or GNUTLS_PSK_KEY_HEX.DescriptionThis function…

gnutls_psk_server_get_username – API function Synopsis#include <gnutls/gnutls.h> const char * gnutls_psk_server_get_username(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls sessionDescriptionThis should only be called in case of PSK authentication and in case of a server. Returnsthe username of the peer, or NULL in case of an error. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright…

gnutls_psk_netconf_derive_key – derive PSK Netconf key from password Synopsis#include <gnutls/gnutls.h> int gnutls_psk_netconf_derive_key(const char * password, const char * psk_identity, const char * psk_identity_hint, gnutls_datum_t * output_key); Argumentsconst char * password zero terminated string containing password. const char * psk_identity zero terminated string with PSK identity. const char * psk_identity_hint zero terminated string with PSK identity…

gnutls_psk_free_server_credentials – API function Synopsis#include <gnutls/gnutls.h> void gnutls_psk_free_server_credentials(gnutls_psk_server_credentials_t sc); Argumentsgnutls_psk_server_credentials_t sc is a gnutls_psk_server_credentials_t structure.DescriptionThis structure is complex enough to manipulate directly thus this helper function is provided in order to free (deallocate) it. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc.. Copying and distribution of…

gnutls_psk_free_client_credentials – API function Synopsis#include <gnutls/gnutls.h> void gnutls_psk_free_client_credentials(gnutls_psk_client_credentials_t sc); Argumentsgnutls_psk_client_credentials_t sc is a gnutls_psk_client_credentials_t structure.DescriptionThis structure is complex enough to manipulate directly thus this helper function is provided in order to free (deallocate) it. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc.. Copying and distribution of…

gnutls_psk_client_get_hint – API function Synopsis#include <gnutls/gnutls.h> const char * gnutls_psk_client_get_hint(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls sessionDescriptionThe 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. Returnsthe identity hint of the peer, or NULL…

gnutls_psk_allocate_server_credentials – API function Synopsis#include <gnutls/gnutls.h> int gnutls_psk_allocate_server_credentials(gnutls_psk_server_credentials_t * sc); Argumentsgnutls_psk_server_credentials_t * sc is a pointer to a gnutls_psk_server_credentials_t structure.DescriptionThis structure is complex enough to manipulate directly thus this helper function is provided in order to allocate it. ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned, otherwise an error code is returned. Reporting BugsReport bugs to <bugs…

gnutls_psk_allocate_client_credentials – API function Synopsis#include <gnutls/gnutls.h> int gnutls_psk_allocate_client_credentials(gnutls_psk_client_credentials_t * sc); Argumentsgnutls_psk_client_credentials_t * sc is a pointer to a gnutls_psk_server_credentials_t structure.DescriptionThis structure is complex enough to manipulate directly thus this helper function is provided in order to allocate it. ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned, otherwise an error code is returned. Reporting BugsReport bugs to <bugs…

gnutls_protocol_set_priority – API function Synopsis#include <gnutls/compat.h> int gnutls_protocol_set_priority(gnutls_session_t session, const int * list); Argumentsgnutls_session_t session is a gnutls_session_t structure. const int * list is a 0 terminated list of gnutls_protocol_t elements.DescriptionSets the priority on the protocol versions supported by gnutls. This function actually enables or disables protocols. Newer protocol versions always have highest priority. ReturnsGNUTLS_E_SUCCESS…

gnutls_protocol_list – API function Synopsis#include <gnutls/gnutls.h> const gnutls_protocol_t * gnutls_protocol_list( void); Arguments void DescriptionGet a list of supported protocols, e.g. SSL 3.0, TLS 1.0 etc. This function is not thread safe. Returnsa (0)-terminated list of gnutls_protocol_t integers indicating the available protocols. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free…

gnutls_protocol_get_version – API function Synopsis#include <gnutls/gnutls.h> gnutls_protocol_t gnutls_protocol_get_version(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls_session_t structure.DescriptionGet TLS version, a gnutls_protocol_t value. ReturnsThe version of the currently used protocol. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc.. Copying and distribution of this file, with or without modification, are…

gnutls_protocol_get_name – API function Synopsis#include <gnutls/gnutls.h> const char * gnutls_protocol_get_name(gnutls_protocol_t version); Argumentsgnutls_protocol_t version is a (gnutls) version numberDescriptionConvert a gnutls_protocol_t value to a string. Returnsa string that contains the name of the specified TLS version (e.g., "TLS1.0"), or NULL. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation,…

gnutls_protocol_get_id – API function Synopsis#include <gnutls/gnutls.h> gnutls_protocol_t gnutls_protocol_get_id(const char * name); Argumentsconst char * name is a protocol nameDescriptionThe names are compared in a case insensitive way. Returnsan id of the specified protocol, or GNUTLS_VERSION_UNKNOWN on error. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc.. Copying…

gnutls_privkey_verify_params – API function Synopsis#include <gnutls/abstract.h> int gnutls_privkey_verify_params(gnutls_privkey_t key); Argumentsgnutls_privkey_t key should contain a gnutls_privkey_t structureDescriptionThis function will verify the private key parameters. ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. Since3.3.0 Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc.. Copying and distribution…

gnutls_privkey_status – API function Synopsis#include <gnutls/abstract.h> int gnutls_privkey_status(gnutls_privkey_t key); Argumentsgnutls_privkey_t key Holds the keyDescriptionChecks 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. Returnsthis function will return non-zero if the…

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); Argumentsgnutls_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()DescriptionThis function will sign the given data using…

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); Argumentsgnutls_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 * signature will…