1Net::LDAP::Control::AssUesretrioCno(n3t)ributed Perl DocNuemte:n:tLaDtAiPo:n:Control::Assertion(3)
2
3
4

NAME

6       Net::LDAP::Control::Assertion - LDAPv3 Assertion Control
7

SYNOPSIS

9        use Net::LDAP;
10        use Net::LDAP::Control::Assertion;
11
12        $ldap = Net::LDAP->new( "ldap.mydomain.eg" );
13
14        $assert = Net::LDAP::Control::Assertion->new( assertion => '(sn=Jensen)' );
15
16        my $mesg = $ldap->modify( "cn=Barbara Jensen, o=University of Michigan, c=US",
17                                  replace => { givenName => "Babs" },
18                                  control => $assert );
19

DESCRIPTION

21       "Net::LDAP::Control::Assertion" provides an interface for the creation
22       and manipulation of objects that represent the "Assertion Control" as
23       described by RFC 4528.
24
25       The "Assertion Control" allows the client to specify a condition, an
26       assertion, that must be TRUE for the operation to be processed
27       normally.  Otherwise, the operation is not performed.  For instance,
28       the control can be used with the Modify operation to perform atomic
29       "test and set" and "test and clear" operations.
30
31       The control is appropriate for both LDAP interrogation and update
32       operations, including Add, Compare, Delete, Modify, ModifyDN (rename),
33       and Search.
34

CONSTRUCTOR ARGUMENTS

36       In addition to the constructor arguments described in
37       Net::LDAP::Control the following are provided.
38
39       assertion => FILTER
40           A filter specifying the assertion that must evaluate to TRUE in
41           order to make the operation process normally.
42

METHODS

44       As with Net::LDAP::Control each constructor argument described above is
45       also available as a method on the object which will return the current
46       value for the attribute if called without an argument, and set a new
47       value for the attribute if called with an argument.
48

SEE ALSO

50       Net::LDAP, Net::LDAP::Control, http://www.ietf.org/rfc/rfc4528.txt
51

AUTHOR

53       Peter Marschall <peter@adpm.de>
54
55       Please report any bugs, or post any suggestions, to the perl-ldap
56       mailing list <perl-ldap@perl.org>
57

59       Copyright (c) 2011 Peter Marschall. All rights reserved. This program
60       is free software; you can redistribute it and/or modify it under the
61       same terms as Perl itself.
62
63
64
65perl v5.38.0                      2023-07-20  Net::LDAP::Control::Assertion(3)
Impressum