Kolab::DirServ

Langue: en

Version: 2008-03-06 (mandriva - 01/05/08)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NAME

Kolab::DirServ - A Perl Module that handles Address book synchronisation between Kolab servers.

SYNOPSIS

   use Kolab::DirServ;
   use Net::LDAP::Entry;
  
   #send notification of a new mailbox
   $entry = Net::LDAP::Entry->new(...);
   &notify_new_alias( $entry );
   
   #handle updates recieved
   &handle_notifications( "address", "IMAP User", "User Password" );

ABSTRACT

   The Kolab::DirServ module provides a mechanism for Kolab servers to
   publish address book data to a list of peers. These peers recieve
   notification of new, updated and removed mailboxes and update their
   address books accordingly.

DESCRIPTION

The Kolab::DirServ module recieves Net::LDAP::Entry entries, converts them to LDIF format and sends them to a list of mailboxes in LDIF format. The list of peers and other configuration parameters is provided through the Kolab::DirServ::Config module.

EXPORT

   &notify_new_alias( $entry )
 
     Recieves a Net::LDAP::Entry object.
     Send a new alias notification to each of the address book peers in
     a LDIF MIME attachment.
   
   &notify_remove_alias( $entry )
  
     Recieves a Net::LDAP::Entry object.
     Send a notification to each of the address book peers to remove an
     entry from their address books.
   
   &notify_modify_alias( $entry )
 
     Recieves a Net::LDAP::Entry object.
     Send updated information to each of the address book peers. Each
     peer then updates the corresponding address book entry with the 
     updated information.
 
   &handle_notifications( $server, $user, $password )
 
     Connects to specified IMAP server and retrieves all messages from
     the specified mailbox. The messages are cleared from the mailbox 
     after they are handled. This process runs periodically on a peer.

SEE ALSO

kolab-devel mailing list: <kolab-devel@kolab.org>

Kolab website: http://www.kolab.org

AUTHOR

Stephan Buys, s.buys@codefusion.co.za

Please report any bugs, or post any suggestions, to the kolab-devel mailing list <kolab-devel@kolab.org>.

Copyright 2003 by Stephan Buys

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.