Specifications

HYLAFAX-CONFIG(5F) HYLAFAX-CONFIG(5F)
letters, but create lockfiles with lower-case letters.
VGettyArgs
Astring that indicates whether or not the server should invoke a voice getty program in response
to an incoming voice call. If the string value is not null, then it is interpreted as a set of arguments
to pass to the vgetty 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
1through 9 (‘‘%1’’through ‘‘%9’’) are replaced by the match to the corresponding CallIDPat-
tern,ifpresent. The ‘‘%’’character can be specified with ‘‘%%’’. If the VGettyArgs parameter
is not specified in the configuration file or if the string value is null, then voice connections will be
rejected. Note that in addition to the specified command line arguments, the vgetty program is
invokedwith its standard input, output, and error descriptors directed to the controlling tty device.
WedgedCmd¹
The command to invoke when a modem is deemed ‘‘wedged’’;see wedged(8C).
MODEM-ORIENTED CONFIGURATION PARAMETERS
This section lists configuration parameters that are specific to the setup and operation of the modem. All
commands must be specified exactly as theyare to be transmitted to the modem (note that this is a depar-
ture from previous versions of this software that automatically prepended ‘‘AT’’ toeach line of commands
sent to the modem). When multi-line commands are required, enclose the commands in quote marks (‘‘"’’)
and insert a newline character ‘‘\n’’where lines should be broken. An example of a multi-line command
string is ‘‘AT+FCQ=1\nAT+FBADMUL=20\nAT+FBADLIN=10’’.
Command strings sent to the modem may include command escapes that force the host to alter the DTE-
DCE communication rate, the flowcontrol scheme used between the host and modem, delay for a period of
time, flush input data, and wait for a specific response from the modem. The following escape codes are
interpreted:
Escape Effect
<none> enable no flowcontrol between DTE and DCE
<xon> enable software flowcontrol between DTE and DCE
<rts> enable hardware flowcontrol between DTE and DCE
<2400> set the DCE-DTE baud rate to 2400 bps
<4800> set the DCE-DTE baud rate to 4800 bps
<9600> set the DCE-DTE baud rate to 9600 bps
<19200> set the DCE-DTE baud rate to 19200 bps
<38400> set the DCE-DTE baud rate to 38400 bps
<57600> set the DCE-DTE baud rate to 57600 bps
<76800> set the DCE-DTE baud rate to 76800 bps
<115200> set the DCE-DTE baud rate to 115200 bps
<delay:N> delay Nx10msonthe host (0 <= N <= 255)
<flush> flush anypending input data from the modem
<waitfor:R> wait for the response R from the modem (see below)
<play:filename> play the specified audio file (see below)
Note that commands to the left of an escape code are sent to the modem before the associated actions are
carried out on the host. This may be important when changing baud rates, as the result code from a com-
mand may be returned at the newbaud rate. Also, beware that not all baud rates are supported by all sys-
tems and modems; the set of baud rates supported by a host is usually listed in stty(1).
The ‘‘<waitfor:..>’’escape can be used to override the default behaviour which is to wait for an ‘‘OK’’
$Date$ 21