1postal-list(1)                      Postal                      postal-list(1)
2
3
4

NAME

6       postal-list - program to show how postal expands user names
7
8

SYNOPSIS

10       postal-list user-list-filename conversion-filename
11
12

DESCRIPTION

14       This  program shows the expansion that the postal program uses on email
15       addresses.  This can be used to make  sure  that  you're  configuration
16       files  do  what  you  expect them to, and can also be used to produce a
17       list of user-names for an account creation script (in case you want  to
18       create a million test accounts in a conveniant fashion).
19
20       The  user-list-filename  is the name of a file which contains a list of
21       user's email addresses.  This can be just user-names or fully qualified
22       email addresses.
23
24       The conversion-filename parameter will be the name of a file containing
25       the conversions to apply to email addresses.  Each line in the file can
26       either  be  a  comment (starting with "#") or is to contain two parame‐
27       ters.  The first parameter is the regular expression.  For  each  email
28       that  is  to  be  sent  a  randomly  selected user-name will be checked
29       against all regular expressions, the first  match  will  determine  the
30       translation  that is to be applied.  The translation will be the second
31       parameter on the line.  It will contain  a  number  of  "."  characters
32       specifying  characters  in  the name that are not to be translated.  To
33       specify the translations a range of characters can be specified  inside
34       square  brackets.   For example to have every address starting with "a"
35       have a character from "01234567890abc" as it's second character  and  a
36       character from "xyz" as it's third character you would have the follow‐
37       ing: ^a .[0-9abc][xyz]
38
39

RETURN CODES

41       0      No Error
42
43       1      Bad Parameters
44
45

AUTHOR

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

AVAILABILITY

52       The source is available from http://doc.coker.com.au/projects/postal/ .
53
54       See  http://etbe.coker.com.au/category/benchmark  for  further informa‐
55       tion.
56
57

SEE ALSO

59       postal(8),rabid(8),regex(7)
60
61
62
63russell@coker.com.au                 0.70                       postal-list(1)
Impressum