OS Manuals

/usr/bin/eximstats

EXIM scripts

From exim-scripts 4.100.1-r2 (os), captured 2026-11-05 by running eximstats --help (exit 1). permalink

eximstats Version 1.61

Usage:
  eximstats [Output] [Options] mainlog1 mainlog2 ...
  eximstats -merge -html [Options] report.1.html ... > weekly_rep.html

Examples:
  eximstats -html=eximstats.html mainlog1 mainlog2 ...
  eximstats mainlog1 mainlog2 ... > report.txt

Parses exim mainlog or syslog files and generates a statistical analysis
of the messages processed.

Valid output types are:
-txt[=<file>]   plain text (default unless no other type is specified)
-html[=<file>]  HTML
-xls[=<file>]   Excel
With no type and file given, defaults to -txt and STDOUT.

Valid options are:
-h<number>      histogram divisions per hour. The default is 1, and
                0 suppresses histograms. Other valid values are:
                2, 3, 5, 10, 15, 20, 30 or 60.
-ne             don't display error information
-nr             don't display relaying information
-nr/pattern/    don't display relaying information that matches
-nt             don't display transport information
-nt/pattern/    don't display transport information that matches
-nvr            don't do volume rounding. Display in bytes, not KB/MB/GB.
-t<number>      display top <number> sources/destinations
                default is 50, 0 suppresses top listing
-tnl            omit local sources/destinations in top listing
-t_remote_users show top user sources/destinations from non-local domains
-q<list>        list of times for queuing information. -q0 suppresses.
-show_rt<list>  Show the receipt times for all the messages.
-show_dt<list>  Show the delivery times for all the messages.
                <list> is an optional list of times in seconds.
                Eg -show_rt1,2,4,8.

-include_original_destination   show both the final and original
                destinations in the results rather than just the final ones.

-byhost         show results by sending host (default unless bydomain or
                byemail is specified)
-bydomain       show results by sending domain.
-byemail        show results by sender's email address
-byedomain      show results by sender's email domain
-bylocaldomain  show results by local domain

-pattern "Description" /pattern/
                Count lines matching specified patterns and show them in
                the results. It can be specified multiple times. Eg:
                -pattern 'Refused connections' '/refused connection/'

-merge          merge previously generated reports into a new report

-charts         Create charts (this requires the GD::Graph modules).
                Only valid with -html.
-chartdir <dir> Create the charts' png files in the directory <dir>
-chartrel <dir> Specify the relative directory for the "img src=" tags
                from where to include the charts in the html file
                -chartdir and -chartrel default to '.'

-emptyok        It is OK if there is no valid input, don't print an error.

-d              Debug mode - dump the eval'ed parser onto STDERR.
Options (23)
OptionDescriptionSource
-txt fileplain text (default unless no other type is specified)help
-html fileHTMLhelp
-xls fileExcelhelp
-h numberhistogram divisions per hour.help
-nedon't display error informationhelp
-nrdon't display relaying informationhelp
-ntdon't display transport informationhelp
-nvrdon't do volume rounding.help
-t numberdisplay top <number> sources/destinations default is 50, 0 suppresses top listinghelp
-tnlomit local sources/destinations in top listinghelp
-q listlist of times for queuing information.help
-show_rt listShow the receipt times for all the messages.help
-show_dt listShow the delivery times for all the messages.help
-include_original_destinationshow both the final and original destinations in the results rather than just the final ones.help
-byhostshow results by sending host (default unless bydomain or byemail is specified)help
-bydomainshow results by sending domain.help
-byemailshow results by sender's email addresshelp
-byedomainshow results by sender's email domainhelp
-bylocaldomainshow results by local domainhelp
-mergemerge previously generated reports into a new reporthelp
-chartsCreate charts (this requires the GD::Graph modules).help
-emptyokIt is OK if there is no valid input, don't print an error.help
-dDebug mode - dump the eval'ed parser onto STDERR.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.