NAME

       inoticoming - trigger actions when files hit an incoming directory

SYNOPSIS

       inoticoming [ global-options ] directory actions*

DESCRIPTION

       Inoticoming  is  a  daemon to watch a directory with Linux's inotify framework and trigger
       actions once files with specific names are placed in there.

       For example it can be used to wait for .changes files uploaded into a directory  and  call
       reprepro to put them into your repository.

GLOBAL OPTIONS

       --foreground
              Do not fork, but stay in the foreground and log to stderr.

       --logfile filename
              After forking in the background, log to the specified filename instead of syslog.

       --pid-file filename
              Write the pid of the running instance into filename.

       --initialsearch
              First  search  the  directory  for files already existing and process them with the
              given rules as if they just appeared.  If files show up in this inital phase,  they
              may  be processed twice, but should never be missed.  (Unless they are too many and
              the inotify queue overflows).

ACTIONS

       Each action description is an optional list of options for this  action  (which  files  to
       call  it  for,  what  directory  to change into before executing it, ...), followed by the
       command and its arguments ended with a single ; as argument. Like:
       inoticoming --foreground / --regexp ^v echo There appeared {} in the  root  directory.  \;
       (Note  that  the  \  before  the ; is needed if and only if you calling it from a shell or
       anything else interpreting the ; on its own).

   ACTION OPTIONS
       --prefix string
              Only trigger this action, if the filename starts with the specified string.

       --suffix string
              Only trigger this action, if the filename ends with the specified string.

       --regexp regular expression
              Only trigger this action, if the filename matches the specified regular expression.

       --chdir directory
              Change into directory before executing the specified commands.  (Note that since it
              is a well-behaved daemon, its working directory is / which will be inherited by all
              actions).

       --stdout-to-log
              Redirect the command's output (stdout) to the logfile.

       --stderr-to-log
              Redirect the command's error output (stderr) to the logfile.

EXAMPLES

       inoticoming  --logfile   logs/ilog   --pid-file   pid   $INCOMINGDIR   --suffix   .changes
       --stderr-to-log   reprepro  -s  -b  $REPREPROBASEDIR  --waitforlock  1000  processincoming
       rulename {} \;
              This will call reprepro for every new  .changes  file.   Note  that  giving  {}  as
              argument  to  processincoming (which inoticoming will replace with the filename) so
              that only that .changes file is processed and reprepro will not  complain  about  a
              possible  other  yet  incomplete  .changes  file  is  only  available starting with
              reprepro version 2.2.2.

PROBLEMS

       There is no handling of queue overflows yet.

REPORTING BUGS

       Report bugs or wishlist requests to the Debian BTS
       (e.g. by using reportbug inoticoming under Debian)
       or directly to <brlink@debian.org>.

COPYRIGHT

       Copyright © 2007 Bernhard R. Link
       This is free software; see the source for copying conditions. There is  NO  warranty;  not
       even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.