Changed msg_style and msg_delim to be file static to m_getfld.c
[mmh] / man / ali.man
1 .TH ALI %manext1% "January 1, 2001" "%nmhversion%"
2 .\"
3 .\" %nmhwarning%
4 .\"
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 .IR mh\-alias (5).
61 .SH FILES
62 .fc ^ ~
63 .nf
64 .ta \w'%etcdir%/ExtraBigFileName  'u
65 ^$HOME/\&.mh\(ruprofile~^The user profile
66 ^/etc/passwd~^List of users
67 ^/etc/group~^List of groups
68 .fi
69 .SH "PROFILE COMPONENTS"
70 .fc ^ ~
71 .nf
72 .ta 2.4i
73 .ta \w'ExtraBigProfileName  'u
74 ^Path:~^To determine the user's nmh directory
75 ^Aliasfile:~^For a default alias file
76 .fi
77 .SH "SEE ALSO"
78 .IR mh\-alias (5)
79 .SH DEFAULTS
80 .nf
81 .RB ` aliasfiles "' defaults to %etcdir%/MailAliases"
82 .RB ` \-nolist '
83 .RB ` \-nonormalize '
84 .RB ` \-nouser '
85 .fi
86 .SH CONTEXT
87 None
88 .SH BUGS
89 The
90 .B \-user
91 option with
92 .B \-nonormalize
93 is not entirely accurate, as it
94 does not replace local nicknames for hosts with their official site names.