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

   1 .TH ALI %manext1% "December 13, 2016" "%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 [ \-help ]
  12 .RB [ \-version ]
  13 .RB [ \-alias
  14 .IR aliasfile ]
  15 .RB [ \-list " | " \-nolist ]
  16 .RB [ \-user " | " \-nouser ]
  17 .RI [ aliases " ...]"
  18 .ad
  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 alias 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 switch is specified, and an address expands to multiple
  33 addresses, each address will appear on a separate line.
  34 .PP
  35 The
  36 .B \-user
  37 switch 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.
  45 .PP
  46 The files specified by the profile entry
  47 .RI \*(lq Aliasfile \*(rq
  48 and any additional alias files given by the
  49 .B \-alias
  50 .I aliasfile
  51 switch will be read.  Each
  52 .I alias
  53 is processed as described in
  54 .IR mh\-alias (5).
  55 .SH FILES
  56 Alias files are looked up in multiple locations: if the pathname is
  57 absolute or starts with
  58 .RI \*(lq . \*(rq
  59 or
  60 .RI \*(lq .. \*(rq
  61 it is accessed directly; otherwise tilde expansion is done on
  62 usernames, then files are searched for in the user's
  63 .I Mail
  64 directory as specified in their profile.  If not found there, the directory
  65 .RI \*(lq %nmhetcdir% \*(rq
  66 is checked.
  67 .PP
  68 .TP 20
  69 $HOME/.mh_profile
  70 The user's profile.
  71 .SH "PROFILE COMPONENTS"
  72 .PP
  73 .PD 0
  74 .TP 20
  75 Path:
  76 To determine the user's nmh directory
  77 .TP
  78 Aliasfile:
  79 For a default alias file
  80 .PD
  81 .SH "SEE ALSO"
  82 .IR mh\-alias (5)
  83 .SH DEFAULTS
  84 .PD 0
  85 .TP 20
  86 aliasfile
  87 %nmhetcdir%/MailAliases
  88 .TP
  89 \-nolist
  90 .TP
  91 \-nouser
  92 .PD
  93 .SH CONTEXT
  94 None