linux-kernel - Re: [PATCH v6 5/5] rust: add arch_static

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: <20240810215720.GH11646@noisy.programming.kicks-ass.net>
Date: Sat, 10 Aug 2024 23:57:20 +0200
From: Peter Zijlstra <peterz@...radead.org>
To: Alice Ryhl <aliceryhl@...gle.com>
Cc: Steven Rostedt <rostedt@...dmis.org>,
	Masami Hiramatsu <mhiramat@...nel.org>,
	Mathieu Desnoyers <mathieu.desnoyers@...icios.com>,
	Josh Poimboeuf <jpoimboe@...nel.org>,
	Jason Baron <jbaron@...mai.com>, Ard Biesheuvel <ardb@...nel.org>,
	Miguel Ojeda <ojeda@...nel.org>,
	Alex Gaynor <alex.gaynor@...il.com>,
	Wedson Almeida Filho <wedsonaf@...il.com>,
	Boqun Feng <boqun.feng@...il.com>, Gary Guo <gary@...yguo.net>,
	Björn Roy Baron <bjorn3_gh@...tonmail.com>,
	Benno Lossin <benno.lossin@...ton.me>,
	Andreas Hindborg <a.hindborg@...sung.com>,
	linux-trace-kernel@...r.kernel.org, rust-for-linux@...r.kernel.org,
	linux-kernel@...r.kernel.org, Arnd Bergmann <arnd@...db.de>,
	linux-arch@...r.kernel.org, Thomas Gleixner <tglx@...utronix.de>,
	Ingo Molnar <mingo@...hat.com>, Borislav Petkov <bp@...en8.de>,
	Dave Hansen <dave.hansen@...ux.intel.com>, x86@...nel.org,
	"H. Peter Anvin" <hpa@...or.com>,
	Sean Christopherson <seanjc@...gle.com>,
	Uros Bizjak <ubizjak@...il.com>,
	Catalin Marinas <catalin.marinas@....com>,
	Will Deacon <will@...nel.org>, Marc Zyngier <maz@...nel.org>,
	Oliver Upton <oliver.upton@...ux.dev>,
	Mark Rutland <mark.rutland@....com>,
	Ryan Roberts <ryan.roberts@....com>, Fuad Tabba <tabba@...gle.com>,
	linux-arm-kernel@...ts.infradead.org,
	Paul Walmsley <paul.walmsley@...ive.com>,
	Palmer Dabbelt <palmer@...belt.com>,
	Albert Ou <aou@...s.berkeley.edu>,
	Anup Patel <apatel@...tanamicro.com>,
	Andrew Jones <ajones@...tanamicro.com>,
	Alexandre Ghiti <alexghiti@...osinc.com>,
	Conor Dooley <conor.dooley@...rochip.com>,
	Samuel Holland <samuel.holland@...ive.com>,
	linux-riscv@...ts.infradead.org,
	Huacai Chen <chenhuacai@...nel.org>,
	WANG Xuerui <kernel@...0n.name>, Bibo Mao <maobibo@...ngson.cn>,
	Tiezhu Yang <yangtiezhu@...ngson.cn>,
	Andrew Morton <akpm@...ux-foundation.org>,
	Tianrui Zhao <zhaotianrui@...ngson.cn>, loongarch@...ts.linux.dev
Subject: Re: [PATCH v6 5/5] rust: add arch_static_branch

On Sat, Aug 10, 2024 at 11:44:13PM +0200, Alice Ryhl wrote:
> On Sat, Aug 10, 2024 at 11:04 PM Peter Zijlstra <peterz@...radead.org> wrote:
> >
> > On Thu, Aug 08, 2024 at 05:23:41PM +0000, Alice Ryhl wrote:
> >
> > > +/// Wrapper around `asm!` that uses at&t syntax on x86.
> > > +// Uses a semicolon to avoid parsing ambiguities, even though this does not match native `asm!`
> > > +// syntax.
> > > +#[cfg(target_arch = "x86_64")]
> > > +#[macro_export]
> > > +macro_rules! asm {
> > > +    ($($asm:expr),* ; $($rest:tt)*) => {
> > > +        ::core::arch::asm!( $($asm)*, options(att_syntax), $($rest)* )
> > > +    };
> > > +}
> > > +
> > > +/// Wrapper around `asm!` that uses at&t syntax on x86.
> >
> > ^ the above line seems out of place given the 'not' below.
> 
> Comments with three slashes are what gets rendered in the html version
> of the docs [1]. This way, the rendered docs will say that the `asm!`
> macro is a wrapper around the built-in `asm!` that uses at&t syntax on
> x86 regardless of which platform you build the docs on.
> 

Urgh, that's not half-way confusing. Also, whoever wants to read HTML
when you already have the code open in your text-editor?