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

FreeBSD Manual Pages

  
 
  

home | help
gnutls_x509_privkey_export_pkcs8(3) gnutls gnutls_x509_privkey_export_pkcs8(3)

NAME
       gnutls_x509_privkey_export_pkcs8	- API function

SYNOPSIS
       #include	<gnutls/x509.h>

       int     gnutls_x509_privkey_export_pkcs8(gnutls_x509_privkey_t	  key,
       gnutls_x509_crt_fmt_t format,  const  char  *  password,	 unsigned  int
       flags, void * output_data, size_t * output_data_size);

ARGUMENTS
       gnutls_x509_privkey_t key
		   Holds the key

       gnutls_x509_crt_fmt_t format
		   the format of output	params.	One of PEM or DER.

       const char * password
		   the password	that will be used to encrypt the key.

       unsigned	int flags
		   an ORed sequence of gnutls_pkcs_encrypt_flags_t

       void * output_data
		   will	contain	a private key PEM or DER encoded

       size_t *	output_data_size
		   holds  the size of output_data (and will be replaced	by the
		   actual size of parameters)

DESCRIPTION
       This function will export the private key to a PKCS8  structure.	  Both
       RSA  and	 DSA keys can be exported. For DSA keys	we use PKCS 11 defini-
       tions. If the flags do not specify the encryption cipher, then the  de-
       fault 3DES (PBES2) will be used.

       The  password can be either ASCII or UTF-8 in the default PBES2 encryp-
       tion schemas, or	ASCII for the PKCS12 schemas.

       If the buffer provided is not long enough  to  hold  the	 output,  then
       *output_data_size  is  updated and GNUTLS_E_SHORT_MEMORY_BUFFER will be
       returned.

       If the structure	is PEM encoded,	it will	have a header  of  "BEGIN  EN-
       CRYPTED PRIVATE KEY" or "BEGIN PRIVATE KEY" if encryption is not	used.

RETURNS
       In  case	 of  failure  a	negative error code will be returned, and 0 on
       success.

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_export_pkcs8(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_export_pkcs8&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help