DIAL(ADM) UNIX System V
Name
dial, uuchat - dials a modem
Syntax
/usr/lib/uucp/dialX ttyname telno speed
/usr/lib/uucp/dialX -h ttyname speed
/usr/lib/uucp/uuchat ttyname speed chat-script
Description
/usr/lib/uucp/dialX dials a modem attached to ttyname. (X
is a dialer name, such as HA1200.) The -h option is used to
hang up the modem.
uucico(ADM), ct(C), and cu(C) use /usr/lib/uucp/dialX. Four
dialer programs are distributed. dialHA12 is for the Hayesr
Smartmodem 1200 and 1200B (and compatibles). dialHA24 is
for the Hayesr Smartmodem 2400 (and compatibles).
dialVA3450 is for the Racal-Vadic VA3450-Series dialers.
dialTBIT is for the Telebit Trailblazer. Source for these
is provided in their respective .c files.
uucico(ADM) invokes dial, with a ttyname, telno (phone
number), and speed. dial attempts to dial the phone number
on the specified line at the given speed. When using the
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:
bit 0x80 = 1
The connection attempt failed.
bits 0x0f =
If bit 0x80 is a 1, then these bits are the dialer
error code:
0 general or unknown error code.
1 line is being used.
2 a signal has aborted the dialer.
3 dialer arguments are invalid.
4 the phone number is invalid.
5 the baud rate is invalid or the dialer
could not connect at the requested baud
rate.
6 can't open the line.
7 ioctl error on the line.
8 timeout waiting for connection.
9 no dialtone was detected.
10 unused.
11 unused.
12 unused.
13 phone is busy.
14 no carrier is detected.
15 remote system did not answer.
Error codes 12-15 are used to indicate that the problem
is at the remote end.
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
cflag and the struct sgttyb sgispeed and
sgospeed tty ioctl structures.
You can copy and modify one of the files
/usr/lib/uucp/dialHA12.c etc., to use a different modem.
There is a makefile in /usr/lib/uucp which should be
modified for the new dialer, and can be used to compile the
new program.
If you create a dial program for another modem, send us the
source. User generated dial programs will be considered for
inclusion in future releases.
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.
Files
/usr/lib/uucp/Devices
/usr/lib/uucp/dialVA3450 Racal Vadic 3450 dialer
/usr/lib/uucp/dialHA12 Hayes Smartmodem 1200/1200B dialer
/usr/lib/uucp/dialHA24 Hayes Smartmodem 2400 dialer
/usr/lib/uucp/makefile Makefile to compile new dialer
/usr/lib/uucp/dialTBIT Telebit Trailblazer dialer
/usr/lib/uucp/uuchat
See Also
ct(C), cu(C), uucico(ADM), dialers(F), getty(M)
Notes
You must have the Development System installed in order to
compile and install a new dial program.
Value Added
dial is an extension of AT&T System V provided by the Santa
Cruz Operation.
(printed 8/23/89) DIAL(ADM)