Linux Manuals session 3

NAME gnutls_record_get_discarded – API function SYNOPSIS #include <gnutls/dtls.h> unsigned int gnutls_record_get_discarded(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION Returns the number of discarded packets in a DTLS connection. RETURNS The number of discarded packets. SINCE 3.0 REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright © 2001-2014 Free Software…

NAME gnutls_record_get_direction – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_record_get_direction(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION This function provides information about the internals of the record protocol and is only useful if a prior gnutls function call (e.g. gnutls_handshake()) was interrupted for some reason, that is, if a function returned GNUTLS_E_INTERRUPTED or…

NAME gnutls_record_disable_padding – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_record_disable_padding(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION Used to disabled padding in TLS 1.0 and above. Normally you do not need to use this function, but there are buggy clients that complain if a server pads the encrypted data. This of course will…

NAME gnutls_record_cork – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_record_cork(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION If called, gnutls_record_send() will no longer send any records. Any sent records will be cached until gnutls_record_uncork() is called. This function is safe to use with DTLS after GnuTLS 3.3.0. SINCE 3.1.9 REPORTING BUGS Report bugs…

NAME gnutls_record_check_pending – API function SYNOPSIS #include <gnutls/gnutls.h> size_t gnutls_record_check_pending(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION This function checks if there are unread data in the gnutls buffers. If the return value is non-zero the next call to gnutls_record_recv() is guaranteed not to block. RETURNS Returns the size of the data or…

NAME gnutls_record_check_corked – API function SYNOPSIS #include <gnutls/gnutls.h> size_t gnutls_record_check_corked(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION This function checks if there pending corked data in the gnutls buffers –see gnutls_record_cork(). RETURNS Returns the size of the corked data or zero. SINCE 3.2.8 REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page:…

NAME gnutls_record_can_use_length_hiding – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_record_can_use_length_hiding(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION If the session supports length-hiding padding, you can invoke gnutls_range_send_message() to send a message whose length is hidden in the given range. If the session does not support length hiding padding, you can use the standard…

NAME gnutls_range_split – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_range_split(gnutls_session_t session, const gnutls_range_st * orig, gnutls_range_st * next, gnutls_range_st * remainder); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure const gnutls_range_st * orig is the original range provided by the user gnutls_range_st * next is the returned range that can be conveyed in a TLS record…

NAME gnutls_random_art – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_random_art(gnutls_random_art_t type, const char * key_type, unsigned int key_size, void * fpr, size_t fpr_size, gnutls_datum_t * art); ARGUMENTS gnutls_random_art_t type The type of the random art (for now only GNUTLS_RANDOM_ART_OPENSSH is supported) const char * key_type The type of the key (RSA, DSA etc.) unsigned int…

NAME gnutls_pubkey_verify_params – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_verify_params(gnutls_pubkey_t key); ARGUMENTS gnutls_pubkey_t key should contain a gnutls_pubkey_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_pubkey_verify_hash2 – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_verify_hash2(gnutls_pubkey_t key, gnutls_sign_algorithm_t algo, unsigned int flags, const gnutls_datum_t * hash, const gnutls_datum_t * signature); ARGUMENTS gnutls_pubkey_t key Holds the public key gnutls_sign_algorithm_t algo The signature algorithm used unsigned int flags Zero or one of gnutls_pubkey_flags_t const gnutls_datum_t * hash holds the hash digest to be…

NAME gnutls_pubkey_verify_hash – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_verify_hash(gnutls_pubkey_t key, unsigned int flags, const gnutls_datum_t * hash, const gnutls_datum_t * signature); ARGUMENTS gnutls_pubkey_t key Holds the public key unsigned int flags Zero or one of gnutls_pubkey_flags_t const gnutls_datum_t * hash holds the hash digest to be verified const gnutls_datum_t * signature contains the signature…

NAME gnutls_pubkey_verify_data2 – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_verify_data2(gnutls_pubkey_t pubkey, gnutls_sign_algorithm_t algo, unsigned int flags, const gnutls_datum_t * data, const gnutls_datum_t * signature); ARGUMENTS gnutls_pubkey_t pubkey Holds the public key gnutls_sign_algorithm_t algo The signature algorithm used unsigned int flags Zero or one of gnutls_pubkey_flags_t const gnutls_datum_t * data holds the signed data const gnutls_datum_t…

NAME gnutls_pubkey_verify_data – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_verify_data(gnutls_pubkey_t pubkey, unsigned int flags, const gnutls_datum_t * data, const gnutls_datum_t * signature); ARGUMENTS gnutls_pubkey_t pubkey Holds the public key unsigned int flags Zero or one of gnutls_pubkey_flags_t const gnutls_datum_t * data holds the signed data const gnutls_datum_t * signature contains the signature DESCRIPTION This function…

NAME gnutls_pubkey_set_pin_function – API function SYNOPSIS #include <gnutls/abstract.h> void gnutls_pubkey_set_pin_function(gnutls_pubkey_t key, gnutls_pin_callback_t fn, void * userdata); ARGUMENTS gnutls_pubkey_t key A key of type gnutls_pubkey_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_pubkey_set_key_usage – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_set_key_usage(gnutls_pubkey_t key, unsigned int usage); ARGUMENTS gnutls_pubkey_t key a certificate of type gnutls_x509_crt_t unsigned int usage an ORed sequence of the GNUTLS_KEY_* elements. DESCRIPTION This function will set the key usage flags of the public key. This is only useful if the key is to be…

NAME gnutls_pubkey_print – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_print(gnutls_pubkey_t pubkey, gnutls_certificate_print_formats_t format, gnutls_datum_t * out); ARGUMENTS gnutls_pubkey_t pubkey The structure to be printed gnutls_certificate_print_formats_t format Indicate the format to use gnutls_datum_t * out Newly allocated datum with null terminated string. DESCRIPTION This function will pretty print public key information, suitable for display to a…

NAME gnutls_pubkey_init – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_init(gnutls_pubkey_t * key); ARGUMENTS gnutls_pubkey_t * key The structure to be initialized DESCRIPTION This function will initialize an public 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_pubkey_import_x509_raw – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_import_x509_raw(gnutls_pubkey_t pkey, const gnutls_datum_t * data, gnutls_x509_crt_fmt_t format, unsigned int flags); ARGUMENTS gnutls_pubkey_t pkey The public key const gnutls_datum_t * data The public key data to be imported gnutls_x509_crt_fmt_t format The format of the public key unsigned int flags should be zero DESCRIPTION This function will…

NAME gnutls_pubkey_import_x509_crq – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_import_x509_crq(gnutls_pubkey_t key, gnutls_x509_crq_t crq, unsigned int flags); ARGUMENTS gnutls_pubkey_t key The public key gnutls_x509_crq_t crq The certificate to be imported unsigned int flags should be zero DESCRIPTION This function will import the given public key to the abstract gnutls_pubkey_t structure. RETURNS On success, GNUTLS_E_SUCCESS (0) is…