Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

gnutls_prf_raw(3) [centos man page]

gnutls_prf_raw(3)						      gnutls							 gnutls_prf_raw(3)

NAME

       gnutls_prf_raw - API function

SYNOPSIS

       #include <gnutls/gnutls.h>

       int  gnutls_prf_raw(gnutls_session_t  session,  size_t label_size, const char * label, size_t seed_size, const char * seed, size_t outsize,
       char * out);

ARGUMENTS

       gnutls_session_t session
		   is a gnutls_session_t structure.

       size_t label_size
		   length of the  label variable.

       const char * label
		   label used in PRF computation, typically a short string.

       size_t seed_size
		   length of the  seed variable.

       const char * seed
		   optional extra data to seed the PRF with.

       size_t outsize
		   size of pre-allocated output buffer to hold the output.

       char * out  pre-allocated buffer to hold the generated data.

DESCRIPTION

       Apply the TLS Pseudo-Random-Function (PRF) on the master secret and the provided data.

       The  label variable usually contains a string denoting the purpose for the generated data.  The	seed usually contains  data  such  as  the
       client  and  server random, perhaps together with some additional data that is added to guarantee uniqueness of the output for a particular
       purpose.

       Because the output is not guaranteed to be unique for a particular session unless  seed includes the client random and server random fields
       (the PRF would output the same data on another connection resumed from the first one), it is not recommended to use this function directly.
       The gnutls_prf() function seeds the PRF with the client and server random fields directly, and is  recommended  if  you	want  to  generate
       pseudo random data unique for each session.

RETURNS

       GNUTLS_E_SUCCESS on success, or an error code.

REPORTING BUGS

       Report bugs to <bug-gnutls@gnu.org>.
       General guidelines for reporting bugs: http://www.gnu.org/gethelp/
       GnuTLS home page: http://www.gnu.org/software/gnutls/

COPYRIGHT

       Copyright (C) 2012 Free Software Foundation, Inc..
       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.  As an alternative you may obtain the manual from:

	      http://www.gnu.org/software/gnutls/manual/

gnutls								      3.1.15							 gnutls_prf_raw(3)

Check Out this Related Man Page

gnutls_record_recv_seq(3)					      gnutls						 gnutls_record_recv_seq(3)

NAME

       gnutls_record_recv_seq - API function

SYNOPSIS

       #include <gnutls/gnutls.h>

       ssize_t gnutls_record_recv_seq(gnutls_session_t session, void * data, size_t data_size, unsigned char * seq);

ARGUMENTS

       gnutls_session_t session
		   is a gnutls_session_t structure.

       void * data the buffer that the data will be read into

       size_t data_size
		   the number of requested bytes

       unsigned char * seq
		   is the packet's 64-bit sequence number. Should have space for 8 bytes.

DESCRIPTION

       This  function  is  the same as gnutls_record_recv(), except that it returns in addition to data, the sequence number of the data.  This is
       useful in DTLS where record packets might be received out-of-order. The returned 8-byte sequence number is an integer in big-endian  format
       and should be treated as a unique message identification.

RETURNS

       The  number  of bytes received and zero on EOF.	A negative error code is returned in case of an error.	The number of bytes received might
       be less than  data_size .

SINCE

       3.0

REPORTING BUGS

       Report bugs to <bug-gnutls@gnu.org>.
       General guidelines for reporting bugs: http://www.gnu.org/gethelp/
       GnuTLS home page: http://www.gnu.org/software/gnutls/

COPYRIGHT

       Copyright (C) 2012 Free Software Foundation, Inc..
       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.  As an alternative you may obtain the manual from:

	      http://www.gnu.org/software/gnutls/manual/

gnutls								      3.1.15						 gnutls_record_recv_seq(3)
Man Page