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