1 Starting with 1.1.3-2 the pflogsumm package no longer ships the
2 '.pl' compatibility symlinks. Thus for consistency we've to do some
3 s/pflogsumm.pl/pflogsumm/ all over the place.
4 Index: pflogsumm/pflogsumm-faq.txt
5 ===================================================================
6 --- pflogsumm.orig/pflogsumm-faq.txt 2012-02-06 10:09:17.000000000 +0100
7 +++ pflogsumm/pflogsumm-faq.txt 2012-02-06 10:18:17.679364712 +0100
10 -FAQ for Pflogsumm.pl - A Log Summarizer/Analyzer for the Postfix MTA
11 +FAQ for pflogsumm - A Log Summarizer/Analyzer for the Postfix MTA
16 hearted exercise in improving my facility with Perl--with the hope
17 that something useful would come out of it as well--has turned out to
18 be a somewhat popular utility. And as more Admins find out about
19 - postfix, and more end up trying pflogsumm.pl, many of the questions,
20 + postfix, and more end up trying pflogsumm, many of the questions,
21 suggestions, and enhancement requests are becoming "frequently
22 asked". So odd as it seems (to me, at any rate), it looks like it's
26 -Index of pflogsumm.pl Frequently Asked Questions (in no particular order)
27 +Index of pflogsumm Frequently Asked Questions (in no particular order)
30 2. "Could You Make" or "Here's A Patch To Make" Pflogsumm Do ...
32 "creeping over-feature-itis" if I can. My position is *not* set in
33 stone on this issue. In the mean-time:
35 - zcat /var/log/maillog.0.gz |pflogsumm.pl <args...>
36 + zcat /var/log/maillog.0.gz |pflogsumm <args...>
40 - gunzip </var/log/maillog.0.gz |pflogsumm.pl <args...>
41 + gunzip </var/log/maillog.0.gz |pflogsumm <args...>
43 should do the trick quite nicely for you.
46 exactly at midnight, you might try something like:
48 (zcat /var/log/maillog.0.gz; cat /var/log/maillog) \
49 - |pflogsumm.pl -d yesterday
50 + |pflogsumm -d yesterday
52 See Also: 5. Processing Multiple Log Files
53 17. How Do I Get Pflogsumm To Email Reports To Me
55 A more complex example, where compressed logs are involved:
57 (zcat `ls -rt /var/log/maillog.*.gz`; cat /var/log/maillog) \
61 Obviously, this depends on the file modification times for your logs
62 being reflective of their chronological order. If that can't be
64 (for each in 3 2 1 0; do
65 zcat "/var/log/maillog.$each.gz"
67 - cat /var/log/maillog) |pflogsumm.pl
68 + cat /var/log/maillog) |pflogsumm
70 or (somewhat more efficiently--by running zcat only once):
72 (zcat `for ea in 3 2 1 0; do echo "/var/log/maillog.$ea.gz";
73 - done`; cat /var/log/maillog) |pflogsumm.pl
74 + done`; cat /var/log/maillog) |pflogsumm
76 [Note: I didn't actually run these. So you would be well-advised
77 to double-check them.]
79 Message size is reported only by the queue manager. The message
80 may be delivered long-enough after the (last) qmgr log entry that
81 the information is not in the log(s) processed by a particular run
89 10. Pflogsumm misses/mis-diagnoses/mis-reports, etc. <whatever>
91 - Are you using a real old version of VMailer? As of pflogsumm.pl
92 + Are you using a real old version of VMailer? As of pflogsumm
93 version 19990220-06, versions of VMailer prior to 19981023 are no
94 longer supported. Sorry. Pflogsumm-19990121-01.pl will be made
95 permanently available from now on for those with out-of-date versions
97 Are you processing your log files in chronological order? See item
98 "5: "Processing Multiple Log Files".
100 - Pflogsumm.pl is being developed by me on my rather small-scale server
101 + pflogsumm is being developed by me on my rather small-scale server
102 at home. There are only two users on the system. And I do no
103 mail-forwarding. So the log samples I have to work with are
104 commensurately limited.
105 @@ -366,13 +366,13 @@
106 11. Pflogsumm is generating lots of "uninitialized value" warnings
108 Are you using a version of Perl lower than 5.004_04? Perhaps with a
109 - "beta" version of pflogsumm.pl? If so, try turning off the "-w"
110 + "beta" version of pflogsumm? If so, try turning off the "-w"
111 switch. Pflogsumm as of 19990413-02beta appeared to work correctly
112 with Perl 5.003 in spite of the warnings. (Those warnings didn't
113 appear with Perl 5.004.)
115 I don't guarantee that I'll remember to test future versions of
116 - pflogsumm.pl against 5.003, but I'll try to :-).
117 + pflogsumm against 5.003, but I'll try to :-).
119 You really should consider upgrading your Perl to 5.004 or later.
121 Index: pflogsumm/pflogsumm.1
122 ===================================================================
123 --- pflogsumm.orig/pflogsumm.1 2012-02-06 10:11:16.000000000 +0100
124 +++ pflogsumm/pflogsumm.1 2012-02-06 10:19:18.695363861 +0100
125 @@ -130,13 +130,13 @@
129 -pflogsumm.pl \- Produce Postfix MTA logfile summary
130 +pflogsumm \- Produce Postfix MTA logfile summary
132 Copyright (C) 1998\-2010 by James S. Seymour, Release 1.1.5
134 .IX Header "SYNOPSIS"
136 -\& pflogsumm.pl \-[eq] [\-d <today|yesterday>] [\-\-detail <cnt>]
137 +\& pflogsumm \-[eq] [\-d <today|yesterday>] [\-\-detail <cnt>]
138 \& [\-\-bounce\-detail <cnt>] [\-\-deferral\-detail <cnt>]
139 \& [\-h <cnt>] [\-i|\-\-ignore\-case] [\-\-iso\-date\-time] [\-\-mailq]
140 \& [\-m|\-\-uucp\-mung] [\-\-no\-no\-msg\-size] [\-\-problems\-first]
142 \& [\-\-syslog\-name=string] [\-u <cnt>] [\-\-verbose\-msg\-detail]
143 \& [\-\-verp\-mung[=<n>]] [\-\-zero\-fill] [file1 [filen]]
145 -\& pflogsumm.pl \-[help|version]
146 +\& pflogsumm \-[help|version]
148 \& If no file(s) specified, reads from stdin. Output is to stdout.
151 \& The message may be delivered long\-enough after the
152 \& (last) qmgr log entry that the information is not in
153 \& the log(s) processed by a particular run of
154 -\& pflogsumm.pl. This throws off "Recipients by message
155 +\& pflogsumm. This throws off "Recipients by message
156 \& size" and the total for "bytes delivered." These are
157 \& normally reported by pflogsumm as "Messages with no
159 @@ -386,15 +386,15 @@
161 \& Produce a report of previous day\*(Aqs activities:
163 -\& pflogsumm.pl \-d yesterday /var/log/maillog
164 +\& pflogsumm \-d yesterday /var/log/maillog
166 \& A report of prior week\*(Aqs activities (after logs rotated):
168 -\& pflogsumm.pl /var/log/maillog.0
169 +\& pflogsumm /var/log/maillog.0
171 \& What\*(Aqs happened so far today:
173 -\& pflogsumm.pl \-d today /var/log/maillog
174 +\& pflogsumm \-d today /var/log/maillog
176 \& Crontab entry to generate a report of the previous day\*(Aqs activity
177 \& at 10 minutes after midnight.
178 Index: pflogsumm/pflogsumm.pl
179 ===================================================================
180 --- pflogsumm.orig/pflogsumm.pl 2012-02-06 10:11:16.000000000 +0100
181 +++ pflogsumm/pflogsumm.pl 2012-02-06 10:19:00.459363575 +0100
186 -pflogsumm.pl - Produce Postfix MTA logfile summary
187 +pflogsumm - Produce Postfix MTA logfile summary
189 Copyright (C) 1998-2010 by James S. Seymour, Release 1.1.5
193 - pflogsumm.pl -[eq] [-d <today|yesterday>] [--detail <cnt>]
194 + pflogsumm -[eq] [-d <today|yesterday>] [--detail <cnt>]
195 [--bounce-detail <cnt>] [--deferral-detail <cnt>]
196 [-h <cnt>] [-i|--ignore-case] [--iso-date-time] [--mailq]
197 [-m|--uucp-mung] [--no-no-msg-size] [--problems-first]
199 [--syslog-name=string] [-u <cnt>] [--verbose-msg-detail]
200 [--verp-mung[=<n>]] [--zero-fill] [file1 [filen]]
202 - pflogsumm.pl -[help|version]
203 + pflogsumm -[help|version]
205 If no file(s) specified, reads from stdin. Output is to stdout.
208 The message may be delivered long-enough after the
209 (last) qmgr log entry that the information is not in
210 the log(s) processed by a particular run of
211 - pflogsumm.pl. This throws off "Recipients by message
212 + pflogsumm. This throws off "Recipients by message
213 size" and the total for "bytes delivered." These are
214 normally reported by pflogsumm as "Messages with no
216 @@ -255,15 +255,15 @@
218 Produce a report of previous day's activities:
220 - pflogsumm.pl -d yesterday /var/log/maillog
221 + pflogsumm -d yesterday /var/log/maillog
223 A report of prior week's activities (after logs rotated):
225 - pflogsumm.pl /var/log/maillog.0
226 + pflogsumm /var/log/maillog.0
228 What's happened so far today:
230 - pflogsumm.pl -d today /var/log/maillog
231 + pflogsumm -d today /var/log/maillog
233 Crontab entry to generate a report of the previous day's activity
234 at 10 minutes after midnight.