DOKK / manpages / debian 10 / libnet-ldap-perl / Net::LDAP::Control::DontUseCopy.3pm.en
Net::LDAP::Control::DontUseCopy(3pm) User Contributed Perl Documentation Net::LDAP::Control::DontUseCopy(3pm)

Net::LDAP::Control::DontUseCopy - LDAPv3 Don't Use Copy control object

 use Net::LDAP;
 use Net::LDAP::Control::DontUseCopy;
 $ldap = Net::LDAP->new( "ldap.mydomain.eg" );
 $nocopy = Net::LDAP::Control::DontUseCopy->new( critical => 1 );
 $msg = $ldap->search( base => 'o=University of Michigan,c=US',
                       filter => '(cn=Barbara Jensen)'
                       control  => [ $nocopy ] );
 die "error: ",$msg->code(),": ",$msg->error()  if ($msg->code());

"Net::LDAP::Control::DontUseCopy" provides an interface for the creation and manipulation of objects that represent the "DontUseCopy" control as described by RFC 6171.

It allows the the client to specify that copied information should not be used in providing the service.

The control is appropriate for LDAP search and compare operations [RFC4511] and inappropriate for all other oeprations.

Its criticality must be TRUE; it has no value.

There is no corresponding response control.

Since the "DontUseCopy" control does not have any values only the constructor arguments described in Net::LDAP::Control are supported

As there are no additional values in the control only the methods in Net::LDAP::Control are available for "Net::LDAP::Control::DontUseCopy" objects.

Net::LDAP, Net::LDAP::Control,

Peter Marschall <peter@adpm.de>.

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

Copyright (c) 2014 Peter Marschall. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

2015-04-06 perl v5.20.2