GreenArrow Email Software Documentation

Local Delivery Attempt Status Messages

Success Status Messages

When hvmail_report reports on a delivery to a local user, it appends an extra bit of information beginning with “did” to the end of its output. Here’s an example:

2017-06-07 13:18:48.299293500 success <return@example> mtaid=<> sendid=<> outmtaid=<>: did 0+0+1/

Here’s the section that contains the extra info:

did 0+0+1

The three numbers in this extra output tell us how many messages were delivered to a local Maildir, forwarded to another email address, and processed by a program, respectively.

In other words for the example log entry above, there were:

  • 0 deliveries to a Maildir (the first number)
  • 0 forwards to another email address (the second number)
  • 1 forward to a program which processed the message (the third number)

The did 0+0+1 message may be suffixed with bounce fast-path, bounce lite-path, or fbl lite-path. This indicates the message was passed to one of the bounce processors for further processing.

Deferral and Failure Status Messages

Most local deliveries will include the did N+N+N status message as described above. There are however other messages that can be reported if something goes wrong.

Type of error Error message
Deferral qmail-lspawn cannot parse mqpos (#5.3.5)
Deferral qmail-lspawn unable to open message. (#4.3.0)
Deferral qmail-lspawn unable to read message. (#4.3.0)
Deferral qmail-lspawn will not follow symlinks to message file. (#4.3.0)
Deferral qmail-lspawn unable to parse message. (#4.3.0)
Deferral qmail-local crashed.
Deferral Trouble reading users/cdb in qmail-lspawn.
Deferral Out of memory in qmail-lspawn.
Deferral Temporary failure in qmail-lspawn.
Deferral Unable to find alias user!
Deferral Not allowed to perform deliveries as root.
Deferral Internal qmail-lspawn bug.
Deferral NFS failure in qmail-local.
Deferral Unable to run qmail-local.
Deferral Unable to run qmail-getpw.
Deferral Unable to open temporary message file.
Deferral Unable to write temporary message file.
Deferral Unable to seek in temporary message file.
Deferral Internal error: messid has nonnumerics. (#5.3.5)
Deferral Internal error: messid too long. (#5.3.5)
Deferral Internal error: messid too short. (#5.3.5)
Deferral Cannot connect to Redis for bounce fast-path.
Deferral Encountered error while waiting for Redis bounce fast-path queue space.
Deferral Encountered error while inserting message into Redis bounce fast-path.
Deferral Deliveries to this domain deferred by configuration.
Deferral error on bounce lite-path: redis unavailable (#4.3.0)
Deferral error on bounce lite-path: error when encoding json: {ERROR} (#4.3.0)
Deferral error on bounce lite-path: error waiting for queue space: {ERROR} (#4.3.0)
Deferral error on bounce lite-path: {ERROR} (#4.3.0)
Deferral error on fbl lite-path: redis unavailable (#4.3.0)
Deferral error on fbl lite-path: error when encoding json: {ERROR} (#4.3.0)
Deferral error on fbl lite-path: error waiting for queue space: {ERROR} (#4.3.0)
Deferral error on fbl lite-path: {ERROR} (#4.3.0)
Failure Sorry, address must include host name. (#5.1.3)
Failure Unable to run qmail-local.

Copyright © 2012–2024 GreenArrow Email