NAME    [Toc]    [Back]

       CL_CrlCache, CSSM_CL_CrlCache - Cache a copy of a certificate
 revocation list (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API: CSSM_RETURN CSSMAPI CSSM_CL_CrlCache  (CSSM_CL_HANDLE
       CLHandle, const CSSM_DATA *Crl, CSSM_HANDLE_PTR CrlHandle)
       SPI:  CSSM_RETURN  CSSMCLI   CL_CrlCache   (CSSM_CL_HANDLE
       CLHandle, const CSSM_DATA *Crl, CSSM_HANDLE_PTR CrlHandle)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The handle that describes the certificate  library  module
       used to perform this function.  A pointer to the CSSM_DATA
       structure containing the encoded CRL.  A  pointer  to  the
       CSSM_HANDLE  that  should be used in all future references
       to the cached CRL.

DESCRIPTION    [Toc]    [Back]

       This function caches a copy of a CertificateRevocationList
       (CRL)   for   subsequent   accesses  using  the  functions
       CSSM_CL_CrlGetFirstFieldValue()    and     CSSM_CL_CrlGetNextFieldValue()
 (or their CL SPI equivalents).

       The  input  CRL  must be in an encoded representation. The
       Certificate Library module can cache the CRL in any appropriate
  internal  representation.  Parsed or incrementally
       parsed representations are common. The selected  representation
 is opaque to the caller.

       The  application  must  call CSSM_CL_CrlCacheAbort() (CSSM
       API), or CL_CrlCacheAbort() (CL SPI), to remove the cached
       copy  when additional get operations will not be performed
       on the cached CRL.

RETURN VALUE    [Toc]    [Back]

       A CSSM_RETURN value indicating  success  or  specifying  a
       particular  error  condition.  The value CSSM_OK indicates
       success. All other values represent an error condition.

ERRORS    [Toc]    [Back]

       Errors are described in the CDSA technical standard.   See
       CDSA_intro(3).      CSSMERR_CL_INVALID_CRL_POINTER    CSSMERR_CL_UNKNOWN_FORMAT

SEE ALSO    [Toc]    [Back]

       Books

       Intel   CDSA   Application    Developer's    Guide    (see
       CDSA_intro(3))

       Reference Pages    [Toc]    [Back]

       Functions for the CSSM API:

       CSSM_CL_CrlGetFirstCachedFieldValue(3),
       CSSM_CL_CrlGetNextCachedFieldValue(3),   CSSM_CL_IsCertInCachedCrl(3),  CSSM_CL_CrlAbortQuery(3), CSSM_CL_CrlAbortCache(3)

       Functions for the CLI SPI:

       CL_CrlGetFirstCachedFieldValue(3),    CL_CrlGetNextCachedFieldValue(3),    CL_IsCertInCachedCrl(3),    CL_CrlAbortQuery(3), CL_CrlAbortCache(3)



                                                   CL_CrlCache(3)