chiark - git - mdw - qmail/blob - condredirect.1

   1 .TH condredirect 1
   2 .SH NAME
   3 condredirect \- perhaps redirect mail to another address
   4 .SH SYNOPSIS
   5 in
   6 .BR .qmail :
   7 .B |condredirect
   8 .I newaddress
   9 .I program
  10 [
  11 .I arg ...
  12 ]
  13 .SH DESCRIPTION
  14 .B condredirect
  15 feeds each new mail message to
  16 .I program
  17 with the given arguments.
  18 If
  19 .I program
  20 exits 0,
  21 .B condredirect
  22 forwards the mail message to
  23 .IR newaddress ,
  24 and then exits 99,
  25 so further commands in
  26 .B .qmail
  27 are ignored.
  28
  29 If
  30 .I program
  31 exits 111,
  32 .B condredirect
  33 exits 111,
  34 so delivery will be retried later.
  35
  36 If
  37 .I program
  38 exits anything else
  39 (or does not exist),
  40 .B condredirect
  41 exits 0,
  42 so the rest of
  43 .B .qmail
  44 will be processed as usual.
  45
  46 Note that
  47 it is not safe for
  48 .I program
  49 to fork a child that
  50 reads the message in the background.
  51
  52 .B WARNING:
  53 If you create a
  54 .B .qmail
  55 file to enable
  56 .BR condredirect ,
  57 make sure to also add a line specifying delivery to your normal mailbox.
  58 .SH "SEE ALSO"
  59 bouncesaying(1),
  60 except(1),
  61 dot-qmail(5),
  62 qmail-command(8),
  63 qmail-queue(8)