Manual Reference Pages - MATCHUP (1)
matchup - collect information on messages and deliveries
matchup reads a series of lines from
qmail-send, with a numeric timestamp in front of each line.
matchup matches the end of each delivery attempt with the start of the delivery attempt
and with the relevant message information;
qmail-sends message reports and delivery reports
with message lines and delivery lines in the format described below.
matchup exits after it sees end of file.
It prints pending messages and deliveries on descriptor 5,
in a format suitable for input to a future invocation of
<log.1 matchup >out.1 5>pending.2
cat pending.2 log.2 | matchup >out.2 5>pending.3
cat pending.3 log.3 | matchup >out.3 5>pending.4
Note that the 5> notation does not work with csh.
A message line summarizes the delivery results for a message
that has left the queue:
m birth done bytes nk nz nd <sender> qp uid
done are timestamps,
bytes is the number of bytes in the message,
nk is the number of successful deliveries,
nz is the number of deferred delivery attempts,
nd is the number of failed delivery attempts,
sender is the messages return path,
qp is the messages long-term queue identifier,
uid is the userid of the user that queued the message.
sender to lowercase.
This can lose information,
since a few hosts pay attention to the case in the box part of an address.
A delivery line shows the result of a single delivery attempt:
d result birth dstart ddone bytes
<sender> chan.recip qp uid reason
uid are message information as above;
chan is the channel for this delivery;
recip is the recipient address for this delivery;
ddone are timestamps;
result is the letter k for success, z for deferral, d for failure;
reason is a more detailed explanation of the delivery result.
recip to lowercase.
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.