Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   9087 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

GRANTPT(3)		 BSD Library Functions Manual		    GRANTPT(3)

NAME
     grantpt — grant access to a slave pseudo-terminal device

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <stdlib.h>

     int
     grantpt(int fildes);

DESCRIPTION
     The grantpt() function changes the mode and ownership of the slave
     pseudo-terminal device that corresponds to the master pseudo-terminal
     device associated with fildes to be owned by the real user id of the
     calling process, group id of tty.	The permissions are set to readable
     and writable by owner, and writable by group.  If the slave pseudo-termi‐
     nal device was being accessed by other file descriptors at the time, all
     such access will be revoked.

RETURN VALUES
     If successful, grantpt() returns 0; otherwise a value of -1 is returned
     and errno is set to indicate the error.

ERRORS
     The grantpt() function will fail if:

     [EACCESS]		the corresponding pseudo-terminal device could not be
			accessed.

     [EBADF]		fildes is not a valid descriptor.

     [EINVAL]		fildes is not associated with a master pseudo-terminal
			device.

NOTES
     Setting the group to tty and revoking accesses by other file descriptors
     are NetBSD extensions.  Calling grantpt() is equivalent to:

	     ioctl(fildes, TIOCGRANTPT, 0);

SEE ALSO
     ioctl(2), posix_openpt(3), ptsname(3), unlockpt(3)

STANDARDS
     The grantpt() 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

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 

Vote for polarhome