Specifications

HYLAFAX-CONFIG(5F) HYLAFAX-CONFIG(5F)
JobRetryNoCarrier
The number of times to redial a phone number after the dialing attempt failed because of NO
CARRIER when the number has not been successfully dialed before. In normal operation the fax
server will treat this result code to mean that a facsimile modem/machine did not answer the phone
and reject the transmit job.This is done to avoid repeatedly dialing wrong phone numbers and
depends on the modem distinguishing between no carrier and no answer.Howev e r, some modems
are not capable of reliably distinguishing between no carrier and no answer,orwhen instructed to
do so do not identify a busy signal correctly.For these modems one may find it necessary to
increase the value of this parameter to compensate. It is strongly recommended, however, that this
value not be set to a large number.
JobRetryOther
The number of times to redial a phone number after the dialing attempt failed for a reason not
already covered by one of the other JobRetry* parameters when the number has not been success-
fully dialed before.
GettyArgs
Astring that indicates whether or not the server should invoke the getty(8C) program in response
to an incoming call from a data modem. If the string value is not null, then it is interpreted as a set
of arguments to pass to the getty program. Before supplying the arguments, the string is first
scanned for ‘‘%’’-escape sequences: anyappearance of ‘‘%l’’isreplaced with the tty name and
anyappearance of ‘‘%s’’isreplaced with the serial port speed (in decimal). Anyappearance of
escaped numbers 1 through 9 (‘‘%1’’through ‘‘%9’’) are replaced by the match to the correspond-
ing CallIDPattern,ifpresent. The ‘‘%’’character can be specified with ‘‘%%’’. If the Gett-
yArgs parameter is not specified in the configuration file or if the string value is null, then data
connections will be rejected. Note that in addition to the specified command line arguments, the
getty program is invokedwith its standard input, output, and error descriptors directed to the con-
trolling tty device.
LocalIdentifier
The local station identification string to use when transmitting TSI and CSI strings (see FAXNum-
ber above). NB: while this string may contain anyprintable ASCII characters; beware that CCITT
T.30 specifies a restricted character set and some fax modems and machines may reject or not dis-
play non-conforming strings. If the local identifier is not specified, a canonical form of the
FAXNumber is used instead.
LockDataCalls
Hold the UUCP lockfile during the time an inbound data call is processed by the external getty pro-
gram. If this is disabled then the lockfile will be removedjust before the getty program is invoked.
Note howeverthat doing this introduces a race condition whereby an outbound program may
sneak in and takecontrol of the modem after the inbound call has been accepted, but before the
getty program has started up and installed it’sown lockfile.
LockVoiceCalls
Hold the UUCP lockfile during the time an inbound data call is processed by the external voice
getty program. If this is disabled then the lockfile will be removedjust before the voice getty pro-
gram is invoked. Note howeverthat doing this introduces a race condition whereby an outbound
program may sneak in and takecontrol of the modem after the inbound call has been accepted, but
before the voice getty program has started up and installed it’sown lockfile.
LogFacility²
The symbolic name for the syslog(3) facility to use when logging error messages and informa-
tional/debugging messages requested through the ServerTracing parameter.The list of facility
names is standardized; it can be found in the system include file <syslog.h>;comparisons are
case-insensitive.
LogCalls
Log all incoming calls into xferfaxlog as CALL records. This allows a quick check of all incom-
ing calls, regardless of fax completion or not in a unified manner with other fax logs.
$Date$ 13