CSSM_CL_CrlSetFields man page on DigitalUNIX

Printed from http://www.polarhome.com/service/man/?qf=CSSM_CL_CrlSetFields&af=0&tf=2&of=DigitalUNIX

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)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net