summaryrefslogtreecommitdiffstats
path: root/man3/grantpt.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/grantpt.3')
-rw-r--r--man3/grantpt.336
1 files changed, 16 insertions, 20 deletions
diff --git a/man3/grantpt.3 b/man3/grantpt.3
index b33fdc452..174c5c949 100644
--- a/man3/grantpt.3
+++ b/man3/grantpt.3
@@ -3,7 +3,7 @@
.\" This page is in the public domain. - aeb
.\" %%%LICENSE_END
.\"
-.TH grantpt 3 2023-02-05 "Linux man-pages 6.03"
+.TH grantpt 3 2023-07-20 "Linux man-pages 6.05.01"
.SH NAME
grantpt \- grant access to the slave pseudoterminal
.SH LIBRARY
@@ -66,43 +66,39 @@ argument is not a valid open file descriptor.
The
.I fd
argument is valid but not associated with a master pseudoterminal.
-.SH VERSIONS
-.BR grantpt ()
-is provided since glibc 2.1.
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
-.ad l
-.nh
.TS
allbox;
lbx lb lb
l l l.
Interface Attribute Value
T{
+.na
+.nh
.BR grantpt ()
T} Thread safety MT-Safe locale
.TE
-.hy
-.ad
.sp 1
.SH STANDARDS
-POSIX.1-2001, POSIX.1-2008.
-.SH NOTES
+POSIX.1-2008.
+.SH HISTORY
+glibc 2.1.
+POSIX.1-2001.
+.PP
This is part of the UNIX 98 pseudoterminal support, see
.BR pts (4).
.PP
-Many systems implement this function via a set-user-ID helper binary
+Historical systems implemented this function via a set-user-ID helper binary
called "pt_chown".
-On Linux systems with a devpts filesystem (present since Linux 2.2),
-the kernel normally sets the correct ownership and permissions
-for the pseudoterminal slave when the master is opened
-.RB ( posix_openpt (3)),
-so that nothing must be done by
-.BR grantpt ().
-Thus, no such helper binary is required
-(and indeed it is configured to be absent during the
-glibc build that is typical on many systems).
+glibc on Linux before glibc 2.33 could do so as well,
+in order to support configurations with only BSD pseudoterminals;
+this support has been removed.
+On modern systems this is either a no-op
+\[em]with permissions configured on pty allocation, as is the case on Linux\[em]
+or an
+.BR ioctl (2).
.SH SEE ALSO
.BR open (2),
.BR posix_openpt (3),