HP-UX Reference (11i v2 03/08) - 3 Library Functions A-M (vol 6)

d
dial(3C) dial(3C)
Permissible Codes
0-9 dial 0-9
*or: dial*
#or; dial#
- 4-second delay for second dial tone
e or < end-of-number
w or = wait for secondary dial tone
f flash off hook for 1 second
modem Specifies modem control for direct lines. Set to non-zero if modem control is required.
attr Pointer to a
termio structure, as defined in the <termio.h> header file. A NULL
value for this pointer element can be passed to the
dial() function, but if such a
structure is included, the elements specified 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 defined in the <
dial.h> header file.
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 file automatically includes the <
termio.h> header file.
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 fields of the the CALL structure so if dial(),
is reinvoked, reinitialize the values of the CALL structure.
FILES
/etc/uucp/Devices
SEE ALSO
uucp(1), alarm(2), read(2), write(2), thread_safety(5), termio(7).
UUCP tutorial in Remote Access User’s Guide.
HP-UX 11i Version 2: August 2003 − 2 − Hewlett-Packard Company Section 3−−185