1postal-list(1) Postal postal-list(1)
2
3
4
6 postal-list - program to show how postal expands user names
7
8
10 postal-list user-list-filename conversion-filename
11
12
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
41 0 No Error
42
43 1 Bad Parameters
44
45
47 This program, it's manual page, and the Debian package were written by
48 Russell Coker <russell@coker.com.au>.
49
50
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
59 postal(8),rabid(8),regex(7)
60
61
62
63russell@coker.com.au 0.70 postal-list(1)