git.marmaro.de Git - mmh/blob - 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.