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:

key_fields

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

base

The LDAP base for all entries

objectclass

The LDAP objectclass for entries

dn_calculate

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>