CL_CrlSetFields(3)CL_CrlSetFields(3)NAME
CL_CrlSetFields, CSSM_CL_CrlSetFields - Set new field values (CDSA)
SYNOPSIS
# include <cdsa/cssm.h>
API: CSSM_RETURN CSSMAPI CSSM_CL_CrlSetFields (CSSM_CL_HANDLE CLHandle,
uint32 NumberOfFields, const CSSM_FIELD *CrlTemplate, const CSSM_DATA
*OldCrl, CSSM_DATA_PTR ModifiedCrl) SPI: CSSM_RETURN CSSMCLI CL_CrlSet‐
Fields (CSSM_CL_HANDLE CLHandle, uint32 NumberOfFields, const
CSSM_FIELD *CrlTemplate, const CSSM_DATA *OldCrl, CSSM_DATA_PTR Modi‐
fiedCrl)
LIBRARY
Common Security Services Manager library (libcssm.so)
PARAMETERS
The handle that describes the add-in Certificate Library module used to
perform this function. The number of OID value pairs specified in the
CrlTemplate input parameter. Any array of field OID value pairs con‐
taining the values to initialize the CRL attribute fields. The CRL to
be updated with the new attribute values. The CRL must be unsigned and
available for update. A pointer to the modified, unsigned CRL. The
ModifiedCrl->Data is allocated by the service provider and must be
deallocated by the application.
DESCRIPTION
This function will set the fields of the input CRL to the new values,
specified by the input OID/value pairs. If there is more than one pos‐
sible instance of an OID (for example, as in an extension or CRL
record), then a new field with the specified value is added to the CRL.
This function should be used to update any of the CRL field values. If
a specified field was initialized by CSSM_CL_CrlCreateTemplate() (CSSM
API), or CL_CrlCreateTemplate() (CL SPI), the field value is set to the
new specified value. If a specified field was not initialized by the
CSSM_CL_CrlCreateTemplate() (CSSM API), or CL_CrlCreateTemplate() (CL
SPI), the field is set to the new specified value. The OldCrl must be
unsigned. Once a CRL has been signed using CSSM_CL_CrlSign() (CSSM
API), or CL_CrlSign() (CL SPI), the signed CRL's field values cannot be
modified. Modification would invalidate the cryptographic signature of
the CRL.
RETURN VALUE
A CSSM_RETURN value indicating success or specifying a particular error
condition. The value CSSM_OK indicates success. All other values repre‐
sent an error condition.
ERRORS
Errors are described in the CDSA technical standard. See
CDSA_intro(3). CSSMERR_CL_INVALID_FIELD_POINTER CSSMERR_CL_UNKNOWN_TAG
CSSMERR_CL_INVALID_NUMBER_OF_FIELDS CSSMERR_CL_UNKNOWN_FORMAT CSS‐
MERR_CL_INVALID_CRL_POINTER CSSMERR_CL_CRL_ALREADY_SIGNED
SEE ALSO
Books
Intel CDSA Application Developer's Guide (see CDSA_intro(3))
Reference Pages
Functions for the CSSM API:
CSSM_CL_CrlCreateTemplate(3), CSSM_CL_CrlAddCert(3), CSSM_CL_Crl‐
Sign(3), CSSM_CL_CertGetFirstFieldValue(3)
Functions for the CLI SPI:
CL_CrlCreateTemplate(3), CL_CrlAddCert(3), CL_CrlSign(3), CL_CertGet‐
FirstFieldValue(3)CL_CrlSetFields(3)