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

  man pages->Tru64 Unix man pages -> CSP_EventNotify (3)              



NAME    [Toc]    [Back]

       CSP_EventNotify - Notify service module of a context event

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

 const CSSM_CONTEXT *Context)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The handle that describes the add-in cryptographic service
       provider module used to perform calls to CSSM for the memory
 functions managed by CSSM.  One of the following event
       types listed:

              Event                       Description
              CSSM_CONTEXT_EVENT_CREATE   A caller using this module attach handle
 has created  a  new  cryptographic
                                          context using CSSM_Create***Context.
              CSSM_CONTEXT_EVENT_DELETE   A caller using this module attach handle
 has deleted a  cryptographic  context
 using CSSM_DeleteContext().
              CSSM_CONTEXT_EVENT_UPDATE   A caller using this module attach handle
 has updated  an  existing  cryptographic
              The  cryptographic  context  handle for the context
              affected by the event.  A pointer  to  the  cryptographic
  context affected by the event. The results
              of the event are visible in the context.

DESCRIPTION    [Toc]    [Back]

       This function is used to notify the service  module  of  a
       context event related to a particular attach handle. Valid
       events include creation, deletion, or  modification  of  a
       cryptographic  context. The service module can examine the
       new or modified context referenced by pContext  to  determine
 whether the context is acceptable to the service module.

       If the cryptographic context is acceptable (if the service
       module  examines the contents of the context only upon use
       of the context), then the  service  module  should  return
       CSSM_OK.  If  the cryptographic context is not acceptable,
       then the service module should return CSSM_FAIL.

       Upon receiving a return value of CSSM_OK,  CSSM  completes
       the  operation  signaled  by this event and returns to the
       calling application.  If the return  value  is  CSSM_FAIL,
       CSSM  deletes  a newly created context or modifications to
       an existing context, and returns the failed result to  the
       calling  application.  When  deleting a cryptographic context,
 CSSM always returns success to the calling  application.

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.

SEE ALSO    [Toc]    [Back]


       Intel    CDSA    Application    Developer's   Guide   (see

       Reference Pages    [Toc]    [Back]

       Functions:             CSSM_CSP_CreateSignatureContext(3),

       CSSM_CSP_CreateSymmetricContext(3), CSSM_CSP_CreateMacContext(3), CSSM_CSP_CreateRandomGenContext(3), CSSM_CSP_CreateAsymmetricContext(3),      CSSM_CSP_CreateDeriveKeyContext(3),  CSSM_CSP_CreateKeyGenContext(3),   CSSM_CSP_CreatePassThroughContext(3),           CSSM_DeleteContext(3),

[ Back ]
 Similar pages
Name OS Title
CSSM_ModuleLoad Tru64 Initialize the security service module (CDSA)
CSSM_SPI_ModuleAttach Tru64 Attach a service provider module(CDSA)
CSSM_ModuleAttach Tru64 Attach and verify a service provider module (CDSA)
CSSM_ModuleDetach Tru64 Detach application from service provider module (CDSA)
MDS_Initialize Tru64 Initiate service context with MDS (CDSA)
MDS_Terminate Tru64 Terminate the MDS service context (CDSA)
tt_spec_move HP-UX notify the ToolTalk service that an object has moved to a different file
pam_sm HP-UX PAM Service Module APIs
pam_sm_acct_mgmt FreeBSD service module implementation for pam_acct_mgmt
pam_sm_authenticate FreeBSD service module implementation for pam_authenticate
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service