Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

gnutls_prf(3) [centos man page]

gnutls_prf(3)							      gnutls							     gnutls_prf(3)

NAME

       gnutls_prf - API function

SYNOPSIS

       #include <gnutls/gnutls.h>

       int  gnutls_prf(gnutls_session_t  session,  size_t label_size, const char * label, int server_random_first, size_t extra_size, const char *
       extra, 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.

       int server_random_first
		   non-0 if server random field should be first in seed

       size_t extra_size
		   length of the  extra variable.

       const char * extra
		   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, seeded with the client and server random fields.

       The  label variable usually contains a string denoting the purpose for the generated data.  The	server_random_first indicates whether  the
       client  random field or the server random field should be first in the seed.  Non-0 indicates that the server random field is first, 0 that
       the client random field is first.

       The  extra variable can be used to add more data to the seed, after the random variables.  It can be used to make sure the generated output
       is strongly connected to some additional data (e.g., a string used in user authentication).

       The output is placed in	out , which must be pre-allocated.

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(3)

Check Out this Related Man Page

gnutls_server_name_get(3)					      gnutls						 gnutls_server_name_get(3)

NAME

       gnutls_server_name_get - API function

SYNOPSIS

       #include <gnutls/gnutls.h>

       int gnutls_server_name_get(gnutls_session_t session, void * data, size_t * data_length, unsigned int * type, unsigned int indx);

ARGUMENTS

       gnutls_session_t session
		   is a gnutls_session_t structure.

       void * data will hold the data

       size_t * data_length
		   will hold the data length. Must hold the maximum size of data.

       unsigned int * type
		   will hold the server name indicator type

       unsigned int indx
		   is the index of the server_name

DESCRIPTION

       This  function  will  allow  you to get the name indication (if any), a client has sent.  The name indication may be any of the enumeration
       gnutls_server_name_type_t.

       If  type is GNUTLS_NAME_DNS, then this function is to be used by servers that support virtual hosting, and the data will be a  null  termi-
       nated UTF-8 string.

       If   data  has  not  enough  size to hold the server name GNUTLS_E_SHORT_MEMORY_BUFFER is returned, and	data_length will hold the required
       size.

	index is used to retrieve more than one server names (if sent by the client).  The first server name has an index of 0, the second  1  and
       so on.  If no name with the given index exists GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE is returned.

RETURNS

       On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error code is returned.

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_server_name_get(3)
Man Page