Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
gnutls_x509_privkey_generate2(3)    gnutls    gnutls_x509_privkey_generate2(3)

NAME
       gnutls_x509_privkey_generate2 - API function

SYNOPSIS
       #include	<gnutls/x509.h>

       int	 gnutls_x509_privkey_generate2(gnutls_x509_privkey_t	  key,
       gnutls_pk_algorithm_t algo, unsigned  int  bits,	 unsigned  int	flags,
       const gnutls_keygen_data_st * data, unsigned data_size);

ARGUMENTS
       gnutls_x509_privkey_t key
		   a key

       gnutls_pk_algorithm_t algo
		   is one of the algorithms in gnutls_pk_algorithm_t.

       unsigned	int bits
		   the size of the modulus

       unsigned	int flags
		   Must	be zero	or flags from gnutls_privkey_flags_t.

       const gnutls_keygen_data_st * data
		   Allow  specifying  gnutls_keygen_data_st  types such	as the
		   seed	to be used.

       unsigned	data_size
		   The number of  data available.

DESCRIPTION
       This function will generate a random private key. Note that this	 func-
       tion   must   be	  called   on	an   empty   private   key.  The  flag
       GNUTLS_PRIVKEY_FLAG_PROVABLE instructs the key  generation  process  to
       use algorithms which generate provable parameters out of	a seed.

       Note  that when generating an elliptic curve key, the curve can be sub-
       stituted	  in   the   place   of	  the	bits   parameter   using   the
       GNUTLS_CURVE_TO_BITS() macro.

       For  DSA	 keys,	if  the	 subgroup size needs to	be specified check the
       GNUTLS_SUBGROUP_TO_BITS() macro.

       Do    not    set	   the	  number     of	    bits     directly,	   use
       gnutls_sec_param_to_pk_bits().

RETURNS
       On  success, GNUTLS_E_SUCCESS (0) is returned, otherwise	a negative er-
       ror value.

REPORTING BUGS
       Report bugs to <bugs@gnutls.org>.
       Home page: http://www.gnutls.org

COPYRIGHT
       Copyright (C) 2001-2017 Free Software Foundation, Inc., and others.
       Copying and distribution	of this	file, with  or	without	 modification,
       are  permitted in any medium without royalty provided the copyright no-
       tice and	this notice are	preserved.

SEE ALSO
       The full	documentation for gnutls is maintained as  a  Texinfo  manual.
       If  the /usr/share/doc/gnutls/ directory	does not contain the HTML form
       visit

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

gnutls				    3.5.12    gnutls_x509_privkey_generate2(3)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | RETURNS | REPORTING BUGS | COPYRIGHT | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=gnutls_x509_privkey_generate2&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help