Initial revision
[mmh] / man / ali.man
1 .\"
2 .\" %nmhwarning%
3 .\" $Id$
4 .\"
5 .\" include the -mh macro file
6 .so %etcdir%/tmac.h
7 .\"
8 .TH ALI %manext1% MH.6.8 [%nmhversion%]
9 .SH NAME
10 ali \- list mail aliases
11 .SH SYNOPSIS
12 .in +.5i
13 .ti -.5i
14 ali
15 \%[\-alias\ aliasfile]
16 \%[\-list] \%[\-nolist]
17 \%[\-normalize]
18 .br
19 \%[\-nonormalize]
20 \%[\-user] \%[\-nouser]
21 \%[aliases\ ...]
22 .br
23 \%[\-version]
24 \%[\-help] 
25 .in -.5i
26 .SH DESCRIPTION
27 \fIAli\fR searches the named mail alias files for each of the given
28 \fIaliases\fR.  It creates a list of addresses for those \fIaliases\fR,
29 and writes that list on standard output.  If no arguments are given,
30 \fIali\fR outputs all alias entries.
31
32 By default, when an aliases expands to multiple addresses, the addresses
33 are separated by commas and printed on as few lines as possible.  If the
34 `\-list' option is specified, then when an address expands to multiple
35 addresses, each address will appear on a separate line.
36
37 The switch `\-user' directs \fIali\fR to perform its processing in
38 an inverted fashion: instead of listing the addresses that each given
39 alias expands to, \fIali\fR will list the aliases that expand to each
40 given address.  If the `\-normalize' switch is given, \fIali\fR will
41 try to track down the official hostname of the address.
42
43 The files specified by the profile entry \*(lqAliasfile:\*(rq and any
44 additional alias files given by the `\-alias aliasfile' switch will be
45 read.  Each \fIalias\fR is processed as described in \fImh\-alias\fR\0(5).
46 .Fi
47 ^$HOME/\&.mh\(ruprofile~^The user profile
48 ^/etc/passwd~^List of users
49 ^/etc/group~^List of groups
50 .Pr
51 ^Path:~^To determine the user's nmh directory
52 .Ps
53 ^Aliasfile:~^For a default alias file
54 .Sa
55 mh\-alias(5)
56 .De
57 `\-alias %etcdir%/MailAliases'
58 .Ds
59 `\-nolist'
60 .Ds
61 `\-nonormalize'
62 .Ds
63 `\-nouser'
64 .Co
65 None
66 .Bu
67 The `\-user' option with `\-nonormalize' is not entirely accurate, as it
68 does not replace local nicknames for hosts with their official site names.
69 .En