share/man/man5/forward.5

   1 .\"     $OpenBSD: forward.5,v 1.10 2012/08/12 17:01:35 schwarze Exp $
   2 .\"
   3 .\"     Copyright (c) 2001 Marco S. Hyman
   4 .\"
   5 .\"     Permission to copy all or part of this material with or without
   6 .\"     modification for any purpose is granted provided that the above
   7 .\"     copyright notice and this paragraph are duplicated in all copies.
   8 .\"
   9 .\"     THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
  10 .\"     IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
  11 .\"     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  12 .\"
  13 .Dd $Mdocdate: August 12 2012 $
  14 .Dt FORWARD 5
  15 .Os
  16 .Sh NAME
  17 .Nm forward
  18 .Nd e-mail forwarding information file
  19 .Sh DESCRIPTION
  20 Users may put a file named
  21 .Pa .forward
  22 in their home directory.
  23 If this file exists,
  24 .Xr sendmail 8
  25 (and sendmail-like mailers) will redirect mail for the user to the list of
  26 addresses found in the
  27 .Pa .forward
  28 file.
  29 .Pp
  30 A
  31 .Pa .forward
  32 file contains one or more lines where each line is an e-mail address
  33 or the name of a private incoming mailer where incoming mail will be
  34 forwarded.
  35 Multiple entries may be specified on one line, comma separated.
  36 Additionally, a copy of all mail may be retained
  37 on the local machine using a
  38 .Dq \euser
  39 entry.
  40 .Pp
  41 .Pa .forward
  42 files must not be group or world writable.
  43 The user's home directory should not be group writable.
  44 The
  45 .Pa .forward
  46 file must be owned by and readable by the indicated user.
  47 .Sh FILES
  48 .Bl -tag -width $HOME/.forward -compact
  49 .It Pa $HOME/.forward
  50 e-mail forwarding information
  51 .El
  52 .Sh EXAMPLES
  53 .Bd -literal -offset indent
  54 # lines with # in the first column are ignored
  55 # empty lines are ignored
  56 # #@# with whitespace on both sides may be used to start a comment
  57
  58 foo@bar.baz.com, \euser                 #@# is a comment anywhere
  59 "| /usr/local/libexec/slocal -user foo"
  60 .Ed
  61 .Sh SEE ALSO
  62 .Xr aliases 5 ,
  63 .Xr sendmail 8
  64 .Pp
  65 .Lk http://www.sendmail.org/