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-dev@lists.sourceforge.net>


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#11 $