From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: AS17314 8.43.84.0/22 X-Spam-Status: No, score=-4.2 required=3.0 tests=AWL,BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,MAILING_LIST_MULTI, RCVD_IN_DNSWL_MED,SPF_HELO_PASS,SPF_PASS shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from sourceware.org (server2.sourceware.org [8.43.85.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by dcvr.yhbt.net (Postfix) with ESMTPS id 53E8E1F8C6 for ; Sun, 8 Aug 2021 21:05:55 +0000 (UTC) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 137E23857434 for ; Sun, 8 Aug 2021 21:05:54 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 137E23857434 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1628456754; bh=2L3dDAiX51fD0WAXI7PG8F0pnMJBEiQGk0kplE1KR7Q=; h=Date:To:Subject:References:In-Reply-To:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=wUnXM9TEDbF0ze8F0XdYJAb/+lb6R+qPlgngHxQNB1nBEVVgOhB2WV0KuGMN79yQ+ rCuyFyssZNd99kliJqCZrFpOM4rwG7kqi1CIRnYEiI2Q7ATnMGDuZYhSeBHnyJfeiU VEC3VhcjKLYqSiQ+4M6SONN1qLl93HTXznI3cZJM= Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by sourceware.org (Postfix) with ESMTPS id EC482385840D for ; Sun, 8 Aug 2021 21:05:34 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org EC482385840D Received: by mail.kernel.org (Postfix) with ESMTPSA id 0D3D360EBB; Sun, 8 Aug 2021 21:05:33 +0000 (UTC) Received: by pali.im (Postfix) id B19C113DC; Sun, 8 Aug 2021 23:05:30 +0200 (CEST) Date: Sun, 8 Aug 2021 23:05:30 +0200 To: "Alejandro Colomar (man-pages)" Subject: Re: [PATCH v3] ioctl_tty.2: Add example how to get or set baudrate on the serial port Message-ID: <20210808210530.ykqrihpfmdabbdl2@pali> References: <20210730095333.6118-1-pali@kernel.org> <20210801135146.14849-1-pali@kernel.org> <54c8c04d-4f9b-1ab6-a3a5-c23b2be74a9d@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <54c8c04d-4f9b-1ab6-a3a5-c23b2be74a9d@gmail.com> User-Agent: NeoMutt/20180716 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: , From: =?utf-8?q?Pali_Roh=C3=A1r_via_Libc-alpha?= Reply-To: Pali =?utf-8?B?Um9ow6Fy?= Cc: Marek =?utf-8?B?QmVow7pu?= , "G. Branden Robinson" , libc-alpha@sourceware.org, Michael Kerrisk , linux-man@vger.kernel.org Errors-To: libc-alpha-bounces+e=80x24.org@sourceware.org Sender: "Libc-alpha" On Sunday 08 August 2021 10:35:24 Alejandro Colomar (man-pages) wrote: > Hi Pali, > > On 8/1/21 3:51 PM, Pali Rohár wrote: > > Signed-off-by: Pali Rohár > > > > --- > > Changes in v3: > > * Check support for custom baudrate only based on BOTHER macro > > * Use TCGETS/TCSETS/termios when TCGETS2/TCSETS2/termios2 is not available > > > > Changes in v2: > > * Use \e for backslash > > * Use exit(EXIT_*) instead of return num > > * Sort includes > > * Add comment about possible fallback > > --- > > > > Hello Alejandro! > > > > I found out that this stuff is more complicated as I originally thought. > > And seems that additional documentation on this topic is needed... > > > > For setting custom baudrate it is needed to set BOTHER flag in c_cflag > > field and baudrate value itself in c_ospeed and c_ispeed fields. > > > > So when BOTHER flag is not provided by then setting custom > > baudrate is not possible, fields c_ospeed and c_ispeed do not exist (and > > only some predefined Bnnn baudrate values are supported). This applies when > > compiling application with older version of header files (prior support for > > custom baudrate was introduced into header files). > > > > First caveat: BOTHER constant is different for different architectures. > > So it is not possible to provide fallback #ifndef..#define BOTHER. > > > > And now the biggest issue: Some architectures have these c_ospeed and > > c_ispeed fields in struct termios and some in struct termios2. > > > > TCGETS/TCSETS ioctls use struct termios and TCGETS/TCSETS2 use > > struct termios2. > > > > Some architectures (e.g. amd64) provide both struct termios and struct > > termios2, but c_ospeed and c_ispeed are only in struct termios2. > > > > Some other architectures (e.g. alpha) provide both struct termios and struct > > termios2 and both have c_ospeed and c_ispeed fields. > > > > And some other architectures (e.g. powerpc) provide only struct termios > > (no struct termios2) and it has c_ospeed and c_ispeed fields. > > > > So basically to support all architectures it is needed to use > > struct termios2 when TCGETS2/TCSETS2 is supported. Otherwise it is needed > > to use struct termios with TCGETS/TCSETS (case for e.g. powerpc). > > When you send v4, please include the above text (or something similar) to > the commit message. Hello Alejandro! Sure I will put description into commit message. Moreover this kind of information should be properly documented into ioctl_tty.2 manpage itself. But I really do not know in which part. Into ioctl (and which?)? Or separate paragraph? As it basically describe some field of struct termios and struct termios2, which are undocumented too. Do you have some idea or picture how such thing should be properly documented in man-pages project? > Thanks, > > Alex > > > > > I updated v3 patch to handle this logic. > > --- > > > -- > Alejandro Colomar > Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/ > http://www.alejandro-colomar.es/