XFERLOG(5F)XFERLOG(5F)NAMExferfaxlog - HylaFAX activity log
DESCRIPTION
The file etc/xferfaxlog contains information about inbound
and outbound activities. The file contains one line per
inbound or outbound call (except for facsimile documents
retrieved by polling in which case multiple entries may be
present for a single call). Lines are fixed-format, tab-
separated ASCII strings. Each record of a facsimile
transmission is of the form:
date SEND commid modem jobid jobtag sender ``dest-
number'' ``CSI'' params #pages jobtime conntime ``reason''
A facsimile reception record is of the form:
date RECV commid modem <null> <null> fax ``local-num-
ber'' ``TSI'' params #pages jobtime conntime ``reason''
Each facsimile document retrieved by polling has a record
of the form:
date POLL commid modem jobid jobtag sender ``dest-
number'' ``TSI'' params #pages jobtime conntime ``reason''
An alphanumeric pager request has a record of the form:
date PAGE commid modem jobid jobtag sender ``dest-
number'' ``<null>'' 0 0 jobtime conntime ``reason''
The following describes the fields in the above records:
date The date and time of the transaction in the
format MM/DD/YY HH:MM , where MM is the
numeric month, DD the numeric day, YY the
last two digits of the year, and HH:MM is
the time in 24-hour format.
commid The communication identifier for the call.
modem The device identifier for the modem that was
used to do the send or receive.
jobid The job number for outbound calls.
jobtag The client-specified job tag for outbound
calls.
sender The sender/receiver's electronic mailing
address (facsimile receptions are always
attributed to the ``fax'' user).
dest-number The phone number dialed for outgoing calls.
TSI The Transmitter Subscriber Identification
string (as received) for incoming calls.
CSI The Caller Subscriber Identification string
June 5, 1996 1
XFERLOG(5F)XFERLOG(5F)
of the remote machine (as reported) for out-
going calls.
local-number The local phone number on which the data was
received.
params The negotiatated facsimile session parame-
ters used for transferring data encoded as
described below.
#pages The total number of pages transferred.
jobtime The duration of the session; in the format
HH:MM:SS. This time includes setup overhead
and any time spent cleaning up after a call.
conntime The time spent on the phone; in the format
HH:MM:SS. This should be the time used by
the PTT to calculate usage charges.
reason A string that indicates if any problem
occured during the session.
Note that fields may have embedded blanks. Session param-
eters are encoded as a decimal number that contains a
packed set of Class 2 session parameter values. The for-
mat is: 2 bits for vertical resolution, 3 bits for sig-
nalling rate, 3 bits for page width, 2 bits for page
length, 2 bits for data format, 1 bit for ECM use, 1 bit
of BF use, and 3 bits for the min scanline time. The page
counts are always integral numbers. Partial pages that
are to be retransmitted are not included in the page
count.
The simple ASCII format was designed to be easy to process
with programs like awk(1).
BUGS
The date format will ``break'' in the year 2000. Informa-
tion should be recorded on a per-page basis for facsimile
communications.
SEE ALSOfaxq(8C)faxsend(8C)faxgetty(8C)
June 5, 1996 2