mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-10-31 22:25:30 +00:00
132 lines
4.9 KiB
Plaintext
132 lines
4.9 KiB
Plaintext
#############################################################################
|
|
# #
|
|
# PerLDAP v1.4 - A Perl Developers' Kit for LDAP #
|
|
# #
|
|
#############################################################################
|
|
|
|
|
|
What is PerLDAP?
|
|
================
|
|
|
|
PerLDAP is a set of modules written in Perl and C that allow developers to
|
|
leverage their existing Perl knowledge to easily access and manage LDAP-
|
|
enabled directories. PerLDAP makes it very easy to search, add, delete,
|
|
and modify directory entries. For example, Perl developers can easily
|
|
build web applications to access information stored in a directory or
|
|
create directory sync tools between directories and other services.
|
|
|
|
PerLDAP is an open source development project, the result of a joint effort
|
|
between Netscape and Clayton Donley, an open source developer. PerLDAP
|
|
currently provides the basic functions to allow Perl users to access and
|
|
manipulate directories easily. Based on developer feedback and
|
|
involvement, PerLDAP will continue to evolve to include additional
|
|
functionality in future releases.
|
|
|
|
|
|
Compiling the PerLDAP Sources
|
|
=============================
|
|
|
|
The source to PerLDAP is available on the Mozilla site at:
|
|
|
|
http://www.mozilla.org/directory/
|
|
|
|
You can either retrieve the .tar/zip file with the source distribution, or
|
|
use CVS to checkout the module directly. The name of the CVS module is
|
|
PerLDAP, and it checks out the directory
|
|
|
|
mozilla/directory/perldap
|
|
|
|
Further instructions for using CVS and Mozilla is available at
|
|
|
|
http://www.mozilla.org/cvs.html
|
|
|
|
and an FAQ for PerLDAP is at
|
|
|
|
http://www.mozilla.org/directory/faq/perldap-faq.html
|
|
|
|
|
|
Instructions for building the source can be found in the INSTALL file
|
|
in the source distribution. The latest stable release of PerLDAP is
|
|
v1.4, the next version is planned to be v2.0 (development continues on the
|
|
v1.9 development branch).
|
|
|
|
|
|
Getting Started
|
|
===============
|
|
|
|
Documentation for this module is in standard Perl 'pod' format. HTML
|
|
versions of this documentation can also be found on the Netscape DevEdge
|
|
site at: http://developer.netscape.com/tech/directory/.
|
|
|
|
Additionally, many good examples can be found in the 'examples' directory.
|
|
|
|
|
|
Modules and Examples Included
|
|
=============================
|
|
|
|
Mozilla::LDAP::API - Low level interface between Perl and the LDAP C API
|
|
Mozilla::LDAP::Entry - Perl methods for manipulating entry objects
|
|
Mozilla::LDAP::Conn - Perl methods for performing LDAP operations
|
|
Mozilla::LDAP::LDIF - Perl methods for utilizing LDIF
|
|
Mozilla::LDAP::Utils - Some convenient LDAP related utilities
|
|
test_api/search.pl - Tests low level API search calls
|
|
test_api/write.pl - Tests low level API write calls
|
|
test_api/api.pl - Tests ALL low level LDAPv2 calls
|
|
examples/lfinger.pl - LDAP version of the regular Unix finger command.
|
|
examples/qsearch.pl - Simple ldapsearch replacement.
|
|
examples/monitor.pl - Retrieve status information from an LDAP server.
|
|
examples/ldappasswd.pl - Change the LDAP password for a user.
|
|
examples/rmentry.pl - Remove an entire entry from the database.
|
|
examples/rename.pl - Rename (modRDN) an entry.
|
|
examples/tabdump.pl - Dump LDAP information into a tab separated file.
|
|
examples/psoftsync.pl - Synchronize LDAP with a PeopleSoft "dump" file.
|
|
|
|
|
|
All examples support the "standard" LDAP command line options, which are
|
|
|
|
-h hostname LDAP server name
|
|
-p port # LDAP port, default is 389 (or 636 for SSL)
|
|
-b base DN LDAP Base-DN
|
|
-D bind DN LDAP bind DN (connect to server as this "user")
|
|
-w bind pswd Password to bind to the server
|
|
-P certfile Use SSL, with the publick keys from this file
|
|
|
|
|
|
Note that the examples currently only support Simple Authentication
|
|
(passwords), the Client Authentication features (using certificates) will
|
|
be used in the next release. All examples also honors the environment
|
|
variable LDAP_BASEDN, set it to your systems base DN, e.g.
|
|
|
|
% setenv LDAP_BASEDN 'dc=netscape,dc=com'
|
|
|
|
or for Bourne shell
|
|
|
|
# LDAP_BASEDN='dc=netscape,dc=com'; export LDAP_BASEDN
|
|
|
|
|
|
Reporting problems and bugs
|
|
===========================
|
|
|
|
Address all bug reports and comments to the Mozilla newsgroups at:
|
|
|
|
news://news.mozilla.org/netscape.public.mozilla.directory
|
|
|
|
|
|
License/Copyright
|
|
=================
|
|
|
|
Portions by Netscape (c) Copyright 1998 Netscape Communications Corp, Inc.
|
|
Portions by Clayton Donley (c) Copyright 1998 Clayton Donley
|
|
|
|
Please read the MPL-1.0.txt file included for information on the Mozilla
|
|
Public License, which covers all files in this distribution.
|
|
|
|
Known Bugs
|
|
==========
|
|
|
|
There are a number of issues still outstanding at the time of release. Most
|
|
of these are already in the process of being resolved.
|
|
|
|
- The Rebind operation on NT does NOT work properly when set to a Perl
|
|
function. This is being investigated.
|