mdw@git.distorted.org.uk Git - fastforward/blob - fastforward.1

   1 .TH fastforward 1
   2 .SH NAME
   3 fastforward \- forward mail according to a cdb database
   4 .SH SYNOPSIS
   5 in
   6 .BR .qmail-default :
   7 .B | fastforward
   8 [
   9 .B \-nNpPdD
  10 ]
  11 .I cdb
  12 .SH DESCRIPTION
  13 .B fastforward
  14 forwards each incoming message
  15 according to instructions in
  16 .I cdb
  17 created by
  18 .BR setforward .
  19
  20 If there is no forwarding instruction in
  21 .I cdb
  22 for the incoming recipient address,
  23 .B fastforward
  24 will bounce the message.
  25
  26 You can override
  27 .B .qmail-default
  28 with a specific
  29 .BR .qmail-\fIrecipient ;
  30 see
  31 .BR dot-qmail (5).
  32
  33 Warning to system administrators:
  34 Messages do not reach
  35 .B ~alias/.qmail-default
  36 unless they are controlled by the
  37 .B alias
  38 user.
  39 See
  40 .BR qmail-getpw (8).
  41
  42 .B SECURITY WARNING:
  43 If
  44 .I cdb
  45 includes instructions pointing to a mailing list owned by another user,
  46 that user gains some amount of control over
  47 .BR fastforward 's
  48 behavior.
  49 In particular, he can force
  50 .B fastforward
  51 to open any file that you can access,
  52 and to read any world-readable file that you own,
  53 even if the file is in a world-inaccessible directory.
  54 .SH "OPTIONS"
  55 .TP 5
  56 .B \-n
  57 No delivery.
  58 .B fastforward
  59 will print a description of its actions,
  60 but will not actually read or forward a message.
  61 .TP
  62 .B \-N
  63 (Default.)
  64 Forward a message as usual.
  65 .TP
  66 .B \-p
  67 Pass through.
  68 If
  69 .B fastforward
  70 does not find the recipient in
  71 .IR cdb ,
  72 it exits 0,
  73 giving the message to further commands in
  74 .BR .qmail-default .
  75 If
  76 .B fastforward
  77 finds the recipient,
  78 it forwards the message and exits 99,
  79 so that further commands are skipped.
  80 .TP
  81 .B \-P
  82 (Default.)
  83 Do not pass through.
  84 If
  85 .B fastforward
  86 finds the recipient,
  87 it forwards the message and exits 0.
  88 Otherwise it bounces the message.
  89 .TP
  90 .B \-d
  91 Use
  92 .B $DEFAULT@$HOST
  93 as the recipient address, or
  94 .B $EXT@$HOST
  95 if
  96 .B $DEFAULT
  97 is not set.
  98 .TP
  99 .B \-D
 100 (Default.)
 101 Use
 102 .B $RECIPIENT
 103 as the recipient address.
 104 .SH VERSION
 105 This is
 106 .B fastforward
 107 0.51.
 108 The
 109 .B fastforward
 110 home page is
 111 .BR http://pobox.com/~djb/fastforward.html .
 112 .SH "SEE ALSO"
 113 newaliases(1),
 114 printforward(1),
 115 setforward(1),
 116 dot-qmail(5),
 117 qmail-command(8),
 118 qmail-local(8),
 119 qmail-getpw(8)