Skip to content

Event-Handlers

Below you will find a list of all available event-handlers, along with a brief explanation of the event that triggers each one.

These are the conditions you can use to trigger the execution of your own SyncJS scripts within the context of a Syncplify Server! client session.

ConstantDescription
OnNewConnectionTriggered immediately when a new incoming connection arrives (before accepting it)
BeforeSendSoftwareIDTriggered right before the server sends its "ID" to the client (only for protocols that support server identification)
OnProtectorStrikeTriggered whenever a worker process sends a "strike" because a client has done something wrong
OnBlocklistHitTriggered when a client that's already in blocklist tries to connect anyway
OnBlocklistAddTriggered when a client's IP address is added to the blocklist
OnAuthRequestTriggered when a user requests to initiate the authentication phase
OnAuthRequestAllowedTriggered if the server decided to allow the user to attempt authentication
OnAuthRequestDeniedTriggered if the server decided to deny the user's authentication request
OnAuthPasswordTriggered when a user attempts password authentication
OnAuthPKITriggered when a user attempts PKI authentication (SSH-2 only)
OnAuthInteractiveSetQuestionsTriggered before a user attempts keyboard-interactive authentication (to set the questions)
OnAuthInteractiveTriggered when a user attempts keyboard-interactive authentication (common in SSH-2)
OnAuthFailTriggered when a user fails an authentication attempt
OnAuthSuccessTriggered when a user has successfully authenticated
BeforeOpenSFTPTriggered when an SSH-2 client requests to open the SFTP subsystem
BeforeOpenShellTriggered when an SSH-2 client requests to open a Shell
BeforeOpenCmdTriggered when an SSH-2 client requests to open a command pipeline
BeforeOpenClientFwdTriggered when an SSH-2 client requests to open a client forwarding tunnel
BeforeOpenServerFwdTriggered when an SSH-2 client requests to open a server forwarding tunnel
BeforeMakeDirTriggered before a directory is created
BeforeListDirTriggered before the list of a directory is retrieved from the VFS
BeforeSendDirListToClientTriggered after the list of a directory is retrieved from the VFS but before such list is sent to the client
BeforeDeleteDirTriggered before a directory is deleted
BeforeRenameDirTriggered before a directory is renamed
BeforeDeleteFileTriggered before a file is deleted
BeforeRenameFileTriggered before a file is renamed
BeforeModifyFileTriggered before an existing file is modified (e.g., data is appended to it)
BeforeFileUploadTriggered before an upload begins
BeforeFileDownloadTriggered before a download begins
AfterMakeDirTriggered right after a directory is created
AfterListDirTriggered right after the list of a directory is sent to the client
AfterDeleteDirTriggered right after a directory is deleted
AfterRenameDirTriggered right after a directory is renamed
AfterDeleteFileTriggered right after a file is deleted
AfterRenameFileTriggered right after a file is renamed
AfterModifyFileTriggered right after an existing file has been modified
AfterFileUploadTriggered right after a new file has been uploaded to the server
AfterFileDownloadTriggered right after a file has been downloaded
OnUploadFailTriggered if an upload fails (only if the failure event is detectable)
OnDownloadFailTriggered if a download fails (only if the failure event is detectable)
BeforeFileCombineRequestTriggered before 2 or more files are combined within the scope of a VFS
AfterFileCombineRequestTriggered after 2 or more files are combined within the scope of a VFS
BeforeAttrChangeTriggered before a file's attributes are changed
AfterAttrChangeTriggered after a file's attributes are changed
BeforeTimeChangeTriggered before a file's timestamps are changed
AfterTimeChangeTriggered after a file's timestamps are changed
OnCheckFileExistTriggered whenever a client checks if a certain file exists on the server
OnFileSizeRequestTriggered when a client retrieves the size of a file (e.g., SIZE command in FTP protocols)
OnFileHashRequestTriggered when a client requests the hash of a file
OnAvailDiskRequestTriggered when a client requests the available space in the home VFS (not all protocols support this)
OnCustomSITECommandTriggered when an FTP client sends a SITE command (specific to FTP only)
BeforeSymlinkTriggered before a symlink is created
AfterSymlinkTriggered after a symlink is created
OnQuotaExceededTriggered when a user exceeds any of the quota limits (soft/hard)
OnConnectionCloseTriggered when a client disconnects
BeforeShrCreateTriggered before a shared object is created
AfterShrCreateTriggered after a shared object is created
BeforeShrAuthRequestTriggered before a shared object is accessed
OnShrAuthRequestAllowedTriggered if the server decided to allow the user to attempt authentication
OnShrAuthSuccessTriggered when a user has successfully authenticated
BeforeShrFileUploadTriggered before a file is uploaded to a shared object
AfterShrFileUploadTriggered after a file is uploaded to a shared object
BeforeShrFileDownloadTriggered before a file is downloaded from a shared object
BeforeShrZipDownloadTriggered before a zip file is downloaded from a shared object
AfterShrFileDownloadTriggered after a file is downloaded from a shared object
AfterShrZipDownloadTriggered after a zip file is downloaded from a shared object