Linux Manuals session 3

gnutls_sec_param_to_pk_bits – API function Synopsis#include <gnutls/gnutls.h> unsigned int gnutls_sec_param_to_pk_bits(gnutls_pk_algorithm_t algo, gnutls_sec_param_t param); Argumentsgnutls_pk_algorithm_t algo is a public key algorithm gnutls_sec_param_t param is a security parameterDescriptionWhen generating private and public key pairs a difficult question is which size of "bits" the modulus will be in RSA and the group size in DSA. The easy answer is…

gnutls_sec_param_get_name – API function Synopsis#include <gnutls/gnutls.h> const char * gnutls_sec_param_get_name(gnutls_sec_param_t param); Argumentsgnutls_sec_param_t param is a security parameterDescriptionConvert a gnutls_sec_param_t value to a string. Returnsa pointer to a string that contains the name of the specified security level, or NULL. Since2.12.0 Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software…

gnutls_safe_renegotiation_status – API function Synopsis#include <gnutls/gnutls.h> int gnutls_safe_renegotiation_status(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls_session_t structure.DescriptionCan be used to check whether safe renegotiation is being used in the current session. Returns0 when safe renegotiation is not used and non (0) when safe renegotiation is used. Since2.10.0 Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org…

gnutls_rsa_params_init – API function Synopsis#include <gnutls/compat.h> int gnutls_rsa_params_init(gnutls_rsa_params_t * rsa_params); Argumentsgnutls_rsa_params_t * rsa_params Is a structure that will hold the parametersDescriptionThis function will initialize the temporary RSA parameters structure. ReturnsGNUTLS_E_SUCCESS on success, or an negative error code. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc.. Copying…

gnutls_rsa_params_import_raw – API function Synopsis#include <gnutls/compat.h> int gnutls_rsa_params_import_raw(gnutls_rsa_params_t rsa_params, const gnutls_datum_t * m, const gnutls_datum_t * e, const gnutls_datum_t * d, const gnutls_datum_t * p, const gnutls_datum_t * q, const gnutls_datum_t * u); Argumentsgnutls_rsa_params_t rsa_params Is a structure will hold the parameters const gnutls_datum_t * m holds the modulus const gnutls_datum_t * e holds the…

gnutls_rsa_params_import_pkcs1 – API function Synopsis#include <gnutls/compat.h> int gnutls_rsa_params_import_pkcs1(gnutls_rsa_params_t params, const gnutls_datum_t * pkcs1_params, gnutls_x509_crt_fmt_t format); Argumentsgnutls_rsa_params_t params A structure where the parameters will be copied to const gnutls_datum_t * pkcs1_params should contain a PKCS1 RSAPrivateKey structure PEM or DER encoded gnutls_x509_crt_fmt_t format the format of params. PEM or DER.DescriptionThis function will extract the RSAPrivateKey found…

gnutls_rsa_params_generate2 – API function Synopsis#include <gnutls/compat.h> int gnutls_rsa_params_generate2(gnutls_rsa_params_t params, unsigned int bits); Argumentsgnutls_rsa_params_t params The structure where the parameters will be stored unsigned int bits is the prime’s number of bitsDescriptionThis function will generate new temporary RSA parameters for use in RSA-EXPORT ciphersuites. This function is normally slow. Note that if the parameters are to…

gnutls_rsa_params_export_raw – API function Synopsis#include <gnutls/compat.h> int gnutls_rsa_params_export_raw(gnutls_rsa_params_t rsa, gnutls_datum_t * m, gnutls_datum_t * e, gnutls_datum_t * d, gnutls_datum_t * p, gnutls_datum_t * q, gnutls_datum_t * u, unsigned int * bits); Argumentsgnutls_rsa_params_t rsa a structure that holds the rsa parameters gnutls_datum_t * m will hold the modulus gnutls_datum_t * e will hold the public exponent…

gnutls_rsa_params_export_pkcs1 – API function Synopsis#include <gnutls/compat.h> int gnutls_rsa_params_export_pkcs1(gnutls_rsa_params_t params, gnutls_x509_crt_fmt_t format, unsigned char * params_data, size_t * params_data_size); Argumentsgnutls_rsa_params_t params Holds the RSA parameters gnutls_x509_crt_fmt_t format the format of output params. One of PEM or DER. unsigned char * params_data will contain a PKCS1 RSAPrivateKey structure PEM or DER encoded size_t * params_data_size holds the…

gnutls_rsa_params_deinit – API function Synopsis#include <gnutls/compat.h> void gnutls_rsa_params_deinit(gnutls_rsa_params_t rsa_params); Argumentsgnutls_rsa_params_t rsa_params Is a structure that holds the parametersDescriptionThis function will deinitialize the RSA 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 in…

gnutls_rsa_params_cpy – API function Synopsis#include <gnutls/compat.h> int gnutls_rsa_params_cpy(gnutls_rsa_params_t dst, gnutls_rsa_params_t src); Argumentsgnutls_rsa_params_t dst Is the destination structure, which should be initialized. gnutls_rsa_params_t src Is the source structureDescriptionThis function will copy the RSA parameters structure from source to destination. ReturnsGNUTLS_E_SUCCESS on success, or an negative error code. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page:…

gnutls_rsa_export_get_pubkey – API function Synopsis#include <gnutls/compat.h> int gnutls_rsa_export_get_pubkey(gnutls_session_t session, gnutls_datum_t * exponent, gnutls_datum_t * modulus); Argumentsgnutls_session_t session is a gnutls session gnutls_datum_t * exponent will hold the exponent. gnutls_datum_t * modulus will hold the modulus.DescriptionThis function will return the peer’s public key exponent and modulus used in the last RSA-EXPORT authentication. The output parameters must…

gnutls_rsa_export_get_modulus_bits – API function Synopsis#include <gnutls/compat.h> int gnutls_rsa_export_get_modulus_bits(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls sessionDescriptionGet the export RSA parameter’s modulus size. ReturnsThe bits used in the last RSA-EXPORT key exchange with the peer, or a negative error code in case of error. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014…

gnutls_rnd_refresh – API function Synopsis#include <gnutls/crypto.h> void gnutls_rnd_refresh(); ArgumentsDescriptionThis function refreshes the random generator state. That is the current precise time, CPU usage, and other values are input into its state. On a slower rate input from /dev/urandom is mixed too. Since3.1.7 Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014…

gnutls_rnd – API function Synopsis#include <gnutls/crypto.h> int gnutls_rnd(gnutls_rnd_level_t level, void * data, size_t len); Argumentsgnutls_rnd_level_t level a security level void * data place to store random bytes size_t len The requested sizeDescriptionThis function will generate random data and store it to output buffer. This function is thread-safe and also fork-safe. ReturnsZero on success, or a…

gnutls_rehandshake – API function Synopsis#include <gnutls/gnutls.h> int gnutls_rehandshake(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls_session_t structure.DescriptionThis function will renegotiate security parameters with the client. This should only be called in case of a server. This message informs the peer that we want to renegotiate parameters (perform a handshake). If this function succeeds (returns 0), you must…

gnutls_register_md5_handler – API function Synopsis#include <gnutls/extra.h> int gnutls_register_md5_handler( void); Arguments void DescriptionRegister a non-libgcrypt based MD5 and HMAC-MD5 handler. This is useful if you run Libgcrypt in FIPS-mode. Normally TLS requires use of MD5, so without this you cannot use GnuTLS with libgcrypt in FIPS mode. ReturnsGNUTLS_E_SUCCESS on success, otherwise an error. Since2.6.0 Reporting BugsReport…

gnutls_record_uncork – API function Synopsis#include <gnutls/gnutls.h> int gnutls_record_uncork(gnutls_session_t session, unsigned int flags); Argumentsgnutls_session_t session is a gnutls_session_t structure. unsigned int flags Could be zero or GNUTLS_RECORD_WAITDescriptionThis resets the effect of gnutls_record_cork(), and flushes any pending data. If the GNUTLS_RECORD_WAIT flag is specified then this function will block until the data is sent or a fatal…

gnutls_record_set_timeout – API function Synopsis#include <gnutls/gnutls.h> void gnutls_record_set_timeout(gnutls_session_t session, unsigned int ms); Argumentsgnutls_session_t session is a gnutls_session_t structure. unsigned int ms is a timeout value in millisecondsDescriptionThis function sets the receive timeout for the record layer to the provided value. Use an ms value of zero to disable timeout (the default). Since3.1.7 Reporting BugsReport bugs…

gnutls_record_set_max_size – API function Synopsis#include <gnutls/gnutls.h> ssize_t gnutls_record_set_max_size(gnutls_session_t session, size_t size); Argumentsgnutls_session_t session is a gnutls_session_t structure. size_t size is the new sizeDescriptionThis function sets the maximum record packet size in this connection. This property can only be set to clients. The server may choose not to accept the requested size. Acceptable values are 512(=2^9),…