nightmaremail

Unnamed repository; edit this file 'description' to name the repository.
Log | Files | Refs

qmail-queue.8 (3557B)


      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 should 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 
     44 Programs included with qmail which invoke
     45 .B qmail-queue
     46 will invoke the contents of
     47 .B $QMAILQUEUE
     48 instead, if that environment variable is set.
     49 .SH "FILESYSTEM RESTRICTIONS"
     50 .B qmail-queue
     51 imposes two constraints on the queue structure:
     52 each
     53 .B mess
     54 subdirectory must be in the same filesystem as the
     55 .B pid
     56 directory; and each
     57 .B todo
     58 subdirectory must be in the same filesystem as the
     59 .B intd
     60 directory.
     61 .SH "EXIT CODES"
     62 .B qmail-queue
     63 does not print diagnostics.
     64 It exits
     65 0 if
     66 it has successfully queued the message.
     67 It exits between 1 and 99 if
     68 it has failed to queue the message.
     69 
     70 All
     71 .B qmail-queue
     72 error codes between 11 and 40
     73 indicate permanent errors:
     74 .TP 5
     75 .B 11
     76 Address too long.
     77 .TP
     78 .B 31
     79 Mail server permanently refuses to send the message to any recipients.
     80 (Not used by
     81 .BR qmail-queue ,
     82 but can be used by programs offering the same interface.)
     83 .PP
     84 A special
     85 .B qmail-queue
     86 error code indicates a custom error string is written to descriptor 6:
     87 .TP 5
     88 .B 82
     89 Mail server refuses to send the message to any recipients:
     90 permanently for strings starting with "D",
     91 temporarily for strings starting with "Z".
     92 (Not used by
     93 .BR qmail-queue ,
     94 but can be used by programs offering the same interface.)
     95 .PP
     96 All other
     97 .B qmail-queue
     98 error codes indicate temporary errors:
     99 .TP 5
    100 .B 51
    101 Out of memory.
    102 .TP
    103 .B 52
    104 Timeout.
    105 .TP
    106 .B 53
    107 Write error; e.g., disk full.
    108 .TP
    109 .B 54
    110 Unable to read the message or envelope.
    111 .TP
    112 .B 55
    113 Unable to read a configuration file.
    114 (Not used by
    115 .BR qmail-queue .)
    116 .TP
    117 .B 56
    118 Problem making a network connection from this host.
    119 (Not used by
    120 .BR qmail-queue .)
    121 .TP
    122 .B 61
    123 Problem with the qmail home directory.
    124 .TP
    125 .B 62
    126 Problem with the queue directory.
    127 .TP
    128 .B 63
    129 Problem with queue/pid.
    130 .TP
    131 .B 64
    132 Problem with queue/mess.
    133 .TP
    134 .B 65
    135 Problem with queue/intd.
    136 .TP
    137 .B 66
    138 Problem with queue/todo.
    139 .TP
    140 .B 71
    141 Mail server temporarily refuses to send the message to any recipients.
    142 (Not used by
    143 .BR qmail-queue .)
    144 .TP
    145 .B 72
    146 Connection to mail server timed out.
    147 (Not used by
    148 .BR qmail-queue .)
    149 .TP
    150 .B 73
    151 Connection to mail server rejected.
    152 (Not used by
    153 .BR qmail-queue .)
    154 .TP
    155 .B 74
    156 Connection to mail server succeeded,
    157 but communication failed.
    158 (Not used by
    159 .BR qmail-queue .)
    160 .TP
    161 .B 81
    162 Internal bug; e.g., segmentation fault.
    163 .TP
    164 .B 91
    165 Envelope format error.
    166 .SH "SEE ALSO"
    167 addresses(5),
    168 envelopes(5),
    169 qmail-header(5),
    170 qmail-inject(8),
    171 qmail-qmqpc(8),
    172 qmail-send(8),
    173 qmail-smtpd(8)