Содержание

1 xferfaxlog - регистрация событий HylaFAX

xferfaxlog - регистрация событий HylaFAX

Описание

Файл etc/xferfaxlog содержит информацию о входящей и исходящей активности. Файл содержит по одной строчке на каждый принимаемый факс или каждое задание на отправку. Файл так же содержит по одной строчке фиксирующей факт истечения срока задания или его завершения. Если в конфигурации модема параметр LogCalls установлен как true, тогда файл содержит ещё по одной строчке на каждый входящий вызов. Строчки имеют фиксированный формат, с символом табуляции в качестве разделителя.

Структуры записей

Запись о передаче факса

   date SEND commid modem jobid jobtag sender ``dest-number ``CSI params #pages jobtime 
     conntime ``reason <null> <null> <null> ``owner ``dcs jobinfo

Записи для принятых документов

     date RECV commid modem qfile <null> fax ``local-number ``TSI params #pages jobtime
       conntime ``reason ``CIDName ``CIDNumber ``callid <null> ``dcs <null>

Записи о вызовах

     date CALL commid modem <null> <null> fax ``local-number ``<null> 0 0 jobtime conntime
 ``<null> ``CIDName ``CIDNumber ``callid ....

Записи факсах принятых по запросу (Поллингу)

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

Записи об истекших сроках незавершенных работ

     date UNSENT ``<null> ``<null> jobid ....

Записи о работах поставленных в очередь

     date SUBMIT ``<null> ``<null> jobid ....

Описание формата полей в вышеописанных записях

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.

qfile

   The associated queue file for the event.

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.

callid

   The CallID values other than CIDName and CIDNumber formatted by ``:: delimeters.

dcs

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

jobinfo

   Other formatted information about the job:
 totpages, ntries, ndials, totdials, maxdials, tottries, and maxtries separated by slashes (``/)

Примечания

Стоит отметить что поля могут быть пустыми.

это я пока не понял к чему  : :))
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.

Текстовый формат был принят для простого использования программ типа awk.

Если существует исполняемый файл $spool/hylafax/etc/FaxAccounting - он будет запускаться при каждом добавлении записи в etc/xferfaxlog. Поля записей будут переданы как отдельные аргументы в командной строке. Такой механизм позволяет подключить внешнюю базу данных и другой механизм учета. FaxAccounting блокирует вызывающий его процесс HylaFAX, поэтому важно чтобы время этой блокировки не превышало таймауты других процессов HylaFax.

Поле sender не обязательно содержит достоверную информацию об отправителе. Так например оно может быть установлено опцией -f в программе sendfax(8C). Будьте осторожны при использовании этого поля для идентификации.

BUGS

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

Смотри также

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

Hylafax xferfaxlog