dial.3c (2010 09)

d
dial(3C) dial(3C)
NAME
dial(), undial() - establish an outgoing terminal line connection
SYNOPSIS
#include <dial.h>
int dial(CALL call);
void undial(int fd);
DESCRIPTION
The dial() function returns a file descriptor for a terminal line open for read/write. The argument to
dial() is a CALL structure (defined in the
<dial.h> header file).
When finished with the terminal line, the calling program must invoke
undial() to release the sema-
phore that has been set during the allocation of the terminal device.
The definition of
CALL in the
<dial.h> header file is:
typedef struct {
struct termio *attr; /* pointer to termio attribute struct */
int baud; /* transmission data rate */
int speed; /* 212A modem: low=300, high=1200 */
char *line; /* device name for out-going line */
char *telno; /* pointer to tel-no digits string */
int modem; /* specify modem control for direct lines */
char *device; /* Will hold the name of the device used
to make a connection */
int dev_len; /* The length of the device used to
make connection */
} CALL;
CALL elements are as follows:
speed Intended only for use with an outgoing dialed call, in which case its value should be
either 300 or 1200 to identify the 113A modem, or the high- or low-speed setting on the
212A modem. Note that the 113A modem or the low-speed setting of the 212A modem
transmits at any rate between 0 and 300 bits per second. However, the high-speed set-
ting of the 212A modem transmits and receives at 1200 bits per second only.
baud Desired transmission baud rate. For example, one might set baud to 110 and speed to
300 (or 1200). However, if speed is set to 1200, baud must be set to high (1200).
line If the desired terminal line is a direct line, a string pointer to its device name should be
placed in the line element in the
CALL structure. Legal values for such terminal device
names are kept in the Devices file. In this case, the value of the baud element need
not be specified as it will be determined from the
Devices file.
telno A pointer to a character string representing the telephone number to be dialed. Such
numbers can consist only of symbols described below. The termination symbol is sup-
plied by the
dial() function, and should not be included in the telno string passed to
dial() in the CALL structure.
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
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1