CONSTANT(1)

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
the Net::LDAP manpage, the Net::LDAP::Message manpage

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 $