Add date to files i missed last time
[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 \*(lqAliasfile:\*(rq and any
52 additional alias files given by the
53 .RB ` \-alias
54 .IR aliasfile '
55 switch will be read.  Each
56 .I alias
57 is processed as described in
58 .BR mh\-alias (5).
59
60 .SH FILES
61 .fc ^ ~
62 .nf
63 .ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
64 ^$HOME/\&.mh\(ruprofile~^The user profile
65 ^/etc/passwd~^List of users
66 ^/etc/group~^List of groups
67
68 .SH "PROFILE COMPONENTS"
69 .fc ^ ~
70 .nf
71 .ta 2.4i
72 .ta \w'ExtraBigProfileName  'u
73 ^Path:~^To determine the user's nmh directory
74 ^Aliasfile:~^For a default alias file
75
76 .SH "SEE ALSO"
77 mh\-alias(5)
78
79 .SH "DEFAULTS"
80 .nf
81 .RB ` \-alias " %etcdir%/MailAliases'"
82 .RB ` \-nolist '
83 .RB ` \-nonormalize '
84 .RB ` \-nouser '
85
86 .SH CONTEXT
87 None
88
89 .SH BUGS
90 The
91 .B \-user
92 option with
93 .B \-nonormalize
94 is not entirely accurate, as it
95 does not replace local nicknames for hosts with their official site names.