diff mbox series

[03/39] ioctl_tty.2: Fix includes

Message ID	20210510175546.28445-4-alx.manpages@gmail.com
State	Not applicable
Headers	DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org C5297396D80C To: mtk.manpages@gmail.com Subject: [PATCH 03/39] ioctl_tty.2: Fix includes Date: Mon, 10 May 2021 19:55:12 +0200 Message-Id: <20210510175546.28445-4-alx.manpages@gmail.com> In-Reply-To: <20210510175546.28445-1-alx.manpages@gmail.com> References: <20210510175546.28445-1-alx.manpages@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Precedence: list From: Alejandro Colomar via Libc-alpha <libc-alpha@sourceware.org> Reply-To: Alejandro Colomar <alx.manpages@gmail.com> Cc: Florian Weimer <fweimer@redhat.com>, Jakub Wilk <jwilk@jwilk.net>, Alejandro Colomar <alx.manpages@gmail.com>, libc-alpha@sourceware.org, linux-man@vger.kernel.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" <libc-alpha-bounces@sourceware.org>
Series	man2: SYNOPSIS: Fix headers, use syscall(), and other fixes \| [00/39] man2: SYNOPSIS: Fix headers, use syscall(), and other fixes [01/39] futex.2: Use syscall(SYS_...); for system calls without a wrapper [02/39] getdents.2: Use syscall(SYS_...); for system calls without a wrapper [03/39] ioctl_tty.2: Fix includes [04/39] ioctl_userfaultfd.2: SYNOPSIS: Add <linux/userfaultfd.h> [05/39] io_destroy.2: Use syscall(SYS_...); for system calls without a wrapper [06/39] io_getevents.2: Use syscall(SYS_...); for system calls without a wrapper [07/39] ioperm.2: Remove obvious comment [08/39] ioprio_set.2: Use syscall(SYS_...); for system calls without a wrapper [09/39] ipc.2: Use syscall(SYS_...); for system calls without a wrapper [10/39] ipc.2: Add needed include [11/39] kcmp.2: Use syscall(SYS_...); for system calls without a wrapper [12/39] kcmp.2: tfix [13/39] kexec_load.2: Use syscall(SYS_...); for system calls without a wrapper [14/39] scripts/bash_aliases: man_lsfunc(): Extract syscall name from syscall(SYS_...) [15/39] keyctl.2: Use syscall(SYS_...); for system calls without a glibc wrapper [16/39] link.2: ffix [17/39] llseek.2: Use syscall(SYS_...); for system calls without a wrapper [18/39] lookup_dcookie.2: Use syscall(SYS_...); for system calls without a wrapper [19/39] membarrier.2: Use syscall(SYS_...); for system calls without a wrapper [20/39] mincore.2: Remove unused include [21/39] mknod.2: Remove unused includes [22/39] mmap2.2: Use syscall(SYS_...); for system calls without a wrapper [23/39] modify_ldt.2: Use syscall(SYS_...); for system calls without a wrapper [24/39] mq_getsetattr.2: Use syscall(SYS_...); for system calls without a wrapper [25/39] alloc_hugepages.2, arch_prctl.2, capget.2, clone.2, delete_module.2, exit_group.2, get_robu… [26/39] open.2: Remove unused <sys/stat.h> [27/39] openat2.2: Use syscall(SYS_...); for system calls without a wrapper; fix includes too [28/39] perf_event_open.2: Use syscall(SYS_...); for system calls without a wrapper [29/39] pidfd_getfd.2: Use syscall(SYS_...); for system calls without a wrapper [30/39] pidfd_open.2: Use syscall(SYS_...); for system calls without a wrapper [31/39] pidfd_send_signal.2: Use syscall(SYS_...); for system calls without a wrapper. Fix includes… [32/39] pipe.2: wfix [33/39] pivot_root.2: Use syscall(SYS_...); for system calls without a wrapper [34/39] poll.2: Remove <signal.h> [35/39] process_madvise.2: Use syscall(SYS_...); for system calls without a wrapper. Fix includes t… [36/39] quotactl.2: Better detail why <xfs/xqm.h> is included [37/39] readdir.2: Use syscall(SYS_...); for system calls without a wrapper [38/39] readlink.2: ffix [39/39] reboot.2: Use syscall(SYS_...); for system calls without a wrapper

Checks

Context	Check	Description
dj/TryBot-apply_patch	fail	Patch failed to apply to master at the time it was sent

Commit Message

Alejandro Colomar May 10, 2021, 5:55 p.m. UTC

  <sys/ioctl.h> is needed for the prototype of ioctl().  That header
also provides most of the constants used by the function.  Only a
few of those constants are not provided by that header, and need
<termios.h>; clarify which constants do need that include.

......

$ <man2/ioctl_tty.2 \
  sed -n '/^.SH DESCRIPTION/,/^.SH/p' \
  |grep -e '^\.B' -e TIOCM \
  |sed 's/^\.B[^ ]* //' \
  |awk '{print $1}' \
  |grep '^[[:upper:]]' \
  |grep -v -e '^CAP' -e '^E' -e '^SIG' -e '^O_' -e '^[TR]XD$' -e '^POLL' \
  |sort \
  |uniq \
  |while read f; do \
	find /usr/include/ -type f \
	|xargs grep -l "define\s$f" \
	|grep -q ioctl.*.h \
	||echo $f \
	|while read ff; do \
		echo "============ $ff"; \
		find /usr/include/ -type f \
		|xargs grep -n "define\s$ff"; \
	done; \
  done;
============ CLOCAL
/usr/include/asm-generic/termbits.h:142:#define CLOCAL	0004000
/usr/include/gphoto2/gphoto2-port-portability.h:127:#   define CLOCAL  0x00000800
/usr/include/x86_64-linux-gnu/bits/termios-c_cflag.h:34:#define CLOCAL	0004000
============ TCIFLUSH
/usr/include/asm-generic/termbits.h:191:#define	TCIFLUSH	0
/usr/include/x86_64-linux-gnu/bits/termios.h:70:#define	TCIFLUSH	0
============ TCIOFF
/usr/include/asm-generic/termbits.h:187:#define	TCIOFF		2
/usr/include/x86_64-linux-gnu/bits/termios.h:66:#define	TCIOFF		2
============ TCIOFLUSH
/usr/include/asm-generic/termbits.h:193:#define	TCIOFLUSH	2
/usr/include/x86_64-linux-gnu/bits/termios.h:72:#define	TCIOFLUSH	2
============ TCION
/usr/include/asm-generic/termbits.h:188:#define	TCION		3
/usr/include/x86_64-linux-gnu/bits/termios.h:67:#define	TCION		3
============ TCOFLUSH
/usr/include/asm-generic/termbits.h:192:#define	TCOFLUSH	1
/usr/include/x86_64-linux-gnu/bits/termios.h:71:#define	TCOFLUSH	1
============ TCOOFF
/usr/include/asm-generic/termbits.h:185:#define	TCOOFF		0
/usr/include/x86_64-linux-gnu/bits/termios.h:64:#define	TCOOFF		0
============ TCOON
/usr/include/asm-generic/termbits.h:186:#define	TCOON		1
/usr/include/x86_64-linux-gnu/bits/termios.h:65:#define	TCOON		1
============ TIOCREMOTE
============ TIOCSTART
============ TIOCSTOP
============ TIOCTTYGSTRUCT
============ TIOCUCNTL

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
---
 man2/ioctl_tty.2 | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff mbox series

Patch

diff --git a/man2/ioctl_tty.2 b/man2/ioctl_tty.2
index badd58e50..c82690701 100644
--- a/man2/ioctl_tty.2
+++ b/man2/ioctl_tty.2
@@ -10,7 +10,9 @@ 
 ioctl_tty \- ioctls for terminals and serial lines
 .SH SYNOPSIS
 .nf
-.B "#include <termios.h>"
+.B #include <sys/ioctl.h>
+.BR "#include <termios.h>" "      /* Definition of " CLOCAL ", and"
+.BR    "                             TC*" { FLUSH , ON , OFF "} constants */"
 .PP
 .BI "int ioctl(int " fd ", int " cmd ", ...);"
 .fi
@@ -119,8 +121,6 @@  Window sizes are kept in the kernel, but not used by the kernel
 update the window size when the size of the virtual console changes,
 for example, by loading a new font).
 .PP
-The following constants and structure are defined in
-.IR <sys/ioctl.h> .
 .TP
 .B TIOCGWINSZ
 Argument: