f2fb580128e17b069896c2aa2fb9a14f06fd30a2
[mmh] / man / ali.man
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 .PP
30 By default, when an aliases expands to multiple addresses, the addresses
31 are separated by commas and printed on as few lines as possible.  If the
32 .B \-list
33 option is specified, then when an address expands to multiple
34 addresses, each address will appear on a separate line.
35 .PP
36 The switch
37 .B \-user
38 directs
39 .B ali
40 to perform its processing in
41 an inverted fashion: instead of listing the addresses that each given
42 alias expands to,
43 .B ali
44 will list the aliases that expand to each
45 given address.  If the
46 .B \-normalize
47 switch is given,
48 .B ali
49 will
50 try to track down the official hostname of the address.
51 .PP
52 The files specified by the profile entry
53 .RI \*(lq Aliasfile \*(rq
54 and any additional alias files given by the
55 .B \-alias
56 .I aliasfile
57 switch will be read.  Each
58 .I alias
59 is processed as described in
60 .BR mh\-alias (5).
61
62 .SH FILES
63 .fc ^ ~
64 .nf
65 .ta \w'%etcdir%/ExtraBigFileName  'u
66 ^$HOME/\&.mh\(ruprofile~^The user profile
67 ^/etc/passwd~^List of users
68 ^/etc/group~^List of groups
69 .fi
70
71 .SH "PROFILE COMPONENTS"
72 .fc ^ ~
73 .nf
74 .ta 2.4i
75 .ta \w'ExtraBigProfileName  'u
76 ^Path:~^To determine the user's nmh directory
77 ^Aliasfile:~^For a default alias file
78 .fi
79
80 .SH "SEE ALSO"
81 mh\-alias(5)
82
83 .SH DEFAULTS
84 .nf
85 .RB ` aliasfiles "' defaults to %etcdir%/MailAliases"
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.