1*b077aed3SPierre Pronchery=pod 2*b077aed3SPierre Pronchery 3*b077aed3SPierre Pronchery=head1 NAME 4*b077aed3SPierre Pronchery 5*b077aed3SPierre Proncherycms_add1_signing_cert, cms_add1_signing_cert_v2 6*b077aed3SPierre Pronchery- add ESS signing-certificate signed attribute to a 7*b077aed3SPierre ProncheryCMS_SignerInfo data structure 8*b077aed3SPierre Pronchery 9*b077aed3SPierre Pronchery=head1 SYNOPSIS 10*b077aed3SPierre Pronchery 11*b077aed3SPierre Pronchery #include <openssl/cms.h> 12*b077aed3SPierre Pronchery 13*b077aed3SPierre Pronchery int cms_add1_signing_cert(CMS_SignerInfo *si, ESS_SIGNING_CERT *sc); 14*b077aed3SPierre Pronchery 15*b077aed3SPierre Pronchery int cms_add1_signing_cert_v2(CMS_SignerInfo *si, ESS_SIGNING_CERT_V2 *sc2); 16*b077aed3SPierre Pronchery 17*b077aed3SPierre Pronchery=head1 DESCRIPTION 18*b077aed3SPierre Pronchery 19*b077aed3SPierre Proncherycms_add1_signing_cert() adds an ESS Signing Certificate I<sc> (version 1) signed 20*b077aed3SPierre Proncheryattribute to the CMS_SignerInfo I<si>. 21*b077aed3SPierre Proncherycms_add1_signing_cert_v2() adds an ESS Signing Certificate I<sc2> (version 2) signed 22*b077aed3SPierre Proncheryattribute to the CMS_SignerInfo I<si>. 23*b077aed3SPierre ProncheryThe ESS Signing Certificate attributes version 1 and 2 are defined in RFC 5035 24*b077aed3SPierre Proncherywhich updates Section 5.4 of RFC 2634. 25*b077aed3SPierre Pronchery 26*b077aed3SPierre Pronchery=head1 NOTES 27*b077aed3SPierre Pronchery 28*b077aed3SPierre ProncheryThis attribute is mandatory to make a CMS compliant with CAdES-BES 29*b077aed3SPierre Pronchery(European Standard ETSI EN 319 122-1 V1.1.1). 30*b077aed3SPierre ProncheryFor a fuller description see L<openssl-cms(1)>). 31*b077aed3SPierre Pronchery 32*b077aed3SPierre Pronchery=head1 RETURN VALUES 33*b077aed3SPierre Pronchery 34*b077aed3SPierre Proncherycms_add1_signing_cert() and cms_add1_signing_cert_v2() return 1 if attribute 35*b077aed3SPierre Proncheryis added or 0 if an error occurred. 36*b077aed3SPierre Pronchery 37*b077aed3SPierre Pronchery=head1 COPYRIGHT 38*b077aed3SPierre Pronchery 39*b077aed3SPierre ProncheryCopyright 2019-2021 The OpenSSL Project Authors. All Rights Reserved. 40*b077aed3SPierre Pronchery 41*b077aed3SPierre ProncheryLicensed under the Apache License 2.0 (the "License"). You may not use 42*b077aed3SPierre Proncherythis file except in compliance with the License. You can obtain a copy 43*b077aed3SPierre Proncheryin the file LICENSE in the source distribution or at 44*b077aed3SPierre ProncheryL<https://www.openssl.org/source/license.html>. 45*b077aed3SPierre Pronchery 46*b077aed3SPierre Pronchery=cut 47