NAME

Net::LDAPxs::Control - LDAPv3 control extension

SYNOPSIS

use Net::LDAPxs::Control;

$ctrl = Net::LDAPxs::Control->new(
        type  => '1.2.840.113556.1.4.473',
        value => 'sn -cn',
        critical => 0
        );

$msg = $ldap->search( base    => $base,
                      control => $ctrl );

DESCRIPTION

The Net::LDAPxs::Control is for LDAPv3 control extension.

CONSTRUCTORS

new ( ARGS )

ARGS is a list of name/value pairs, valid arguments are:

type

A dotted-decimal representation of an OBJECT IDENTIFIER which uniquely identifies the control. This prevents conflicts between control names.

value

Optional information associated with the control. It's format is specific to the particular control.

critical

A boolean value, if TRUE and the control is unrecognized by the server or is inappropriate for the requested operation then the server will return an error and the operation will not be performed.

If FALSE and the control is unrecognized by the server or is inappropriate for the requested operation then the server will ignore the control and perform the requested operation as if the control was not given.

If absent, FALSE is assumed.

ACKNOWLEDGEMENTS

This document is based on the document of Net::LDAP::Control

AUTHOR

Pan Yu <xiaocong@vip.163.com>

COPYRIGHT AND LICENSE

Copyright (C) 2008-2009 by Pan Yu. All rights reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.