Isode API Customer Documentation

Summary: Isode components write to logging streams when events occur.

Facility `dsapi`

DSAPI client library events

Name	Severity	ID	Description	Action
`atn_failure`	error	34	An address could not be converted for the given reason.
`atn_trace`	detail	35	This traces the address mapping algorithm.
`bad_addr`	error	3	The input address could not be parsed as either an RFC 1006 presentation address or an LDAP URI.	No operator action
`bad_ldap_filter`	information	23	Invalid LDAP filter specification.	Correct errors in LDAP filter specification and reattempt search.
`DAP_session_lost`	error	30	An DAP operation failed and a status of DS_ERROR_CONNECT was detected. The corresponding DSAPI session state has been set to DSConnectionLost, and further attempts to perform operations will result in DS_E_NOTBOUND errors.	Check server and network availability.
`delete_file_failed`	warning	26	Unexpected failure to delete a file.	Look for access-control/permissions problems.
`dn_convert_fail`	error	15	The DAP DN could not be converted to a DS_DN.	Enter a valid DN string
`dn_parse_fail`	information	14	The DN string could not be parsed.	Enter a valid DN string
`entry_convert_fail`	error	9	The DAP read result could not be converted into a DS_Entry.	No operator action
`internal`	error	31	Unexpected condition, should not occur.	Consider reporting to Isode.
`invalid_attrtype`	error	17	The attribute type was not recognized.	Check the schema files are up to date
`invalid_dn`	error	7	The passed DN could not be converted.	No operator action
`invalid_eis`	error	16	The combination of attributes in the entry information selection was invalid.	No operator action
`invalid_opid`	error	10	The operation ID was out of range.	No operator action
`ldap_error_text`	information	18	The LDAP error returned extra information.	No operator action
`LDAP_session_lost`	error	29	An LDAP operation failed and a status of LDAP_SERVER_DOWN was detected. The corresponding DSAPI session state has been set to DSConnectionLost, and further attempts to perform operations will result in DS_E_NOTBOUND errors.	Check server and network availability.
`ldif_write_type_change`	notice	28	An attempt has been made to write a change-entry on a stream which has previously had normal entries read from it or written to it, or to write normal entries on a stream previously used for change-entries.	Possible software bug.
`not_implemented`	error	4	The operation is not currently implemented for the protocol being used.	No operator action
`rdn_convert_fail`	error	13	The DAP RDN could not be converted.	No operator action
`read_unexpected_message`	error	8	An unexpected LDAP message was received while waiting for read/search results.	No operator action
`referral_parse_failure`	warning	24	An operation returned a referral, but the referral information could not be parsed into a DS_Referral structure.	None.
`rename_file_failed`	warning	27	Unexpected failure to rename a file.	Look for access-control/permissions problems.
`sasl_debug`	detail	33	Information was logged about a SASL related operation.	No operator action.
`search_correlation_failed`	warning	21	An attempt to correlate a set of search results failed	No operator action
`signature_invalid`	warning	20	A signed operation appears to have completed successfully, but the signature did not verify.	The results from this operation should be treated with caution
`tls_debug`	detail	32	Information was logged about a TLS related operation.	No operator action.
`trace_enter`	detail	1	The function was entered.	No operator action
`trace_leave`	detail	2	The function returned.	No operator action
`unexpected`	error	25	Unexpected condition; should not occur.	Consider reporting to Isode.
`unknown_opid`	error	11	The operation ID was not found.	No operator action
`unrecognised_common_arg`	detail	22	An option in a common arguments structure was ignored	No operator action
`unsupported_critical_extension`	information	19	An unsupported critical extension bit was used.	No operator action
`value_convert_fail`	error	12	The DAP attribute value could not be converted into a DS_AttrVal.	No operator action
`x509_make_bind_fail`	error	5	The strong DAP bind argument could not be constructed.	Check identities
`x509_sign_bind_fail`	error	6	The strong DAP bind argument could not be signed.	Check identities