m

mailstats(1)

mailstats(1)

NAME

mailstats - print mail traf®c statistics

SYNOPSIS

mailstats [-o][-C cf®le ] [-f st®le ]

DESCRIPTION

mailstats reads and interprets the sendmail statistics ®le, /etc/mail/sendmail.st, then prints out the mail traf®c statistics. If /etc/mail/sendmail.st exists, sendmail collects statistics about your mail traf®c and stores them in the statistics ®le. This ®le does not grow.

Statistics are gathered on a per-mailer basis for each mailer de®ned in the sendmail con®guration ®le. Statistics are kept on the number of messages and the number of bytes for all inbound and outbound traf®c.

The mailstats utility displays the time at which statistics collection was started on the ®rst line. Then, the statistics of each mailer is displayed on a single line, each with the following white space separated ®elds (see the "EXAMPLES" section below):

M

The mailer number.

msgsfr

Number of messages from the mailer.

bytes_from

Kbytes from the mailer.

msgsto

Number of messages to the mailer.

bytes_to

Kbytes to the mailer.

msgsrej

Number of messages rejected.

msgsdis

Number of messages discarded.

Mailer

The name of the mailer.

After this display, a line totaling the values for all of the mailers is displayed, separated from the previous information by a line containing only equals (``='') characters.

Options

The options are as follows:

-CRead the speci®ed ®le instead of the default /etc/mail/sendmail.cf ®le.

-fRead the speci®ed statistics ®le instead of the statistics ®le speci®ed in the /etc/mail/sendmail.cf ®le.

-oDo not display the name of the mailer in the output.

To clear the statistics ®le, execute, as root:

cp/dev/null/etc/mail/sendmail.st

RETURN VALUE

The mailstats utility exits 0 on success, and >0 if an error occurs.

DIAGNOSTICS

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

mailstats: file size changed

Either /etc/mail/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 ®le is supposed to remain constant, any change in size means that the ®le is invalid.

mailstats: /etc/mail/sendmail.st: No such file or directory

The statistics ®le does not exist.

mailstats: /etc/mail/sendmail.st: Permission denied

The statistics ®le's permissions are set so that you cannot read it.

EXAMPLES

Here is a typical example of mailstats output:

 

Section 1−496

− 1 −

HP-UX Release 11i: December 2000