.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" 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 .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . 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 .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "NMS2DLF.IN 1" .TH NMS2DLF.IN 1 "2020-07-07" "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" nms2dlf \- convert Netscape Messaging Server SMTP log files to the email DLF .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBnms2dlf\fR \s-1STDIN STDOUT\s0 .SH "DESCRIPTION" .IX Header "DESCRIPTION" This program converts Netscape Messaging Server log file generated by the \s-1SMTP\s0 service to the email \s-1DLF.\s0 .PP To process correctly the log file, you need to turn on logging of the following modules: .PP .Vb 4 \& \- SMTP\-Accept \& \- SMTP\-Deliver \& \- Error\-Handler \& \- Mailbox\-Deliver (Need to be enabled) .Ve .SH "LIMITATIONS" .IX Header "LIMITATIONS" This \s-1DLF\s0 converter was developed for the Netscape Messaging Server version 4.1. 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 Netscape Messaging Server at the following \s-1URL:\s0 .PP .Vb 1 \& http://developer.netscape.com/docs/manuals/messaging/41/ag/logging.htm .Ve .PP Not all messages are documented. And we found errors in the documentation. The fields msgID and mailFrom are inversed in both SMTP-Accept and SMTP-Deliver from what described the documentation. .SS "\s-1CONFIGURING LOGGING OF\s0 MAILBOX-DELIVER \s-1MODULE\s0" .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 Netscape Messaging Server 4 \s-1MTA\s0 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/usr/netscape/server4/msg\-mymailserver\fR .IP "4." 4 Do: .Sp .Vb 2 \& $ ./configutil \-o service.smtp.mailbox\-deliver.log \-v yes \& OK SET .Ve .IP "5." 4 Then become root, go again to your instance directory like: \&\fI/usr/netscape/server4/msg\-mymailserver\fR and do: .Sp .Vb 2 \& # ./stop\-msg smtp \& /usr/netscape/server4: Stopping SMTP daemon 16279 .... done: 16279 \& \& # ./start\-msg smtp \& /usr/netscape/server4: Starting SMTP daemon ..... done: 10820 .Ve .PP And then you will start seeing lines which will look like the following: .PP .Vb 7 \& [19/Jul/2002:08:31:54 +0200] amail2 smtpd[10820]: \e \& General Notice: SMTP\-Accept:GZHGT501.C01:<200207190632.g6J6W7Y01389@\e \& esmtp.orangemail.ch>:[192.168.30.2]:192.168.30.2: \e \& :19514:1: \& [19/Jul/2002:08:31:54 +0200] amail2 smtpd[10820]: General Notice: \e \& Mailbox\-Deliver:GZHGT501.C01:<200207190632.g6J6W7Y01389@\e \& esmtp.orangemail.ch>:19516:1:hmarmy; .Ve .PP If this was not done the line with the pattern Mailbox-Deliver above will not be present and the program will give wrong results. A warning will be output in the error log. .SH "EXAMPLES" .IX Header "EXAMPLES" To process a log as produced by Netscape Messaging Server .PP .Vb 1 \& $ nms2dlf < mail.log .Ve .PP nms2dlf 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 nms2dlf.in,v 1.10 2006/07/23 13:16:34 vanbaal Exp $ .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright (C) 2002 Stichting LogReport Foundation Copyright (C) 2002 Arnaud Taddei Copyright (C) 2002 Arnaud Gaillard .PP This program is free software; you can redistribute it and/or modify it under the terms of the \s-1GNU\s0 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 \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of \&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0 See the \&\s-1GNU\s0 General Public License for more details. .PP You should have received a copy of the \s-1GNU\s0 General Public License along with this program (see \s-1COPYING\s0); if not, check with http://www.gnu.org/copyleft/gpl.html. .SH "AUTHORS" .IX Header "AUTHORS" Francis J. Lacoste , Arnaud Taddei and Arnaud Gaillard