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 |