MDS_Install(3)MDS_Install(3)NAMEMDS_Install - Create the object directory database (CDSA)
SYNOPSIS
#include <cdsa/mds.h>
CSSM_RETURN CSSMAPI MDS_Install (MDS_HANDLE MdsHandle)
LIBRARY
Module Directory Services library (libmds.so)
PARAMETERS
The MDS handle identifying an MDS context.
DESCRIPTION
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
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_DL_HANDLE CSSMERR_DL_DATAS‐
TORE_ALREADY_EXISTS CSSMERR_DL_INVALID_ACCESS_REQUEST CSS‐
MERR_DL_INVALID_DB_LOCATION CSSMERR_DL_INVALID_DB_NAME CSS‐
MERR_DL_INVALID_OPEN_PARAMETERS CSSMERR_DL_INVALID_RECORD_INDEX CSS‐
MERR_DL_INVALID_RECORDTYPE CSSMERR_DL_INVALID_FIELD_NAME CSS‐
MERR_DL_UNSUPPORTED_FIELD_FORMAT CSSMERR_DL_UNSUPPORTED_INDEX_INFO CSS‐
MERR_DL_UNSUPPORTED_LOCALITY CSSMERR_DL_UNSUPPORTED_NUM_ATTRIBUTES CSS‐
MERR_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
Books
Intel CDSA Application Developer's Guide (see CDSA_intro(3))
Reference Pages
MDS_Install(3)