2004-04-15

      mailping

      0.0.4

MAILPING-STORE(1)						     Mailping							 MAILPING-STORE(1)

NAME

       mailping-store - store email from stdin to a mailping incoming maildir

SYNOPSIS

       mailping-store

DESCRIPTION

	mailping-store reads an email from standard input and writes it into a maildir chosen according to following logic:

	1.  If EXTENSION is not set, select Maildir.

	2.  If EXTENSION is set, ensure its value is safe to use, and select EXTENSION/incoming.

	mailping-store is usually run from a .forward file, and thus the filenames above are relative to the home directory of the account in
       question.

   Normal use
       Normally, mailping-store is used to ease the setup of new circuits to probe from mailping-cron. This is done with a system account mailping
       using <mailping@yourhost.example.com> as the from address, and <mailping+circuitname@yourhost.example.com> (or some remote address aliased
       to that) as the to address. In fact, these are the default values for from and to, so you can just skip creating those configuration files.

       This allows adding new test circuits without any changes to the email configuration.

FILES

       /var/lib/mailping/state/circuit/incoming
	   Maildir to store the email to.

       /var/lib/mailping/state/Maildir/
	   Maildir to store the email to, if no extension was given.

ENVIRONMENT

       MAILPING_STATEDIR
	   Override the location of the state directory. Circuit states are stored in the state subdirectory of this directory, in subdirectories
	   named after the circuit name. Default: /var/lib/mailping

       EXTENSION
	   Name of the current circuit to store the mail for.

SEE ALSO

	mailping-cron(1), mailping-success(1), mailping-latency(1)

AUTHOR

       Tommi Virtanen <tv@havoc.fi>
       Havoc Consulting
	   Author.

COPYRIGHT

       Copyright (C) 2004 Havoc Consulting

mailping 0.							    2004-04-15							 MAILPING-STORE(1)