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

FreeBSD Manual Pages

  
 
  

home | help
CMS_ADD0_CERT(3)		    OpenSSL		      CMS_ADD0_CERT(3)

NAME
       CMS_add0_cert, CMS_add1_cert, CMS_get1_certs, CMS_add0_crl,
       CMS_add1_crl, CMS_get1_crls - CMS certificate and CRL utility functions

SYNOPSIS
	#include <openssl/cms.h>

	int CMS_add0_cert(CMS_ContentInfo *cms,	X509 *cert);
	int CMS_add1_cert(CMS_ContentInfo *cms,	X509 *cert);
	STACK_OF(X509) *CMS_get1_certs(CMS_ContentInfo *cms);

	int CMS_add0_crl(CMS_ContentInfo *cms, X509_CRL	*crl);
	int CMS_add1_crl(CMS_ContentInfo *cms, X509_CRL	*crl);
	STACK_OF(X509_CRL) *CMS_get1_crls(CMS_ContentInfo *cms);

DESCRIPTION
       CMS_add0_cert() and CMS_add1_cert() add certificate cert	to cms.	 must
       be of type signed data or enveloped data.

       CMS_get1_certs()	returns	all certificates in cms.

       CMS_add0_crl() and CMS_add1_crl() add CRL crl to	cms. CMS_get1_crls()
       returns any CRLs	in cms.

NOTES
       The CMS_ContentInfo structure cms must be of type signed	data or
       enveloped data or an error will be returned.

       For signed data certificates and	CRLs are added to the certificates and
       crls fields of SignedData structure. For	enveloped data they are	added
       to OriginatorInfo.

       As the 0	implies	CMS_add0_cert()	adds cert internally to	cms and	it
       must not	be freed up after the call as opposed to CMS_add1_cert() where
       cert must be freed up.

       The same	certificate or CRL must	not be added to	the same cms structure
       more than once.

RETURN VALUES
       CMS_add0_cert(),	CMS_add1_cert()	and CMS_add0_crl() and CMS_add1_crl()
       return 1	for success and	0 for failure.

       CMS_get1_certs()	and CMS_get1_crls() return the STACK of	certificates
       or CRLs or NULL if there	are none or an error occurs. The only error
       which will occur	in practice is if the cms type is invalid.

SEE ALSO
       ERR_get_error(3), CMS_sign(3), CMS_encrypt(3)

COPYRIGHT
       Copyright 2008-2016 The OpenSSL Project Authors.	All Rights Reserved.

       Licensed	under the OpenSSL license (the "License").  You	may not	use
       this file except	in compliance with the License.	 You can obtain	a copy
       in the file LICENSE in the source distribution or at
       <https://www.openssl.org/source/license.html>.

1.1.1d				  2019-09-10		      CMS_ADD0_CERT(3)

NAME | SYNOPSIS | DESCRIPTION | NOTES | RETURN VALUES | SEE ALSO | COPYRIGHT

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

home | help