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-
Strong authentication is required for the opera-
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.
An object class violation occurred (e.g., a "must"
attribute was missing from the entry).
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.
Indicates more results could be returned.
LDAP_CLIENT_LOOP Indicates the library has detected a loop in its
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 2015/08/14 LDAP_ERROR(3)
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2019
All Rights Reserved.