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

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



NAME    [Toc]    [Back]

       CSSM_ModuleAttach  -  Attach and verify a service provider
       module (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       CSSM_RETURN  CSSMAPI  CSSM_ModuleAttach  (const  CSSM_GUID
       *ModuleGuid,    const    CSSM_VERSION    *Version,   const
       CSSM_API_MEMORY_FUNCS *MemoryFuncs,  uint32  SubserviceID,
       AttachFlags,       CSSM_KEY_HIERARCHY        KeyHierarchy,
       CSSM_FUNC_NAME_ADDR    *FunctionTable,   uint32   NumFunctionTable,
 const  void  *Reserved,  CSSM_MODULE_HANDLE_PTR

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       A pointer to the CSSM_GUID structure containing the global
       unique identifier for the CSP module.  The major and minor
       version  number of CDSA that the application is compatible
       with.  A structure containing pointers to the memory  routines.
  A SubServiceID identifying a particular subservice
       within the module. Subservice IDs can be obtained from MDS
       or  gleaned  from  insertion  events  reported through the
       callback  function  installed  through  CSSM_ModuleLoad().
       Modules  that  provide  only  one  service can use zero as
       their subservice ID.  A service mask describing  the  type
       of  service  the  caller  is  requesting  of  the  service
       provider module.  A mask representing the caller's request
       for  session-specific  services.   The  CSSM_KEY_HIERARCHY
       option directing CSSM what embedded key to use when  verifying
 integrity of the named module.  A table of functionname
 and API function-pointer pairs. The  caller  provides
       the  name of the functions as input. The corresponding API
       function pointers are returned  on  output.  The  function
       table allows dynamic linking of CDSA interfaces, including
       interfaces to Elective Module Managers (EMMs),  which  are
       transparently  loaded  by CSSM during CSSM_ModuleAttach().
       The number of entries in the FunctionTable  parameter.  If
       no  FunctionTable  is  provided,  this value must be zero.
       This field is reserved for future use. It should always be
       set to zero A new module handle that can be used to interact
 with the requested service provider. The value will be
       set to CSSM_INVALID_HANDLE if the function fails.

DESCRIPTION    [Toc]    [Back]

       This  function  attaches  the  service provider module and
       verifies that the version of the module  expected  by  the
       application  is compatible with the version on the system.
       The module can implement subservices  (described  in  your
       service  provider's documentation). The caller can specify
       a specific subservice provided by the module.

       If the subservice is supported as part of the CSSM  framework
  as well as by an EMM, ModuleAttach attaches the Service
 Provider to the CSSM framework. If the subservice  is
       supported only by an EMM, ModuleAttach loads the appropriate
 EMM. The service provider is given  an  indication  of
       whether  it  is being attached to the CSSM framework or an

       The caller can provide a function table  containing  function
  names for the desired services. On output each function
 name is matched with an  API  function  pointer.  The
       caller can use the pointers to invoke service module operations
 through CSSM.

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

SEE ALSO    [Toc]    [Back]


       Intel   CDSA   Application    Developer's    Guide    (see

       Reference Pages    [Toc]    [Back]

       Functions: CSSM_ModuleDetach(3)

[ Back ]
 Similar pages
Name OS Title
CSSM_SPI_ModuleAttach Tru64 Attach a service provider module(CDSA)
CSSM_ModuleDetach Tru64 Detach application from service provider module (CDSA)
cssm_CcToHandle Tru64 Get the module attach handle (CDSA)
Initialize Tru64 Verify module version (CDSA)
CSSM_ModuleLoad Tru64 Initialize the security service module (CDSA)
CSSM_SPI_ModuleDetach Tru64 Notify service module of a context event (CDSA)
CSP_EventNotify Tru64 Notify service module of a context event (CDSA)
getspinfo IRIX get service provider information
setspinfo IRIX set service provider information
pam_sm_authenticate HP-UX Service provider implementation for pam_authenticate
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service