ptsname(3C)ptsname(3C)NAMEptsname() - get the pathname of a slave pty (pseudo-terminal)
SYNOPSIS
Obsolescent Interfaces
Remarks
supports STREAMS pty (see ptm(7) and pts(7)), and non-STREAMS pty (see
pty(7)) which have different device naming conventions. Notice that
the STREAMS pty, being an optional feature, is supported only when it
is installed on the system.
is useful only on systems that follow the insf(1M) naming conventions
for pty (STREAMS and non-STREAMS).
DESCRIPTION
The passed parameter, fildes, is a file descriptor of an opened master
pty. generates the name of the slave pty corresponding to this master
pty. This means that their minor numbers will be identical.
Obsolescent Interfaces
gets the pathname of a slave pty (pseudo-terminal).
RETURN VALUE
Upon successful completion, returns a string containing the full path
name of a slave pty. Otherwise, a NULL pointer is returned. The
return value is pointed to static data area which is overwritten with
each call to so it should be copied if it is to be saved.
ERRORS
fails and returns a NULL pointer under the following conditions:
· File descriptor does not refer to an open master pty.
· Request falls outside pty name-space.
· Pty device naming conventions have not been followed.
· failed to find a match.
WARNINGS
is obsolescent interface supported only for compatibility with existing
DCE applications. New multi-threaded applications should use
EXAMPLES
The following example shows how is typically used for non-STREAMS pty
to obtain the pathname of the slave pty corresponding to a master pty
obtained through a pty clone open.
...
The following example shows how is typically used on obtaining the
pathname of the STREAMS slave pty corresponding to a STREAMS master
pty.
...
AUTHOR
and were developed by HP and OSF.
SEE ALSOinsf(1M), devnm(3), pty(7), grantpt(3C), unlockpt(3C), ptm(7), pts(7),
ptem(7), ldterm(7).
ptsname(3C)