NAME    [Toc]    [Back]

       CL_CertCache,  CSSM_CL_CertCache  - Cache a copy of a certificate
 (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API: CSSM_RETURN CSSMAPI CSSM_CL_CertCache (CSSM_CL_HANDLE
       CLHandle,    const    CSSM_DATA   *Cert,   CSSM_HANDLE_PTR
       CertHandle)  SPI:  CSSM_RETURN  CSSMAPI  CSSM_CL_CertCache
       (CSSM_CL_HANDLE CLHandle, const CSSM_DATA *Cert, CSSM_HANDLE_PTR
 CertHandle)

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 certificate.   A  pointer
       to  the CSSM_HANDLE that should be used in all future references
 to the cached certificate.

DESCRIPTION    [Toc]    [Back]

       This function caches a copy of a  certificate  for  subsequent
  accesses  using the functions CSSM_CL_CertGetFirstCachedFieldValue()
 (CSSM API),  or  CL_CertGetFirstCachedFieldValue()
 (CL SPI), and CSSM_CL_CertGetNextCachedFieldValue()
 (CSSM  API),  or  CL_CertGetNextCachedFieldValue()
       (CL SPI).

       The  input  certificate  must be in an encoded representation.
 The Certificate Library module can  cache  the  certificate
   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_CertAbortCache() (CSSM
       API), or  CL_CertAbortCache()  (CL  SPI),  to  remove  the
       cached  copy  when  additional  get operations will not be
       performed on the cached certificate.

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_CERT_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_CertGetFirstCachedFieldValue(3),  CSSM_CL_CertGetNextCachedFieldValue(3),        CSSM_CL_CertAbortQuery(3),
       CSSM_CL_CertAbortCache(3)

       Functions for the CLI SPI:

       CL_CertGetFirstCachedFieldValue(3),  CL_CertGetNextCachedFieldValue(3), CL_CertAbortQuery(3), CL_CertAbortCache(3)



                                                  CL_CertCache(3)