Sun ONE logo     Previous      Contents      Index      Next     
Sun ONE Directory Server 5.2 Plug-In API Reference

About This Guide

Sun ONE Directory Server 5.2 is a powerful and scalable distributed directory server based on the industry-standard Lightweight Directory Access Protocol (LDAP). Sun ONE Directory Server software is part of the Sun Open Net Environment (Sun ONE), Sun's standards-based software vision, architecture, platform, and expertise for building and deploying Services On Demand.

Sun ONE Directory Server is the cornerstone for building a centralized and distributed data repository that can be used in your intranet, over your extranet with your trading partners, or over the public Internet to reach your customers.

Purpose of This Guide

This reference covers the data types and structures, functions and parameter block data that make up the public Sun ONE Directory Server plug-in API. Refer to it as you develop server plug-ins to extend Sun ONE Directory Server functionality.


To make the most of this document, you must already be familiar with LDAP and with programming in the C language.

You should also have a clear understanding of the server extensions to develop, preferably including appropriate specifications.

For directory client programming, download the Sun ONE Directory Server Resource Kit. Refer to "Downloading Directory Server Tools" for instructions.

Typographical Conventions

This section explains the typographical conventions used in this book.

Monospaced font - This typeface is used for literal text, such as the names of attributes and object classes when they appear in text. It is also used for URLs, filenames, and examples.

Italic font - This typeface is used for emphasis, for new terms, and for text that you must substitute for actual values, such as placeholders in path names.

The greater-than symbol (>) is used as a separator when naming an item in a menu or sub-menu. For example, Object > New > User means that you should select the User item in the New sub-menu of the Object menu.


Notes, Cautions, and Tips highlight important conditions or limitations. Be sure to read this information before continuing.

Default Paths and Filenames

All path and filename examples in the Sun ONE Directory Server product documentation are one of the following two forms:

  • ServerRoot/... - The ServerRoot is the location of the Sun ONE Directory Server product. This path contains the shared binary files of Directory Server, Sun ONE Administration Server, and command line tools.
  • The actual ServerRoot path depends on your platform, your installation, and your configuration. The default path depends on the product platform and packaging as shown in Table 1.

  • ServerRoot/slapd-serverID/... - The serverID is the name of the Directory Server instance that you defined during installation or configuration. This path contains database and configuration files that are specific to the given instance.

  • Note

    Paths specified in this manual use the forward slash format of UNIX and commands are specified without file extensions. If you are using a Windows version of Sun ONE Directory Server, use the equivalent backslash format. Executable files on Windows systems generally have the same names with the .exe or .bat extension.

    Table 1    Default ServerRoot Paths 

    Product Version

    ServerRoot Path

    Solaris Packages1

    /var/mps/serverroot - After configuration, this directory contains links to the following locations:

    • /etc/ds/v5.2 (static configuration files)
    • /usr/admserv/mps/admin (Sun ONE Administration Server binaries)
    • /usr/admserv/mps/console (Server Console binaries)
    • /usr/ds/v5.2 (Directory Server binaries)

    Compressed Archive Installation on Solaris and Other UNIX Systems


    Zip Installation on Windows Systems

    C:\Program Files\Sun\MPS


    If you are working on the Solaris Operating Environment and are unsure which version of the Sun ONE Directory Server software is installed, check for the existence a key package such as SUNWdsvu using the pkginfo command. For example: pkginfo | grep SUNWdsvu.

Directory Server instances are located under ServerRoot/slapd-serverID/, where serverID represents the server identifier given to the instance on creation. For example, if you gave the name dirserv to your Directory Server, then the actual path would appear as shown in Table 2. If you have created a Directory Server instance in a different location, adapt the path accordingly.

Table 2    Default Example dirserv Instance Locations 

Product Version

Instance Location

Solaris Packages


Compressed Archive Installation on Solaris and Other UNIX Systems


Zip Installation on Windows Systems

C:\Program Files\Sun\MPS\slapd-dirserv

Downloading Directory Server Tools

Some supported platforms provide native tools for accessing Directory Server. More tools for testing and maintaining LDAP directory servers, download the Sun ONE Directory Server Resource Kit (DSRK). This software is available at the following location:

Installation instructions and reference documentation for the DSRK tools is available in the Sun ONE Directory Server Resource Kit Tools Reference.

For developing directory client applications, you may also download the iPlanet Directory SDK for C and the iPlanet Directory SDK for Java from the same location.

Additionally, Java Naming and Directory Interface (JNDI) technology supports accessing the Directory Server using LDAP and DSML v2 from Java applications. Information about JNDI is available from:

The JNDI Tutorial contains detailed descriptions and examples of how to use JNDI. It is available at:

Suggested Reading

Sun ONE Directory Server product documentation includes the following documents delivered in both HTML and PDF:

Other useful information can be found on the following Web sites:

Previous      Contents      Index      Next     
Copyright 2003 Sun Microsystems, Inc. All rights reserved.