--- sendmail-8.12.9/mailstats/mailstats.8.orig Fri Jun 28 00:47:29 2002 +++ sendmail-8.12.9/mailstats/mailstats.8 Sun Jan 12 04:38:26 2014 @@ -13,22 +13,24 @@ mailstats \- display mail statistics .SH SYNOPSIS -.B mailstats -.RB [ \-c "] [" \-o "] [" \-p "] [" \-P ] -.RB [ \-C -.IR cffile ] -.RB [ \-f -.IR stfile ] +.LP +.nf +\fBmailstats\fR [\fB-c\fR] [\fB-o\fR] [\fB-p\fR] [\fB-P\fR] [\fB-C\fR \fIcffile\fR] [\fB-f\fR \fIstfile\fR] +.fi + .SH DESCRIPTION The .B mailstats -utility displays the current mail statistics. +utility displays the current mail statistics collected by the +\fBsendmail\fR(8) program. However, if the \fBStatusFile\fR does not +exist (see "Processing Options" in \fBsendmail\fR(8)), no statistics +are collected and mailstats displays a corresponding error message. +In this case simply touch the file (per default \fB/var/log/sendmail.st\fR) +and make sure, that it is owned by the user \fBroot\fR. + .PP -First, the time at which statistics started being kept is displayed, -in the format specified by -ctime(3). -Then, -the statistics for each mailer are displayed on a single line, +Mailstat displays the time at which statistics started being kept, first. +Then, the statistics for each mailer are displayed on a single line, each with the following white space separated fields: .sp .RS @@ -69,10 +71,12 @@ (``='') characters. Another line preceded with a ``C'' lists the number of TCP connections. + +.SH OPTIONS .PP The options are as follows: .TP -.B \-C +.BI "\-C" file Read the specified file instead of the default .B sendmail configuration file. @@ -82,7 +86,7 @@ .B sendmail configuration file. .TP -.B \-f +.BI "\-f" file Read the specified statistics file instead of the statistics file specified in the .B sendmail @@ -96,23 +100,28 @@ .TP .B \-o Don't display the name of the mailer in the output. -.PP -The -.B mailstats -utility exits 0 on success, and >0 if an error occurs. + +.SH EXIT STATUS +.TP +\fB0\fR +Successful completion. +.TP +\fB>0\fR +An error occurred. + .SH FILES .PD 0.2v .TP 2.5i -/etc/mail/sendmail.cf +\fB/etc/mail/sendmail.cf\fR The default .B sendmail configuration file. .TP -/etc/mail/statistics +\fB/var/log/sendmail.st\fR The default .B sendmail statistics file. .PD .SH SEE ALSO -mailq(1), -sendmail(8) +.LP +\fBsendmail\fR(8)