linux-kernel - Re: [PATCH] dt-bindings: PCI: Remove obsolete .txt docs

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: <20250423223625.GA460759@bhelgaas>
Date: Wed, 23 Apr 2025 17:36:25 -0500
From: Bjorn Helgaas <helgaas@...nel.org>
To: Rob Herring <robh@...nel.org>
Cc: Bjorn Helgaas <bhelgaas@...gle.com>,
	Lorenzo Pieralisi <lpieralisi@...nel.org>,
	Krzysztof Wilczyński <kw@...ux.com>,
	Manivannan Sadhasivam <manivannan.sadhasivam@...aro.org>,
	Krzysztof Kozlowski <krzk+dt@...nel.org>,
	Conor Dooley <conor+dt@...nel.org>,
	Thierry Reding <thierry.reding@...il.com>,
	Jonathan Hunter <jonathanh@...dia.com>,
	Vidya Sagar <vidyas@...dia.com>, Frank Li <Frank.li@....com>,
	linux-pci@...r.kernel.org, devicetree@...r.kernel.org,
	linux-tegra@...r.kernel.org, linux-kernel@...r.kernel.org,
	Jean-Philippe Brucker <jean-philippe@...aro.org>
Subject: Re: [PATCH] dt-bindings: PCI: Remove obsolete .txt docs

On Wed, Apr 23, 2025 at 08:02:04AM -0500, Rob Herring wrote:
> On Tue, Apr 22, 2025 at 12:18 PM Bjorn Helgaas <helgaas@...nel.org> wrote:
> > On Fri, Apr 04, 2025 at 05:15:57PM -0500, Rob Herring (Arm) wrote:
> > > The content in these files has been moved to the schemas in dtschema.
> > > pci.txt is covered by pci-bus-common.yaml and pci-host-bridge.yaml.
> > > pci-iommu.txt is covered by pci-iommu.yaml. pci-msi.txt is covered in
> > > msi-map property in pci-host-bridge.yaml.
> >
> > I guess "dtschema" refers to
> > https://github.com/devicetree-org/dt-schema?
> 
> Yes.
> 
> > I kinda wish there was some direct link from the Linux kernel source
> > to dt-schema where all this information now lives (Requester ID
> > format, iommu-map, msi-map, linux,pci-domain, reg (and reference to
> > IEEE Std 1275-1994), interrupt mapping info, external-facing, etc).
> > Being a DT neophyte, I need all the help I can get ;)
> 
> Links to each property wouldn't really scale. Might as well copy all
> the common schemas into the kernel tree at that point.

Right.  In my ignorance, I found it useful to just grep the Linux
source for these properties, but that doesn't work any more.

> > There are a few dangling references to pci.txt:
> >
> >   Documentation/devicetree/bindings/pci/aardvark-pci.txt: - max-link-speed: see pci.txt
> >   Documentation/devicetree/bindings/pci/aardvark-pci.txt: - reset-gpios: see pci.txt
> >   Documentation/devicetree/bindings/pci/v3-v360epc-pci.txt:- bus-range: see pci.txt
> >   Documentation/devicetree/bindings/pci/v3-v360epc-pci.txt:  1275-1994 (see pci.txt) with the following restriction:
> 
> If no one cares enough to convert these, then I don't think the link matters.

I guess the descriptions of these now live at
https://github.com/devicetree-org/dt-schema/blob/main/dtschema/schemas/pci/pci-bus-common.yaml

There are a few Documentation/devicetree/bindings/ files that include
URLs like that, but maybe that's not considered a canonical source?

Bjorn