HP-UX Reference (11i v1 05/09) - 3 Library Functions A-M (vol 6)

d
dial(3C) dial(3C)
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 struc-
ture 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 negative
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 other-
wise 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.
Section 3144 Hewlett-Packard Company 2 HP-UX 11i Version 1: September 2005