Error codes

The possible values for an LDAP error code are shown in the tables provided here.

Table 1. General return codes
Dec value Value Hex value Brief description Detailed description
00 LDAP_SUCCESS 00 Success The request was successful.
01 LDAP_OPERATIONS_ERROR 01 Operations error An operations error occurred.
02 LDAP_PROTOCOL_ERROR 02 Protocol error A protocol violation was detected.
03 LDAP_TIMELIMIT_EXCEEDED 03 Time limit exceeded An LDAP time limit was exceeded.
04 LDAP_SIZELIMIT_EXCEEDED 04 Size limit exceeded An LDAP size limit was exceeded.
05 LDAP_COMPARE_FALSE 05 Compare false A compare operation returned false.
06 LDAP_COMPARE_TRUE 06 Compare true A compare operation returned true.
07 LDAP_STRONG_AUTH_NOT_SUPPORTED 07 Strong authentication not supported The LDAP server does not support strong authentication.
08 LDAP_STRONG_AUTH_REQUIRED 08 Strong authentication required Strong authentication is required for the operation.
09 LDAP_PARTIAL_RESULTS 09 Partial results and referral received Partial results only returned.
10 LDAP_REFERRAL 0A Referral returned Referral returned.
11 LDAP_ADMIN_LIMIT_EXCEEDED 0B Administration limit exceeded Administration limit exceeded.
12 LDAP_UNAVAILABLE_CRITICAL_EXTENSION 0C Critical extension not supported Critical extension is not supported.
13 LDAP_CONFIDENTIALITY_REQUIRED 0D Confidentiality is required Confidentiality is required.
14 LDAP_SASLBIND_IN_PROGRESS 0E SASL bind in progress An SASL bind is in progress.
16 LDAP_NO_SUCH_ATTRIBUTE 10 No such attribute The attribute type specified does not exist in the entry.
17 LDAP_UNDEFINED_TYPE 11 Undefined attribute type The attribute type specified is not valid.
18 LDAP_INAPPROPRIATE_MATCHING 12 Inappropriate matching Filter type not supported for the specified attribute.
19 LDAP_CONSTRAINT_VIOLATION 13 Constraint violation An attribute value specified violates some constraint (for example, a postal address has too many lines, or a line that is too long).
20 LDAP_TYPE_OR_VALUE_EXISTS 14 Type or value exists An attribute type or attribute value specified already exists in the entry.
21 LDAP_INVALID_SYNTAX 15 Invalid syntax An attribute value that is not valid was specified.
32 LDAP_NO_SUCH_OBJECT 20 No such object The specified object does not exist in the directory.
33 LDAP_ALIAS_PROBLEM 21 Alias problem An alias in the directory points to a nonexistent entry.
34 LDAP_INVALID_DN_SYNTAX 22 Invalid DN syntax A DN that is syntactically not valid was specified.
35 LDAP_IS_LEAF 23 Object is a leaf The object specified is a leaf.
36 LDAP_ALIAS_DEREF_PROBLEM 24 Alias dereferencing problem A problem was encountered when dereferencing an alias.
48 LDAP_INAPPROPRIATE_AUTH 30 Inappropriate authentication Inappropriate authentication was specified (for example, LDAP_AUTH_SIMPLE was specified and the entry does not have a userPassword attribute).
49 LDAP_INVALID_CREDENTIALS 31 Invalid credentials Invalid credentials were presented (for example, the wrong password).
50 LDAP_INSUFFICIENT_ACCESS 32 Insufficient access The user has insufficient access to perform the operation.
51 LDAP_BUSY 33 DSA is busy The DSA is busy.
52 LDAP_UNAVAILABLE 34 DSA is unavailable The DSA is unavailable.
53 LDAP_UNWILLING_TO_PERFORM 35 DSA is unwilling to perform The DSA is unwilling to perform the operation.
54 LDAP_LOOP_DETECT 36 Loop detected A loop was detected.
64 LDAP_NAMING_VIOLATION 40 Naming violation A naming violation occurred.
65 LDAP_OBJECT_CLASS_VIOLATION 41 Object class violation An object class violation occurred (for example, a "required" attribute was missing from the entry).
66 LDAP_NOT_ALLOWED_ON_NONLEAF 42 Operation not allowed on nonleaf The operation is not allowed on a nonleaf object.
67 LDAP_NOT_ALLOWED_ON_RDN 43 Operation not allowed on RDNĀ® The operation is not allowed on an RDN.
68 LDAP_ALREADY_EXISTS 44 Already exists The entry already exists.
69 LDAP_NO_OBJECT_CLASS_MODS 45 Cannot modify object class Object class modifications are not allowed.
70 LDAP_RESULTS_TOO_LARGE 46 Results too large Results too large.
71 LDAP_AFFECTS_MULTIPLE_DSAS 47 Affects multiple DSAs Affects multiple DSAs.
80 LDAP_OTHER 50 Unknown error An unknown error occurred.
81 LDAP_SERVER_DOWN 51 Can't contact LDAP server The LDAP library cannot contact the LDAP server.
82 LDAP_LOCAL_ERROR 52 Local error Some local error occurred. This is usually a failed memory allocation.
83 LDAP_ENCODING_ERROR 53 Encoding error An error was encountered encoding parameters to send to the LDAP server.
84 LDAP_DECODING_ERROR 54 Decoding error An error was encountered decoding a result from the LDAP server.
85 LDAP_TIMEOUT 55 Timed out A time limit was exceeded while waiting for a result.
86 LDAP_AUTH_UNKNOWN 56 Unknown authentication method The authentication method specified on a bind operation is not known.
87 LDAP_FILTER_ERROR 57 Bad search filter An invalid filter was supplied to ldap_search (for example, unbalanced parentheses).
88 LDAP_USER_CANCELLED 58 User cancelled operation The user cancelled the operation.
89 LDAP_PARAM_ERROR 59 Bad parameter to an LDAP routine An LDAP routine was called with a bad parameter (for example, a NULL ld pointer, etc.).
90 LDAP_NO_MEMORY 5A Out of memory A memory allocation (for example malloc) call failed in an LDAP library routine.
91 LDAP_CONNECT_ERROR 5B Connection error Connection error.
92 LDAP_NOT_SUPPORTED 5C Not supported Not supported.
93 LDAP_CONTROL_NOT_FOUND 5D Control not found Control not found.
94 LDAP_NO_RESULTS_RETURNED 5E No results returned No results returned.
95 LDAP_MORE_RESULTS_TO_RETURN 5F More results to return More results to return.
96 LDAP_URL_ERR_NOTLDAP 60 URL doesn't begin with ldap:// The URL does not begin with ldap://.
97 LDAP_URL_ERR_NODN 61 URL has no DN (required) The URL does not have a DN (required).
98 LDAP_URL_ERR_BADSCOPE 62 URL scope string is invalid The URL scope string is not valid.
99 LDAP_URL_ERR_MEM 63 Can't allocate memory space Cannot allocate memory space.
100 LDAP_CLIENT_LOOP 64 Client loop Client loop.
101 LDAP_REFERRAL_LIMIT_EXCEEDED 65 Referral limit exceeded Referral limit exceeded.
112 LDAP_SSL_ALREADY_INITIALIZED 70 ldap_ssl_client_init successfully called previously in this process The ldap_ssl_client_init was successfully called previously in this process.
113 LDAP_SSL_INITIALIZE_FAILED 71 Initialization call failed SSL Initialization call failed.
Note: GSKit must be installed and the GSKit libraries must be present.
114 LDAP_SSL_CLIENT_INIT_NOT_CALLED 72 Must call ldap_ssl_client_init before attempting to use SSL connection Must call ldap_ssl_client_init before attempting to use SSL connection.
115 LDAP_SSL_PARAM_ERROR 73 Invalid SSL parameter previously specified An SSL parameter that was not valid was previously specified.
116 LDAP_SSL_HANDSHAKE_FAILED 74 Failed to connect to SSL server Failed to connect to SSL server.
117 LDAP_SSL_GET_CIPHER_FAILED 75 Not used Deprecated.
118 LDAP_SSL_NOT_AVAILABLE 76 SSL library cannot be located Ensure that GSKit has been installed.
LDAP_SSL_KEYRING_NOT_FOUND 77
LDAP_SSL_PASSWORD_NOT_SPECIFIED 78
128 LDAP_NO_EXPLICIT_OWNER 80 No explicit owner found No explicit owner was found.
129 LDAP_NO_LOCK 81 Could not obtain lock Client library was not able to lock a required resource.
In addition, the following DNS-related error codes are defined in the ldap.h file:
Table 2. DNS-related return codes
Dec value Value Hex value Detailed description
133 LDAP_DNS_NO_SERVERS 85 No LDAP servers found
134 LDAP_DNS_TRUNCATED 86 Warning: truncated DNS results
135 LDAP_DNS_INVALID_DATA 87 Invalid DNS Data
136 LDAP_DNS_RESOLVE_ERROR 88 Can't resolve system domain or nameserver
137 LDAP_DNS_CONF_FILE_ERROR 89 DNS Configuration file error
The following UTF8-related error codes are defined in the ldap.h file:
Table 3. UTF8-related return codes
Dec value Value Hex value Detailed description
160 LDAP_XLATE_E2BIG A0 Output buffer overflow
161 LDAP_XLATE_EINVAL A1 Input buffer truncated
162 LDAP_XLATE_EILSEQ A2 Unusable input character
163 LDAP_XLATE_NO_ENTRY A3 No codeset point to map to
176 LDAP_REG_FILE_NOT_FOUND B0 File not found in NT registry
177 LDAP_REG_CANNOT_OPEN B1 Can not open NT registry
178 LDAP_REG_ENTRY_NOT_FOUND B2 Entry not found in NT registry
192 LDAP_CONF_FILE_NOT_OPENED C0 Plug-in configuration file not opened
193 LDAP_PLUGIN_NOT_LOADED C1 Plug-in library not loaded
194

LDAP_PLUGIN_FUNCTION_
NOT_RESOLVED

C2 Plug-in function not resolved
195 LDAP_PLUGIN_NOT_INITIALIZED C3 Plug-in library not initialized
196 LDAP_PLUGIN_COULD_NOT_BIND C4 Could not bind to plug-in function
208 LDAP_SASL_GSS_NO_SEC_CONTEXT D0 gss_init_sec_context failed