diplodocus.org Git - nmh/blob - man/ali.man

   1 .TH ALI %manext1% "March 21, 2013" "%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 Alias files are looked up in multiple locations: if the pathname is
  63 absolute or starts with
  64 .RI \*(lq . \*(rq
  65 or
  66 .RI \*(lq .. \*(rq
  67 then it's accessed directly; otherwise tilde expansion is done on
  68 usernames, then files are searched for in the user's
  69 .I Mail
  70 directory as specified in their profile.  If not found there, the directory
  71 .RI \*(lq %etcdir% \*(rq
  72 is checked.
  73 .PP
  74 .TP 20
  75 $HOME/.mh\-profile
  76 The user's profile.
  77 .SH "PROFILE COMPONENTS"
  78 .PP
  79 .PD 0
  80 .TP 20
  81 Path:
  82 To determine the user's nmh directory
  83 .TP
  84 Aliasfile:
  85 For a default alias file
  86 .PD
  87 .SH "SEE ALSO"
  88 .IR mh\-alias (5)
  89 .SH DEFAULTS
  90 .PD 0
  91 .TP 20
  92 aliasfile
  93 %etcdir%/MailAliases
  94 .TP
  95 \-nolist
  96 .TP
  97 \-nonormalize
  98 .TP
  99 \-nouser
 100 .PD
 101 .SH CONTEXT
 102 None
 103 .SH BUGS
 104 The
 105 .B \-user
 106 option with
 107 .B \-nonormalize
 108 is not entirely accurate, as it
 109 does not replace local nicknames for hosts with their official site names.