Net::LDAP::Control::EntryChange (3)
Leading comments
Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28) Standard preamble: ========================================================================
NAME
Net::LDAP::Control::EntryChange - LDAPv3 Entry Change Notification control objectSYNOPSIS
use Net::LDAP;
use Net::LDAP::Control::PersistentSearch;
use Net::LDAP::Constant qw(LDAP_CONTROL_ENTRYCHANGE);
$ldap = Net::LDAP->new( "ldap.mydomain.eg" );
$persist = Net::LDAP::Control::PersistentSearch->new( changeTypes => 15,
changesOnly => 1,
returnECs => 1 );
$srch = $ldap->search( base => "cn=People,dc=mydomain,dc=eg",
filter => "(objectClass=person)",
callback => \&process_entry, # call for each entry
control => [ $persist ] );
die "error: ",$srch->code(),": ",$srch->error() if ($srch->code());
sub process_entry {
my $message = shift;
my $entry = shift;
my ($control) = $message->control(LDAP_CONTROL_ENTRYCHANGE);
print $control->changeType()."\t".$entry->dn()."\n";
}
DESCRIPTION
"Net::LDAP::Control::EntryChange" provides an interface for the creation and manipulation of objects that represent the "EntryChangeNotification" control as described by draft-smith-psearch-ldap-03.txt.CONSTRUCTOR ARGUMENTS
In addition to the constructor arguments described in Net::LDAP::Control the following are provided.- changeType
-
An integer value telling the type of LDAPoperation that the entry has undergone. It is one of the following values (which represent theLDAPoperations indicated next to them):
-
- 1 = add
- 2 = delete
- 4 = modify
- 8 = modDN
-
- previousDN
-
When changeType is 8 (for modDN) this parameter tells the entry's DNbefore the modDN operation. In all other cases this value is not defined.
- changeNumber
-
This is the change number according to <draft-good-ldap-changelog-03.txt>
assigned by a server for the change. If a server supports an LDAPChange Log it should include this field.
Usually you do not need to create a "Net::LDAP::Control::EntryChange" control yourself because it is provided by the server in response to an option with the "Net::LDAP::Control::PersistentSearch" control.
METHODS
As with Net::LDAP::Control each constructor argument described above is also available as a method on the object which will return the current value for the attribute if called without an argument, and set a new value for the attribute if called with an argument.SEE ALSO
Net::LDAP, Net::LDAP::Control, Net::LDAP::Control::PersistentSearchAUTHOR
Peter Marschall <peter@adpm.de>, based on Net::LDAP::Control::Page from Graham Barr <gbarr@pobox.com> and the preparatory work of Don Miller <donm@uidaho.edu>.Please report any bugs, or post any suggestions, to the perl-ldap mailing list <perl-ldap@perl.org>