From patchwork Tue Aug 31 20:28:09 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Pali_Roh=C3=A1r?= X-Patchwork-Id: 44828 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 75F0B3858025 for ; Tue, 31 Aug 2021 20:29:54 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 75F0B3858025 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1630441794; bh=StH/14V4Y6XKXEO7ysb4AxF9a4rvGqdqizjRcpuLTvY=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=k5tbpnldIyuwjvd6qLQuF/9ORXFQ5WJPepJX55FWmn0Afle0UP/xuc/jVki71nn+l fus7mV2jimqas1YLL5zDM52lRPykukKEg3jF6d9w/NhNgE8XtbupyFVSv6WB8eCKhi 7R4EUYbwqvPYFWzIsBp+z0BnDqRBFYJwVqRUvAR4= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by sourceware.org (Postfix) with ESMTPS id 7730A3858C27 for ; Tue, 31 Aug 2021 20:29:33 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 7730A3858C27 Received: by mail.kernel.org (Postfix) with ESMTPSA id 53F6560F12; Tue, 31 Aug 2021 20:29:32 +0000 (UTC) Received: by pali.im (Postfix) id 0230DEF2; Tue, 31 Aug 2021 22:29:29 +0200 (CEST) To: "Alejandro Colomar (man-pages)" , Michael Kerrisk Subject: [PATCH v3] ioctl_tty.2: Fix information about header include file Date: Tue, 31 Aug 2021 22:28:09 +0200 Message-Id: <20210831202809.29819-1-pali@kernel.org> X-Mailer: git-send-email 2.20.1 In-Reply-To: <3d927d3c-67a1-bb48-b597-44c87b8f715a@gmail.com> References: <3d927d3c-67a1-bb48-b597-44c87b8f715a@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-12.4 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on server2.sourceware.org X-BeenThere: libc-alpha@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Libc-alpha mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: =?utf-8?q?Pali_Roh=C3=A1r_via_Libc-alpha?= From: =?utf-8?q?Pali_Roh=C3=A1r?= Reply-To: =?utf-8?q?Pali_Roh=C3=A1r?= Cc: =?utf-8?q?Marek_Beh=C3=BAn?= , "G. Branden Robinson" , libc-alpha@sourceware.org, linux-man@vger.kernel.org Errors-To: libc-alpha-bounces+patchwork=sourceware.org@sourceware.org Sender: "Libc-alpha" Header file termios.h contains incompatible definitions for linux ioctl calls. Correct definitions are exported by header file linux/termios.h but this file conflicts with sys/ioctl.h header file (required for ioctl() call). Therefore include direct asm header file asm/termbits.h which contains compatible definitions and structures for ioctl calls. Signed-off-by: Pali Rohár --- Changes in v3: * Use .I instead of .B #include * Use Bnnn instead of Bnn Changes in v2: * Reformat SYNOPSIS for 80 chars per line --- man2/ioctl_tty.2 | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) diff --git a/man2/ioctl_tty.2 b/man2/ioctl_tty.2 index 186011ee7c33..7d866867c6bd 100644 --- a/man2/ioctl_tty.2 +++ b/man2/ioctl_tty.2 @@ -11,8 +11,10 @@ ioctl_tty \- ioctls for terminals and serial lines .SH SYNOPSIS .nf .B #include -.BR "#include " " /* Definition of " CLOCAL ", and" -.BR " TC*" { FLUSH , ON , OFF "} constants */" +.BR "#include " " /* Definition of " "struct termios" , +.BR " struct termios2" ", and" +.BR " Bnnn" ", " BOTHER ", " CBAUD ", " CLOCAL , +.BR " TC*" { FLUSH , ON , OFF "} and other constants */" .PP .BI "int ioctl(int " fd ", int " cmd ", ...);" .fi @@ -31,6 +33,19 @@ makes for nonportable programs. Use the POSIX interface described in .BR termios (3) whenever possible. +.PP +Please note that +.B struct termios +from +.I +is different and incompatible with +.B struct termios +from +.IR . +These ioctl calls require +.B struct termios +from +.IR . .SS Get and set terminal attributes .TP .B TCGETS