ptsname(3c) [hpux man page]

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)

ptsname(3)						     Library Functions Manual							ptsname(3)

NAME

       ptsname, ptsname_r - Gets the name of a slave pseudoterminal device

LIBRARY

       Standard C Library (libc)

SYNOPSIS

       #include <stdlib.h>

       char *ptsname(	   int masterfd);

       The  following  function is not defined in current industry standards and is supported only for backward compatibility.	You should not use
       it in new designs.

       int ptsname_r(	   int masterfd,      char *slavename,	    int len);

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       ptsname(): XSH5.0

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

PARAMETERS

       Specifies a file descriptor that is returned from a successful open of the master pty.  Points to the character	array  for  the  resulting
       null-terminated pathname of the slave pty.  Specifies the length of the slave pty specified by slavename.  This length must be 32 bytes.

DESCRIPTION

       The ptsname() function returns the name of the slave pseudoterminal device associated with a master pseudoterminal device.

NOTES

       The  ptsname()  function  returns a pointer to thread-specific data.  Subsequent calls to this function from the same thread overwrite this
       data.

       [Tru64 UNIX]  The ptsname_r() function is an obsolete reentrant version of the ptsname() function.  It is supported in  order  to  maintain
       backward compatibility with previous versions of the operating system and should not be used in new designs.

RETURN VALUES

       Upon  successful  completion,  the  ptsname() function returns a pointer to a string that contains the pathname of the slave pseudoterminal
       device.	The pathname has the form: /dev/pts /N.  Upon failure, it returns a null pointer.  The function can fail if the masterfd parameter
       is an invalid file descriptor or if the slave device name does not exist in the file system.

       [Tru64  UNIX]  Upon successful completion, the ptsname_r() function stores a the string in slavename and returns a value of 0 (zero).  Upon
       failure, it returns a value of -1 and may place an appropriate value in the errno variable.

ERRORS

       If the following conditions occur, the ptsname_r() function sets errno to the following value: [Tru64  UNIX]  The  slavename  parameter	is
       invalid or the len parameter is too small.

RELATED INFORMATION

       Functions: openpty(3), pty(7)

       Standards: standards(5) delim off

																	ptsname(3)