/usr/share/perl5/Net/LDAP/Control/DontUseCopy.pm is in libnet-ldap-perl 1:0.6500+dfsg-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 | # Copyright (c) 2014 Peter Marschall <peter@adpm.de>. All rights reserved.
# This program is free software; you can redistribute it and/or
# modify it under the same terms as Perl itself.
package Net::LDAP::Control::DontUseCopy;
use Net::LDAP::Control;
our @ISA = qw(Net::LDAP::Control);
our $VERSION = '0.01';
use strict;
sub init {
my($self) = @_;
delete $self->{asn};
delete $self->{value};
$self->{critical} = 1;
$self;
}
# make sure value does not get set
sub value {
undef;
}
# make sure criticality remains TRUE
sub critical {
1;
}
1;
__END__
=head1 NAME
Net::LDAP::Control::DontUseCopy - LDAPv3 Don't Use Copy control object
=head1 SYNOPSIS
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());
=head1 DESCRIPTION
C<Net::LDAP::Control::DontUseCopy> provides an interface for the creation
and manipulation of objects that represent the C<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.
=head1 CONSTRUCTOR ARGUMENTS
Since the C<DontUseCopy> control does not have any values only the
constructor arguments described in L<Net::LDAP::Control> are
supported
=head1 METHODS
As there are no additional values in the control only the
methods in L<Net::LDAP::Control> are available for
C<Net::LDAP::Control::DontUseCopy> objects.
=head1 SEE ALSO
L<Net::LDAP>,
L<Net::LDAP::Control>,
=head1 AUTHOR
Peter Marschall E<lt>peter@adpm.deE<gt>.
Please report any bugs, or post any suggestions, to the perl-ldap
mailing list E<lt>perl-ldap@perl.orgE<gt>
=head1 COPYRIGHT
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.
=cut
|