gnutls_dh_get_prime_bits

Section: gnutls (3)
Updated: 2.8.5
Index Return to Main Contents

NAME

gnutls_dh_get_prime_bits - return the bits used in DH authentication

SYNOPSIS

#include <gnutls/gnutls.h>

int gnutls_dh_get_prime_bits(gnutls_session_t session);

ARGUMENTS

gnutls_session_t session: is a gnutls session

DESCRIPTION

This function will return the bits of the prime used in the last Diffie-Hellman authentication with the peer. Should be used for both anonymous and ephemeral Diffie-Hellman. Note that some ciphers, like RSA and DSA without DHE, does not use a Diffie-Hellman exchange, and then this function will return 0.

RETURNS

The Diffie-Hellman bit strength is returned, or 0 if no Diffie-Hellman exchange was done, or a negative error code on failure.

REPORTING BUGS

Report bugs to <bug-gnutls@gnu.org>. GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/

COPYRIGHT

Copyright © 2008 Free Software Foundation.
Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.