*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> CSSM_CL_CertCache (3)              
Title
Content
Arch
Section
 

CL_CertCache(3)

Contents


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)
[ Back ]
 Similar pages
Name OS Title
CL_CrlCache Tru64 Cache a copy of a certificate revocation list (CDSA)
CSSM_CL_CrlCache Tru64 Cache a copy of a certificate revocation list (CDSA)
CSSM_CL_CertAbortCache Tru64 Terminate a certificate cache handle (CDSA)
CL_CertAbortCache Tru64 Terminate a certificate cache handle (CDSA)
CSSM_CL_CertGroupToSignedBundle Tru64 Convert a certificate group to a certificate bundle (CDSA)
CL_CertGroupToSignedBundle Tru64 Convert a certificate group to a certificate bundle (CDSA)
CSSM_TP_CertRevoke Tru64 Determine if the revoking certificate group can revoke the subject certificate group (CDSA)
TP_CertRevoke Tru64 Determine if the revoking certificate group can revoke the subject certificate group (CDSA)
CSSM_TP_CertReclaimKey Tru64 Get private key associated with a certificate (CDSA)
CL_CrlRemoveCert Tru64 Reinstate a certificate (CDSA)
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service