mdw@git.distorted.org.uk Git - qmail/blob - qmail-queue.8

   1 .TH qmail-queue 8
   2 .SH NAME
   3 qmail-queue \- queue a mail message for delivery
   4 .SH SYNOPSIS
   5 .B qmail-queue
   6 .SH DESCRIPTION
   7 .B qmail-queue
   8 reads a mail message from descriptor 0.
   9 It then reads envelope information from descriptor 1.
  10 It places the message into the outgoing queue
  11 for future delivery by
  12 .BR qmail-send .
  13
  14 The envelope information is
  15 an envelope sender address
  16 followed by a list of envelope recipient addresses.
  17 The sender address is preceded by the letter F
  18 and terminated by a 0 byte.
  19 Each recipient address is preceded by the letter T
  20 and terminated by a 0 byte.
  21 The list of recipient addresses is terminated by an extra 0 byte.
  22 If
  23 .B qmail-queue
  24 sees end-of-file before the extra 0 byte,
  25 it aborts without placing the message into the queue.
  26
  27 Every envelope recipient address
  28 must contain a username,
  29 an @ sign,
  30 and a fully qualified domain name.
  31
  32 .B qmail-queue
  33 always adds a
  34 .B Received
  35 line to the top of the message.
  36 Other than this,
  37 .B qmail-queue
  38 does not inspect the message
  39 and does not enforce any restrictions on its contents.
  40 However, the recipients probably expect to see a proper header,
  41 as described in
  42 .BR qmail-header(5) .
  43 .SH "EXIT CODES"
  44 0 if
  45 .B qmail-queue
  46 has successfully queued the message,
  47 nonzero if
  48 .B qmail-queue
  49 has failed to queue the message.
  50 .B qmail-queue
  51 does not print diagnostics.
  52 .SH "SEE ALSO"
  53 addresses(5),
  54 envelopes(5),
  55 qmail-header(5),
  56 qmail-inject(8),
  57 qmail-send(8),
  58 qmail-smtpd(8)