ptsname(3C)

NAME
     ptsname - get name of the slave pseudo-terminal device

SYNOPSIS
     #include <stdlib.h>

     char *ptsname(int fildes);

DESCRIPTION
     The function ptsname() returns the name of the slave pseudo-terminal
     device associated with a master pseudo-terminal device.  fildes is a file
     descriptor returned from a successful open of the master device.

RETURN VALUE
     Upon successful completion, ptsname() returns a pointer to a string
     containing the null-terminated path name of the slave device of the form
     /dev/tty[qrstuvwxyz]N, where N is an integer between 0 and 99.  This
     value points to a static data area that is overwritten by each call to
     ptsname().

     Upon failure completion, ptsname() returns NULL.  This could occur if
     fildes is an invalid file descriptor, or if the slave device name does
     not exist in the file system.

SEE ALSO
     open(2), grantpt(3C), ttyname(3C), unlockpt(3C)