Specifications

HYLAFAX-CONFIG(5F) HYLAFAX-CONFIG(5F)

AreaCode²

The local area code in which the facsimile modem resides. This value is passed to the dial string

rules that are used, for example, to formulate canonical phone numbers for dialing (see Dial-

StringRules below.)

AuditHook¹

Speciﬁes a program command and an interest speciﬁcation indicating which events as described in

faxwatch(8C) should trigger the execution of the program. Forexample, this conﬁguration:

AuditHook: "bin/hook: J*S*M*R*"

would cause bin/hook to be executed upon every event. The arguments passed to the hook pro-

gram are respectively <class>, <mask>, <id>,and optionally [info] where...

<class> = JOB | SEND | MODEM | RECV

<mask> = the speciﬁc event

<id> = id of the job/modem with which the event is associated

[info] = additional information

BadPageHandlingMethod

(Class 1/1.0 only) Speciﬁes howtoreact to a bad page receivedfrom the remote sender: one of

‘‘RTN’’,‘‘DCN’’,or‘‘RTN-SAVE’’.

If a page is receivedinnon-ECM mode with unacceptable quality according to PercentGood-

Lines or MaxConseutiveBadLines then it can be somewhat difﬁcult to inform the sender of the

problem. Historically, HylaFAX has assumed that signalling RTN to the sender will accomplish

this. However, some senders are incapable of retransmitting pages, and to reduce burden theytreat

an RTN signal as a receipt conﬁrmation and proceed to the next page without notifying the send-

ing user of the potential problem in readability on the receive-end. (The assumption there being

that the receiving user will notify the sending user if there actually is a readability problem.)

Asetting of ‘‘RTN’’ isthe historic behavior and assumes that an RTN signal will be enough to get

the sender to retransmit or be otherwise informed of a potential readability problem on the receive-

end. The previously-receivedpage data is marked to be overwritten by the next page data received

from the sender.

Asetting of ‘‘DCN’’ tells HylaFAX to transmit a DCN signal in response to the post-page message

and should trigger a call abortion by the sender.This should clearly indicate a problem in page

readability to the sender,although the receipt of anyfollowing pages in a later call cannot be guar-

anteed.

Asetting of ‘‘RTN-SAVE’’ more closely approximates the behavior of other fax receivers (espe-

cially fax machines). It causes HylaFAX to send the RTN signal but it savesthe previously

receivedpage data and places the next transmitted page data in another page. This is the default

setting. However, this could result in multiple copies of the same page image being savedinthe

same ﬁle - if the sender does indeed retransmit the unacceptable pages during the same call.

BatchLogs¹

When sending or receiving multiple documents (denoted by EOM), this value determines if the

session logs span the entire batch or,ifset to no, only contain a single document.

CallIDPattern

Astring that identiﬁes the caller’sidentity in anycall identiﬁcation messages provided by the

modem (such as Caller*ID or DNIS/DID). The speciﬁed string is compared against anyunrecog-

nized status messages receivedfrom the modem before ModemAnswerCmd is sent to the

modem. If there is a match, then the remainder of the message is returned as CallIDn where n

$Date$ 8