Unix/Linux Go Back    


NetBSD 6.1.5 - man page for ptsname (netbsd section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


PTSNAME(3)			   BSD Library Functions Manual 		       PTSNAME(3)

NAME
     ptsname -- get the pathname of the slave pseudo-terminal device

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <stdlib.h>

     char *
     ptsname(int masterfd);

DESCRIPTION
     The ptsname() function returns the pathname of the slave pseudo-terminal device that corre-
     sponds to the master pseudo-terminal device associated with masterfd.  The ptsname() func-
     tion is not reentrant or thread-safe.

RETURN VALUES
     If successful, ptsname() returns a pointer to a nul-terminated string containing the path-
     name of the slave pseudo-terminal device.	If an error occurs ptsname() will return NULL and
     errno is set to indicate the error.

ERRORS
     The 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.

NOTES
     The 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 ALSO
     ioctl(2), grantpt(3), posix_openpt(3), unlockpt(3)

STANDARDS
     The 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'').

BSD					   May 25, 2004 				      BSD
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 03:37 PM.