NAME

AddressBook::DB::LDIF - Backend for AddressBook to use LDIF files.

SYNOPSIS

  use AddressBook;
  $a = AddressBook->new(source => "LDIF",
                        filename => "/tmp/ldif")

AddressBook::DB::LDIF supports sequential backend database methods.

AddressBook::DB::LDIF behavior can be modified using the following options:

A list of LDIF attribute names (not cannonical names) which can be used to uniquely identify an entry.

The LDAP base for all entries

The LDAP objectclass for entries

A perl expression which, when eval'd returns a valid LDAP "dn" (omitting the "base" part of the dn). Other attributes may be referenced as "$<attr>".

For example, if LDIF entries have a dn like: "cn=John Doe,mail=jdoe@mail.com", then use the following:

  dn_calculate="'cn=' . $cn . ',mail=' . $mail"

Any of these options can be specified in the constructor, or in the configuration file.

The LDIF file is specified using the "filename" parameter:

  $a = AddressBook->new(source => "LDIF",
                        filename => "/tmp/ldif")

The filename may also be specified in the configuration file.

For syncronization purposes, all records are timestamped with the modification date of the LDIF file.

David L. Leigh, <dleigh@sameasiteverwas.net>