Asterisk LDAP Perl Module
by Ben Klang <ben@alkaloid.net>
http://projects.alkaloid.net
Copyright 2005-2006
Released under the terms of the GPL.  See LICENSE for more information.


This is a module for generating Asterisk compatible configuration files from
data stored in an LDAP directory tree.


The main site for these files is http://projects.alkaloid.net, or hopefully
soon to be found at a CPAN mirror near you.

Some documentation is in the the perl modules, use perldoc to read it
(example: perldoc Asterisk::LDAP)

To install these modules just do:
        perl Makefile.PL
        make all
        make install

Example scripts and LDAP ldifs that illustrate the use of this module can be
found in the examples/ directory

Asterisk::LDAP is dependant on the following Perl modules:
* File::Temp
* Getopt::Long
* Net::LDAP


To use Asterisk::LDAP you'll need to add the asterisk.schema file to your
LDAP server.  Documentation on the useage of the objectclasses and attributes
is not quite complete.  In fact, the schema file itself should be considered a
work in progress.  Check this and any other README* files in this or the docs/
directory with each release to see what may have changed.  Look in 
examples/asterisk*.ldiff for sample LDAP entries which are compatible with this
package.

      NOTE NOTE NOTE
      If you get a message similar to
      'Can't call method "code" without a package or object reference'
      check your TLS settings.  There doesn't appear to be a clean way to catch
      whether start_tls failed, so this program will simply crash rather than
      send unsecured information.

The latest release of Asterisk::LDAP will be available at
http://projects.alkaloid.net

$Id$