Perl in a Nutshell, 2nd Edition

Net::LDAP Methods

Net::LDAP implements the following methods:

new ( host [, % options ])

new( ) creates a new Net::LDAP object and opens a connection to host. % options include:

port

Port to connect to on the remote server.

timeout

The maximum time that Net::LDAP will take to connect to a host. The default is 120 seconds.

debug

Shows details of the conversion between Net::LDAP and the directory server.

async

Performs asynchronous entry retrieval so that search results are returned to the client as they are identified:

$ldap = Net::LDAP->new('ldap.my.domain', async => 1);

onerror

If set to true, and if async is also true, then Net::LDAP will check for errors on all methods. If an error exists in the resulting data, then one of the following actions will be taken: die( ), warn( ), undef.

CODEREF

Calls the given coderef in a scalar context with the result message as the argument.

version( )

Sets the version of the LDAP protocol to use. Values are LDAPv2 (default) and LDAPv3.

bind( dn [, % options ])

Binds to the server that’s contained in the connection handle. dn is the DN to bind as. You’ll end up binding anonymously if you call bind( ) without any arguments.

As for % options, you should give no more than one of the following:

noauth

Do not attempt to authenticate at all.

anonymous

Binds without any password; the value passed with this option is ignored. This is the default if no arguments are given.

password

Binds with the given password.

sasl

Binds using an SASL mechanism. The argument given should be a ...