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

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



NAME    [Toc]    [Back]

       MDS_Initialize - Initiate service context with MDS (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/mds.h>

       CSSM_RETURN CSSMAPI MDS_Initialize (const CSSM_GUID *pCallerGuid,
 const CSSM_DATA *pCallerManifest, const CSSM_MEMORY_FUNCS
  *pMemoryFunctions,  MDS_FUNCS_PTR pDlFunctions,
       MDS_HANDLE *hMds)

LIBRARY    [Toc]    [Back]

       Module Directory Services library (libmds.so)

PARAMETERS    [Toc]    [Back]

       The GUID of the module calling MDS.  The Manifest  of  the
       module  calling  MDS.   The memory-management routines MDS
       uses to allocate query results on behalf  of  the  caller.
       The  function  table containing MDS programming interfaces
       for database access.  A new handle that  can  be  used  to
       interact   with   the  MDS.  The  value  will  be  set  to
       CSSM_INVALID_HANDLE if the function fails.

DESCRIPTION    [Toc]    [Back]

       This function initiates a service  context  with  MDS  and
       returns  an  opaque  handle corresponding to that context.
       The caller provides memory functions that MDS can  use  to
       manage  memory  in  the  caller's  space  on behalf of the
       caller.  The caller also provides input/output table  pDlFunctions
 to get access to MDS databases.

       If the caller is a CDSA service provider that will require
       write-access to an MDS database, (such as  a  module  that
       supports  dynamic  insertion and removal events), then the
       caller can provide the caller's GUID  as  input  parameter
       pCallerGuid.  When  provided as input, the GUID is associated
 with the MDS handle and is used  during  DbOpen  processing.
  If  write-access is requested during DbOpen, MDS
       uses the associated GUID to locate the service  provider's
       signed manifest credentials in the DS Common relation. The
       service provider module and its credentials  are  verified
       to  ensure that write-access is permitted on this database
       by this module.

       The installers will have to  provide  the  pCallerManifest
       instead  of  pCallerGuid, as GUID cannot be used to locate
       an application unless it is installed. Only one of the two
       parameters  pCallerGuid  and pCallerManifest should be non
       NULL in an MDS_Initialize() call, otherwise an error  will
       be returned.

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]

[ Back ]
 Similar pages
Name OS Title
MDS_Terminate Tru64 Terminate the MDS service context (CDSA)
CSP_EventNotify Tru64 Notify service module of a context event (CDSA)
CSSM_SPI_ModuleDetach Tru64 Notify service module of a context event (CDSA)
gss_init_sec_context Tru64 Initiate a security context between an application and its peer.
gss_process_context_token HP-UX process a context to the security service
CSSM_GetContextAttribute Tru64 Get context attribute (CDSA)
CSP_WrapKey Tru64 Wrap a key using the context (CDSA)
CSSM_GetContext Tru64 Get context information (CDSA)
CSSM_WrapKey Tru64 Wrap a key using the context (CDSA)
WrapKey Tru64 Wrap a key using the context (CDSA)
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service