The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Net::LDAP::Control - LDAPv3 control object base class

SYNOPSIS

 use Net::LDAP::Control;

 $ctrl = Net::LDAP::Control->new(
   type     => "1.2.3.4",
   value    => "help",
   critical => 0
 );

 $mesg = $ldap->search( @args, control => [ $ctrl ]);

DESCRIPTION

Net::LDAP::Control is a base-class for LDAPv3 control objects.

CONSTRUCTORS

new ARGS
type
value
critical
from_asn HASHREF

METHODS

Net::LDAP::Control provides the following methods in the base class.

init

init will be called as the last step in both contructors. What it does will depend on the sub-class. It must always return the object.

error

Returns true if there has been an error.

valid

Returns true if the object is valid and can be encoded.

type [ OID ]
value [ VALUE ]
critical [ CRITICAL ]
to_asn

Returns the asn structure for encoding. This method will be called by Net::LDAP when the control is used. The base class implementaion of this method will call the value method without arguments to allow a sub-class to encode it's value. Sub-classes should not need to override this method.

SEE ALSO

Net::LDAP

AUTHOR

Graham Barr <gbarr@pobox.com>

Please report any bugs, or post any suggestions, to the perl-ldap mailing list <perl-ldap@mail.med.cornell.edu>

COPYRIGHT

Copyright (c) 1999-2000 Graham Barr. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

$Id: //depot/ldap/lib/Net/LDAP/Control.pm#9 $