CSP_EventNotify man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

CSP_EventNotify(3)					    CSP_EventNotify(3)

NAME
       CSP_EventNotify - Notify service module of a context event (CDSA)

SYNOPSIS
       # include <cdsa/cssm.h>

       CSSM_RETURN   CSSMSPI  CSP_EventNotify  (CSSM_MODULE_HANDLE  CSPHandle,
       CSSM_CONTEXT_EVENT Event, CSSM_CC_HANDLE CCHandle,  const  CSSM_CONTEXT
       *Context)

LIBRARY
       Common Security Services Manager library (libcssm.so)

PARAMETERS
       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 han‐
					  dle has created  a  new  cryptographic
					  context using CSSM_Create***Context.
	      CSSM_CONTEXT_EVENT_DELETE	  A caller using this module attach han‐
					  dle has deleted a  cryptographic  con‐
					  text using CSSM_DeleteContext().
	      CSSM_CONTEXT_EVENT_UPDATE	  A caller using this module attach han‐
					  dle has updated  an  existing	 crypto‐
					  graphic context.
	      ───────────────────────────────────────────────────────────────────
	      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
       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 mod‐
       ule 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 exam‐
       ines 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 mod‐
       ifications 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
       A CSSM_RETURN value indicating success or specifying a particular error
       condition. The value CSSM_OK indicates success.	All other values  rep‐
       resent an error condition.

SEE ALSO
       Books

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

       Reference Pages

       Functions:  CSSM_CSP_CreateSignatureContext(3),	CSSM_CSP_CreateDigest‐
       Context(3),

       CSSM_CSP_CreateSymmetricContext(3),	 CSSM_CSP_CreateMacContext(3),
       CSSM_CSP_CreateRandomGenContext(3),	 CSSM_CSP_CreateAsymmetricCon‐
       text(3), CSSM_CSP_CreateDeriveKeyContext(3),  CSSM_CSP_CreateKeyGenCon‐
       text(3),	 CSSM_CSP_CreatePassThroughContext(3),	CSSM_DeleteContext(3),
       CSSM_UpdateContextAttributes(3)

							    CSP_EventNotify(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