xferfaxstats.1m
上传用户:weiyuanprp
上传日期:2020-05-20
资源大小:1169k
文件大小:7k
源码类别:

传真(Fax)编程

开发平台:

C/C++

  1. ." $Id: xferfaxstats.1m,v 1.3 2007/08/15 20:14:12 faxguy Exp $
  2. ."
  3. ." HylaFAX Facsimile Software
  4. ."
  5. ." Copyright (c) 1993-1996 Sam Leffler
  6. ." Copyright (c) 1993-1996 Silicon Graphics, Inc.
  7. ." HylaFAX is a trademark of Silicon Graphics
  8. ." 
  9. ." Permission to use, copy, modify, distribute, and sell this software and 
  10. ." its documentation for any purpose is hereby granted without fee, provided
  11. ." that (i) the above copyright notices and this permission notice appear in
  12. ." all copies of the software and related documentation, and (ii) the names of
  13. ." Sam Leffler and Silicon Graphics may not be used in any advertising or
  14. ." publicity relating to the software without the specific, prior written
  15. ." permission of Sam Leffler and Silicon Graphics.
  16. ." 
  17. ." THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
  18. ." EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
  19. ." WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
  20. ." 
  21. ." IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
  22. ." ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
  23. ." OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  24. ." WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
  25. ." LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
  26. ." OF THIS SOFTWARE.
  27. ."
  28. .if n .po 0
  29. .ds Fx fIHylas-1FAXs+1fP
  30. .TH XFERFAXSTATS ${MANNUM1_8} "May 12, 1996"
  31. .SH NAME
  32. xferfaxstats - summarize *(Fx transmission accounting
  33. .SH SYNOPSIS
  34. .B ${SBIN}/xferfaxstats
  35. [
  36. .I options
  37. ] [
  38. .I files
  39. ]
  40. .SH DESCRIPTION
  41. .I xferfaxstats
  42. is a command script that prints a summary of the *(Fx
  43. accounting statistics for transmitted jobs.
  44. The statistics can be sorted using one of several keys:
  45. the sender's account name (default),
  46. the job tag (useful when used for accounting purposes),
  47. the remote party's s-1CSIs+1,
  48. the called phone number,
  49. the output device used for the call,
  50. the communication speed, and
  51. the communication data format.
  52. Statistics are read from the file
  53. .B ${SPOOL}/etc/xferfaxlog
  54. in the spooling area, unless filenames are
  55. specified on the command line.
  56. .PP
  57. The following table is an example of the output from
  58. .I xferfaxstats
  59. (using the default sort key):
  60. .sp .5
  61. .nf
  62. .ta w'richardn@mfg.sgi.com   'u +w'Pages   'u +w'Calls   'u +w'25:49:13  'u +w'Pg/min   'u +w'Errs   'u +w'TypRate   'u
  63. fBDestination Pages Calls Time Pg/min Errs TypRate TypDatafP
  64. cadsmith@esd.sgi.com 34 41 24:05 1.4 0 9600 1-D MH
  65. ctb@corp.sgi.com 32 42 20:43 1.5 2 9600 2-D MR
  66. edmark@esd.sgi.com 42 53 29:30 1.4 3 9600 1-D MH
  67. fredc@mfg.sgi.com 157 174 1:37:52 1.6 0 9600 2-D MR
  68. jlw@engr.sgi.com 81 90 57:29 1.4 1 9600 1-D MH
  69. jlw@wpd.sgi.com 346 411 3:57:57 1.5 100 9600 1-D MH
  70. karlton@asd.sgi.com 68 71 36:57 1.8 0 9600 1-D MH
  71. kerrie@mfg.sgi.com 48 58 32:29 1.5 1 9600 2-D MR
  72. kgraf@mfg.sgi.com 128 130 1:48:21 1.2 2 9600 1-D MH
  73. kubey@wpd.sgi.com 264 289 3:22:13 1.3 6 9600 1-D MH
  74. loki@wpd.sgi.com 205 225 2:56:45 1.2 5 9600 2-D MR
  75. moondog@esd.sgi.com 112 120 1:23:01 1.3 4 9600 2-D MR
  76. mpolen@mti.sgi.com 122 129 1:39:32 1.2 1 9600 1-D MH
  77. nancyf@mfg.sgi.com 174 180 2:08:44 1.4 2 9600 2-D MR
  78. paulh@mfg.sgi.com 56 56 1:29:24 0.6 0 9600 2-D MR
  79. richardn@mfg.sgi.com 34 30 24:42 1.4 1 9600 1-D MH
  80. rosa@corp.sgi.com 32 30 28:00 1.1 2 9600 1-D MH
  81. sam@asd.sgi.com 65 65 46:25 1.4 5 9600 1-D MH
  82. seth@asd.sgi.com 34 30 25:04 1.4 0 9600 1-D MH
  83. --------------------------------------------------------------------------
  84. Total 2034 2224 25:49:13 1.3 135
  85. .sp .5
  86. .fi
  87. The first column column shows the sort key value used (the sender's
  88. identity here, but otherwise the destination phone number,
  89. remote s-1CSIs+1, etc.).
  90. The
  91. .I Pages
  92. column is the total number of good pages transmitted.
  93. The
  94. .I Calls
  95. column is the total number of calls placed.
  96. The
  97. .I time
  98. column shows the total amount of time spent transmitting.
  99. The
  100. .I Pg/min
  101. column displays the average transfer rate.
  102. The
  103. .I Errs
  104. column indicates how many errors were encountered while
  105. transmitting facsimile.
  106. (Note that this statistic does not
  107. include problems encountered while placing a call; e.g.
  108. busy signals.)
  109. The
  110. .I TypRate
  111. column displays the most common communication speed with which
  112. facsimile were transmitted.
  113. The
  114. .I TypData
  115. column shows the most common data format in which facsimile
  116. data were transmitted.
  117. .PP
  118. Account names other than ``root'' and ``guest''
  119. can be automatically mapped to a canonical format
  120. in which the host name is removed and identical addresses in the
  121. same domain are merged together (i.e. for NIS environments).
  122. For example, ``sam@flake.asd.sgi.com'' and ``sam@foobar.asd.sgi.com''
  123. are both mapped to ``sam@asd.sgi.com'' with the associated statistics
  124. accumulated.
  125. Identical account names in different domains generate a warning;
  126. e.g. ``loki@wpd.sgi.com'' and ``loki@corp.sgi.com''.
  127. The above mapping is done only if the
  128. .B -map
  129. option is specified, by default account names are not altered.
  130. .ne 1i
  131. .SH OPTIONS
  132. .TP 12
  133. .BI -age " days"
  134. Show information only for the facsimile transmitted in the last specified number of
  135. .IR days .
  136. .TP 12
  137. .B -csi*
  138. Sort output by the remote party's 
  139. .SM CSI.
  140. .TP
  141. .B -dest*
  142. Sort output by the phone number called.
  143. .TP
  144. .B -dev*
  145. Sort output by the output device (i.e. modem) used.
  146. .TP
  147. .B -format
  148. Sort output by the negotiated data format.
  149. .TP
  150. .B -job*
  151. Sort output by client-specified job tag identifiers.
  152. .TP
  153. .B -nomap
  154. Do not perform the account name mapping by which
  155. statistics for the ``root'' and ``guest'' accounts are 
  156. merged and leading hostname part of domain names are stripped.
  157. This is the default behavior.
  158. .TP
  159. .B -map
  160. Perform the account name mapping by which
  161. statistics for the ``root'' and ``guest'' accounts are 
  162. merged and leading hostname part of domain names are stripped.
  163. .TP
  164. .B -send*
  165. Sort output by sender's account name (default).
  166. .TP 12
  167. .BI -since " time"
  168. Show information only for the facsimile transmitted since the
  169. specified
  170. .IR time ;
  171. where
  172. .I time
  173. is of the form ``MM/DD/YY HH:MM'' (the
  174. .IR date (1)
  175. format string %D %H:%M).
  176. .TP 12
  177. .BI -end " time"
  178. Show information only for the facsimile transmitted before the
  179. specified
  180. .IR time ;
  181. where
  182. .I time
  183. is of the same form as
  184. .B since.
  185. .TP
  186. .B -speed
  187. Sort output by the signalling rate.
  188. .SH DIAGNOSTICS
  189. .PP
  190. ``fBWarning, address clash, "%s" and "%s".fP''
  191. During address mapping two mapped addresses were found for the same
  192. account name.
  193. .PP
  194. ``fBWarning, weird user address/name "%s".fP''
  195. During address mapping an address was encountered that multiple ``@''
  196. symbols in it.
  197. .SH NOTES
  198. The sender field does not necessarily represent the submitter's
  199. actual identity.  For example, it reflects the value given by
  200. the
  201. .IR sendfax (${MANNUM1_8})
  202. ``-f'' option.  Be cautious that this field is not utilized
  203. for auditing if the fax user base is not trusted.
  204. .SH FILES
  205. .nf
  206. .ta w'${SPOOL}    'u
  207. ${SPOOL} spooling area
  208. etc/xferfaxlog default file from which to read statistics
  209. .fi
  210. .SH "SEE ALSO"
  211. .IR faxq (${MANNUM1_8}),
  212. .IR faxsend (${MANNUM1_8}),
  213. .IR recvstats (${MANNUM1_8}),
  214. .IR hylafax-log (${MANNUM4_5})