Provided by: hylafax-server_4.4.4-10.1ubuntu2_i386 bug

NAME

       xferfaxlog - 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).   If  the  modem
       config setting LogCalls is set to true, then the file also contains one
       line per received 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’’  <null>   <null>   <null>
       ‘‘owner’’ ‘‘dcs’’

       A facsimile reception record is of the form:
            date  RECV commid modem <null> <null> fax ‘‘local-number’’ ‘‘TSI’’
       params  #pages  jobtime  conntime  ‘‘reason’’  ‘‘CallID1’’  ‘‘CallID2’’
       ‘‘CallID3...CallIDn’’ <null> ‘‘dcs’’

       Each inbound call record is of the form:
            date CALL commid modem <null> <null> fax ‘‘local-number’’ <null> 0
       0    jobtime    conntime     ‘‘reason’’     ‘‘CallID1’’     ‘‘CallID2’’
       ‘‘CallID3..CallIDn’’ <null> ‘‘dcs’’

       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’’ <null> <null> <null>

       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’’ <null> <null> ‘‘owner’’

       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 of the remote
                     machine (as reported) for outgoing calls.

       local-number  The local phone number on which the data was received.

       params        The  negotiated  facsimile  session  parameters  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  occurred  during
                     the session.

       CIDName       The received CIDName value for the session.

       CIDNumber     The received CIDNumber value for the session.

       owner         The login name of the job owner.

       dcs           The  T.30  DCS  string  that  was  used  in the facsimile
                     communication.

       Note that fields may have  embedded  blanks.   Session  parameters  are
       encoded  as  a  decimal  number  that  contains a packed set of Class 2
       session  parameter  values.   The  format  is:  2  bits  for   vertical
       resolution,  3  bits for signalling 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).

NOTES

       The sender field does not necessarily represent the submitter’s  actual
       identity.   For  example, it reflects the value given by the sendfax(8)
       ‘‘-f’’ option.  Be  cautious  that  this  field  is  not  utilized  for
       auditing if the fax user base is not trusted.

BUGS

       The date format will ‘‘break’’ in the year 2000.  Information should be
       recorded on a per-page basis for facsimile communications.

SEE ALSO

       faxq(8) faxsend(8) faxgetty(8)

                                 June 5, 1996                    XFERFAXLOG(5)