DCE 1.1: Directory Services
Copyright © 1997 The Open Group

Frontmatter


CAE Specification
DCE 1.1: Directory Services
Document Number: C705


©October 1997, The Open Group All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording or otherwise, without the prior permission of the copyright owners.


This document and the software to which it relates are derived in part from materials which are copyright © 1990, 1991 Digital Equipment Corporation and copyright © 1990, 1991 Hewlett-Packard Company.


Any comments relating to the material contained in this document may be submitted to The Open Group at:

The Open Group
Apex Plaza
Forbury Road
Reading
Berkshire, RG1 1AX
United Kingdom
or by electronic mail to:
OGSpecs@opengroup.org

Preface

The Open Group

The Open Group is the leading vendor-neutral, international consortium for buyers and suppliers of technology. Its mission is to cause the development of a viable global information infrastructure that is ubiquitous, trusted, reliable, and as easy-to-use as the telephone. The essential functionality embedded in this infrastructure is what we term the IT DialTone. The Open Group creates an environment where all elements involved in technology development can cooperate to deliver less costly and more flexible IT solutions.

Formed in 1996 by the merger of the X/Open Company Ltd. (founded in 1984) and the Open Software Foundation (founded in 1988), The Open Group is supported by most of the world's largest user organizations, information systems vendors, and software suppliers. By combining the strengths of open systems specifications and a proven branding scheme with collaborative technology development and advanced research, The Open Group is well positioned to meet its new mission, as well as to assist user organizations, vendors, and suppliers in the development and implementation of products supporting the adoption and proliferation of systems which conform to standard specifications.

With more than 200 member companies, The Open Group helps the IT industry to advance technologically while managing the change caused by innovation. It does this by:

The Open Group operates in all phases of the open systems technology lifecycle including innovation, market adoption, product development, and proliferation. Presently, it focuses on seven strategic areas: open systems application platform development, architecture, distributed systems management, interoperability, distributed computing environment, security, and the information superhighway. The Open Group is also responsible for the management of the UNIX trademark on behalf of the industry.

The Development of Product Standards

This process includes the identification of requirements for open systems and, now, the IT DialTone, development of CAE and Preliminary Specifications through an industry consensus review and adoption procedure (in parallel with formal standards work), and the development of tests and conformance criteria.

This leads to the preparation of a Product Standard which is the name used for the documentation that records the conformance requirements (and other information) to which a vendor may register a product. There are currently two forms of Product Standard, namely the Profile Definition and the Component Definition, although these will eventually be merged into one.

The "X" mark is used by vendors to demonstrate that their products conform to the relevant Product Standard. By use of the Open Brand they guarantee, through the X/Open Trade Mark Licence Agreement (TMLA), to maintain their products in conformance with the Product Standard so that the product works, will continue to work, and that any problems will be fixed by the vendor.

Open Group Publications

The Open Group publishes a wide range of technical documentation, the main part of which is focused on specification development and product documentation, but which also includes Guides, Snapshots, Technical Studies, Branding and Testing documentation, industry surveys, and business titles.

There are several types of specification:


In addition, The Open Group publishes:

Versions and Issues of Specifications

As with all live documents, CAE Specifications require revision to align with new developments and associated international standards. To distinguish between revised specifications which are fully backwards compatible and those which are not:

Corrigenda

Readers should note that Corrigenda may apply to any publication. Corrigenda information is published on the World-Wide Web at http://www.opengroup.org/public/pubs.

Ordering Information

Full catalogue and ordering information on all Open Group publications is available on the World-Wide Web at http://www.opengroup.org/public/pubs.

About This Document

This document is a CAE Specification (see above). It specifies the Directory Services in The Open Group DCE. It is a portability guide for application programs using Directory Services, and a conformance specification for implementations.

Structure
This document is organised into five parts:

Part 1 is an introduction:

Part 2 defines the application programming interfaces:

Part 3 defines the Global Directory Service (GDS):

Part 4 defines the Cell Directory Service (CDS):

Part 5 contains the appendices:

An index is provided.

Intended Audience

This document is written for application programmers who need to make use of directory services, and implementation developers.

Typographical Conventions
The following typographical conventions are used throughout this document:

Trademarks

Motif®, OSF/1®, and UNIX® are registered trademarks and the IT DialToneTM;, The Open GroupTM;, and the "X Device"TM; are trademarks of The Open Group.

Referenced Documents

The following standards and external related documents are referenced in this specification:

ASN.1

ISO 8824:1990, Information Technology - Open Systems Interconnection - Specification of Abstract Syntax Notation One (ASN.1).

BER

ISO/IEC 8825:1990 (ITU-T Recommendation X.209 (1988)), Information Technology - Open Systems Interconnection - Specification of Basic Encoding Rules for Abstract Syntax Notation One (ASN.1).

CCITT T.61

CCITT Recommendation T.61: 1984, Character Repertoire and Coded Character Sets for the International Teletex Service, Geneva, 1980, amended at Malaga-Torremolinos, 1984.

ISO 3166

ISO 3166:1988, Codes for the Representation of Names of Countries, Bilingual edition.

ISO 8326

ISO 8326:1987, Information Processing Systems - Open Systems Interconnection - Basic Connection-oriented Session Service Definition.

ISO 8327

ISO 8327:1987, Information Processing Systems - Open Systems Interconnection - Basic Connection-oriented Session Protocol Specification.

ISO 8327-2 CD

ISO CD 8327-2:1990, Information Processing Systems - Open Systems Interconnection - Basic Connection-oriented Session Protocol Specification - Part 2: Implementation Conformance Statement (PICS) Proforma.

ISO 8649

ISO 8649:1988, Information Processing Systems - Open Systems Interconnection - Service Definition for the Association Control Service Element.

ISO 8650

ISO 8650:1992, Information Processing Systems - Open Systems Interconnection - Protocol Specification for the Association Control Service Element.

ISO/IEC 8650-2 DIS

ISO/IEC DIS 8650-2:1990 Information Processing Systems - Open Systems Interconnection - ACSE Protocol Implementation Conformance Statement (PICS) Proforma.

ISO 8822

ISO 8822:1988, Information Processing Systems - Open Systems Interconnection - Connection-oriented Presentation Service Definition.

ISO 8823

ISO 8823:1988, Information Processing Systems - Open Systems Interconnection - Connection-oriented Presentation Protocol Specification.

ISO/IEC 8823-2 DIS

ISO/IEC DIS 8823-2:1990 Information Processing Systems - Open Systems Interconnection - Basic Connection-oriented Presentation Protocol Implementation Conformance Statement (PICS) Proforma.

ISO/IEC 9072

ISO/IEC 9072:1989, Information Processing Systems - Text Communication - Remote Operations - Parts 1 and 2
Part 1: Model, Notation and Service Definition Part 2: Protocol Specification.

ISO/IEC 9594

ISO/IEC 9594:1990, Information Technology - Open Systems Interconnection - The Directory, Parts 1 to 8:
Part 1: Overview of Concepts, Models and Services (CCITT X.500) Part 2: Models (CCITT X.501) Part 3: Abstract Service Definition (CCITT X.511) Part 4: Procedures for Distributed Operation (CCITT X.518) Part 5: Protocol Specifications (CCITT X.519) Part 6: Selected Attribute Types (CCITT X.520) Part 7: Selected Object Classes (CCITT X.521) Part 8: Authentication Framework (CCITT X.509)

ISO/IEC 10021-2

ISO/IEC 10021:1990, Information Technology - Text Communications - Message-oriented Text Interchange System - Part 2: Overall Architecture (CCITT X.402).

PUB 217

Directory Services PICS Proforma for DAP/DUA (OSTC/DS/DUA/PICS/V1.0) Open Systems Testing Consortium, PUB 217.

PUB 218

Directory Services PICS Proforma for DAP/DSA (OSTC/DS/DSA/PICS/V1.0) Open Systems Testing Consortium, PUB 218.

RFC 1033

M.Lottor, Domain administrators operations guide, 11/01/1987.

RFC 1034

P. Mockapetris, Domain names - concepts and facilities, 11/01/1987. (Obsoletes RFC 0973; updated by RFC 1101.)

RFC 1035

P. Mockapetris, Domain names - implementation and specification, 11/01/1987. (Obsoletes RFC 0973; updated by RFC 1348.)

RFC 1101

P. Mockapetris, DNS encoding of network names and other types, 04/01/1989. (UpdatesRFC 1034.)

RFC 1348

B. Manning, DNS NSAP RRs, 07/01/1992. (Updates RFC 1035).

CCITT X.249

CCITT, 1992, Data Communication Networks: Open Systems Interconnection (OSI), Series X Recommendations (X.220 to X.290), Draft Recommendation X.249 - Remote Operations Service Element: Protocol Implementation Conformance Statement (PICS) Proforma.

The following X/Open documents are referenced in this specification:

DCE DFS

Preliminary Specification, September 1996, DCE 1.1: Distributed File Service Specification, (P409).

DCE RPC

The Open Group CAE Specification, October 1997, The Open Group DCE 1.1: Remote Procedure Call (Publication number: C706).

DCE Security

The Open Group CAE Specification, October 1997, The Open Group DCE 1.1: Authentication and Security Services (Publication number: C311).

DCE Time

The Open Group CAE Specification, November 1994, The Open Group DCE 1.1: Time Services (ISBN: 1-85912-067-9, C310).

X.400, Issue 3

Also known as XMHS Issue 3: CAE Specification, May 1996, API to Electronic Mail (X.400), Issue 3 (ISBN: 1-85912-185-3, C609).

XDS, Issue 3

CAE Specification, May 1996, API to Directory Services (XDS), Issue 3 (ISBN: 1-85912-180-2, C608).

XOM, Issue 3

CAE Specification, May 1996, OSI-Abstract-Data Manipulation API (XOM), Issue 3 (ISBN: 1-85912-175-6, C607).


Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.

Contents Next section Index