Penguin
Recent Changes
Blame: eximstats(8)
EditPageHistoryDiffInfoLikePages
Annotated edit history of eximstats(8) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 eximstats
2 !!!eximstats
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 SEE ALSO
8 AUTHOR
9 ----
10 !!NAME
11
12
13 eximstats - exim mail statistics
14 !!SYNOPSIS
15
16
17 __eximstats [[options] __
18 !!DESCRIPTION
19
20
21 A Perl script called eximstats is supplied in the util
22 directory. This has been hacked about quite a bit over time.
23 It now gives quite a lot of information by default, but
24 there are options for suppressing various parts of it.
25 Following any options, the arguments to the script are a
26 list of files, which should be main log files.
27
28
29 Eximstats extracts information about the number and volume
30 of messages received from or delivered to various hosts. The
31 information is sorted both by message count and by volume,
32 and the top 50 hosts in each category are listed on the
33 standard output. For messages delivered and received
34 locally, similar statistics are produced per
35 user.
36
37
38 The output also includes total counts and statistics about
39 delivery errors, and histograms showing the number of
40 messages received and deliveries made in each hour of the
41 day. A delivery with more than one address in its counted as
42 a single delivery by eximstats.
43
44
45 Though normally more deliveries than receipts are reported
46 (as messages may have multiple recipients), it is possible
47 for eximstats to report more messages received than
48 delivered, even though the spool is empty at the start and
49 end of the period in question. If an incoming message
50 contains no valid recipients, no deliveries are recorded for
51 it. An error report is handled as an entirely separate
52 message.
53
54
55 Eximstats always outputs a grand total summary giving the
56 volume and number of messages received and deliveries made,
57 and the number of hosts involved in each case. It also
58 outputs the number of messages that were delayed (that is,
59 not completely delivered at the first attempt), and the
60 number that had at least one address that
61 failed.
62
63
64 The remainder of the output is in sections that can be
65 independently disabled or modified by various options. It
66 consists of a summary of deliveries by transport, histograms
67 of messages received and delivered per time interval
68 (default per hour), information about the time messages
69 spent on the queue, a list of relayed messages, lists of the
70 top 50 sending hosts, local senders, destination hosts, and
71 destination local users by count and by volume, and a list
72 of delivery errors that occurred. The options are as
73 follows:
74 !!OPTIONS
75
76
77 __-nt__
78
79
80 Suppress the statistics about delivery by
81 transport.
82
83
84 __-h__
85
86
87 This option controls the histograms of messages received and
88 deliveries per time interval. By default the time interval
89 is one hour. If -h0 is given, the histograms are suppressed;
90 otherwise the value of
91
92
93 __-q0__
94
95
96 Suppress information about times messages spend on the
97 queue.
98
99
100 __-q__
101
102
103 This option sets an alternative list of time intervals for
104 the queueing information. The values are separated by commas
105 and are in seconds, but can involve arithmetic multipliers,
106 so for example you can set 3*60 to specify 3 minutes. A
107 setting such as
108
109
110 -q60,5*60,10*60
111
112
113 causes eximstats to give counts of messages that stayed on
114 the queue for less than one minute, less than five minutes,
115 less than ten minutes, and over ten minutes.
116
117
118 __-nr__
119
120
121 Suppress information about messages relayed through this
122 host.
123
124
125 __-nr/pattern/__
126
127
128 Suppress information about relayed messages that match the
129 pattern, which is matched against a string of the
130 form
131
132
133 H=
134
135
136 for example
137
138
139 H=in.host A=from@some.where =
140
141
142 The addresses are taken from the envelope, not the headers.
143 This option allows you to screen out hosts whom you are
144 happy to have using your host as a relay.
145
146
147 __-t__
148
149
150 Sets the 'top' count to
151
152
153 __-tnl__
154
155
156 Omit local information from the 'top' listings.
157
158
159 __-ne__
160
161
162 Suppress the list of delivery errors.
163 !!SEE ALSO
164
165
166 There is extensive documentation available in
167 ''/usr/share/doc/exim'' and in the info system regarding
168 exim. Please be sure to have the __exim-doc__ package
169 installed.
170 !!AUTHOR
171
172
173 This manual page was stitched together by Christoph Lameter
174 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.