NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       #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 );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

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

NOTES    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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.

SEE ALSO    [Toc]    [Back]

       Functions: openpty(3), pty(7)

       Standards: standards(5)



                                                       ptsname(3)