Technical Standard DCE 1.1: Directory Services NICAL H S C T A E N T D A R D [This page intentionally left blank] CAE Specification DCE 1.1: Directory Services The Open Group August 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. CAE Specification DCE 1.1: Directory Services Document Number: C705 Published by The Open Group 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: [email protected] ii CAE Specification (1997) Contents Part 1 Introduction....................................................................................................... 1 Chapter 1 Information Model .......................................................................................... 3 1.1 Names and Identifiers .......................................................................................... 4 1.2 Name Spaces .......................................................................................................... 6 1.2.1 Global Name Space............................................................................................ 7 1.2.2 Cell Name Space................................................................................................. 7 1.2.3 Other Composite Name Spaces ...................................................................... 10 1.3 Name Syntax .......................................................................................................... 11 1.3.1 DCE Name Syntax ............................................................................................. 11 1.3.2 DCE Composite Names .................................................................................... 13 1.3.3 Global Name Space Name Syntax.................................................................. 15 1.3.4 Cell Name Space Name Syntax....................................................................... 17 1.4 Conformance Requirements ............................................................................... 18 Chapter 2 Inter-cell Operation......................................................................................... 19 2.1 Global Directory System Organization ............................................................ 20 2.2 Global Directory Agent........................................................................................ 21 2.2.1 Hierarchical Cells ............................................................................................... 22 2.3 Cell Registration in Global Name Space .......................................................... 23 2.3.1 Cell Registration in X.500 ................................................................................. 23 2.3.2 Cell Registration in DNS................................................................................... 24 Part 2 Application Programming Interfaces............................................ 25 Chapter 3 X/Open Directory Service API (XDS)................................................... 27 3.1 XDS Conformance................................................................................................. 28 3.2 XDS Functions........................................................................................................ 29 3.2.1 ds_abandon() ...................................................................................................... 30 3.2.2 ds_add_entry() ................................................................................................... 30 3.2.3 ds_bind().............................................................................................................. 31 3.2.4 ds_compare( ) ...................................................................................................... 31 3.2.5 ds_initialize() ...................................................................................................... 31 3.2.6 ds_list( )................................................................................................................. 31 3.2.7 ds_modify_entry()............................................................................................. 31 3.2.8 ds_modify_rdn() ................................................................................................ 32 3.2.9 ds_read().............................................................................................................. 32 3.2.10 ds_receive_result( ) ............................................................................................ 32 3.2.11 ds_remove_entry() ............................................................................................ 32 3.2.12 ds_search() .......................................................................................................... 32 3.2.13 ds_shutdown() ................................................................................................... 32 DCE 1.1: Directory Services iii Contents 3.2.14 ds_unbind()......................................................................................................... 32 3.2.15 ds_version() ........................................................................................................ 32 3.3 XDS Function Call Results................................................................................... 33 3.3.1 invoke_id_return Parameter ............................................................................ 33 3.4 Synchronous Operations ..................................................................................... 34 3.5 Security and XDS................................................................................................... 34 3.6 Automatic Connection Management................................................................ 34 3.7 Global Directory Service Package...................................................................... 35 3.7.1 GDSP Attribute Types ....................................................................................... 35 3.7.2 GDSP Object Classes ......................................................................................... 38 3.7.3 GDS OM Class Hierarchy................................................................................. 38 Chapter 4 X/Open OSI Abstract Data Manipulation (XOM)........................ 45 4.1 XOM Conformance............................................................................................... 45 4.2 XOM Functions...................................................................................................... 46 4.2.1 om_copy( ) ........................................................................................................... 46 4.2.2 om_copy_value( ) ............................................................................................... 46 4.2.3 om_create( ) ......................................................................................................... 46 4.2.4 om_delete( ) ......................................................................................................... 46 4.2.5 om_get( )............................................................................................................... 47 4.2.6 om_instance( ) ..................................................................................................... 47 4.2.7 om_put( ) .............................................................................................................. 47 4.2.8 om_read() ............................................................................................................ 47 4.2.9 om_remove( ) ...................................................................................................... 48 4.2.10 om_write( )........................................................................................................... 48 Chapter 5 XDS/XOM Convenience Functions....................................................... 49 5.1 String Handling ..................................................................................................... 49 5.2 Convenience Functions........................................................................................ 49 5.2.1 dsX_extract_attr_values( ) ................................................................................ 50 5.2.2 omX_extract( ) ..................................................................................................... 50 5.2.3 omX_fill( )............................................................................................................. 50 5.2.4 omX_fill_oid( )..................................................................................................... 50 5.2.5 omX_object_to_string( ) .................................................................................... 50 5.2.6 omX_string_to_object( ) .................................................................................... 50 Chapter 6 Name Service Independent Interface (NSI) ..................................... 51 6.1 Interface Functions...............................................................................................