NAME¶
file - event signalling that a file has changed
SYNOPSIS¶
file FILE=PATH EVENT=TYPE
[MATCH=PATH]
DESCRIPTION¶
The
file event is generated by the
upstart-file-bridge(8) daemon
when a file whose details match the file event condition and environment
specified in a job's
start on or
stop on stanza is modified.
The
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
EVENT this will still be set to one of
create,
modify or
delete 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
FILE
environment variable, the event will contain the
MATCH environment
variable which will be set to the full path of the file that matched the
pattern in
FILE.
NOTES¶
- •
- When specifying a path that contains spaces, ensure that the path is
quoted.
- •
- FILE 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 MATCH, ensure that FILE does not
contain multiple consecutive runs of slashes since otherwise your job will
find it difficult to perform such a match.
EXAMPLES¶
- 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
deleted.
- start on file FILE=/var/crash/*.crash EVENT=create
- Event emitted when files that match a glob pattern are created in the
indicated directory.
- start on file FILE="/this/path/contains whitespace.txt"
- Specify a file that contains a space character.
AUTHOR¶
Written by James Hunt <
james.hunt@canonical.com>
BUGS¶
Report bugs at <
https://launchpad.net/upstart/+bugs>
COPYRIGHT¶
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¶
init(5) init(8) upstart-file-bridge(8)