.\" -*- 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 "S1MS2DLF.IN 1"
.TH S1MS2DLF.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
s1ms2dlf \- convert SunONE Messaging Server SMTP log files to the email DLF
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBnms2dlf\fR
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This program converts a SunONE Messaging Server log file generated by the SMTP
service to the Lire email DLF.  The log file is expected on stdin, the DLF file
is printed to stdout.
.PP
In order to correctly process the log file, you need to turn on logging of the
following channels:
.PP
.Vb 1
\& FIXME
.Ve
.SH LIMITATIONS
.IX Header "LIMITATIONS"
This DLF converter was developed for the SunONE Messaging Server
version 5.2. Other versions may or may not work. Contact the LogReport
developers if you have problems with that converter.
.PP
You can find information about the log format used by SunONE
Messaging Server at the following URL:
.PP
.Vb 1
\&    http://docs.sun.com/source/816\-6009\-10/logging.htm
.Ve
.SS "CONFIGURING LOGGING OF MAILBOX\-DELIVER MODULE"
.IX Subsection "CONFIGURING LOGGING OF MAILBOX-DELIVER MODULE"
We found that there are no logs from the Mailbox\-Delivery module by
default. In order to fix that problem please make sure you do the
following:
.IP 1. 4
Go on the SunONE Messaging Server MTA or Message Store
.IP 2. 4
Become the Mail Server user (usually this should not be root but
typically a user like mailsrv or whatever was defined at installation
time, check for the ownership of the files in your message server
instance for example)
.IP 3. 4
Go to the right location, something like: \fIserver\-root\fR/msg\-instance
.Sp
For example it could be: \fI/opt/sunone/s1ms5/msg\-mymailserver\fR
.IP 4. 4
Do:
.Sp
.Vb 1
\& TO BE WRITTEN
.Ve
.SH EXAMPLES
.IX Header "EXAMPLES"
To process a log as produced by Netscape Messaging Server
.PP
.Vb 1
\& $ s1ms2dlf < mail.log
.Ve
.PP
s1ms2dlf will be rarely used on its own, but is more likely
called by lr_log2report:
.PP
.Vb 1
\& $ lr_log2report nms < /var/log/mail.log
.Ve
.SH VERSION
.IX Header "VERSION"
\&\f(CW$Id:\fR s1ms2dlf.in,v 1.5 2006/07/23 13:16:34 vanbaal Exp $
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2002 Stichting LogReport Foundation <logreport@LogReport.org>
Copyright (C) 2002 Arnaud Taddei
Copyright (C) 2002, 2003 Arnaud Gaillard
Copyright (C) 2002, 2003 Jean\-Yves Monnier
.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 AUTHORS
.IX Header "AUTHORS"
Francis J. Lacoste <flacoste@logreport.org>,
Arnaud Taddei <Arnaud.Taddei@sun.com>,
Arnaud Gaillard <arnaud.gaillard@orange.ch> and
Jean\-Yves Monnier <jean\-yves.monnier@sun.com>