postal-list(8)
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 cre
- ation 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 con
- tains 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 reg
- ular expression. For each email that is to be sent a randomly
- selected user-name will be checked against all regular expres
- sions, 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 charac
- ter 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>.