DIAL(M) XENIX System V DIAL(M)
Name
dial - Dials a modem.
Syntax
/usr/lib/uucp/dial ttyname telno speed
/usr/lib/uucp/dial -h ttyname speed
Description
/usr/lib/uucp/dial dials a modem attached to ttyname.
Although the installed dialer program is a compiled ``C''
program, you can also create a shell script to perform
dialing functions. The -h option is used to hang up the
modem.
uucp(C) and cu(C) use /usr/lib/uucp/dial. Three dialer
programs are distributed. dialHA12 is for the Hayes
Smartmodem 1200 and 1200B. dialHA24 is for the Hayes
Smartmodem 2400. dialVA3450 is for the Racal-Vadic VA3450-
Series dialers. The dial program in /usr/lib/uucp is linked
to dialHA12. Source for dialHA12 is provided in the file
dialHA12.c.
uucp(C) 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.
bit 0x10 = 1
The line is also used for dial-in and the getty has
been suspended. This bit is used to tell uucp and
cu that they must call dial with the -h flag when
they are finished using the line.
Page 1 (printed 8/7/87)
DIAL(M) XENIX System V DIAL(M)
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 and uucp and cu should not try
another line.
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.
If the specified line has been configured as a dial-
in/dial-out line, dial invokes ungetty(M) to suspend the
Page 2 (printed 8/7/87)
DIAL(M) XENIX System V DIAL(M)
getty, making it a dial-out line. When the dial-out session
is finished, dial should be called
with the -h option to restore the dial-in line. (See
ungetty(M).) If uucp or cu abort abnormally, the line will
still be enabled for dial-out. Use who -a to check the line
status. If the serial line is still in a dial-out state, use
ungetty -r to restore the dial-in line.
You can copy and modify the file /usr/lib/uucp/dialHA12.c 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.
Files
/usr/lib/uucp/dial Default dialer program used by
uucp
/usr/lib/uucp/dialHA12.c C source program for dialHA12
/usr/lib/uucp/dialVA3450 Racal Vadic 3450 dialer
/usr/lib/uucp/dialVA212 Racal Vadic VA212 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 and link new
dial
See Also
dial(S), uucp(C), uux(C), ungetty(M)
Notes
You must have the Development System installed in order to
compile and install a new dial program.
Page 3 (printed 8/7/87)