Section: Environments, Tables, and Troff Macros (7)
Return to Main Contents
file - event signalling that a file has changed
event is generated by the
daemon when a file whose details match the
file event condition and environment specified in a job's
stanza is modified.
FILE and EVENT
environment variables will be set to the same values as specified by the
job. Note that if the job did not specify
this will still be set to one of
depending on what type of file event caused the event to be emitted.
If the job specified a glob pattern in the file part of the
environment variable, the event will contain the
environment variable which will be set to the full path of the file that
matched the pattern in
When specifying a path that contains spaces, ensure that the path is
values specified by jobs are not canonicalised; this cannot be done reliably
as they may not exist so cannot be fully resolved.
If you wish to match on
does not contain multiple consecutive runs of slashes since otherwise
your job will find it difficult to perform such a match.
- start on file FILE=/run/app.pid EVENT=create
Event emitted when file is created.
- start on file FILE=/run/app.pid
Event emitted when file is created, modified or deleted.
- start on file FILE=/var/log/
Event emitted when files within a directory are created, modified or
- start on file FILE=/var/crash/*.crash EVENT=create
Event emitted when files that match a glob pattern are created in the
- start on file FILE="/this/path/contains whitespace.txt"
Specify a file that contains a space character.
Written by James Hunt
Report bugs at
Copyright © 2013 Canonical Ltd.
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
- SEE ALSO
This document was created by
using the manual pages.
Time: 16:16:16 GMT, January 22, 2018