Linux Manuals session 3

gnutls_dtls_prestate_set – API function Synopsis#include <gnutls/dtls.h> void gnutls_dtls_prestate_set(gnutls_session_t session, gnutls_dtls_prestate_st * prestate); Argumentsgnutls_session_t session a new session gnutls_dtls_prestate_st * prestate contains the client’s prestateDescriptionThis function will associate the prestate acquired by the cookie authentication with the client, with the newly established session. This functions must be called after a successful gnutls_dtls_cookie_verify() and should be succeeded…

gnutls_dtls_get_timeout – API function Synopsis#include <gnutls/dtls.h> unsigned int gnutls_dtls_get_timeout(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls_session_t structure.DescriptionThis function will return the milliseconds remaining for a retransmission of the previously sent handshake message. This function is useful when DTLS is used in non-blocking mode, to estimate when to call gnutls_handshake() if no packets have been received. Returnsthe…

gnutls_dtls_get_mtu – API function Synopsis#include <gnutls/dtls.h> unsigned int gnutls_dtls_get_mtu(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls_session_t structure.DescriptionThis function will return the MTU size as set with gnutls_dtls_set_mtu(). This is not the actual MTU of data you can transmit. Use gnutls_dtls_get_data_mtu() for that reason. Returnsthe set maximum transfer unit. Since3.0 Reporting BugsReport bugs to <bugs [at] gnutls.org>….

gnutls_dtls_get_data_mtu – API function Synopsis#include <gnutls/dtls.h> unsigned int gnutls_dtls_get_data_mtu(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls_session_t structure.DescriptionThis function will return the actual maximum transfer unit for application data. I.e. DTLS headers are subtracted from the actual MTU which is set using gnutls_dtls_set_mtu(). Returnsthe maximum allowed transfer unit. Since3.0 Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home…

gnutls_dtls_cookie_verify – API function Synopsis#include <gnutls/dtls.h> int gnutls_dtls_cookie_verify(gnutls_datum_t * key, void * client_data, size_t client_data_size, void * _msg, size_t msg_size, gnutls_dtls_prestate_st * prestate); Argumentsgnutls_datum_t * key is a random key to be used at cookie generation void * client_data contains data identifying the client (i.e. address) size_t client_data_size The size of client’s data void *…

gnutls_dtls_cookie_send – API function Synopsis#include <gnutls/dtls.h> int gnutls_dtls_cookie_send(gnutls_datum_t * key, void * client_data, size_t client_data_size, gnutls_dtls_prestate_st * prestate, gnutls_transport_ptr_t ptr, gnutls_push_func push_func); Argumentsgnutls_datum_t * key is a random key to be used at cookie generation void * client_data contains data identifying the client (i.e. address) size_t client_data_size The size of client’s data gnutls_dtls_prestate_st * prestate…

gnutls_digest_self_test – API function Synopsis#include <gnutls/gnutls.h> int gnutls_digest_self_test(unsigned all, gnutls_digest_algorithm_t digest); Argumentsunsigned all if non-zero then tests to all ciphers are performed. gnutls_digest_algorithm_t digest the digest algorithm to useDescriptionThis function will run self tests on the provided digest. ReturnsZero or a negative error code on error. Since3.3.0 Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home…

gnutls_digest_list – API function Synopsis#include <gnutls/gnutls.h> const gnutls_digest_algorithm_t * gnutls_digest_list( void); Arguments void DescriptionGet a list of hash (digest) algorithms supported by GnuTLS. This function is not thread safe. ReturnsReturn a (0)-terminated list of gnutls_digest_algorithm_t integers indicating the available digests. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software…

gnutls_digest_get_name – API function Synopsis#include <gnutls/gnutls.h> const char * gnutls_digest_get_name(gnutls_digest_algorithm_t algorithm); Argumentsgnutls_digest_algorithm_t algorithm is a digest algorithmDescriptionConvert a gnutls_digest_algorithm_t value to a string. Returnsa string that contains the name of the specified digest algorithm, or NULL. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc.. Copying and…

gnutls_digest_get_id – API function Synopsis#include <gnutls/gnutls.h> gnutls_digest_algorithm_t gnutls_digest_get_id(const char * name); Argumentsconst char * name is a digest algorithm nameDescriptionConvert a string to a gnutls_digest_algorithm_t value. The names are compared in a case insensitive way. Returnsa gnutls_digest_algorithm_t id of the specified MAC algorithm string, or GNUTLS_DIG_UNKNOWN on failures. Reporting BugsReport bugs to <bugs [at] gnutls.org>….

gnutls_dh_set_prime_bits – API function Synopsis#include <gnutls/gnutls.h> void gnutls_dh_set_prime_bits(gnutls_session_t session, unsigned int bits); Argumentsgnutls_session_t session is a gnutls_session_t structure. unsigned int bits is the number of bitsDescriptionThis function sets the number of bits, for use in a Diffie-Hellman key exchange. This is used both in DH ephemeral and DH anonymous cipher suites. This will set the…

gnutls_dh_params_init – API function Synopsis#include <gnutls/gnutls.h> int gnutls_dh_params_init(gnutls_dh_params_t * dh_params); Argumentsgnutls_dh_params_t * dh_params Is a structure that will hold the prime numbersDescriptionThis function will initialize the DH parameters structure. ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error code is returned. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014…

gnutls_dh_params_import_raw – API function Synopsis#include <gnutls/gnutls.h> int gnutls_dh_params_import_raw(gnutls_dh_params_t dh_params, const gnutls_datum_t * prime, const gnutls_datum_t * generator); Argumentsgnutls_dh_params_t dh_params Is a structure that will hold the prime numbers const gnutls_datum_t * prime holds the new prime const gnutls_datum_t * generator holds the new generatorDescriptionThis function will replace the pair of prime and generator for use…

gnutls_dh_params_import_pkcs3 – API function Synopsis#include <gnutls/gnutls.h> int gnutls_dh_params_import_pkcs3(gnutls_dh_params_t params, const gnutls_datum_t * pkcs3_params, gnutls_x509_crt_fmt_t format); Argumentsgnutls_dh_params_t params A structure where the parameters will be copied to const gnutls_datum_t * pkcs3_params should contain a PKCS3 DHParams structure PEM or DER encoded gnutls_x509_crt_fmt_t format the format of params. PEM or DER.DescriptionThis function will extract the DHParams found…

gnutls_dh_params_generate2 – API function Synopsis#include <gnutls/gnutls.h> int gnutls_dh_params_generate2(gnutls_dh_params_t dparams, unsigned int bits); Argumentsgnutls_dh_params_t dparams Is the structure that the DH parameters will be stored unsigned int bits is the prime’s number of bitsDescriptionThis function will generate a new pair of prime and generator for use in the Diffie-Hellman key exchange. The new parameters will be…

gnutls_dh_params_export_raw – API function Synopsis#include <gnutls/gnutls.h> int gnutls_dh_params_export_raw(gnutls_dh_params_t params, gnutls_datum_t * prime, gnutls_datum_t * generator, unsigned int * bits); Argumentsgnutls_dh_params_t params Holds the DH parameters gnutls_datum_t * prime will hold the new prime gnutls_datum_t * generator will hold the new generator unsigned int * bits if non null will hold the secret key’s number of…

gnutls_dh_params_export_pkcs3 – API function Synopsis#include <gnutls/gnutls.h> int gnutls_dh_params_export_pkcs3(gnutls_dh_params_t params, gnutls_x509_crt_fmt_t format, unsigned char * params_data, size_t * params_data_size); Argumentsgnutls_dh_params_t params Holds the DH parameters gnutls_x509_crt_fmt_t format the format of output params. One of PEM or DER. unsigned char * params_data will contain a PKCS3 DHParams structure PEM or DER encoded size_t * params_data_size holds the…

gnutls_dh_params_export2_pkcs3 – API function Synopsis#include <gnutls/gnutls.h> int gnutls_dh_params_export2_pkcs3(gnutls_dh_params_t params, gnutls_x509_crt_fmt_t format, gnutls_datum_t * out); Argumentsgnutls_dh_params_t params Holds the DH parameters gnutls_x509_crt_fmt_t format the format of output params. One of PEM or DER. gnutls_datum_t * out will contain a PKCS3 DHParams structure PEM or DER encodedDescriptionThis function will export the given dh parameters to a PKCS3…

gnutls_dh_params_deinit – API function Synopsis#include <gnutls/gnutls.h> void gnutls_dh_params_deinit(gnutls_dh_params_t dh_params); Argumentsgnutls_dh_params_t dh_params Is a structure that holds the prime numbersDescriptionThis function will deinitialize the DH parameters structure. 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 permitted…

gnutls_dh_params_cpy – API function Synopsis#include <gnutls/gnutls.h> int gnutls_dh_params_cpy(gnutls_dh_params_t dst, gnutls_dh_params_t src); Argumentsgnutls_dh_params_t dst Is the destination structure, which should be initialized. gnutls_dh_params_t src Is the source structureDescriptionThis function will copy the DH parameters structure from source to destination. ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error code is returned. Reporting BugsReport bugs to…