Specifications

HYLAFAX-CONFIG(5F) HYLAFAX-CONFIG(5F)
The corresponding DistinctiveRings parameter for this ring cadence would be:
DistinctiveRings: F-8-4-8
where ‘‘F’’tells the faxgetty process that the ring cadence is for a facsimile (‘‘V’’for voice and
‘‘D’’for data), and the other values describe the ring cadence with leading and ending DRingOff
values ignored. Multiple ring cadences are indicated by delimiting them with commas in this fash-
ion:
DistinctiveRings: V-20,F-8-4-8,D-4-2-4-8
DRingOff
Astring that identifies the ‘‘off’’value in anydistinctive ring cadence, for example ‘‘DROF=’’.
See also DRingOn and DistinctiveRings.
DRingOn
Astring that identifies the ‘‘on’’value in anydistinctive ring cadence, for example ‘‘DRON=’’.See
also DRingOff and DistinctiveRings.
DynamicConfig
The pathname of the optional program, e.g. ‘‘etc/localid’’, that makes dynamic configuration
changes, i.e., to LocalIdentifier, based on device ID and call identification. The program is
passed those values as the parameters ($1 = device id, $2 = CallID1, $3 = CallID2, $4 = CallID3,
...), when answering an incoming call. The program can then perform local processing as desired
to send on standard output the configuration items to change in a ‘‘parameter:value’’format, i.e.
‘‘LocalIdentifier: +1.800.555.1212’’. If there are multiple parameters to be changed, then each
item must be on its own line. This is commonly used to dynamically alter the local identification
of systems which use DID/DNIS, but it can also be used to allowdifferent modem configurations
for different senders. This program can also set the RejectCall options to cause the current call to
be rejected instead of answered. Note that this file must be marked as executable by the faxgetty
process.
EGettyArgs
Astring that indicates whether or not the server should use an an external getty application to
deduce and possibly handle an incoming call. 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 corre-
sponding CallIDPattern,ifpresent. The ‘‘%’’character can be specified with ‘‘%%’’. If the
EGettyArgs parameter is not specified in the configuration file or if the string value is null, then
‘‘extern’’connections will be rejected. Note that in addition to the specified command line argu-
ments, the external getty program is invokedwith its standard input, output, and error descriptors
directed to the controlling tty device.
When the external getty application completes, its exit status is evaluated and is interpreted to indi-
cate what, if anything, should be done with the call. An exit status of ‘‘0’’indicates an unknown
call type and that the call should be handled as if the external getty program had not been used.
An exit status of ‘‘1’’indicates a data connection and that the getty(8C) program should be used to
handle the call (see GettyArgs)after being answered with ModemAnswerDataBeginCmd . An
exit status of ‘‘2’’indicates a fax connection that should be handled after being answered with
ModemAnswerFaxBeginCmd.Anexit status of ‘‘3’’indicates a voice call and that the vgetty
program should be used to handle the call (see VGettyArgs)after being answered with BR Mode-
mAnswerVoiceBeginCmd . An exit status of ‘‘4’’isconsidered to be an error condition. The ses-
sion will be terminated. An exit status of ‘‘5’’isused to indicate that the external getty program
handled the call entirely,isnot an error condition, and that the session is to be considered
$Date$ 11