Section (3) ptsname
ptsname, ptsname_r — get the name of the slave pseudoterminal
returns the name of the slave pseudoterminal device
corresponding to the master referred to by
ptsname_r() function is
the reentrant equivalent of
ptsname(). It returns the name of the slave
pseudoterminal device as a null-terminated string in the
buffer pointed to by
buflen argument specifies the
number of bytes available in
returns a pointer to a string in static storage which will be
overwritten by subsequent calls. This pointer must not be
freed. On failure, NULL is returned.
returns 0. On failure, a nonzero value is returned and
errno is set to indicate the
bufis NULL. (This error is returned only for glibc 2.25 and earlier.)
fddoes not refer to a pseudoterminal master device.
bufis too small.
For an explanation of the terms used in this section, see attributes(7).
||Thread safety||MT-Unsafe race:ptsname|
ptsname() is part of the
UNIX 98 pseudoterminal support (see pts(4)).
ptsname_r() is a Linux
extension, that is proposed for inclusion in the next major
revision of POSIX.1 (Issue 8). A version of this function is
documented on Tru64 and HP-UX, but on those implementations,
−1 is returned on error, with
errno set to indicate the error. Avoid using
this function in portable programs.
This page is part of release 4.16 of the Linux
man-pages project. A
description of the project, information about reporting bugs,
and the latest version of this page, can be found at
This page is in the public domain. - aeb
2004-12-17, mtk, added description of ptsname_r() + ERRORS