faxcron(8) [linux man page]
FAXCRON(8) System Manager's Manual FAXCRON(8) NAME
faxcron - HylaFAX routine maintenance script SYNOPSIS
/usr/sbin/faxcron [ -n ] [ -l lastrun ] DESCRIPTION
faxcron is a command script that does routine upkeep tasks in a HylaFAX spooling directory hierarchy. This script is intended to be invoked from cron(8) on behalf of the fax user (often the ``fax'' user is uucp) once a day, with the standard output sent by mail to the HylaFAX administrator. For example, the following crontab might be set up for the fax user: 25 23 * * * sh /usr/sbin/faxcron | mail FaxMaster The faxcron script does the following work: o report statistics for facsimile transmitted since the last time faxcron was run. o report statistics for facsimile transmitted in the past week. o report statistics for facsimile received since the last time faxcron was run. o report statistics for facsimile received in the past week. o report any recent calls that failed suspiciously and return the associated trace log; o purge data that is 30 days or older from the remote machine information directory; o delete information that is 30 days or older from session trace log files; o remove files from the tmp directory that are older than 1 day; o remove files in the received facsimile queue that are 7 days or older; o report sites that are currently having jobs rejected; and o force all session log files to be owned by the fax user and kept with protection mode 644. OPTIONS
-n Forces faxcron to run without updating any files. -l lastrun Forces the notion of the last time that faxcron was run to be lastrun. The value of lastrun is a date and time string of the form ``MM/DD/YY HH:MM'' (the date(1) format string ``%D %H:%M''). -info n Set the expiration time for data in the info database to be n days. -log n Set the expiration time for session log data to be n days. -rcv n Set the expiration time for files in the received facsimile queue to be n days. -tmp n Set the expiration time for files in the tmp directory to be n days. -mode m Set the file protection mode for session logs to m (a command line argument to chmod(1)). NOTES
This script requires nawk(1) or gawk(1) and a date (1) program that supports the ``+format'' option. If session logs are to be kept private this script must be modified to filter out sensitive information such as calling card numbers. (It should also be run with ``-mode 0600'' so that session log files are not publicly readable.) FILES
/var/spool/hylafax spooling area /var/spool/hylafax/status/lastrun timestamp of last run /usr/sbin/xferfaxstats for generating transmit statistics /usr/sbin/recvstats for generating receive statistics /var/spool/hylafax/tmp/faxcronXXXX temporary file for truncating session logs /var/spool/hylafax/tmp/faxlogXXXX temporary file for logs of failed calls SEE ALSO
cron(8), faxq(8), faxgetty(8), faxsend(8), xferfaxstats(8), recvstats(8), hylafax-server(5) May 12, 1996 FAXCRON(8)
Check Out this Related Man Page
RECVSTATS(8) System Manager's Manual RECVSTATS(8) NAME
recvstats - summarize HylaFAX receive accounting information SYNOPSIS
/usr/sbin/recvstats [ options ] [ files ] DESCRIPTION
recvstats is a command script that prints a summary of the HylaFAX accounting statistics for received facsimile. The statistics can be sorted using one of several keys: the caller's CSI (default), CIDName (CallID2), CIDNumber (CallID1), the communication speed, or the com- munication data format. Statistics are read from the file /var/spool/hylafax/log/xferfaxlog unless filenames are specified on the command line. The following table is an example of the output from recvstats (using the default sort key): Sender CIDName CIDNumber Pages Time Pg/min Errs TypRate TypData 61 30:47 2.0 16 9600 1-DMR +13037904674 5 1:34 3.2 2 9600 1-DMH +14159657824 1 1:00 1.0 0 9600 1-DMH +15086636852 2 0:00 2.0 0 9600 1-DMH +15105268781 740 5:47:51 2.1 59 9600 1-DMH +15105287164 20 7:00 2.9 0 9600 1-DMH +15123713545 3 1:19 2.3 0 9600 1-DMH +15123713641 5 1:04 4.6 0 9600 1-DMH +16099211926 3 2:00 1.5 0 9600 1-DMH +17088987617 1 0:18 3.3 0 9600 1-DMH 415 390 6175 22 6:01 3.6 0 9600 1-DMH 415 965 7651 56 34:52 1.6 14 9600 1-DMH 415 973 6723 1 2:09 0.5 0 9600 2-DMR 49 211 161514 1 0:00 1.0 0 9600 2-DMR 8185970503 1 0:28 2.1 0 9600 2-DMR ALDUS CORPORATION ALDUS CO 5551212 3 2:34 1.2 0 9600 1-DMH -------------------------------------------------------------------------------------------------- Total 925 7:19:03 2.1 91 The Sender column shows the caller's TSI (notice that some callers have not setup a TSI). The CIDName column is the received CIDName value for the sender. The CIDNumber column is the received CIDNumber value for the sender. The Pages column is the total number of good pages received. The time column shows the total amount of time spent receiving facsimile from a sender. The Pg/min column displays the average transfer rate. The Errs column indicates how many protocol errors were encountered while receiving facsimile. The TypRate column displays the most common communication speed with which facsimile were received. The TypData column shows the most common data format in which fac- simile data were received. OPTIONS
-age days Show information only for the facsimile received in the last specified number of days. -csi* Sort output by caller's CSI. -cidname Sort output by CIDName -cidnumber Sort output by CIDNumber -format Sort output by data format. -send* Sort output by sender (i.e. caller's CSI). -speed Sort output by signalling rate. -since time Show information only for the facsimile received since the specified time; where time is of the form ``MM/DD/YY HH:MM'' (the date(1) format string %D %H:%M). -end time Show information only for the facsimile received before the specified time; where time is of the same form as since. FILES
/var/spool/hylafax spooling area /var/spool/hylafax/log/xferfaxlog default file from which to read statistics SEE ALSO
faxq(8), xferfaxstats(8), hylafax-log(5) March 3, 1995 RECVSTATS(8)