dial.3c (2010 09)

dial(3C) dial(3C)

structure is included, the elements speciﬁed in it are set for the outgoing terminal line

before the connection is established. This is often important for certain attributes such

as parity and baud rate.

device Holds the device name that establishes the connection.

dev_len Length of the device name that is copied into the array device.

RETURN VALUE

On failure, a negative value indicating the reason for the failure is returned. Mnemonics for these nega-

tive indices as listed here are deﬁned in the

<dial.h> header ﬁle.

INTRPT -1 /* interrupt occurred */

D_HUNG -2 /* dialer hung (no return from write) */

NO_ANS -3 /* no answer within 10 seconds */

ILL_BD -4 /* illegal baud-rate */

A_PROB -5 /* automatic call unit (acu) problem (open() failure) */

L_PROB -6 /* line problem (open() failure) */

NO_Ldv -7 /* can’t open LDEVS file */

DV_NT_A -8 /* requested device not available */

DV_NT_K -9 /* requested device not known */

NO_BD_A -10 /* no device available at requested baud */

NO_BD_K -11 /* no device known at requested baud */

WARNINGS

Including the <dial.h> header ﬁle automatically includes the

<termio.h> header ﬁle.

The above routine uses

<stdio.h>, which causes unexpected increases in the size of programs that oth-

erwise do not use standard I/O.

The

dial() function will modify the values of some of the ﬁelds of the CALL structure so if

dial() is

reinvoked, it will reinitialize the values of the

CALL structure.

FILES

/etc/uucp/Devices