Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

gnutls_ia_enable(3) [suse man page]

gnutls_ia_enable(3)						      gnutls						       gnutls_ia_enable(3)

NAME

       gnutls_ia_enable - Indicate willingness for TLS/IA application phases

SYNOPSIS

       #include <gnutls/extra.h>

       void gnutls_ia_enable(gnutls_session_t session, int allow_skip_on_resume);

ARGUMENTS

       gnutls_session_t session
		   is a gnutls_session_t structure.

       int allow_skip_on_resume
		   non-zero if local party allows to skip the TLS/IA application phases for a resumed session.

DESCRIPTION

       Specify whether we must advertise support for the TLS/IA extension during the handshake.

       At  the	client	side,  we always advertise TLS/IA if gnutls_ia_enable was called before the handshake; at the server side, we also require
       that the client has advertised that it wants to run TLS/IA before including the advertisement, as required by the protocol.

       Similarly, at the client side we always advertise that we allow TLS/IA to be  skipped  for  resumed  sessions  if  allow_skip_on_resume	is
       non-zero;  at  the server side, we also require that the session is indeed resumable and that the client has also advertised that it allows
       TLS/IA to be skipped for resumed sessions.

       After the TLS handshake, call gnutls_ia_handshake_p() to find out whether both parties agreed to do  a  TLS/IA  handshake,  before  calling
       gnutls_ia_handshake() or one of the lower level gnutls_ia_* functions.

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 (C) 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.

SEE ALSO

       The  full documentation for gnutls is maintained as a Texinfo manual.  If the info and gnutls programs are properly installed at your site,
       the command

	      info gnutls

       should give you access to the complete manual.

gnutls								       2.8.6						       gnutls_ia_enable(3)

Check Out this Related Man Page

gnutls_handshake(3)						      gnutls						       gnutls_handshake(3)

NAME

       gnutls_handshake - This is the main function in the handshake protocol.

SYNOPSIS

       #include <gnutls/gnutls.h>

       int gnutls_handshake(gnutls_session_t session);

ARGUMENTS

       gnutls_session_t session
		   is a gnutls_session_t structure.

DESCRIPTION

       This function does the handshake of the TLS/SSL protocol, and initializes the TLS connection.

       This  function will fail if any problem is encountered, and will return a negative error code. In case of a client, if the client has asked
       to resume a session, but the server couldn't, then a full handshake will be performed.

       The non-fatal errors such as GNUTLS_E_AGAIN and GNUTLS_E_INTERRUPTED interrupt the handshake procedure, which should be later  be  resumed.
       Call this function again, until it returns 0; cf.  gnutls_record_get_direction() and gnutls_error_is_fatal().

       If  this  function  is called by a server after a rehandshake request then GNUTLS_E_GOT_APPLICATION_DATA or GNUTLS_E_WARNING_ALERT_RECEIVED
       may be returned.  Note that these are non fatal errors, only in the specific case of a rehandshake.   Their  meaning  is  that  the  client
       rejected the rehandshake request.

RETURNS

       GNUTLS_E_SUCCESS on success, otherwise an error.

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 (C) 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.

SEE ALSO

       The  full documentation for gnutls is maintained as a Texinfo manual.  If the info and gnutls programs are properly installed at your site,
       the command

	      info gnutls

       should give you access to the complete manual.

gnutls								       2.8.6						       gnutls_handshake(3)
Man Page