CONTENTS

  Title Page

  Copyright Page

  Preface

  1      The XDS Programming Interface

  1.1     C Language Binding

  1.2     C Naming Conventions

  1.3     Function Return Values

  1.4     Compiling and Linking

  2      Interface Description

  2.1     Abstract Services and Interface Functions

  2.2     Negotiation Sequence

  2.3     Session

  2.4     Context

  2.5     Function Arguments
    2.5.1      Attribute and AVA
    2.5.2      Entry Info Selection
    2.5.3      Name

  2.6     Function Results
    2.6.1      Status
    2.6.2      Result
    2.6.3      Invoke-ID

  2.7     Synchronous and Asynchronous Operation
    2.7.1      Synchronous
    2.7.2      Asynchronous

  3      Interface Class Definitions

  3.1     Access Point

  3.2     Address

  3.3     Attribute

  3.4     Attribute List

  3.5     AVA

  3.6     Common Results

  3.7     Compare Result

  3.8     Context

  3.9     Continuation Reference

  3.10    Distinguished Name

  3.11    Entry Information

  3.12    Entry Information Selection

  3.13    Entry Modification

  3.14    Entry Modification List

  3.15    Extension

  3.16    Filter

  3.17    Filter Item

  3.18    List Information

  3.19    List Information Item

  3.20    List Result

  3.21    Name

  3.22    Operation Progress

  3.23    Partial Outcome Qualifier

  3.24    Presentation Address

  3.25    Read Result

  3.26    Relative Distinguished Name

  3.27    Relative Name

  3.28    Search Information

  3.29    Search Result

  3.30    Session

  4      Interface Functions

  ds_intro

  ds_abandon

  ds_add_entry

  ds_bind

  ds_compare

  ds_initialize

  ds_list

  ds_modify_entry

  ds_modify_rdn

  ds_read

  ds_receive_result

  ds_remove_entry

  ds_search

  ds_shutdown

  ds_unbind

  ds_version

  dsX_trace_object

  5      Errors

  5.1     Error

  5.2     Abandon Failed

  5.3     Attribute Error

  5.4     Attribute Problem

  5.5     Communications Error

  5.6     Library Error

  5.7     Name Error

  5.8     Referral

  5.9     Security Error

  5.10    Service Error

  5.11    System Error

  5.12    Update Error

  6      Directory Class Definitions

  6.1     Selected Attribute Types

  6.2     Selected Object Classes

  6.3     OM Class Hierarchy
    6.3.1      Algorithm Identifier
    6.3.2      Certificate
    6.3.3      Certificate List
    6.3.4      Certificate Pair
    6.3.5      Certificate Sublist
    6.3.6      Facsimile Phone Number
    6.3.7      DL Submit Permission
    6.3.8      Postal Address
    6.3.9      Search Criterion
    6.3.10     Search Guide
    6.3.11     Signature
    6.3.12     Teletex Terminal Identifier
    6.3.13     Telex Number

  FIGURES

  3-1        Hierarchy of Directory Object Classes

  5-1        Hierarchy of Error Object Classes

  6-1        Hierarchy of Selected Object Classes

  TABLES

  1-1        Naming Conventions for C Identifiers

  2-1        Interface Functions

  5-1        Communications Error

  6-1        Representation of Values for Selected Attribute Types

  6-2        Selected Object Classes