xenial (1) postal-list.1.gz

Provided by: postal_0.73+nmu1build1_amd64 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>.

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)