www.delorie.com/gnu/docs/uucp/uucp_78.html

search

	Buy GNU books!

Taylor UUCP

5.9 The Dialer Configuration File

The dialer configuration files define dialers. By default there is a single dialer file, named `dial' in the directory newconfigdir. This may be overridden by the dialfile command in the main configuration file; see 5.6.2 Configuration File Names.

Any commands in the file before the first dialer command specify defaults for all the dialers in the file. All commands after a dialer command up to the next dialer command are associated with the named dialer.

dialer string

Introduces and names a dialer.

chat strings

chat-timeout number

chat-fail string

chat-seven-bit boolean

chat-program strings

Specify a chat script to be used to dial the phone. This chat script is used before the login chat script in the `sys' file, if any (see section 5.7.3.3 Logging In). For full details on chat scripts, see 5.5 Chat Scripts.

The uucico daemon will sleep for one second between attempts to dial out on a modem. If your modem requires a longer wait period, you must start your chat script with delays (`\d' in a send string).

The chat script will be read from and sent to the port specified by the dial-device command for the port, if there is one.

The following escape addition escape sequences may appear in send strings:

\D

send phone number without dialcode translation

\T

send phone number with dialcode translation

\M

do not require carrier

\m

require carrier (fail if not present)

See the description of the dialcodes file (see section 5.6.2 Configuration File Names) for a description of dialcode translation. If the port does not support carrier, as set by the carrier command in the port file, \M and \m are ignored. If both the port and the dialer support carrier, as set by the carrier command in the port file and the carrier command in the dialer file, then every chat script implicitly begins with \M and ends with \m. There is no default chat script for dialers.

The following additional escape sequences may be used in chat-program:

\D

phone number without dialcode translation

\T

phone number with dialcode translation

If the program changes the port in any way (e.g., sets parity) the changes will be preserved during protocol negotiation, but once the protocol is selected it will change the port settings.

dialtone string

A string to output when dialing the phone number which causes the modem to wait for a secondary dial tone. This is used to translate the = character in a phone number. The default is a comma.

pause string

A string to output when dialing the phone number which causes the modem to wait for 1 second. This is used to translate the - character in a phone number. The default is a comma.

carrier boolean

An argument of true means that the dialer supports the modem carrier signal. After the phone number is dialed, uucico will require that carrier be on. One some systems, it will be able to wait for it. If the argument is false, carrier will not be required. The default is true.

carrier-wait number

If the port is supposed to wait for carrier, this may be used to indicate how many seconds to wait. The default is 60 seconds. Only some systems support waiting for carrier.

dtr-toggle boolean boolean

If the first argument is true, then DTR is toggled before using the modem. This is only supported on some systems and some ports. The second boolean need not be present; if it is, and it is true, the program will sleep for 1 second after toggling DTR. The default is to not toggle DTR.

complete-chat strings

complete-chat-timeout number

complete-chat-fail string

complete-chat-seven-bit boolean

complete-chat-program strings

These commands define a chat script (see section 5.5 Chat Scripts) which is run when a call is finished normally. This allows the modem to be reset. There is no default. No additional escape sequences may be used.

complete string

This is a simple use of complete-chat. It is equivalent to complete-chat "" string; this has the effect of sending string to the modem when a call finishes normally.

abort-chat strings

abort-chat-timeout number

abort-chat-fail string

abort-chat-seven-bit boolean

abort-chat-program strings

These commands define a chat script (see section 5.5 Chat Scripts) to be run when a call is aborted. They may be used to interrupt and reset the modem. There is no default. No additional escape sequences may be used.

abort string

This is a simple use of abort-chat. It is equivalent to abort-chat "" string; this has the effect of sending string to the modem when a call is aborted.

protocol-parameter character strings

Set protocol parameters, just like the protocol-parameter command in the system configuration file or the port configuration file; see 5.7.5 Protocol Selection. These parameters take precedence, then those for the port, then those for the system.

seven-bit boolean

This is only used during protocol negotiation; if it is true, it forces selection of a protocol which works across a seven-bit link. It does not prevent eight bit characters from being transmitted. The default is false. It would be more common to specify this for a port than for a dialer.

reliable boolean

This is only used during protocol negotiation; if it is false, it forces selection of a protocol which works across an unreliable communication link. The default is true.

half-duplex boolean [ any type ]

If the argument is true, it means that the dialer only supports half-duplex connections. This only affects bidirectional protocols, and causes them to not do bidirectional transfers.