Sun Java System LDAP SDK for C Programming Guide |
Preface
The Sun Java System Directory Server Resource Kit LDAP SDK for C Programming Guide documents the Sun Java System LDAP SDK for C, a software development kit (SDK) for writing Lightweight Directory Access Protocol (LDAP) client applications. This preface contains the following sections:
Audience for This GuideThis LDAP SDK for C Programming Guide is intended for use by C and C++ programmers who want to enable new or existing client applications to connect to, search or update databases that are managed by LDAP servers located on a network or the Internet. This book assumes that you are a programmer familiar with writing and compiling C applications on the platform(s) for which you want to implement this functionality. It is also recommended that programmers attempting this implementation understand the LDAP Data Interchange Format (LDIF).
In addition, programmers should be familiar with Sun Java System Directory Server, Sun Microsystems’ LDAP data repository, and the command-line syntax for the particular shell and platform on which the server is installed. The books and guides described in "Related Sources of Information" provide a good introduction to this information.
Directory Server Resource Kit Documentation SetThe Sun Java System DSRK documentation set contains three manuals:
Tools Reference
The Tools Reference explains how to use each of the tools shipped with the DSRK. The book details their command-line syntax, listing all options, functionality, and return values (where applicable), as well as providing examples of usage.
LDAP SDK for C Programming Guide
The LDAP SDK for C Programming Guide (this guide) documents the LDAP SDK for C by explaining how to use it to enable applications to interact with LDAP servers. It offers a references to the LDAP API, which consists of data structures and functions. This manual is divided into four parts:
- Part 1, "Getting Started" explains how you can use the LDAP SDK for C to enable your applications for LDAP.
- Part 2, "Working with the LDAP SDK for C" explains how you can use the LDAP SDK for C to enable your applications for LDAP communications.
- Part 3, "Advanced Topics" contains additional material including descriptions of entries and attributes.
- Part 4, "Reference Guide" describes each data structure, function, and status code in the LDAP API.
LDAP SDK for Java Programming Guide
The LDAP SDK for Java Programming Guide documents the LDAP SDK for Java. It includes descriptions of, and reference material for, the interfaces, classes, and methods used to enable Java applications with the functionality to interact and communicate with LDAP servers. Also available are the Java API specifications or Javadocs.
Documentation Conventions Used in This GuideIn the DSRK documentation, certain typographical conventions and terminology are used. These are described in the following sections.
Typographical Conventions
This book uses the following typographical conventions:
- Italic type is used within text for book titles, new terminology, emphasis, and words used in the literal sense.
- Monospace font is used for sample code and code listings, API and language elements (such as function names and class names), filenames, pathnames, directory names, HTML tags, and any text that must be typed on the screen.
- Italic serif font is used within code and code fragments to indicate variable placeholders. For example, the following command uses filename as a variable placeholder for an argument to the gunzip command:
gunzip -d filename.tar.gz
Terminology
Below is a list of general terms used in the Directory Server Resource Kit documentation set:
- DSRK refers to the installed Directory Server Resource Kit software.
- Directory Server refers to an installed instance of Sun Java System Directory Server.
- DSRK_base is a variable place holder for the home directory where the Directory Server Resource Kit is installed.
- DirectoryServer_base is a variable place holder for the home directory where Sun Java System Directory Server is installed.
Related Sources of InformationIn addition to the documentation provided with Directory Server Resource Kit, there are several other sources of information that might be helpful.
Directory Server Documentation
The tools in the DSRK interact with Sun Java System Directory Server. The following documentation is referenced throughout this guide:
A listing of the full set of documentation can be found at:
http://docs.sun.com/coll/S1_DirectoryServer_52
Sources of Information
Sun Microsystems has other helpful sources of information. Table 0-1 lists these sources.
Third-Party Sources of Information
The following sections list sources of information found on sites that are not under the auspices of Sun Microsystems.
The Mozilla Project
SDKs for accessing LDAP in C and Java are also released through the Mozilla open source project. Instructions on obtaining the source code and contributing to the development of these API is available at:
http://www.mozilla.org/directory
LDAP and Associated Information
There are many sources of information detailing LDAP and its associated technologies.
- The Internet Engineering Task Force
- The C LDAP Application Program Interface Internet-Draft
http://www.mozilla.org/directory/ietf-docs/draft-ietf-ldapext-ldap-c-api-05.t xt
- LDAP Control Extension for Server Side Sorting of Search Results, RFC 2891
http://www.faqs.org/rfcs/rfc2891.html
- Simple Authentication and Security Layer (SASL)
http://www.faqs.org/rfcs/rfc2222.html
- Secure Sockets Layer (SSL) Protocol (v3), Internet-Draft Revision 3
http://wp.netscape.com/eng/ssl3/
- Netscape Portable Runtime Library
AcknowledgementsThis product includes software developed by the Apache Software Foundation:
This product also includes software developed through Mozilla
Documentation FeedbackSun is interested in improving its documentation and welcomes your comments and suggestions. Use this web-based form to provide feedback to Sun:
http://www.sun.com/hwdocs/feedback/
Please provide the full document title and part number in the appropriate fields. The part number can be found on the title page of the book or at the top of the document, and is usually a seven or nine digit number. For example, the part number of this Directory Server Resource Kit 5.2.1 LDAP SDK for C Programming Guide is 817-6707-05.