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

NAME

Net::LDAP::Constant - Constants for use with Net::LDAP

SYNOPSIS

 use Net::LDAP qw(LDAP_SUCCESS LDAP_PROTOCOL_ERROR);

 # import all constants 
 use Net::LDAP qw(:all);

DESCRIPTION

Net::LDAP::Constant exports constant subroutines for the following LDAP error codes.

LDAP_SUCCESS

Operation completed without error

LDAP_OPERATIONS_ERROR

Server encountered an internal error

LDAP_PROTOCOL_ERROR

Unrecognized version number or incorrect PDU structure

LDAP_TIMELIMIT_EXCEEDED

The time limit on a search operation has been exceeded

LDAP_SIZELIMIT_EXCEEDED

The maximum number of search results to return has been exceeded.

LDAP_COMPARE_FALSE

This code is returned when a compare request completes and the attribute value given is not in the entry specified

LDAP_COMPARE_TRUE

This code is returned when a compare request completes and the attribute value given is in the entry specified

LDAP_AUTH_METHOD_NOT_SUPPORTED

Unrecognized SASL mechanism name

LDAP_STRONG_AUTH_REQUIRED

The server requires authentication be performed with a SASL mechanism

LDAP_PARTIAL_RESULTS

Returned to version 2 clients when a referral is returned. The response will contain a list of URL's for other servers.

LDAP_REFERRAL

The server is referring the client to another server. The response will contain a list of URL's

LDAP_ADMIN_LIMIT_EXCEEDED

The server has exceed the maximum number of entries to search while gathering a list of search result candidates

LDAP_UNAVAILABLE_CRITICAL_EXT

A control or matching rule specified in the request is not supported by the server

LDAP_CONFIDENTIALITY_REQUIRED

This result code is returned when confidentiality is required to perform a given operation

LDAP_SASL_BIND_IN_PROGRESS

The server requires the client to send a new bind request, with the same SASL mechanism, to continue the authentication process

LDAP_NO_SUCH_ATTRIBUTE

The request referenced an attribute that does not exist

LDAP_UNDEFINED_TYPE

The request contains an undefined attribute type

LDAP_INAPPROPRIATE_MATCHING

An extensible matching rule in the given filter does not apply to the specified attribute

LDAP_CONSTRAINT_VIOLATION

The request contains a value which does not meet with certain constraints. This result can be returned as a consequence of

  • The request was to add or modify a user password, and the password fails to meet the criteria the server is configured to check. This could be that the password is too short, or a recognizable word (e.g. it matches one of the attributes in the users entry) or it matches a previous password used by the same user.

  • The request is a bind request to a user account that has been locked

LDAP_TYPE_OR_VALUE_EXISTS

The request attempted to add an attribute type or value that already exists

LDAP_INVALID_SYNTAX

Some part of the request contained an invalid syntax. It could be a search with an invalid filter or a request to modify the schema and the given schema has a bad syntax.

LDAP_NO_SUCH_OBJECT

The server cannot find an object specified in the request

LDAP_ALIAS_PROBLEM

Server encountered a problem while attempting to dereference an alias

LDAP_INVALID_DN_SYNTAX

The request contained an invalid DN

LDAP_IS_LEAF

The specified entry is a leaf entry

LDAP_ALIAS_DEREF_PROBLEM

Server encountered a problem while attempting to dereference an alias

LDAP_INAPPROPRIATE_AUTH

The server requires the client which had attempted to bind anonymously or without supplying credentials to provide some form of credentials

LDAP_INVALID_CREDENTIALS

The wrong password was supplied or the SASL credentials could not be processed

LDAP_INSUFFICIENT_ACCESS

The client does not have sufficient access to perform the requested operation

LDAP_BUSY

The server is too busy to perform requested operation

LDAP_UNAVAILABLE

The server in unavailable to perform the request, or the server is shutting down

LDAP_UNWILLING_TO_PERFORM

The server is unwilling to perform the requested operation

LDAP_LOOP_DETECT

The server was unable to perform the request due to an internal loop detected

LDAP_SORT_CONTROL_MISSING

The search contained a "virtual list view" control, but not a server-side sorting control, which is required when a "virtual list view" is given.

LDAP_INDEX_RANGE_ERROR

The search contained a control for a "virtual list view" and the results exceeded the range specified by the requested offsets.

LDAP_NAMING_VIOLATION

The request violates the structure of the DIT

LDAP_OBJECT_CLASS_VIOLATION

The request specifies a change to an existing entry or the addition of a new entry that does not comply with the servers schema

LDAP_NOT_ALLOWED_ON_NONLEAF

The requested operation is not allowed on an entry that has child entries

LDAP_NOT_ALLOWED_ON_RDN

The requested operation ill affect the RDN of the entry

LDAP_ALREADY_EXISTS

The client attempted to add an entry that already exists. This can occur as a result of

  • An add request was submitted with a DN that already exists

  • A modify DN requested was submitted, where the requested new DN already exists

  • The request is adding an attribute to the schema and an attribute with the given OID or name already exists

LDAP_NO_OBJECT_CLASS_MODS

Request attempt to modify the object class of an entry that should not be modified

LDAP_RESULTS_TOO_LARGE

The results of the request are to large

LDAP_AFFECTS_MULTIPLE_DSAS

The requested operation needs to be performed on multiple servers where the requested operation is not permitted

LDAP_OTHER

An unknown error has occurred

LDAP_SERVER_DOWN

Net::LDAP cannot establish a connection or the connection has been lost

LDAP_LOCAL_ERROR

An error occurred in Net::LDAP

LDAP_ENCODING_ERROR

Net::LDAP encountered an error while encoding the request packet that would have been sent to the server

LDAP_DECODING_ERROR

Net::LDAP encountered an error while decoding a response packet from the server.

LDAP_TIMEOUT

Net::LDAP timeout while waiting for a response from the server

LDAP_AUTH_UNKNOWN

The method of authentication requested in a bind request is unknown to the server

LDAP_FILTER_ERROR

An error occurred while encoding the given search filter.

LDAP_USER_CANCELED

The user canceled the operation

LDAP_PARAM_ERROR

An invalid parameter was specified

LDAP_NO_MEMORY

Out of memory error

LDAP_CONNECT_ERROR

A connection to the server could not be established

LDAP_NOT_SUPPORTED

An attempt has been made to use a feature not supported by Net::LDAP

LDAP_CONTROL_NOT_FOUND

The controls required to perform the requested operation were not found.

LDAP_NO_RESULTS_RETURNED

No results were returned from the server.

LDAP_MORE_RESULTS_TO_RETURN

There are more results in the chain of results.

LDAP_CLIENT_LOOP

A loop has been detected. For example when following referals.

LDAP_REFERRAL_LIMIT_EXCEEDED

The referral hop limit has been exceeded.

SEE ALSO

Net::LDAP, Net::LDAP::Message

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) 1998-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: Constant.pod,v 1.3 2001/08/24 19:31:14 gbarr Exp $