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(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.

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), ptm(4D),
pts(4D), attributes(7), standards(7)

illumos February 5, 2022 illumos