Jump to main content

# About Events Publishing

Events Publishing allows third-party applications to register to receive event notification and context from the storage system when accessing file systems by using the SMB or NFS protocols. The Events Publishing agent delivers to the application both event notification and associated context in one message. Context may consist of file metadata or directory metadata that is necessary to decide business policy.

You must define at least one event option (pre-, post-, or post-error event) when Events Publishing is enabled.

- Pre-event notifications are sent before processing an SMB or NFS client request.
- Post-event notifications are sent after a successful SMB or NFS client request.
- Post-error event notifications are sent after a failed SMB or NFS client request.

For additional information about Events Publishing, see either the "Using the Common Event Enabler on Windows Platforms" or "Using the Common Event Enabler on Linux Platforms" article, depending on your platform, on Online Support.

Table 1. Event descriptions
Value | Definition | Protocol
--- | --- | ---
OpenFileNoAccess | Sends a notification when a file is opened for a change other than read or write access (for example, read or write attributes on the file). | SMB/CIFS NFS (v4)
OpenFileRead | Sends a notification when a file is opened for read access. | SMB/CIFS NFS (v4)
OpenFileReadOffline | Sends a notification when an offline file is opened for read access. | SMB/CIFS NFS (v4)
OpenFileWrite | Sends a notification when a file is opened for write access. | SMB/CIFS NFS (v4)
OpenFileWriteOffline | Sends a notification when an offline file is opened for write access. | SMB/CIFS NFS (v4)
OpenDir | Sends a notification when a directory is opened. | SMB/CIFS
FileRead | Sends a notification when a file read is received over NFS. | NFS (v3/v4)
FileWrite | Sends a notification when a file write is received over NFS. | NFS (v3/v4)
CreateFile | Sends a notification when a file is created. | SMB/CIFS NFS (v3/v4)
CreateDir | Sends a notification when a directory is created. | SMB/CIFS NFS (v3/v4)
DeleteFile | Sends a notification when a file is deleted. | SMB/CIFS NFS (v3/v4)
DeleteDir | Sends a notification when a directory is deleted. | SMB/CIFS NFS (v3/v4)
CloseModified | Sends a notification when a file is changed before closing. | SMB/CIFS NFS (v4)
CloseUnmodified | Sends a notification when a file is not changed before closing. | SMB/CIFS NFS (v4)
CloseDir | Sends a notification when a directory is closed. | SMB/CIFS
RenameFile | Sends a notification when a file is renamed. | SMB/CIFS NFS (v3/v4)
RenameDir | Sends a notification when a directory is renamed. | SMB/CIFS NFS (v3/v4)
SetAclFile | Sends a notification when the security descriptor (ACL) on a file is changed. | SMB/CIFS
SetAclDir | Sends a notification when the security descriptor (ACL) on a directory is changed. | SMB/CIFS
SetSecFile | Sends a notification when a file security change is received over NFS. | NFS (v3/v4)
SetSecDir | Sends a notification when a directory security change is received over NFS. | NFS (v3/v4)