Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

gnutls_certificate_set_x509_simple_pkcs12_file(3) [suse man page]

gnutls_certificate_set_x509_simple_pkcs12_file(3)		      gnutls			 gnutls_certificate_set_x509_simple_pkcs12_file(3)

NAME

       gnutls_certificate_set_x509_simple_pkcs12_file - API function

SYNOPSIS

       #include <gnutls/gnutls.h>

       int  gnutls_certificate_set_x509_simple_pkcs12_file(gnutls_certificate_credentials_t  res,  const  char * pkcs12file, gnutls_x509_crt_fmt_t
       type, const char * password);

ARGUMENTS

       gnutls_certificate_credentials_t res
		   is a gnutls_certificate_credentials_t structure.

       const char * pkcs12file
		   filename of file containing PKCS12 blob.

       gnutls_x509_crt_fmt_t type
		   is PEM or DER of the pkcs12file.

       const char * password
		   optional password used to decrypt PKCS12 file, bags and keys.

DESCRIPTION

       This function sets a certificate/private key pair and/or a CRL in the gnutls_certificate_credentials_t structure.   This  function  may	be
       called more than once (in case multiple keys/certificates exist for the server).

MAC

       ed  PKCS12  files are supported.  Encrypted PKCS12 bags are supported.  Encrypted PKCS8 private keys are supported.  However, only password
       based security, and the same password for all operations, are supported.

       The private keys may be RSA PKCS1 or DSA private keys encoded in the OpenSSL way.

       PKCS12 file may contain many keys and/or certificates, and there is no way to identify which key/certificate pair  you  want.   You  should
       make sure the PKCS12 file only contain one key/certificate pair and/or one CRL.

       It is believed that the limitations of this function is acceptable for most usage, and that any more flexibility would introduce complexity
       that would make it harder to use this functionality at all.

RETURNS

       GNUTLS_E_SUCCESS on success, or an error code.

REPORTING BUGS

       Report  bugs  to  <bug-gnutls@gnu.org>.	 GnuTLS  home  page:  http://www.gnu.org/software/gnutls/  General  help   using   GNU	 software:
       http://www.gnu.org/gethelp/

COPYRIGHT

       Copyright (C) 2008 Free Software Foundation.
       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.

gnutls								       2.8.6			 gnutls_certificate_set_x509_simple_pkcs12_file(3)

Check Out this Related Man Page

gnutls_certificate_set_x509_key_file(3) 			      gnutls				   gnutls_certificate_set_x509_key_file(3)

NAME

       gnutls_certificate_set_x509_key_file - API function

SYNOPSIS

       #include <gnutls/gnutls.h>

       int   gnutls_certificate_set_x509_key_file(gnutls_certificate_credentials_t   res,   const   char   *   certfile,  const  char  *  keyfile,
       gnutls_x509_crt_fmt_t type);

ARGUMENTS

       gnutls_certificate_credentials_t res
		   is a gnutls_certificate_credentials_t structure.

       const char * certfile
		   is a file that containing the certificate list (path) for the specified private key, in PKCS7 format, or a list of certificates

       const char * keyfile
		   is a file that contains the private key

       gnutls_x509_crt_fmt_t type
		   is PEM or DER

DESCRIPTION

       This function sets a certificate/private key pair in the gnutls_certificate_credentials_t structure.  This function may be called more than
       once,  in  case	multiple  keys/certificates exist for the server.  For clients that need to send more than its own end entity certificate,
       e.g., also an intermediate CA cert, then the
	certfile must contain the ordered certificate chain.

       This function can also accept URLs at  keyfile and  certfile . In that case it will import the private key and certificate indicated by the
       URLs. Note that the supported URLs are the ones indicated by gnutls_url_is_supported().

RETURNS

       GNUTLS_E_SUCCESS (0) on success, or a negative 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_certificate_set_x509_key_file(3)
Man Page