Query: ptsname
OS: netbsd
Section: 3
Links: netbsd man pages all man pages forum categories
Format:Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
PTSNAME(3) BSD Library Functions Manual PTSNAME(3)NAMEptsname -- get the pathname of the slave pseudo-terminal deviceLIBRARYStandard C Library (libc, -lc)SYNOPSIS#include <stdlib.h> char * ptsname(int masterfd);DESCRIPTIONThe ptsname() function returns the pathname of the slave pseudo-terminal device that corresponds to the master pseudo-terminal device associ- ated with masterfd. The ptsname() function is not reentrant or thread-safe.RETURN VALUESIf successful, ptsname() returns a pointer to a nul-terminated string containing the pathname of the slave pseudo-terminal device. If an error occurs ptsname() will return NULL and errno is set to indicate the error.ERRORSThe ptsname() function will fail if: [EACCESS] the corresponding pseudo-terminal device could not be accessed. [EBADF] masterfd is not a valid descriptor. [EINVAL] masterfd is not associated with a master pseudo-terminal device.NOTESThe error returns of ptsname() are a NetBSD extension. The ptsname() function is equivalent to: struct ptmget pm; return ioctl(masterfd, TIOCPTSNAME, &pm) == -1 ? NULL : pm.ps;SEE ALSOioctl(2), grantpt(3), posix_openpt(3), unlockpt(3)STANDARDSThe ptsname() function conforms to IEEE Std 1003.1-2001 (``POSIX.1''). Its first release was in X/Open Portability Guide Issue 4, Version 2 (``XPG4.2'').BSDMay 25, 2004 BSD