contrib/sendmail-8.14/sendmail/aliases.5

   1 .\" Copyright (c) 1998-2000 Sendmail, Inc. and its suppliers.
   2 .\"      All rights reserved.
   3 .\" Copyright (c) 1983, 1997 Eric P. Allman.  All rights reserved.
   4 .\" Copyright (c) 1985, 1991, 1993
   5 .\"     The Regents of the University of California.  All rights reserved.
   6 .\"
   7 .\" By using this file, you agree to the terms and conditions set
   8 .\" forth in the LICENSE file which can be found at the top level of
   9 .\" the sendmail distribution.
  10 .\"
  11 .\"
  12 .\"     $Id: aliases.5,v 8.19 2004/07/12 05:39:21 ca Exp $
  13 .\"
  14 .TH ALIASES 5 "$Date: 2004/07/12 05:39:21 $"
  15 .SH NAME
  16 aliases
  17 \- aliases file for sendmail
  18 .SH SYNOPSIS
  19 .B aliases
  20 .SH DESCRIPTION
  21 This file describes user
  22 ID
  23 aliases used by
  24 sendmail.
  25 The file resides in
  26 /etc/mail
  27 and
  28 is formatted as a series of lines of the form
  29 .IP
  30 name: addr_1, addr_2, addr_3, . . .
  31 .PP
  32 The
  33 .I name
  34 is the name to alias, and the
  35 .I addr_n
  36 are the aliases for that name.
  37 .I addr_n
  38 can be another alias, a local username, a local filename,
  39 a command,
  40 an include file,
  41 or an external address.
  42 .TP
  43 .B Local Username
  44 username
  45 .IP
  46 The username must be available via getpwnam(3).
  47 .TP
  48 .B Local Filename
  49 /path/name
  50 .IP
  51 Messages are appended to the file specified by the full pathname
  52 (starting with a slash (/))
  53 .TP
  54 .B Command
  55 |command
  56 .IP
  57 A command starts with a pipe symbol (|),
  58 it receives messages via standard input.
  59 .TP
  60 .B Include File
  61 :include: /path/name
  62 .IP
  63 The aliases in pathname are added to the aliases for
  64 .I name.
  65 .TP
  66 .B E-Mail Address
  67 user@domain
  68 .IP
  69 An e-mail address in RFC 822 format.
  70 .PP
  71 Lines beginning with white space are continuation lines.
  72 Another way to continue lines is by placing a backslash
  73 directly before a newline.
  74 Lines beginning with
  75 #
  76 are comments.
  77 .PP
  78 Aliasing occurs only on local names.
  79 Loops can not occur, since no message will be sent to any person more than once.
  80 .PP
  81 If an alias is found for
  82 .IR name ,
  83 sendmail then checks for an alias for
  84 .IR owner-name .
  85 If it is found and the result of the lookup expands to a single
  86 address, the envelope sender address of the message is rewritten to
  87 that address.
  88 If it is found and the result expands to more than one address, the
  89 envelope sender address is changed to
  90 .IR owner-name .
  91 .PP
  92 After aliasing has been done, local and valid recipients who have a
  93 ``.forward''
  94 file in their home directory have messages forwarded to the
  95 list of users defined in that file.
  96 .PP
  97 This is only the raw data file; the actual aliasing information is
  98 placed into a binary format in the file
  99 /etc/mail/aliases.db
 100 using the program
 101 newaliases(1).
 102 A
 103 newaliases
 104 command should be executed each time the aliases file is changed for the
 105 change to take effect.
 106 .SH SEE  ALSO
 107 newaliases(1),
 108 dbm(3),
 109 dbopen(3),
 110 db_open(3),
 111 sendmail(8)
 112 .PP
 113 .I
 114 SENDMAIL Installation and Operation Guide.
 115 .PP
 116 .I
 117 SENDMAIL An Internetwork Mail Router.
 118 .SH BUGS
 119 If you have compiled
 120 sendmail
 121 with DBM support instead of NEWDB,
 122 you may have encountered problems in
 123 dbm(3)
 124 restricting a single alias to about 1000 bytes of information.
 125 You can get longer aliases by ``chaining''; that is, make the last name in
 126 the alias be a dummy name which is a continuation alias.
 127 .SH HISTORY
 128 The
 129 .B aliases
 130 file format appeared in
 131 4.0BSD.