linux-kernel - Re: [PATCH] docs: align with scripts/syscall.tbl migration

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: <87ldqsip7k.fsf@trenco.lwn.net>
Date: Mon, 19 May 2025 09:40:15 -0600
From: Jonathan Corbet <corbet@....net>
To: Jesung Yang <y.j3ms.n@...il.com>
Cc: Vineet Gupta <vgupta@...nel.org>, Catalin Marinas
 <catalin.marinas@....com>, Will Deacon <will@...nel.org>, Guo Ren
 <guoren@...nel.org>, Brian Cain <bcain@...nel.org>, Huacai Chen
 <chenhuacai@...nel.org>, WANG Xuerui <kernel@...0n.name>, Dinh Nguyen
 <dinguyen@...nel.org>, Jonas Bonn <jonas@...thpole.se>, Stefan
 Kristiansson <stefan.kristiansson@...nalahti.fi>, Stafford Horne
 <shorne@...il.com>, Paul Walmsley <paul.walmsley@...ive.com>, Palmer
 Dabbelt <palmer@...belt.com>, Albert Ou <aou@...s.berkeley.edu>, Alexandre
 Ghiti <alex@...ti.fr>, linux-snps-arc@...ts.infradead.org,
 linux-arm-kernel@...ts.infradead.org, linux-csky@...r.kernel.org,
 linux-hexagon@...r.kernel.org, loongarch@...ts.linux.dev,
 linux-openrisc@...r.kernel.org, linux-riscv@...ts.infradead.org,
 workflows@...r.kernel.org, linux-doc@...r.kernel.org,
 linux-kernel@...r.kernel.org, Jesung Yang <y.j3ms.n@...il.com>
Subject: Re: [PATCH] docs: align with scripts/syscall.tbl migration

Jesung Yang <y.j3ms.n@...il.com> writes:

> Update the documentation to reflect the migration of the following
> architectures to the centralized syscall table format:
>
>   arc, arm64, csky, hexagon, loongarch, nios2, openrisc, riscv
>
> As of commit 3db80c999debbad ("riscv: convert to generic syscall table"),
> these architectures no longer rely on include/uapi/asm-generic/unistd.h.
> Instead, syscall table headers (syscall_table_{32,64}.h) are generated by
> scripts/syscalltbl.sh based on entries in scripts/syscall.tbl, with ABIs
> specified in arch/*/kernel/Makefile.syscalls.
>
> For the convenience of developers working with older kernel versions, the
> original documentation is fully retained, with new sections added to
> cover the scripts/syscall.tbl approach.
>
> Verified with `make htmldocs`.
>
> Signed-off-by: Jesung Yang <y.j3ms.n@...il.com>
> Link: https://lore.kernel.org/lkml/20240704143611.2979589-1-arnd@kernel.org

I'm not sure anybody has looked at this ... but nobody has complained,
anyway.

I have applied it but ... it seems like this document needs a more
thorough refresh rather than just adding some "actually, don't do it
that way on these architectures" notes?  Hopefully somebody will find
the energy to do that at some point.

Thanks,

jon