Open Source Software

file-event(7)



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)



Free and Open Source Software


Free Software Video

Useful Programs

Free Online Courses

Open Opportunity

Open Business