HP-UX Reference (11i v1 00/12) - 3 Library Functions A-M (vol 6)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/!!!intro.3c
________________________________________________________________
___ ___
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 establishesthe connection.
dev_len Length of the device name that is copied into the array device.
APPLICATION USAGE
dial() and undial() are thread-safe. These interfaces are not cancel-safe. A cancellation point may
occur when a thread is executing dial() or undial().
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), termio(7).
UUCP tutorial in Remote Access User’s Guide.
HP-UX Release 11i: December 2000 − 2 − Section 3−−143
___
___