|-s speed||Communicate with the modem at a fixed speed; this may be any value recognized by the stty(1) command.|
|-f||Use the fuser(1) command for exclusive access to the device.|
faxaddmodem uses prototype configuration files that have been created for known modems. These prototype files are kept in the config subdirectory and, by convention, have names that identify a brand or type of modem and the DTE-DCE flow control scheme the prototype files configures. The faxaddmodem(8C) program that is used to configure a modem for use with HylaFAX selects a prototype configuration file using information retrieved from the modem and comments embedded in the prototype files. For Class 1 and Class 1.0 modems the product ID code returned by the command ATI0 and the response from the command ATI3 are used to select a prototype configuration file, while for Class 2 modems the manufacturer and model as returned by AT+FMFR? and AT+FMDL?, respectively, are used (or AT+FMI? and AT+FMM? for Class 2.0 and Class 2.1 modems).
A Class 1 prototype configuration file is identified for use by faxaddmodem by searching for a comment of the form:In this example 144 is the product ID code for an AT&T DataPort modem, .* is a regular expression matched against the result string returned by the ATI3 command, and RTSCTS indicates the modem is configured to use hardware flow control during fax operation. The remainder of the line is evaluated by the sh(1) and used to specify the modems manufacturer and model (since Class 1 modems do not have standard commands to query this information).
# CONFIG:CLASS1:144:.*:RTSCTS: Manufacturer=AT&T Model=Dataport
Class 2, 2.0, and 2.1 prototype configuration files match the string manufacturer-model-flowcontrol against a sh(1) glob pattern specified in the configuration file, where manufacturer and model are the strings returned by querying the modem and flowcontrol is either RTSCTS for hardware flow control or XONXOFF for software flow control. For example:
# CONFIG: CLASS2: ZyXEL*-RTSCTS
# CONFIG: CLASS2.0: USRobotics*-XONXOFF
are configuration comments that appear in the prototype file for a ZyXEL 1496E with Class 2 support, and for a US Robotics Courier modem with Class 2.0 firmware.
The faxaddmodem program merges server-specific configuration parameters into a prototype configuration according to comments placed in the prototype file. All lines between BEGIN-SERVER and END-SERVER comments are placed with the appropriate server configuration parameters. Note that this means modem-related configuration parameters must be placed outside this area of the file.
/var/spool/hylafax/etc/setup.cache master configuration parameters /var/spool/hylafax/etc/setup.modem modem-related configuration support /var/spool/hylafax/config prototype configuration files /usr/local/sbin/ondelay program to open device without waiting for carrier /usr/local/sbin/lockname SVR4 UUCP lockfile name generator
Consult hylafax-server(5F) for a complete discussion of the structure and content of the spooling area.
hylafax-server(5F), hylafax-config(5F), faxsetup(8C), faxq(8C), faxgetty(8C), faxmodem(8C), faxconfig(8C), faxsend(8C)
|-->||FAXADDMODEM (8C)||May 12, 1996|