hpux man page for ptsname

ptsname(3C)															       ptsname(3C)

NAME
       ptsname() - get the pathname of a slave pty (pseudo-terminal)

SYNOPSIS
   Obsolescent Interfaces
   Remarks
       supports STREAMS pty (see ptm(7) and pts(7)), and non-STREAMS pty (see pty(7)) which have different device naming conventions.  Notice that
       the STREAMS pty, being an optional feature, is supported only when it is installed on the system.

       is useful only on systems that follow the insf(1M) naming conventions for pty (STREAMS and non-STREAMS).

DESCRIPTION
       The passed parameter, fildes, is a file descriptor of an opened master pty.  generates the name of the slave pty corresponding to this mas-
       ter pty.  This means that their minor numbers will be identical.

   Obsolescent Interfaces
       gets the pathname of a slave pty (pseudo-terminal).

RETURN VALUE
       Upon  successful  completion,  returns  a string containing the full path name of a slave pty.  Otherwise, a NULL pointer is returned.  The
       return value is pointed to static data area which is overwritten with each call to so it should be copied if it is to be saved.

ERRORS
       fails and returns a NULL pointer under the following conditions:

	      o  File descriptor does not refer to an open master pty.

	      o  Request falls outside pty name-space.

	      o  Pty device naming conventions have not been followed.

	      o  failed to find a match.

WARNINGS
       is obsolescent interface supported only for compatibility with existing DCE applications.  New multi-threaded applications should use

EXAMPLES
       The following example shows how is typically used for non-STREAMS pty to obtain the pathname of the slave pty corresponding to a master pty
       obtained through a pty clone open.

		   ...

       The following example shows how is typically used on obtaining the pathname of the STREAMS slave pty corresponding to a STREAMS master pty.

		   ...

AUTHOR
       and were developed by HP and OSF.

SEE ALSO
       insf(1M), devnm(3), pty(7), grantpt(3C), unlockpt(3C), ptm(7), pts(7), ptem(7), ldterm(7).

																       ptsname(3C)