- LDAP protocol error handling routines
OpenLDAP LDAP (libldap, -lldap)
char *ldap_err2string( int err );
The ldap_err2string() routine provides short description of the various
codes returned by routines in this library. The returned string is a
pointer to a static area that should not be modified.
These codes are either negative, indicating an API error code; posi-
tive, indicating an LDAP resultCode other than 'success' (0), or -
zero, indicating both successful use of the API and the LDAP resultCode
The code associated with an LDAP session is accessible using
ldap_get_option(3) and ldap_set_option(3) with the LDAP_OPT_RESULT_CODE
option (previously called LDAP_OPT_ERROR_NUMBER).
PROTOCOL RESULT CODES
This section provides a partial list of protocol codes recognized by
the library. As LDAP is extensible, additional values may be returned.
A complete listing of registered LDAP result codes can be obtained from
the Internet Assigned Numbers Authority <http://www.iana.org>.
LDAP_SUCCESS The request was successful.
An operations error occurred.
LDAP_PROTOCOL_ERROR A protocol violation was detected.
An LDAP time limit was exceeded.
An LDAP size limit was exceeded.
LDAP_COMPARE_FALSE A compare operation returned false.
LDAP_COMPARE_TRUE A compare operation returned true.
The LDAP server does not support strong authentica-
Filter type not supported for the specified
An attribute value specified violates some con-
straint (e.g., a postalAddress has too many lines,
or a line that is too long).
An attribute type or attribute value specified
already exists in the entry.
LDAP_INVALID_SYNTAX An invalid attribute value was specified.
LDAP_NO_SUCH_OBJECT The specified object does not exist in The Direc-
LDAP_ALIAS_PROBLEM An alias in The Directory points to a nonexistent
A syntactically invalid DN was specified.
LDAP_IS_LEAF The object specified is a leaf.
A problem was encountered when dereferencing an
Inappropriate authentication was specified (e.g.,
LDAP_AUTH_SIMPLE was specified and the entry does
not have a userPassword attribute).
Invalid credentials were presented (e.g., the wrong
The user has insufficient access to perform the
LDAP_BUSY The DSA is busy.
LDAP_UNAVAILABLE The DSA is unavailable.
The DSA is unwilling to perform the operation.
LDAP_LOOP_DETECT A loop was detected.
A naming violation occurred.
Object class modifications are not allowed.
LDAP_OTHER An unknown error occurred.
API ERROR CODES
This section provides a complete list of API error codes recognized by
the library. Note that LDAP_SUCCESS indicates success of an API call
in addition to representing the return of the LDAP 'success' result-
LDAP_SERVER_DOWN The LDAP library can't contact the LDAP server.
LDAP_LOCAL_ERROR Some local error occurred. This is usually a
failed dynamic memory allocation.
LDAP_ENCODING_ERROR An error was encountered encoding parameters to
send to the LDAP server.
LDAP_DECODING_ERROR An error was encountered decoding a result from the
LDAP_TIMEOUT A timelimit was exceeded while waiting for a
LDAP_AUTH_UNKNOWN The authentication method specified to ldap_bind()
is not known.
LDAP_FILTER_ERROR An invalid filter was supplied to ldap_search()
(e.g., unbalanced parentheses).
LDAP_PARAM_ERROR An ldap routine was called with a bad parameter.
LDAP_NO_MEMORY An memory allocation (e.g., malloc(3) or other
dynamic memory allocator) call failed in an ldap
LDAP_USER_CANCELED Indicates the user cancelled the operation.
LDAP_CONNECT_ERROR Indicates a connection problem.
LDAP_NOT_SUPPORTED Indicates the routine was called in a manner not
supported by the library.
Indicates the control provided is unknown to the
Indicates no results returned.
Deprecated interfaces generally remain in the library. The macro
LDAP_DEPRECATED can be defined to a non-zero value (e.g., -DLDAP_DEPRE-
CATED=1) when compiling program designed to use deprecated interfaces.
It is recommended that developers writing new programs, or updating old
programs, avoid use of deprecated interfaces. Over time, it is
expected that documentation (and, eventually, support) for deprecated
interfaces to be eliminated.
OpenLDAP Software is developed and maintained by The OpenLDAP Project
<http://www.openldap.org/>. OpenLDAP Software is derived from Univer-
sity of Michigan LDAP 3.3 Release.
OpenLDAP 2012/04/23 LDAP_ERROR(3)
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2019
All Rights Reserved.