Print this page
14249 pseudo-terminal nomenclature should reflect POSIX
Change-Id: Ib4a3cef899ff4c71b09cb0dc6878863c5e8357bc

*** 1,49 **** PTSNAME(3C) Standard C Library Functions PTSNAME(3C) NAME ! ptsname - get name of the slave pseudo-terminal device SYNOPSIS #include <stdlib.h> ! char *ptsname(int fildes); - DESCRIPTION ! The ptsname() function 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. ! ptsname() returns a pointer to a string containing the null-terminated ! path name of the slave device of the form /dev/pts/N, where N is a non- ! negative integer. RETURN VALUES ! Upon successful completion, the function ptsname() returns a pointer to ! a string which is the name of the pseudo-terminal slave 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 slave device name does ! not exist in the file system. ! ATTRIBUTES ! See attributes(5) for descriptions of the following attributes: - - +--------------------+-----------------+ - | ATTRIBUTE TYPE | ATTRIBUTE VALUE | - +--------------------+-----------------+ - |Interface Stability | Standard | - +--------------------+-----------------+ - |MT-Level | Safe | - +--------------------+-----------------+ - SEE ALSO ! open(2), grantpt(3C), ttyname(3C), unlockpt(3C), attributes(5), ! standards(5) ! ! STREAMS Programming Guide ! ! August 14, 2002 PTSNAME(3C) --- 1,42 ---- PTSNAME(3C) Standard C Library Functions PTSNAME(3C) NAME ! ptsname - get the name of the subsidiary device of a pseudo-terminal SYNOPSIS #include <stdlib.h> ! char * ! ptsname(int fildes); DESCRIPTION ! 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(7D) 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. + RETURN VALUES ! 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. + INTERFACE STABILITY + Committed + MT LEVEL + Safe SEE ALSO ! open(2), grantpt(3C), posix_openpt(3C), ttyname(3C), unlockpt(3C), ! attributes(5), standards(5), ptm(7D), pts(7D) ! illumos February 5, 2022 illumos