contrib/sendmail-8.14/mailstats/mailstats.8

   1 .\" Copyright (c) 1998-2002 Sendmail, Inc. and its suppliers.
   2 .\"      All rights reserved.
   3 .\"
   4 .\" By using this file, you agree to the terms and conditions set
   5 .\" forth in the LICENSE file which can be found at the top level of
   6 .\" the sendmail distribution.
   7 .\"
   8 .\"
   9 .\"     $Id: mailstats.8,v 8.31 2002/06/27 22:47:29 gshapiro Exp $
  10 .\"
  11 .TH MAILSTATS 8 "$Date: 2002/06/27 22:47:29 $"
  12 .SH NAME
  13 mailstats
  14 \- display mail statistics
  15 .SH SYNOPSIS
  16 .B mailstats
  17 .RB [ \-c "] [" \-o "] [" \-p "] [" \-P ]
  18 .RB [ \-C
  19 .IR cffile ]
  20 .RB [ \-f
  21 .IR stfile ]
  22 .SH DESCRIPTION
  23 The
  24 .B mailstats
  25 utility displays the current mail statistics.
  26 .PP
  27 First, the time at which statistics started being kept is displayed,
  28 in the format specified by
  29 ctime(3).
  30 Then,
  31 the statistics for each mailer are displayed on a single line,
  32 each with the following white space separated fields:
  33 .sp
  34 .RS
  35 .PD 0.2v
  36 .TP 1.2i
  37 .B M
  38 The mailer number.
  39 .TP
  40 .B msgsfr
  41 Number of messages from the mailer.
  42 .TP
  43 .B bytes_from
  44 Kbytes from the mailer.
  45 .TP
  46 .B msgsto
  47 Number of messages to the mailer.
  48 .TP
  49 .B bytes_to
  50 Kbytes to the mailer.
  51 .TP
  52 .B msgsrej
  53 Number of messages rejected.
  54 .TP
  55 .B msgsdis
  56 Number of messages discarded.
  57 .TP
  58 .B msgsqur
  59 Number of messages quarantined.
  60 .TP
  61 .B Mailer
  62 The name of the mailer.
  63 .PD
  64 .RE
  65 .PP
  66 After this display, a line totaling the values for all of the mailers
  67 is displayed (preceded with a ``T''),
  68 separated from the previous information by a line containing only equals
  69 (``='')
  70 characters.
  71 Another line preceded with a ``C'' lists the number of TCP connections.
  72 .PP
  73 The options are as follows:
  74 .TP
  75 .B \-C
  76 Read the specified file instead of the default
  77 .B sendmail
  78 configuration file.
  79 .TP
  80 .B \-c
  81 Try to use submit.cf instead of the default
  82 .B sendmail
  83 configuration file.
  84 .TP
  85 .B \-f
  86 Read the specified statistics file instead of the statistics file
  87 specified in the
  88 .B sendmail
  89 configuration file.
  90 .TP
  91 .B \-P
  92 Output information in program-readable mode without clearing statistics.
  93 .TP
  94 .B \-p
  95 Output information in program-readable mode and clear statistics.
  96 .TP
  97 .B \-o
  98 Don't display the name of the mailer in the output.
  99 .PP
 100 The
 101 .B mailstats
 102 utility exits 0 on success, and >0 if an error occurs.
 103 .SH FILES
 104 .PD 0.2v
 105 .TP 2.5i
 106 /etc/mail/sendmail.cf
 107 The default
 108 .B sendmail
 109 configuration file.
 110 .TP
 111 /etc/mail/statistics
 112 The default
 113 .B sendmail
 114 statistics file.
 115 .PD
 116 .SH SEE ALSO
 117 mailq(1),
 118 sendmail(8)