OpenBSD manual page server

Manual Page Search Parameters

CMS_ADD0_CERT(3) Library Functions Manual CMS_ADD0_CERT(3)

CMS_add0_cert, CMS_add1_cert, CMS_get1_certs, CMS_add0_crl, CMS_add1_crl, CMS_get1_crlsCMS certificate and CRL utility functions

#include <openssl/cms.h>

int
CMS_add0_cert(CMS_ContentInfo *cms, X509 *certificate);

int
CMS_add1_cert(CMS_ContentInfo *cms, X509 *certificate);

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);

() adds the certificate to the certificates field of cms if it is of the type SignedData or to the originatorInfo.certs field if it is of the type EnvelopedData. () does the same and also increments the reference count of the certificate with X509_up_ref(3) in case of success.

() returns all certificates in cms.

() adds the crl to the crls field of cms if it is of the type SignedData or to the originatorInfo.crls field if it is of the type EnvelopedData. () does the same and also increments the reference count of the crl with X509_CRL_up_ref(3) in case of success.

() returns any CRLs in cms.

An error occurs if cms is of any type other than SignedData or EnvelopedData.

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

CMS_add0_cert(), CMS_add1_cert(), CMS_add0_crl(), and CMS_add1_crl() return 1 for success or 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.

CMS_ContentInfo_new(3), CMS_encrypt(3), CMS_final(3), CMS_sign(3), ERR_get_error(3)

RFC 5652: Cryptographic Message Syntax

CMS_add0_cert(), CMS_add1_cert(), CMS_get1_certs(), CMS_add0_crl(), and CMS_get1_crls() first appeared in OpenSSL 0.9.8h and CMS_add1_crl() in OpenSSL 1.0.0. These functions have been available since OpenBSD 6.7.

November 2, 2019 OpenBSD-7.0