Re: [PATCH 13/23] ioctl_tty.2: Document ioctls: TCGETS2, TCSETS2, TCSETSW2, TCSETSF2
From: Pali Rohár <pali@kernel.org>
Date: 2021-08-08 21:15:05
On Sunday 08 August 2021 22:56:55 Michael Kerrisk (man-pages) wrote:
Hello Pali and Alex, On 8/8/21 10:41 AM, Alejandro Colomar wrote:quoted
From: Pali Rohár <pali@kernel.org> Signed-off-by: Pali Rohár <pali@kernel.org> Signed-off-by: Alejandro Colomar <redacted> --- man2/ioctl_tty.2 | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+)diff --git a/man2/ioctl_tty.2 b/man2/ioctl_tty.2 index 46294e63f..967b5c4c7 100644 --- a/man2/ioctl_tty.2 +++ b/man2/ioctl_tty.2@@ -77,6 +77,35 @@ The following four ioctls are just like .BR TCSETSW , .BR TCSETSF , except that they take a +.I "struct termios2\ *" +instead of a +.IR "struct termios\ *" . +If struct member +.B c_cflag +contains +.B BOTHER +then baudrate is stored in struct members +.B c_ispeed +and +.B c_ospeed +as integer values. +These ioctls are not supported on all architectures. +.RS +.TS +lb l. +TCGETS2 \fBstruct termios2 *\fPargp +TCSETS2 \fBconst struct termios2 *\fPargp +TCSETSW2 \fBconst struct termios2 *\fPargp +TCSETSF2 \fBconst struct termios2 *\fPargp +.TE +.RE +.PP +The following four ioctls are just like +.BR TCGETS , +.BR TCSETS , +.BR TCSETSW , +.BR TCSETSF , +except that they take a .I "struct termio\ *" instead of a .IR "struct termios\ *" .The Linux man-pages generally try to maintain historical and version info (at least back as far as 2.6.0), so I applied the patch below.
Hello Michael! That is a good idea. Anyway, these ioctls were not added for all architectures as for some they are not needed (when version 1 already contains everything what was introduced in version 2). I collected all details which I found and I know in this email https://lore.kernel.org/linux-man/20210808210530.ykqrihpfmdabbdl2@pali/ (local) and it is something which should be properly documented. But I do not how to put these details into structured manpage...
quoted hunk ↗ jump to hunk
Thanks, Michael commit 48a486dddefa20cddbc83610cf582acecf23e2b3 (HEAD -> master) Author: Michael Kerrisk [off-list ref] Date: Sun Aug 8 22:54:29 2021 +0200 ioctl_tty.2: Note kernel version that added TCGETS2, TCSETS2, TCSETSW2, and TCSETSF2 Signed-off-by: Michael Kerrisk [off-list ref]diff --git a/man2/ioctl_tty.2 b/man2/ioctl_tty.2 index 9854cfd3f..1d9a6dee1 100644 --- a/man2/ioctl_tty.2 +++ b/man2/ioctl_tty.2@@ -71,7 +71,10 @@ Equivalent to Allow the output buffer to drain, discard pending input, and set the current serial port settings. .PP -The following four ioctls are just like +The following four ioctls, added in Linux 2.6.20, +.\" commit 64bb6c5e1ddcd47c951740485026ef08975ee2e6 +.\" commit 592ee3a5e5e2a981ef2829a0380093006d045661 +are just like .BR TCGETS , .BR TCSETS , .BR TCSETSW ,-- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/