| PTSNAME(3C) | Standard C Library Functions | PTSNAME(3C) |
ptsname — get the
name of the subsidiary device of a pseudo-terminal
#include
<stdlib.h>
char *
ptsname(int fildes);
The
ptsname()
function returns the name of the pseudo-terminal subsidiary device
associated with a pseudo-terminal manager device. The
fildes argument is a file descriptor returned from a
successful open of the pseudo-terminal manager device; e.g., by calling
posix_openpt(3C) or by
performing an open(2) of the
ptm(4D) device.
The
ptsname()
function returns a pointer to a string containing the null-terminated path
name of the subsidiary device. This string is of the form
/dev/pts/N, where
N is a
non-negative integer.
If successful, the ptsname() function
returns a pointer to a string which is the name of the pseudo-terminal
subsidiary device. This value points to a static data area that is
overwritten by each call to ptsname().
Upon failure, ptsname() returns
NULL. This could occur if
fildes is an invalid file descriptor or if the
subsidiary device name does not exist in the file system.
open(2), grantpt(3C), posix_openpt(3C), ttyname(3C), unlockpt(3C), ptm(4D), pts(4D), attributes(7), standards(7)
| February 5, 2022 | OmniOS |