ModuleManagerAuthenticate man page on DigitalUNIX

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

ModuleManagerAuthenticate(3)			  ModuleManagerAuthenticate(3)

NAME
       ModuleManagerAuthenticate - Module manager authentication (CDSA)

SYNOPSIS
       # include <cdsa/mds.h>

       CSSM_RETURN  CSSMAPI ModuleManagerAuthenticate (CSSM_KEY_HIERARCHY Key‐
       Hierarchy,  const  CSSM_GUID  *CssmGuid,	 const	 CSSM_GUID   *AppGuid,
       CSSM_MANAGER_REGISTRATION_INFO_PTR FunctionTable)

LIBRARY
       Common Security Services Manager library (libcssm.so)

PARAMETERS
       The  CSSM_KEY_HIERARCHY	flag  indicating  which	 embedded  key(s) CSSM
       should use when verifying the  integrity	 of  the  module  manager.   A
       CSSM_GUID  value identifying the calling CSSM. The elective module man‐
       ager can use this value to locate the signed manifest  credentials  for
       CSSM.   A  CSSM_GUID  value identifying the application who invoked the
       calling CSSM.  The elective module manager can use this value to locate
       the signed manifest credentials for the application.  A set of function
       pointers for EMM-defined functions used by CSSM	to  communicate	 state
       changes related to module attach and module detach operations.

DESCRIPTION
       This  function should perform the elective module manager's half of the
       bilateral authentication procedure with CSSM. The CssmGuid is  used  to
       locate  the  CSSM's  credentials	 to be verified. The credentials are a
       zipped, signed manifest.

       The KeyHierarchy indicates which public key should be used as the  root
       when  checking the integrity of the module manager. The AppGuid is used
       to locate the application's signed manifest credentials.	 The  elective
       module  manager	must check the application's credentials to verify the
       application's authorization. If no privileges are requested,  then  the
       application is not required to provide a GUID nor a set of signed mani‐
       fest credentials.

       Upon successful completion, the elective	 module	 manager  returns  its
       function table to the calling CSSM. The EMM function table contains the
       set of EMM entry points that CSSM uses to notify the module manager  of
       significant  events  such  as  module attach and module detach requests
       issued by an application, and event notifications issued by other  mod‐
       ule managers.

       This  function  symbol must be exported by the elective module manager,
       so CSSM can  invoke  this  function  upon  completion  of  the  loading
       process.

       This  function  is  the	first module manager interface invoked by CSSM
       after loading and invoking the main entry  point.  In  particular,  the
       elective	 module manager's initialize function is invoked by CSSM after
       this function has successfully completed execution.

RETURN VALUE
       A CSSM_RETURN value indicating success or specifying a particular error
       condition. The value CSSM_OK indicates success. All other values repre‐
       sent an error condition.

SEE ALSO
       Books

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

       Reference Pages

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