Event notification

Edit online

The event notification function allows a server to notify a registered client that an entry in the directory tree is changed, added, or deleted. This notification is in the form of an unsolicited message.

When an event occurs, the server sends a message to the client as an LDAP v3 unsolicited notification. The messageID is 0 and the message is in the form of an extended operation response. The responseName field is set to the registration OID. The response field contains the unique registration ID and a timestamp for when the event occurred. The time field is in UTC time format.

When a transaction occurs, the event notifications for the transaction steps cannot be sent until the entire transaction is completed.

Note: ACLs are only checked on the entry that the event is registered on, when the event is registered. A user who does not have access to some of the entries below the access entry might receive notification of changes for those entries. The user is not told the exact change, just that a change occurred. If the ACLs are changed on the original entry to not allow the user access, the registered events remain, even though the user no longer has access. See Access Control Lists for information about ACLs.

See the Programming Reference for more information about event notification.