aboutsummaryrefslogtreecommitdiffstats
diff options
authorGünther Noack <gnoack3000@gmail.com>2025-05-02 12:24:03 +0200
committerAlejandro Colomar <alx@kernel.org>2025-05-02 12:32:30 +0200
commit5889aa978ddc93d31d3c48c29899761ebde3f53d (patch)
treea76dc46d4dccfa69be51e293b53591ef864c86f4
parent84521911eab71ce5ff83365c75dfce846d12ce97 (diff)
downloadman-pages-master.tar.gz
man/man2const/TIOCLINUX.2const: Document CAP_SYS_ADMIN requirement for TIOCL_SETSEL modesHEADmaster
CAP_SYS_ADMIN was previously required for the entire TIOCL_SETSEL subcode, but is now only needed for a subset of the selection modes, since linux.git 2f83e38a095f (2025-01-13; "tty: Permit some TIOCL_SETSEL modes without CAP_SYS_ADMIN"). The CAP_SYS_ADMIN requirement for TIOCL_SELMOUSEREPORT was further corrected in linux.git ee6a44da3c87 (2025-04-11; "tty: Require CAP_SYS_ADMIN for all usages of TIOCL_SELMOUSEREPORT"). Admittedly, there are kernels where CAP_SYS_ADMIN was briefly not required for TIOCL_SELMOUSEREPORT, even after Linux v6.7, but this was a mistake which is now fixed in all up-to-date stable kernels. Therefore, we still document CAP_SYS_ADMIN as required "since Linux 6.7" in this case. Link: <https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit?id=2f83e38a095f8bf7c6029883d894668b03b9bd93> Link: <https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit?id=ee6a44da3c87cf64d67dd02be8c0127a5bf56175> Signed-off-by: Günther Noack <gnoack3000@gmail.com> Message-ID: <20250502102405.4891-2-gnoack3000@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
-rw-r--r--man/man2const/TIOCLINUX.2const16
1 files changed, 14 insertions, 2 deletions
diff --git a/man/man2const/TIOCLINUX.2const b/man/man2const/TIOCLINUX.2const
index 61f1c596d0..b98a0202bf 100644
--- a/man/man2const/TIOCLINUX.2const
+++ b/man/man2const/TIOCLINUX.2const
@@ -72,18 +72,30 @@ may be one of the following operations:
Select character-by-character.
The indicated screen characters are highlighted
and saved in a kernel buffer.
+.IP
+Since Linux 6.7, using this selection mode requires the
+.B CAP_SYS_ADMIN
+capability.
.TP
.B TIOCL_SELWORD
Select word-by-word,
expanding the selection outwards to align with word boundaries.
The indicated screen characters are highlighted
and saved in a kernel buffer.
+.IP
+Since Linux 6.7, using this selection mode requires the
+.B CAP_SYS_ADMIN
+capability.
.TP
.B TIOCL_SELLINE
Select line-by-line,
expanding the selection outwards to select full lines.
The indicated screen characters are highlighted
and saved in a kernel buffer.
+.IP
+Since Linux 6.7, using this selection mode requires the
+.B CAP_SYS_ADMIN
+capability.
.TP
.B TIOCL_SELPOINTER
Show the pointer at position
@@ -118,11 +130,11 @@ If mouse reporting is not enabled for the terminal,
this operation yields an
.B EINVAL
error.
-.RE
.IP
-Since Linux 6.7, using this subcode requires the
+Since Linux 6.7, using this selection mode requires the
.B CAP_SYS_ADMIN
capability.
+.RE
.TP
.BR subcode = TIOCL_PASTESEL
Paste selection.