Preface

Part 1 DCE Directory Service

Chapter 1. Introduction to This Guide

Using the DCE Directory Service

DCE Directory Service Concepts

Structure of DCE Names

The Federated DCE Namespace

Programming Interfaces to the DCE Directory Service

Part 2 CDS Application Programming

Chapter 2. Programming in the CDS Namespace

Initial Cell Namespace Organization

Recommended Use of the CDS Namespace

Valid Characters and Naming Rules for CDS

Use of OIDs

Chapter 3. XDS and the DCE Cell Namespace

Introduction to Accessing CDS with XDS

XDS Objects

Accessing CDS Using the XDS Step-by-Step Procedure

Object-Handling Techniques

XDS/CDS Object Recipes

Attribute and Data Type Translation

Part 3 GDS Application Programming

Chapter 4. Overview - GDS API: Concepts and Overview

Directory Service Interfaces

The X.500 Directory Information Model

X.500 Naming Concepts

Schemas

Abstract Syntax Notation 1

GDS as a Distributed Service

Chapter 5. XOM Programming

OM Objects

Packages

Workspaces

Storage Management

OM Syntaxes for Attribute Values

Service Interface Data Types

OM Function Calls

XOM API Header Files

Chapter 6. XDS Programming

XDS Interface Management Functions

Directory Connection Management Functions

XDS Interface Class Definitions

Directory Class Definitions

The GDS Package

Directory Operation Functions

Directory Read Operations

Directory Search Operations

Directory Modify Operations

Return Codes

Chapter 7. Sample Application Programs

General Programming Guidelines

The example.c Program

The acl.c Program

The teldir.c Program

Chapter 8. Using Threads With The XDS/XOM API

Overview of Sample Threads Program

Description of Sample Program

Detailed Description of Thread Specifics

The thradd.c Code

The thradd.h Header File

Chapter 9. XDS/XOM Convenience Routines

String Handling

The acl2.c Program

Part 4 XDS/XOM Supplementary Information

Chapter 10. XDS Interface Description

XDS Conformance to Standards

The XDS Functions

The XDS Negotiation Sequence

The session Parameter

The context Parameter

The XDS Function Arguments

XDS Function Call Results

Synchronous Operations

Security and XDS

Other Features of the XDS Interface

Chapter 11. XDS Class Definitions

Introduction to OM Classes

XDS Errors

OM Class Hierarchy

DS_C_ABANDON_FAILED

DS_C_ACCESS_POINT

DS_C_ADDRESS

DS_C_ATTRIBUTE

DS_C_ATTRIBUTE_ERROR

DS_C_ATTRIBUTE_LIST

DS_C_ATTRIBUTE_PROBLEM

DS_C_AVA

DS_C_COMMON_RESULTS

DS_C_COMMUNICATIONS_ERROR

DS_C_COMPARE_RESULT

DS_C_CONTEXT

DS_C_CONTINUATION_REF

DS_C_DS_DN

DS_C_DS_RDN

DS_C_ENTRY_INFO

DS_C_ENTRY_INFO_SELECTION

DS_C_ENTRY_MOD

DS_C_ENTRY_MOD_LIST

DS_C_ERROR

DS_C_EXT

DS_C_FILTER

DS_C_FILTER_ITEM

DS_C_LIBRARY_ERROR

DS_C_LIST_INFO

DS_C_LIST_INFO_ITEM

DS_C_LIST_RESULT

DS_C_NAME

DS_C_NAME_ERROR

DS_C_OPERATION_PROGRESS

DS_C_PARTIAL_OUTCOME_QUAL

DS_C_PRESENTATION_ADDRESS

DS_C_READ_RESULT

DS_C_REFERRAL

DS_C_RELATIVE_NAME

DS_C_SEARCH_INFO

DS_C_SEARCH_RESULT

DS_C_SECURITY_ERROR

DS_C_SERVICE_ERROR

DS_C_SESSION

DS_C_SYSTEM_ERROR

DS_C_UPDATE_ERROR

Chapter 12. Basic Directory Contents Package

Selected Attribute Types

Selected Object Classes

OM Class Hierarchy

DS_C_FACSIMILE_PHONE_NBR

DS_C_POSTAL_ADDRESS

DS_C_SEARCH_CRITERION

DS_C_SEARCH_GUIDE

DS_C_TELETEX_TERM_IDENT

DS_C_TELEX_NBR

Chapter 13. Strong Authentication Package

SAP Attribute Types

SAP Object Classes

OM Class Hierarchy

DS_C_ALGORITHM_IDENT

DS_C_CERT

DS_C_CERT_LIST

DS_C_CERT_PAIR

DS_C_CERT_SUBLIST

DS_C_SIGNATURE

Chapter 14. MHS Directory User Package

MDUP Attribute Types

MDUP Object Classes

MDUP OM Class Hierarchy

MH_C_OR_ADDRESS

MH_C_OR_NAME

DS_C_DL_SUBMIT_PERMS

Chapter 15. GDS Package

GDSP Attribute Types

GDSP Object Classes

GDSP OM Class Hierarchy

DSX_C_GDS_ACL

DSX_C_GDS_ACL_ITEM

DSX_C_GDS_CONTEXT

DSX_C_GDS_SESSION

Chapter 16. Distributed Management Environment Support

DME Attribute Types

DME Object Classes

Chapter 17. Information Syntaxes

Syntax Templates

Syntaxes

Strings

Representation of String Values

Relationship to ASN.1 Simple Types

Relationship to ASN.1 Useful Types

Relationship to ASN.1 Character String Types

Relationship to ASN.1 Type Constructors

Chapter 18. XOM Service Interface

Standards Conformance

XOM Data Types

XOM Functions

XOM Return Codes

Chapter 19. Object Management Package

Class Hierarchy

Class Definitions