linux-kernel - Re: [PATCH 01/12] habanalabs/gaudi2: add asic registers header files

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: <CAFCwf11kj=V=p5iemR5SMuN6X=Cc3aiMmWfMLaKtcYNfhe=+og@mail.gmail.com>
Date:   Tue, 28 Jun 2022 09:52:34 +0300
From:   Oded Gabbay <ogabbay@...nel.org>
To:     Greg KH <gregkh@...uxfoundation.org>
Cc:     "Linux-Kernel@...r. Kernel. Org" <linux-kernel@...r.kernel.org>
Subject: Re: [PATCH 01/12] habanalabs/gaudi2: add asic registers header files

On Tue, Jun 28, 2022 at 9:28 AM Greg KH <gregkh@...uxfoundation.org> wrote:
>
> On Mon, Jun 27, 2022 at 11:26:09PM +0300, Oded Gabbay wrote:
> > +#ifndef __GAUDI2_ARC_COMMON_PACKETS_H__
> > +#define __GAUDI2_ARC_COMMON_PACKETS_H__
> > +
> > +/**
> > + * \file    gaudi2_arc_common_packets.h
> > + * \brief   IDs for QMAN ARC CPUs
> > + *          This defines IDs that needs to be programmed into CPU ID
> > + *          register xx_ARC_AUX_ARC_NUM
>
> What is this "\" formatting for and from?  What uses it?  I don't think
> it's kernel-doc, right?
>
> And if it is kernel-doc, are these files all hooked into the kernel
> documentation build process to generate the output of them?
>
> thanks,
>
> greg k-h
No, it's not kernel-doc.
It's a file copied from f/w team and these comments went under my radar.
I'll just remove the non-standard format. It's not relevant anyway.

Thanks,
Oded