file contains instructions to the
daemon of the general form: run this command when these events happen
to the file at this path.
Blank lines and leading spaces and tabs are ignored.
Lines whose first non-space character is a pound-sign (#) are comments,
and are ignored. Note that comments are not allowed on the same line as
commands, since they will be taken to be part of the command.
Similarly, comments are not allowed on the same line as
environment variable settings.
An active line of a
will be either an environment setting or a command.
An environment setting is of the form
name = value
where the spaces around the equal-sign (=) are optional, and any subsequent
non-leading spaces in
will be part of the value assigned to
cannot contain any blackslash or tabulation.
Several environment variables are set up automatically by the
are set to the command user,
is set to the home directory of the command user, unless explicitly overriden.
is set to the path that has triggered the command execution.
The format of a
command is a tabulation-separated sequence of fields, interpreted as follow:
When less than 6 fields are given in a command line, the
value is considered omitted, and chroot will be performed.
When less than 5 fields are given, the
value is considered omitted, and no setuid or setgid will be performed.
When less than 4 fields are given, the
value is considered as zero.
It is an error to provide less than 3 fields.
Path of the file to watch
Set of events which trigger the command. It can either be a single
star-sign (*), or a punctuation-separated list of names among:
DELETE, WRITE, EXTEND, ATTRIB, LINK, RENAME and REVOKE. Their meaning is
Number of seconds, allowing a decimal point, between the trigger and when
the command is actually run.
User, and optionally group preceded by a colon sign (:), to change to
before running the command.
Path of a directory in which to chroot before running the command.
The command to run.