1FAXCRON(8C)                                                        FAXCRON(8C)
2
3
4

NAME

6       faxcron - HylaFAX routine maintenance script
7

SYNOPSIS

9       /usr/sbin/faxcron [ -n ] [ -l lastrun ]
10

DESCRIPTION

12       faxcron is a command script that does routine upkeep tasks in a HylaFAX
13       spooling directory hierarchy.  This script is intended  to  be  invoked
14       from  cron(8C)  on  behalf  of  the fax user (often the ``fax'' user is
15       uucp) once a day, with the standard output sent by mail to the  HylaFAX
16       administrator.   For example, the following crontab might be set up for
17       the fax user:
18         25   23    *    *    *   sh /usr/sbin/faxcron | mail FaxMaster
19
20       The faxcron script does the following work:
21
22       ·  report statistics for facsimile transmitted since the last time fax‐
23          cron was run.
24
25       ·  report statistics for facsimile transmitted in the past week.
26
27       ·  report statistics for facsimile received since the last time faxcron
28          was run.
29
30       ·  report statistics for facsimile received in the past week.
31
32       ·  report any recent calls that  failed  suspiciously  and  return  the
33          associated trace log;
34
35       ·  purge data that is 30 days or older from the remote machine informa‐
36          tion directory;
37
38       ·  delete information that is 30 days or older from session  trace  log
39          files;
40
41       ·  remove files from the tmp directory that are older than 1 day;
42
43       ·  remove  files  in  the  received  facsimile queue that are 7 days or
44          older;
45
46       ·  report sites that are currently having jobs rejected; and
47
48       ·  force all session log files to be owned by the  fax  user  and  kept
49          with protection mode 644.
50

OPTIONS

52       -n        Forces faxcron to run without updating any files.
53
54       -l lastrun
55                 Forces the notion of the last time that faxcron was run to be
56                 lastrun.  The value of lastrun is a date and time  string  of
57                 the  form  ``MM/DD/YY HH:MM'' (the date(1) format string ``%D
58                 %H:%M'').
59
60       -q spool  Specify the location of the HylaFAX spool directory.
61
62       -info n   Set the expiration time for data in the info database to be n
63                 days.
64
65       -log n    Set the expiration time for session log data to be n days.
66
67       -rcv n    Set  the  expiration time for files in the received facsimile
68                 queue to be n days.
69
70       -tmp n    Set the expiration time for files in the tmp directory to  be
71                 n days.
72
73       -mode m   Set the file protection mode for session logs to m (a command
74                 line argument to chmod(1)).
75

NOTES

77       This script requires nawk(1) or gawk(1) and a  date  (1)  program  that
78       supports the ``+format'' option.
79
80       If  session logs are to be kept private this script must be modified to
81       filter out sensitive information such as  calling  card  numbers.   (It
82       should  also  be  run with ``-mode 0600'' so that session log files are
83       not publicly readable.)
84

FILES

86       /var/spool/hylafax                     spooling area
87       /var/spool/hylafax/etc/lastrun         timestamp of last run
88       /usr/sbin/xferfaxstats                 for generating transmit statistics
89       /usr/sbin/recvstats                    for generating receive statistics
90       /var/spool/hylafax/tmp/faxcronXXXX     temporary file for truncating session logs
91       /var/spool/hylafax/tmp/faxlogXXXX      temporary file for logs of failed calls
92

SEE ALSO

94       cron(8C), faxq(8C), faxgetty(8C), faxsend(8C), xferfaxstats(8C), recvs‐
95       tats(8C), hylafax-server(5F)
96
97
98
99                                 May 12, 1996                      FAXCRON(8C)
Impressum