ptsname(3)ptsname(3)NAME
ptsname, ptsname_r - Get the name of a slave pseudoterminal device
SYNOPSIS
#include <stdlib.h>
char *ptsname(
int masterfd );
The following function is not defined in current industry standards and
is supported only for backward compatibility. You should not use it in
new designs.
int ptsname_r(
int masterfd,
char *slavename,
int len );
LIBRARY
Standard C Library (libc)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
ptsname(): XSH5.0
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
PARAMETERS
Specifies a file descriptor that is returned from a successful open of
the master pty. Points to the character array for the resulting null-
terminated pathname of the slave pty. Specifies the length of the
slave pty specified by slavename. This length must be 32 bytes.
DESCRIPTION
The ptsname() function returns the name of the slave pseudoterminal
device associated with a master pseudoterminal device.
NOTES
The ptsname() function returns a pointer to thread-specific data. Sub‐
sequent calls to this function from the same thread overwrite this
data.
[Tru64 UNIX] The ptsname_r() function is an obsolete reentrant version
of the ptsname() function. It is supported in order to maintain back‐
ward compatibility with previous versions of the operating system and
should not be used in new designs.
RETURN VALUES
Upon successful completion, the ptsname() function returns a pointer to
a string that contains the pathname of the slave pseudoterminal device.
The pathname has the form: /dev/pts /N. Upon failure, it returns a null
pointer. The function can fail if the masterfd parameter is an invalid
file descriptor or if the slave device name does not exist in the file
system.
[Tru64 UNIX] Upon successful completion, the ptsname_r() function
stores a the string in slavename and returns a value of 0 (zero). Upon
failure, it returns a value of -1 and may place an appropriate value in
the errno variable.
ERRORS
If the following conditions occur, the ptsname_r() function sets errno
to the following value: [Tru64 UNIX] The slavename parameter is
invalid or the len parameter is too small.
SEE ALSO
Functions: openpty(3), pty(7)
Standards: standards(5)ptsname(3)