NAME    [Toc]    [Back]

       MDS_Install - Create the object directory database (CDSA)

SYNOPSIS    [Toc]    [Back]

       #include <cdsa/mds.h>

       CSSM_RETURN CSSMAPI MDS_Install (MDS_HANDLE MdsHandle)

LIBRARY    [Toc]    [Back]

       Module Directory Services library (libmds.so)

PARAMETERS    [Toc]    [Back]

       The MDS handle identifying an MDS context.

DESCRIPTION    [Toc]    [Back]

       This  function  creates the Object Directory database containing
  the  Object  relation,  and  the  CDSA  Directory
       database  containing  the  set  of CDSA-specific relations
       defined in this specification. The MdsHandle identifies an
       MDS context created by invoking MDS_Initialize(). The context
 contains information about the access rights  of  the
       caller.  Write-access  is  required to perform this operation.

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
       CDSA_intro(3).       CSSMERR_DL_INVALID_DL_HANDLE     CSSMERR_DL_DATASTORE_ALREADY_EXISTS
                      CSSMERR_DL_INVALID_ACCESS_REQUEST
 CSSMERR_DL_INVALID_DB_LOCATION
            CSSMERR_DL_INVALID_DB_NAME            CSSMERR_DL_INVALID_OPEN_PARAMETERS
                       CSSMERR_DL_INVALID_RECORD_INDEX
 CSSMERR_DL_INVALID_RECORDTYPE
       CSSMERR_DL_INVALID_FIELD_NAME            CSSMERR_DL_UNSUPPORTED_FIELD_FORMAT
 CSSMERR_DL_UNSUPPORTED_INDEX_INFO CSSMERR_DL_UNSUPPORTED_LOCALITY
             CSSMERR_DL_UNSUPPORTED_NUM_ATTRIBUTES
   CSSMERR_DL_UNSUPPORTED_NUM_INDEXES
       CSSMERR_DL_UNSUPPORTED_NUM_RECORDTYPES   CSSMERR_DL_UNSUPPORTED_RECORDTYPE
 CSSMERR_DL_FIELD_SPECIFIED_MULTIPLE CSSMERR_DL_INCOMPATIBLE_FIELD_FORMAT
 CSSMERR_DL_INVALID_PARSING_MODULE

SEE ALSO    [Toc]    [Back]

       Books

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

       Reference Pages    [Toc]    [Back]




                                                   MDS_Install(3)