Skip to contentSkip to conversation

ioctl_tty.2: Document CAP_SYS_ADMIN requirement for TIOCSTI

PATCH In review Günther Noack 3 participants 3 messages Sep 13, 2023 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 ioctl_tty.2: Document CAP_SYS_ADMIN requirement for TIOCSTI

Cc Samuel Thibault <[email protected]>
Cc Kees Cook <[email protected]>
---
 man2/ioctl_tty.2 | 9 +++++++++
 1 file changed, 9 insertions(+)
man2/ioctl_tty.2 +9 -0
index 85577f80f..ebad97bcf 100644
@@ -334,6 +334,15 @@ Argument:
 .BI "const char\~*" argp
 .IP
 Insert the given byte in the input queue.
+.IP
+Since Linux 6.2,
+.\" commit 690c8b804ad2eafbd35da5d3c95ad325ca7d5061
+.\" commit 83efeeeb3d04b22aaed1df99bc70a48fe9d22c4d
+this operation may require the
+.B CAP_SYS_ADMIN
+capability (if the
+.I dev.tty.legacy_tiocsti
+sysctl variable is set to false).
 .SS Redirecting console output
 .TP
 .B TIOCCONS
Signature · 1 line
2.42.0.283.g2d96d420d3-goog
Reviewed-by on v1 1/1
#1 lore raw

Günther Noack, le mer. 13 sept. 2023 13:06:31 +0200, a ecrit:

Quoted 3 lines
Cc Samuel Thibault <[email protected]>
Cc Kees Cook <[email protected]>
Quoted 26 lines
---
 man2/ioctl_tty.2 | 9 +++++++++
 1 file changed, 9 insertions(+)
man2/ioctl_tty.2 +9 -0
index 85577f80f..ebad97bcf 100644
@@ -334,6 +334,15 @@ Argument:
 .BI "const char\~*" argp
 .IP
 Insert the given byte in the input queue.
+.IP
+Since Linux 6.2,
+.\" commit 690c8b804ad2eafbd35da5d3c95ad325ca7d5061
+.\" commit 83efeeeb3d04b22aaed1df99bc70a48fe9d22c4d
+this operation may require the
+.B CAP_SYS_ADMIN
+capability (if the
+.I dev.tty.legacy_tiocsti
+sysctl variable is set to false).
 .SS Redirecting console output
 .TP
 .B TIOCCONS
Signature · 1 line
2.42.0.283.g2d96d420d3-goog
#2 lore raw

Hi Günther, Samuel,

Quoted 6 lines · Samuel Thibault

Günther Noack, le mer. 13 sept. 2023 13:06:31 +0200, a ecrit:

Quoted 3 lines
Cc Samuel Thibault <[email protected]>
Cc Kees Cook <[email protected]>

Patch applied. Thanks for the patch, and the review!

Cheers,
Alex

Quoted 27 lines
Quoted 27 lines
---
 man2/ioctl_tty.2 | 9 +++++++++
 1 file changed, 9 insertions(+)
man2/ioctl_tty.2 +9 -0
index 85577f80f..ebad97bcf 100644
@@ -334,6 +334,15 @@ Argument:
 .BI "const char\~*" argp
 .IP
 Insert the given byte in the input queue.
+.IP
+Since Linux 6.2,
+.\" commit 690c8b804ad2eafbd35da5d3c95ad325ca7d5061
+.\" commit 83efeeeb3d04b22aaed1df99bc70a48fe9d22c4d
+this operation may require the
+.B CAP_SYS_ADMIN
+capability (if the
+.I dev.tty.legacy_tiocsti
+sysctl variable is set to false).
 .SS Redirecting console output
 .TP
 .B TIOCCONS
Signature · 1 line
2.42.0.283.g2d96d420d3-goog
Signature · 2 lines
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5