linux-kernel - Re: Document the types "struct termios" and "struct termios2"

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20210802125034.gubtf24tsm7lkh3k@pali>
Date:   Mon, 2 Aug 2021 14:50:34 +0200
From:   Pali Rohár <pali@...nel.org>
To:     "Alejandro Colomar (man-pages)" <alx.manpages@...il.com>
Cc:     Glibc <libc-alpha@...rceware.org>,
        "linux-kernel@...r.kernel.org" <linux-kernel@...r.kernel.org>,
        linux-serial@...r.kernel.org
Subject: Re: Document the types "struct termios" and "struct termios2"

+ linux-serial

On Monday 02 August 2021 14:38:43 Alejandro Colomar (man-pages) wrote:
> Hi,
> 
> From a few patches of Pali and their subsequent discussions,

For others, link to patch with code example:
https://lore.kernel.org/linux-man/20210801135146.14849-1-pali@kernel.org/

And links to other discussions:
https://lore.kernel.org/linux-man/20210725225506.7404-1-pali@kernel.org/t/#u
https://lore.kernel.org/linux-man/20210730105353.10424-1-pali@kernel.org/t/#u
https://lore.kernel.org/linux-man/20210730153044.23673-1-pali@kernel.org/t/#u

> it was clear
> that those types need to be documented (the most appropriate place being
> system_data_types(7), with link pages termios-struct(3) and
> termios2-struct(3)).
> 
> The most important part (the one we had problems with) being which headers
> should be included for each type (and for each version of the type
> (kernel/glibc)).  That includes the recommended header, and other headers
> that _shall_ also provide the type.
> 
> Is there someone that knows those types enough to write such documentation
> and wants to do it? :)
> 
> Thanks,
> 
> Alex
> 
> -- 
> Alejandro Colomar
> Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
> http://www.alejandro-colomar.es/