dial, uuchat --
dial a modem
ttyname telno speed
/usr/lib/uucp/dialname -h [ -c ]
/usr/lib/uucp/uuchat ttyname speed
A /usr/lib/uucp/dialname program
dials a modem attached to
(name is a dialer name, such as ``HA1200''.)
Source for the dialname programs is provided in the
respective dialname.c files.
The -h option is used to hang up the modem.
The -c option tells the dialer to wait for a connection
and adjust the line rate to match before returning.
This feature requires that a SIGUSR2 be sent back to
after the modem has been initialized but before the connection has been
Examine the sample dialers in /usr/lib/uucp to see how this is done.
invokes dial with a ttyname,
telno (telephone number), and speed.
attempts to dial the phone number on the specified line at the given speed.
When using dialHA12 or dialHA24,
speed can be a range of baud rates.
The range is specified with the form:
lowrate - highrate
where lowrate is the minimum acceptable connection baud rate and
highrate is the maximum.
The dial program returns the status of the attempt through
the following dial return codes:
If bit 0x80 is a 0, then these bits are used to indicate the actual
connection baud rate. If 0, the baud rate is the same as the baud rate
used to dial the phone number or the highest baud rate if a range
was specified. Otherwise, these four bits are the CBAUD bits
in the struct termio c_flag and the
struct sgttyb sg_ispeed and sg_ospeed
tty ioctl structures.
bit 0x80 = 1
The connection attempt failed.
bits 0x0f = n
If bit 0x80 is a 1, then these bits are the dialer error code n:
general or unknown error code
line is being used
a signal has aborted the dialer
dialer arguments are invalid
the phone number is invalid
the baud rate is invalid or the dialer could not connect
at the requested baud rate
can't open the line
ioctl error on the line
timeout waiting for connection
no dialtone was detected
phone is busy
no carrier is detected
remote system did not answer
Error codes 12-15 are used to indicate that the problem is at the
You can copy and modify one of the files
to use a different modem.
There is a makefile in /usr/lib/uucp
that you can copy and modify to use for compiling a new dialer program.
The dial program to be used on a particular line is specified in
the fifth field of the entry for that line in /usr/lib/uucp/Devices.
If there is no dial program of that name, then uucico,
ct, and cu use a built-in dialer, together with the
chat-script of that name in /usr/lib/uucp/Dialers.
dial -h is executed by getty when it is respawned on
a line shared between dial-in and dial-out. If there is no dial
program, then getty uses /usr/lib/uucp/uuchat, passing it
the ``&'' chat-script from /usr/lib/uucp/Dialers.
You must have the Development System installed in order
to compile and install a new dial program.
dialer default files
source files for the dialer programs
makefile to compile new dialer
program to interpret a chat-script
dial is not part of any currently supported standard; it
is an extension of AT&T System V provided by The Santa
Cruz Operation, Inc.
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003