NAME

mailstats − print mail traffic statistics

SYNOPSIS

mailstats

DESCRIPTION

mailstats reads and interprets the sendmail statistics file, /usr/lib/sendmail.st, then prints out the mail traffic statistics.  If /usr/lib/sendmail.st exists, sendmail collects statistics about your mail traffic and stores them in the statistics file.  This file does not grow. 

Statistics are gathered on a per-mailer basis for each mailer defined in the sendmail configuration file.  Statistics are kept on the number of messages and the number of bytes for all inbound and outbound traffic. 

To show the definitions of the mailers (delivery agents) reported on by mailstats, use the command:

grep ’^M’ /usr/lib/sendmail.cf

The first one listed is mailer 0, the second is mailer 1, etc. 

To clear the statistics file, execute, as root:

cp /dev/null /usr/lib/sendmail.st

The statistics file is then invalid until some mail is actually transferred. 

DIAGNOSTICS

mailstats generates error messages if the statistics file is not accessible or if the size of the statistics file has changed.  Error messages are:

mailstats: file size changed
Either /usr/lib/sendmail.st is zero length, meaning that no mail has been transferred since it was cleared out, or its size has changed.  Since the size of this file is supposed to remain constant, any change in size means that the file is invalid. 

mailstats: /usr/lib/sendmail.st: No such file or directory
The statistics file does not exist.

mailstats: /usr/lib/sendmail.st: Permission denied
The statistics file’s permissions are set so that you cannot read it.

EXAMPLES

Here is a typical example of mailstats output:

Statistics from Fri Dec  7 12:34:47 1990
M msgsfr  bytes_from  msgsto  bytes_to
0    216        318K      68       76K
3     80        108K      75      124K
4      0          0K      60       64K

This example shows that mailers 0, 3 and 4 have handled the given amounts of mail traffic since Friday, December 6th.  Specifically, sendmail has sent 60 messages containing 64 Kbytes via mailer number 4, but has not received any inbound messages via mailer number 4. 

AUTHOR

mailstats was developed by the University of California, Berkeley. 

FILES

/usr/lib/sendmail.st mail traffic statistics file

/usr/lib/sendmail.cf sendmail configuration file

SEE ALSO

sendmail(1m). 

Hewlett-Packard Company  —  HP-UX Release 9.03: April 1994