t
<!-- Copyright 2021 Double Precision, Inc. See COPYING for -->
<!-- distribution information. -->
 Title: maildirwatch
 Author: Sam Varshavchik
 Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
 Date: 02/18/2021
 Manual: Double Precision, Inc.
 Source: Courier Mail Server
 Language: English

 "MAILDIRWATCH" "1" "02/18/2021" "Courier Mail Server" "Double Precision, Inc."
 -----------------------------------------------------------------
 * Define some portability stuff
 -----------------------------------------------------------------
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 http://bugs.debian.org/507673
 http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 -----------------------------------------------------------------
 * set default formatting
 -----------------------------------------------------------------
 disable hyphenation
 disable justification (adjust text to left margin only)
 -----------------------------------------------------------------
 * MAIN CONTENT STARTS HERE *
 -----------------------------------------------------------------
 "NAME"
maildirwatch - wait for changes to a maildir

 "SYNOPSIS"
 \w'maildirwatch 'u
maildirwatch {maildir} {command} [argument...]

 "DESCRIPTION"

maildirwatch
repeatedly invokes the
command, with any optional
arguments, an external command, as follows:


\h'-04'\(bu\h'+03'\c
.\}

 \(bu 2.3
.\}
The first time the
command
gets executed is immediately after
maildirwatch
starts.




\h'-04'\(bu\h'+03'\c
.\}

 \(bu 2.3
.\}
Subsequent invocatons of
command
occur whenever there
may
be some kind of a change to the contents of the
maildir.
maildirwatch
does not determine what, if anything, changed in the
maildir.
maildirwatch
might occasionally raise a false alarm and run the
command
even though nothing changed, but that\*(Aqs rare. It\*(Aqs also possible that by the time
command
actually runs, then whatever was changed in the
maildir
is no longer changed; it became what it was before it was changed (a mystery that will remain unsolved forever). It\*(Aqs up to the
command
to intelligently figure out if it needs to do something about whatever it finds in the
maildir.




maildirwatch
is a rudimentary mechanism for writing shell scripts that deal with newly-delivered mail, in some form or fashion.

 "EXIT CODE"

A non-zero exit code indicates that the specified
maildir
does not exist or is corrupted.


Otherwise
maildirwatch
runs until the
command
exits with a non-zero exit code.
maildirwatch
prints
command\*(Aqs exit code on standard output, and terminates with an exit code of 0.

 "SEE ALSO"

\m[blue]maildirmake(1)\m[]\s-2\u[1]\d\s+2.

 "AUTHOR"

Sam Varshavchik


Author



 "NOTES"
 " 1." 4
maildirmake(1)


\%[set $man.base.url.for.relative.links]/maildirmake.html