Provided by: postal_0.62.1build1_i386 bug

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 qualified
       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>.

SEE ALSO

       postal(8),regex(7)