postal-list(1)							      Postal							    postal-list(1)

NAME

       postal-list - program to show how postal expands user names

SYNOPSIS

       postal-list user-list-filename conversion-filename

DESCRIPTION

       This  program shows the expansion that the postal program uses on email addresses.  This can be used to make sure that you're configuration
       files do what you expect them to, and can also be used to produce a list of user-names for an account creation script (in case you want	to
       create a million test accounts in a conveniant fashion).

       The  user-list-filename is the name of a file which contains a list of user's email addresses.  This can be just user-names or fully quali-
       fied email addresses.

       The conversion-filename parameter will be the name of a file containing the conversions to apply to email addresses.  Each line in the file
       can  either  be	a  comment  (starting with "#") or is to contain two parameters.  The first parameter is the regular expression.  For each
       email that is to be sent a randomly selected user-name will be checked against all regular expressions, the first match will determine  the
       translation  that  is to be applied.  The translation will be the second parameter on the line.	It will contain a number of "." characters
       specifying characters in the name that are not to be translated.  To specify the translations a range of characters can be specified inside
       square brackets.  For example to have every address starting with "a" have a character from "01234567890abc" as it's second character and a
       character from "xyz" as it's third character you would have the following: ^a .[0-9abc][xyz]

RETURN CODES

       0      No Error

       1      Bad Parameters

AUTHOR

       This program, it's manual page, and the Debian package were written by Russell Coker <russell@coker.com.au>.

AVAILABILITY

       The source is available from http://doc.coker.com.au/projects/postal/ .

       See http://etbe.coker.com.au/category/benchmark for further information.

SEE ALSO

       postal(8),rabid(8),regex(7)

russell@coker.com.au						       0.70							    postal-list(1)