MDS_Initialize man page on DigitalUNIX

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

MDS_Initialize(3)					     MDS_Initialize(3)

NAME
       MDS_Initialize - Initiate service context with MDS (CDSA)

SYNOPSIS
       # 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
       Module Directory Services library (libmds.so)

PARAMETERS
       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
       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 pDl‐
       Functions 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 asso‐
       ciated 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 pCaller‐
       Manifest should be non NULL in an MDS_Initialize() call,	 otherwise  an
       error will be returned.

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.

ERRORS
       Errors	are   described	  in   the   CDSA   technical  standard.   See
       CDSA_intro(3).	CSSMERR_DL_INVALID_POINTER   CSSMERR_DL_INTERNAL_ERROR
       CSSMERR_DL_MEMORY_ERROR CSSMERR_DL_FUNCTION_FAILED

SEE ALSO
       Books

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

       Reference Pages

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