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

FreeBSD Manual Pages

  
 
  

home | help
gnutls_certifi..._x509_key_mem2(3)  gnutls  gnutls_certifi..._x509_key_mem2(3)

NAME
       gnutls_certificate_set_x509_key_mem2 - API function

SYNOPSIS
       #include	<gnutls/gnutls.h>

       int     gnutls_certificate_set_x509_key_mem2(gnutls_certificate_creden-
       tials_t res, const gnutls_datum_t * cert, const gnutls_datum_t  *  key,
       gnutls_x509_crt_fmt_t type, const char *	pass, unsigned int flags);

ARGUMENTS
       gnutls_certificate_credentials_t	res
		   is a	gnutls_certificate_credentials_t type.

       const gnutls_datum_t * cert
		   contains  a	certificate list (path)	for the	specified pri-
		   vate	key

       const gnutls_datum_t * key
		   is the private key, or NULL

       gnutls_x509_crt_fmt_t type
		   is PEM or DER

       const char * pass
		   is the key's	password

       unsigned	int flags
		   an ORed sequence of gnutls_pkcs_encrypt_flags_t

DESCRIPTION
       This function sets a certificate/private	key pair  in  the  gnutls_cer-
       tificate_credentials_t  type.  This  function  may  be called more than
       once, in	case multiple keys/certificates	exist for the server.

       Note that the keyUsage (2.5.29.15) PKIX extension in X.509 certificates
       is supported. This means	that certificates intended for signing	cannot
       be used for ciphersuites	that require encryption.

       If  the	certificate and	the private key	are given in PEM encoding then
       the strings that	hold their values must be null terminated.

       The   key  may  be  NULL	 if  you  are  using  a	 sign  callback,   see
       gnutls_sign_callback_set().

       Note that, this function	by default returns zero	on success and a nega-
       tive  value  on	error.	 Since	3.5.6,	when  the flag GNUTLS_CERTIFI-
       CATE_API_V2 is set using	gnutls_certificate_set_flags() it  returns  an
       index (greater or equal to zero). That index can	be used	to other func-
       tions to	refer to the added key-pair.

RETURNS
       On  success this	functions returns zero,	and otherwise a	negative value
       on error	(see above for modifying that behavior).

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

COPYRIGHT
       Copyright (C) 2001-2023 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/local/share/doc/gnutls/ directory does not contain the HTML
       form visit

       https://www.gnutls.org/manual/

gnutls				     3.8.9  gnutls_certifi..._x509_key_mem2(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gnutls_certificate_set_x509_key_mem2&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help