SysTutorials Posts

NAME 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); ARGUMENTS gnutls_psk_client_credentials_t cred is a gnutls_psk_server_credentials_t structure. gnutls_psk_client_credentials_function * func is the callback function DESCRIPTION This 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,…

NAME 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); ARGUMENTS gnutls_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…

NAME gnutls_psk_server_get_username – API function SYNOPSIS #include <gnutls/gnutls.h> const char * gnutls_psk_server_get_username(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls session DESCRIPTION This should only be called in case of PSK authentication and in case of a server. RETURNS the username of the peer, or NULL in case of an error. REPORTING BUGS Report bugs to…

NAME 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); ARGUMENTS const 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…

NAME gnutls_psk_free_server_credentials – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_psk_free_server_credentials(gnutls_psk_server_credentials_t sc); ARGUMENTS gnutls_psk_server_credentials_t sc is 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 free (deallocate) it. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright © 2001-2014 Free…

NAME gnutls_psk_free_client_credentials – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_psk_free_client_credentials(gnutls_psk_client_credentials_t sc); ARGUMENTS gnutls_psk_client_credentials_t sc is a gnutls_psk_client_credentials_t structure. DESCRIPTION This structure is complex enough to manipulate directly thus this helper function is provided in order to free (deallocate) it. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright © 2001-2014 Free…

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…