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] [day] [month] [year] [list]

Message-ID: <5e9e1f1a-1e08-59f5-6579-a02c0738b9a4@gmail.com>
Date:   Mon, 2 Aug 2021 15:07:14 +0200
From:   "Alejandro Colomar (man-pages)" <alx.manpages@...il.com>
To:     Pali Rohár <pali@...nel.org>
Cc:     Glibc <libc-alpha@...rceware.org>,
        "linux-kernel@...r.kernel.org" <linux-kernel@...r.kernel.org>,
        linux-serial@...r.kernel.org, linux-man <linux-man@...r.kernel.org>
Subject: Re: Document the types "struct termios" and "struct termios2"

+= linux-man@

:)

On 8/2/21 2:50 PM, Pali Rohár wrote:
> + 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/


-- 
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/