DIAL(ADM) XENIX System V DIAL(ADM)
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. A
number of dialer binaries are distributed (there may be
differences between -286 and -386 distributions):
___________________________________________________
| Binary File Modem |
|__________________________________________________|
| dialHA12 Hayes Smartmodem 1200 or compatible|
| dialHA24 Hayes Smartmodem 2400 or compatible|
| dialHA96V Hayes Smartmodem 9600 or compatible|
| dialMUL Multitech Multimodem 224 EH |
| dialVA3450 Racal Vadic 3451 modem |
| dialVA96 Racal Vadic 9600 modem |
| dialTBIT Telebit Trailblazer Modem |
|__________________________________________________|
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
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.
Page 1 (printed 2/7/91)
DIAL(ADM) XENIX System V DIAL(ADM)
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
c_flag and the struct sgttyb sg_ispeed and sg_ospeed 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
Page 2 (printed 2/7/91)
DIAL(ADM) XENIX System V DIAL(ADM)
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/dial/* Location of dialer binaries and
source
/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.
Page 3 (printed 2/7/91)