.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "ARGOMAIL2DLF.IN 1" .TH ARGOMAIL2DLF.IN 1 2025-09-28 "Lire 2.1.1" "LogReport's Lire Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NAME argomail2dlf \- converts ArGoSoft Mail Server log files to the email DLF format .SH SYNOPSIS .IX Header "SYNOPSIS" \&\fBargomail2dlf\fR .SH DESCRIPTION .IX Header "DESCRIPTION" \&\fBargomail2dlf\fR 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. .PP 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\*(Aqt tested. .SH "LOGGING CONFIGURATION" .IX Header "LOGGING CONFIGURATION" To operate properly with Lire, you have to make sure that the following logging features are enabled: .PP .Vb 3 \& \- Log SMTP commands. \& \- Log SMTP conversations. \& \- Log to File. .Ve .PP The other two options (Log POP Commands and Log Web Commands) aren\*(Aqt needed and can be left unchecked. .SH LIMITATIONS .IX Header "LIMITATIONS" Due to the limitations in the logging system of ArGoSoft Mail Server, the following information isn\*(Aqt available: .PP .Vb 2 \& \- size of messages \& \- message\*(Aqs ID .Ve .PP Also, since ArGoSoft doesn\*(Aqt 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. .IP "Delivery in order" 4 .IX Item "Delivery in order" We assume that ArGoSoft Mail Server will deliver its messages in the order it received them. .IP "One recipient delivery" 4 .IX Item "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. .IP "Local delivery happens immediately" 4 .IX Item "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\*(Aqt mention the sender. .IP "Unknown messages were delivered through the web" 4 .IX Item "Unknown messages were delivered through the web" Messages that are delivered but weren\*(Aqt 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. .SH EXAMPLES .IX Header "EXAMPLES" To process a log as produced by argomail .PP .Vb 1 \& $ argomail2dlf < mail.log .Ve .PP argomail2dlf will be rarely used on its own, but is more likely called by lr_log2report: .PP .Vb 1 \& $ lr_log2report argomail < /var/log/mail.log .Ve .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBexim2dlf\fR\|(1), \fBpostfix2dlf\fR\|(1), \fBsendmail2dlf\fR\|(1), \fBqmail2dlf\fR\|(1) .SH VERSION .IX Header "VERSION" \&\f(CW$Id:\fR argomail2dlf.in,v 1.10 2006/07/23 13:16:34 vanbaal Exp $ .SH COPYRIGHT .IX Header "COPYRIGHT" Copyright (C) 2000, 2001 Stichting LogReport Foundation LogReport@LogReport.org .PP 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. .PP 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. .PP 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. .SH CREDITS .IX Header "CREDITS" We would like to thanks denon from denon.cx for contributing sample log files and helping debug this DLF converter. .SH AUTHOR .IX Header "AUTHOR" Francis J. Lacoste