dial man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

dial(3C)							      dial(3C)

NAME
       dial(), undial() - establish an outgoing terminal line connection

SYNOPSIS
DESCRIPTION
       The  function  returns  a  file descriptor for a terminal line open for
       read/write.  The argument to is a  structure  (defined  in  the	header
       file).

       When  finished  with the terminal line, the calling program must invoke
       to release the semaphore that has been set during the allocation of the
       terminal device.

       The definition of in the header file is:

       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.	  How‐
			ever,  the high-speed setting of the 212A modem trans‐
			mits 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 structure.  Legal values for
			such terminal device names are kept in the  file.   In
			this  case,  the value of the baud element need not be
			specified as it will be determined from the file.

	      telno	A pointer to a character string representing the tele‐
			phone  number  to be dialed.  Such numbers can consist
			only of symbols described below.  The termination sym‐
			bol  is	 supplied  by  the function, and should not be
			included in the telno string passed to in  the	struc‐
			ture.

			Permissible Codes

			Dial

			Dial

			Dial

			4-second delay for second dial tone

			End of number

			Wait for secondary dial tone

			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 structure, as defined in the header file.
			A NULL value for this pointer element can be passed to
			the function, but if such a structure is included, the
			elements specified in it are set for the outgoing ter‐
			minal line before the connection is established.  This
			is often important for certain attributes such as par‐
			ity 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 header file.

WARNINGS
       Including the header file automatically includes the header file.

       The above routine uses which causes unexpected increases in the size of
       programs that otherwise do not use standard I/O.

       The function will modify the values of some of the fields of the struc‐
       ture  so if is reinvoked, it will reinitialize the values of the struc‐
       ture.

FILES
SEE ALSO
       uucp(1), alarm(2), read(2), write(2), thread_safety(5), termio(7).

       UUCP tutorial in

								      dial(3C)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net