Tizen 2.0 Release
[external/libgnutls26.git] / doc / manpages / gnutls_ia_extract_inner_secret.3
1 .\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
2 .TH "gnutls_ia_extract_inner_secret" 3 "2.12.6.1" "gnutls" "gnutls"
3 .SH NAME
4 gnutls_ia_extract_inner_secret \- API function
5 .SH SYNOPSIS
6 .B #include <gnutls/extra.h>
7 .sp
8 .BI "void gnutls_ia_extract_inner_secret(gnutls_session_t " session ", char * " buffer ");"
9 .SH ARGUMENTS
10 .IP "gnutls_session_t session" 12
11 is a \fBgnutls_session_t\fP structure.
12 .IP "char * buffer" 12
13 pre\-allocated buffer to hold 48 bytes of inner secret.
14 .SH "DESCRIPTION"
15 Copy the 48 bytes large inner secret into the specified buffer
16
17 This function is typically used after the TLS/IA handshake has
18 concluded.  The TLS/IA inner secret can be used as input to a PRF
19 to derive session keys.  Do not use the inner secret directly as a
20 session key, because for a resumed session that does not include an
21 application phase, the inner secret will be identical to the inner
22 secret in the original session.  It is important to include, for
23 example, the client and server randomness when deriving a sesssion
24 key from the inner secret.
25 .SH "REPORTING BUGS"
26 Report bugs to <bug-gnutls@gnu.org>.
27 GnuTLS home page: http://www.gnu.org/software/gnutls/
28 General help using GNU software: http://www.gnu.org/gethelp/
29 .SH COPYRIGHT
30 Copyright \(co 2008 Free Software Foundation.
31 .br
32 Copying and distribution of this file, with or without modification,
33 are permitted in any medium without royalty provided the copyright
34 notice and this notice are preserved.
35 .SH "SEE ALSO"
36 The full documentation for
37 .B gnutls
38 is maintained as a Texinfo manual.  If the
39 .B info
40 and
41 .B gnutls
42 programs are properly installed at your site, the command
43 .IP
44 .B info gnutls
45 .PP
46 should give you access to the complete manual.