1Net::LDAP::Control::MatUcsheerdVCaolnutersi(b3u)ted PerlNeDto:c:uLmDeAnPt:a:tCioonntrol::MatchedValues(3)
2
3
4

NAME

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

SYNOPSIS

9        use Net::LDAP;
10        use Net::LDAP::Control::MatchedValues;
11
12        $ldap = Net::LDAP->new( "ldap.mydomain.eg" );
13
14        $mv = Net::LDAP::Control::MatchedValues->new( matchedValues => '((sn=Jensen)(sn=Miller))' );
15
16        # return the entries of all people with first name "Babs",
17        # but only show the sn if it is "Jensen" or "Miller"
18        my $mesg = $ldap->search( base => "o=University of Michigan, c=US",
19                                  filter => "(givenName=Babs)",
20                                  attrs => [ qw/sn/ ],
21                                  control => $mv );
22

DESCRIPTION

24       "Net::LDAP::Control::MatchedValues" provides an interface for the
25       creation and manipulation of objects that represent the "MatchedValues
26       Control" as described by RFC 3876.
27
28       The "MatchedValues Control", which only has a meaning with the "Search"
29       operation, allows the client to specify criteria that restrict the
30       values of attributes returned.  It has no effect on the number of
31       objects found, but only allows one to restrict the values of the
32       attributes returned by the search to those matching the criteria.
33

CONSTRUCTOR ARGUMENTS

35       In addition to the constructor arguments described in
36       Net::LDAP::Control the following are provided.
37
38       matchedValues => VALUESRETURNFILTER
39           A filter giving the criteria which attribute values shall be
40           returned.
41
42           VALUESRETURNFILTER is a sequence of simple filter items of the form
43           "( <ATTRSPEC> <OP> <VALUE> )" surrounded by an additional set of
44           parentheses; e.g.
45
46           ((personsAge<=29))
47               Only return the age if is less than 30 ;-)
48
49           ((cn=*Emergency*)(telephoneNumber=+1*)(telephoneNumber=911))
50               Only return those values of the cn that contain "Emergency",
51               and phone numbers from North America including the one for
52               emergency calls.
53

METHODS

55       As with Net::LDAP::Control each constructor argument described above is
56       also available as a method on the object which will return the current
57       value for the attribute if called without an argument, and set a new
58       value for the attribute if called with an argument.
59

SEE ALSO

61       Net::LDAP, Net::LDAP::Control, http://www.ietf.org/rfc/rfc3876.txt
62

AUTHOR

64       Peter Marschall <peter@adpm.de>
65
66       Please report any bugs, or post any suggestions, to the perl-ldap
67       mailing list <perl-ldap@perl.org>
68
70       Copyright (c) 2011 Peter Marschall. All rights reserved. This program
71       is free software; you can redistribute it and/or modify it under the
72       same terms as Perl itself.
73
74
75
76perl v5.36.0                      2023-01-2N4et::LDAP::Control::MatchedValues(3)
Impressum