ptsname(3C)							   ptsname(3C)

NAME    [Toc]    [Back]

     ptsname - get name	of the slave pseudo-terminal device

SYNOPSIS    [Toc]    [Back]

     #include <stdlib.h>

     char *ptsname(int fildes);

DESCRIPTION    [Toc]    [Back]

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

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

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


									PPPPaaaaggggeeee 1111