55ec128e548d867d48ad8dd6ff2c7bb2fada7c70
[mmh] / man / ali.man1
1 .\"
2 .\" %nmhwarning%
3 .\"
4 .TH ALI %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
5 .SH NAME
6 ali \- list mail aliases
7 .SH SYNOPSIS
8 .HP 5
9 .na
10 .B ali
11 .RB [ \-alias
12 .IR aliasfile ]
13 .RB [ \-list " | " \-nolist ]
14 .RB [ \-normalize " | " \-nonormalize ]
15 .RB [ \-user " | " \-nouser ]
16 .RB [ \-Version ]
17 .RB [ \-help ]
18 .RI [ aliases " ...]"
19 .ad
20 .SH DESCRIPTION
21 .B Ali
22 searches the named mail alias files for each of the given
23 .IR aliases .
24 It creates a list of addresses for those
25 .IR aliases ,
26 and writes that list on standard output.  If no arguments are given,
27 .B ali
28 outputs all alias entries.
29 This can be used to check the format of the alias file for validity.
30 .PP
31 By default, when an aliases expands to multiple addresses, the addresses
32 are separated by commas and printed on as few lines as possible.  If the
33 .B \-list
34 option is specified, then when an address expands to multiple
35 addresses, each address will appear on a separate line.
36 .PP
37 The switch
38 .B \-user
39 directs
40 .B ali
41 to perform its processing in
42 an inverted fashion: instead of listing the addresses that each given
43 alias expands to,
44 .B ali
45 will list the aliases that expand to each
46 given address.  If the
47 .B \-normalize
48 switch is given,
49 .B ali
50 will
51 try to track down the official hostname of the address.
52 .PP
53 The files specified by the profile entry
54 .RI \*(lq Aliasfile \*(rq
55 and any additional alias files given by the
56 .B \-alias
57 .I aliasfile
58 switch will be read.  Each
59 .I alias
60 is processed as described in
61 .BR mh\-alias (5).
62
63 .SH FILES
64 .fc ^ ~
65 .nf
66 .ta \w'%etcdir%/ExtraBigFileName  'u
67 ^$HOME/.mmh/profile~^The user profile
68 ^/etc/passwd~^List of users
69 ^/etc/group~^List of groups
70 .fi
71
72 .SH "PROFILE COMPONENTS"
73 .fc ^ ~
74 .nf
75 .ta 2.4i
76 .ta \w'ExtraBigProfileName  'u
77 ^Path:~^To determine the user's mail storage
78 ^Aliasfile:~^For a default alias file
79 .fi
80
81 .SH "SEE ALSO"
82 mh\-alias(5)
83
84 .SH DEFAULTS
85 .nf
86 .RB ` \-nolist '
87 .RB ` \-nonormalize '
88 .RB ` \-nouser '
89 .fi
90
91 .SH CONTEXT
92 None
93
94 .SH BUGS
95 The
96 .B \-user
97 option with
98 .B \-nonormalize
99 is not entirely accurate, as it
100 does not replace local nicknames for hosts with their official site names.