HOME

matchup(1)                  General Commands Manual                 matchup(1)



NAME
       matchup - collect information on messages and deliveries

SYNTAX
       matchup

DESCRIPTION
       matchup  reads  a series of lines from qmail-send, with a numeric time-
       stamp 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;  it  replaces  qmail-send's  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 matchup:

          <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.

MESSAGE LINES
       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

       Here birth and 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 message's return  path,  qp  is  the  message's
       long-term  queue  identifier,  and  uid  is the userid of the user that
       queued the message.

       Note that matchup converts sender to lowercase.  This can lose informa-
       tion, since a few hosts pay attention to the case in the box part of an
       address.

DELIVERY LINES
       A delivery line shows the result of a single delivery attempt:

          d result birth dstart ddone bytes
          <sender> chan.recip qp uid reason

       Here birth, bytes, sender, qp,  and  uid  are  message  information  as
       above;  chan  is  the channel for this delivery; recip is the recipient
       address for this delivery; dstart and ddone are timestamps;  result  is
       the  letter k for success, z for deferral, d for failure; and reason is
       a more detailed explanation of the delivery result.

       matchup converts recip to lowercase.

SEE ALSO
       xqp(1), xrecipient(1), xsender(1), accustamp(1),  qmail-log(5),  splog-
       ger(8)



                                                                    matchup(1)