freebsd-dev/contrib/sendmail/mailstats/mailstats.8
1999-01-12 12:26:57 +00:00

101 lines
2.1 KiB
Groff

.\" Copyright (c) 1998 Sendmail, Inc. All rights reserved.
.\"
.\" By using this file, you agree to the terms and conditions set
.\" forth in the LICENSE file which can be found at the top level of
.\" the sendmail distribution.
.\"
.\"
.\" @(#)mailstats.8 8.8 (Berkeley) 11/13/1998
.\"
.Dd April 25, 1996
.Dt MAILSTATS 1
.Os BSD 3
.Sh NAME
.Nm mailstats
.Nd display mail statistics
.Sh SYNOPSIS
.Nm mailstats
.Op Fl o
.if \nP .Op Fl p
.Op Fl C Ar cffile
.Op Fl f Ar stfile
.Sh DESCRIPTION
The
.Nm mailstats
utility displays the current mail statistics.
.Pp
First, the time at which statistics started being kept is displayed,
in the format specified by
.Xr ctime 3 .
Then,
the statistics for each mailer are displayed on a single line,
each with the following whitespace separated fields:
.Pp
.Bl -tag -width 10n -offset indent -compact
.It Sy M
The mailer number.
.It Sy msgsfr
Number of messages from the mailer.
.It Sy bytes_from
Kbytes from the mailer.
.It Sy msgsto
Number of messages to the mailer.
.It Sy bytes_to
Kbytes to the mailer.
.It Sy msgsrej
Number of messages rejected.
.It Sy msgsdis
Number of messages discarded.
.It Sy Mailer
The name of the mailer.
.El
.Pp
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
.Pq Dq \&=
characters.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl C
Read the specified file instead of the default
.Nm sendmail
.Dq cf
file.
.It Fl f
Read the specified statistics file instead of the statistics file
specified in the
.Nm sendmail
.Dq cf
file.
.if \nP \
\{
.It Fl p
Output information in program-readable mode and clear statistics.
.\}
.It Fl o
Don't display the name of the mailer in the output.
.El
.Pp
The
.Nm mailstats
utility exits 0 on success, and >0 if an error occurs.
.Sh FILES
.Bl -tag -width /var/log/sendmail.stXX -compact
.ie \nP .It Pa /etc/mail/sendmail.cf
.el .It Pa /etc/sendmail.cf
The default
.Nm sendmail
.Dq cf
file.
.ie \nP .It Pa /etc/mail/statistics
.el .It Pa /var/log/sendmail.st
The default
.Nm sendmail
statistics file.
.El
.Sh SEE ALSO
.Xr mailq 1 ,
.Xr sendmail 8