Factor trim format function out
[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 [ \-file
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 If no
54 .B \-file
55 .I aliasfile
56 is given, then the default alias files, as specified by the profile entry
57 .RI ` Aliasfile ',
58 will be read.
59 If any alias files are given by
60 .B \-file
61 .I aliasfile
62 switches, these will be read instead of the default alias files.
63 Either the default alias files are read or the ones given at the
64 command line, never both.
65 .PP
66 Each
67 .I alias
68 is processed as described in
69 .BR mh\-alias (5).
70
71 .SH FILES
72 .fc ^ ~
73 .nf
74 .ta \w'%etcdir%/ExtraBigFileName  'u
75 ^$HOME/.mmh/profile~^The user profile
76 ^/etc/passwd~^List of users
77 ^/etc/group~^List of groups
78 .fi
79
80 .SH "PROFILE COMPONENTS"
81 .fc ^ ~
82 .nf
83 .ta 2.4i
84 .ta \w'ExtraBigProfileName  'u
85 ^Path:~^To determine the user's mail storage
86 ^Aliasfile:~^For default alias files
87 .fi
88
89 .SH "SEE ALSO"
90 mh\-alias(5)
91
92 .SH DEFAULTS
93 .nf
94 .RB ` \-nolist '
95 .RB ` \-nonormalize '
96 .RB ` \-nouser '
97 .fi
98
99 .SH CONTEXT
100 None
101
102 .SH BUGS
103 The
104 .B \-user
105 option with
106 .B \-nonormalize
107 is not entirely accurate, as it
108 does not replace local nicknames for hosts with their official site names.