NAME
argomail2dlf - converts ArGoSoft Mail Server log files to the email DLF
format
SYNOPSIS
argomail2dlf
DESCRIPTION
argomail2dlf converts a ArGoSoft Mail Server log file to email DLF
format. Information on the ArGoSoft Mail Server can be found on
http://www.argosoft.com/applications/mailserver/. The generic email DLF
format is described in email.xml.
This DLF converter was developed and tested with the ArGoSoft Mail
Server Pro. It could work with the Free and Plus versions, but it
wasn’t tested.
LOGGING CONFIGURATION
To operate properly with Lire, you have to make sure that the following
logging features are enabled:
- Log SMTP commands.
- Log SMTP conversations.
- Log to File.
The other two options (Log POP Commands and Log Web Commands) aren’t
needed and can be left unchecked.
LIMITATIONS
Due to the limitations in the logging system of ArGoSoft Mail Server,
the following information isn’t available:
- size of messages
- message's ID
Also, since ArGoSoft doesn’t log "queue identifier" (that is an
identifier that can be used to track the delivery of a message across
the different components), we have to rely on heuristics and assumed
invariants to track the messages. We use the sender and recipient
addresses to track the messages.
Delivery in order
We assume that ArGoSoft Mail Server will deliver its messages in
the order it received them.
One recipient delivery
We assume that ArGoSoft Mail Server will only deliver to one
recipient at a time. That is that if a message was adressed to two
recipients to the same remote demain, it will use two connections
to deliver this message.
Local delivery happens immediately
We assume that local delivery (and forward) will happen right after
the 354 or 250 status code is logged. We have to rely on this,
because the log messages related to forwarding don’t mention the
sender.
Unknown messages were delivered through the web
Messages that are delivered but weren’t sent through SMTP are
presumed to come from the webmail relay (sent through the web
interface). They could also have been sent before the start of the
log file.
EXAMPLES
To process a log as produced by argomail
$ argomail2dlf < mail.log
argomail2dlf will be rarely used on its own, but is more likely called
by lr_log2report:
$ lr_log2report argomail < /var/log/mail.log
SEE ALSO
exim2dlf(1), postfix2dlf(1), sendmail2dlf(1), qmail2dlf(1)
VERSION
$Id: argomail2dlf.in,v 1.10 2006/07/23 13:16:34 vanbaal Exp $
COPYRIGHT
Copyright (C) 2000, 2001 Stichting LogReport Foundation
LogReport@LogReport.org
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License along
with this program (see COPYING); if not, check with
http://www.gnu.org/copyleft/gpl.html.
CREDITS
We would like to thanks denon from denon.cx for contributing sample log
files and helping debug this DLF converter.
AUTHOR
Francis J. Lacoste <flacoste@logreport.org>