PCI: of: warn on bogus device_type property
Subsystems (2)
v3 cover PCI: of: warn on bogus device_type property
Add a check when adding a PCI device to ensure the device_type property is (or is not) correctly defined when the device has a non-null devicetree node pointer.
PCI has a well-defined bus and device discovery process. The PCI_DYNAMIC_OF_NODES Kconfig option allows PCI devices to *also* have a devicetree node. This enables certain things that are not possible with PCI enumeration alone.
While working on a Qualcomm platform, I learned that some PCI endpoint nodes were defined with device_type = "pci" properties. Herve Codina pointed out that this was not correct. Rob Herring indicated that people seem to have trouble getting the PCI devicetree nodes right, and asked whether we could warn if this particular problem occurred. During review, Herve Codina also suggested that bridge nodes be checked to ensure they *do* have the proper device_type property.
This series implements these checks. A new patch in this version removes a (now duplicate) warning issued by the devicetree code.
The first two patches are simple cleanups. The third adds the new PCI devicetree node checks and warnings, and the last removes the duplicate warning message.
-Alex
Between version 2 and version 3:
- Drop a patch that made a change only needed by a different series
- Switch a function header to use kernel-doc format
- Add a warning if a PCI bridge node has no device_type property
- Added a patch to remove a duplicate warning in the devicetree code
Version 2 is available here:
https://lore.kernel.org/lkml/[email protected]/
Between version 1 and version 2:
- Check the PCI devicetree node even when PCI_DYNAMIC_OF_NODES is not enabled
Version 1 is available here:
https://lore.kernel.org/lkml/[email protected]/
Alex Elder (4):
PCI: of: drop the reg_num argument to of_pci_set_address()
PCI: of: don't zero flags in of_pci_get_addr_flags()
PCI: of: introduce of_pci_verify_node()
of: address: kill of_node_is_pcie()
drivers/of/address.c | 12 +----------- drivers/pci/bus.c | 1 + drivers/pci/of.c | 31 +++++++++++++++++++++++++++++++ drivers/pci/of_property.c | 14 ++++++-------- drivers/pci/pci.h | 3 +++ 5 files changed, 42 insertions(+), 19 deletions(-)
base-commit: cee9395acd8043be0644b25c34bfa86623f2b935
Signature · 1 line
2.53.0
PATCH v3 1/4 PCI: of: drop the reg_num argument to of_pci_set_address()
The reg_num argument passed to of_pci_set_address() is always zero, so get rid of it.
--- drivers/pci/of_property.c | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-)
drivers/pci/of_property.c +5 -5
@@ -52,7 +52,7 @@ enum of_pci_prop_compatible { };static void of_pci_set_address (struct pci_dev *pdev,u32 *prop,u64 addr, -u32 reg_num,u32 flags,bool reloc) +u32 flags,bool reloc) {if (pdev) { prop[0] = FIELD_PREP(OF_PCI_ADDR_FIELD_BUS, pdev->bus->number) |
@@ -61,7 +61,7 @@ static void of_pci_set_address(struct pci_dev *pdev, u32 *prop, u64 addr, }else prop[0 ] =0 ; - prop[0 ] |= flags | reg_num; + prop[0 ] |= flags;if (!reloc) { prop[0 ] |=OF_PCI_ADDR_FIELD_NONRELOC ; prop[1 ] =upper_32_bits (addr);
@@ -131,7 +131,7 @@ static int of_pci_prop_ranges(struct pci_dev *pdev, struct of_changeset *ocs,continue ; val64 =pci_bus_address (pdev, &res[j] - pdev->resource); -of_pci_set_address (pdev, rp[i].parent_addr, val64,0 , flags, +of_pci_set_address (pdev, rp[i].parent_addr, val64, flags, false);if (pci_is_bridge (pdev)) { memcpy(rp[i].child_addr, rp[i].parent_addr,
@@ -164,7 +164,7 @@ static int of_pci_prop_reg(struct pci_dev *pdev, struct of_changeset *ocs,struct of_pci_addr_pair reg = {0 };/* configuration space */ -of_pci_set_address (pdev, reg.phys_addr,0 ,0 ,0 , true); +of_pci_set_address (pdev, reg.phys_addr,0 ,0 , true);return of_changeset_add_prop_u32_array (ocs, np,"reg" , (u32 *)®,sizeof (reg) /sizeof (u32));
@@ -458,7 +458,7 @@ static int of_pci_host_bridge_prop_ranges(struct pci_host_bridge *bridge,/* PCI bus address */ val64 = res->start;of_pci_set_address (NULL , &ranges[ranges_sz], - val64 - window->offset,0 , flags, false); + val64 - window->offset, flags, false); ranges_sz +=OF_PCI_ADDRESS_CELLS ;/* Host bus address */
Signature · 1 line
2.53.0
[email protected]
AI reviewRe: [PATCH v3 1/4] PCI: of: drop the reg_num argument to of_pci_set_address()
Sashiko has reviewed this patch and found no issues. It looks great!
Quoted 5 lines
The
reg_numargument passed toof_pci_set_address()is always zero, so get rid of it.Reviewed-by Herve Codina <[email protected]>Signed-off-by Alex Elder <[email protected]>
Sashiko has reviewed this patch and found no issues. It looks great!
Signature · 1 line
Sashiko AI review · https://sashiko.dev/#/patchset/[email protected]?part=1
PATCH v3 2/4 PCI: of: don't zero flags in of_pci_get_addr_flags()
In reply to Alex ElderThe flags variable whose address is passed to of_pci_get_addr_flags() is zeroed before assigning a value to it. Skip the zeroing and just assign it instead.
--- drivers/pci/of_property.c | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-)
drivers/pci/of_property.c +1 -3
@@ -82,12 +82,10 @@ static int of_pci_get_addr_flags(const struct resource *res, u32 *flags)else return -EINVAL ; - *flags =0 ; + *flags =FIELD_PREP (OF_PCI_ADDR_FIELD_SS , ss);if (res->flags &IORESOURCE_PREFETCH ) *flags |=OF_PCI_ADDR_FIELD_PREFETCH ; - *flags |=FIELD_PREP (OF_PCI_ADDR_FIELD_SS , ss); -return 0 ; }
Signature · 1 line
2.53.0
[email protected]
AI reviewRe: [PATCH v3 2/4] PCI: of: don't zero flags in of_pci_get_addr_flags()
Thank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider:
Thank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider:
Pre-existing issues:
- [High] Potential NULL pointer dereference in of_pci_prop_compatible if kasprintf fails. --
commit 036872e87dc6e9201c6f86349afb91815a638d1e
Author: Alex Elder <[email protected]>
PCI: of: don't zero flags in of_pci_get_addr_flags()
The flags variable whose address is passed to of_pci_get_addr_flags() is zeroed before assigning a value to it. Skip the zeroing and just assign it instead.
Quoted 7 lines
drivers/pci/of_property.c +0
-0@@ -82,12 +82,10 @@ static int of_pci_get_addr_flags(const struct resource *res, u32 *flags)else return -EINVAL ;
drivers/pci/of_property.c static int of_pci_get_addr_flags(const struct resource *res, u32 *flags) · line 90
Quoted 10 lines
drivers/pci/of_property.c +1
-3- *flags =0 ; + *flags =FIELD_PREP (OF_PCI_ADDR_FIELD_SS , ss);if (res->flags &IORESOURCE_PREFETCH ) *flags |=OF_PCI_ADDR_FIELD_PREFETCH ; - *flags |=FIELD_PREP (OF_PCI_ADDR_FIELD_SS , ss); -return 0 ; }
[Severity: High]
This is a pre-existing issue, but I noticed a potential null pointer dereference in this file under low memory conditions.
Looking at of_pci_prop_compatible(), kasprintf() can fail and return a null pointer:
drivers/pci/of_property.c:of_pci_prop_compatible() {
...
compat_strs[PROP_COMPAT_PCI_VVVV_DDDD] =
kasprintf(GFP_KERNEL, "pci%x,%x", pdev->vendor, pdev->device);
...
ret = of_changeset_add_prop_string_array(ocs, np, "compatible",
compat_strs, PROP_COMPAT_NUM);
...
}If kasprintf() fails, the compat_strs array will contain a null pointer. When this array is passed to of_changeset_add_prop_string_array(), it unconditionally dereferences the strings to calculate their lengths:
drivers/of/dynamic.c:of_changeset_add_prop_string_array() {
...
prop.length = 0;
for (i = 0; i < sz; i++)
prop.length += strlen(str_array[i]) + 1;
...
}Would it be better to add a check for allocation failures in of_pci_prop_compatible() before passing the array to of_changeset_add_prop_string_array() to prevent this?
Signature · 1 line
Sashiko AI review · https://sashiko.dev/#/patchset/[email protected]?part=2
Re: [PATCH v3 2/4] PCI: of: don't zero flags in of_pci_get_addr_flags()
Quoted 4 lines · On 8/31/26 8:20 PM, [email protected] wrote:
Thank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider:
Pre-existing issues:
- [High] Potential NULL pointer dereference inof_pci_prop_compatibleif kasprintf fails.
This issue was reported before, and I responded that I would fix it. I *do* have a fix, but I have not yet posted it for review (waiting for the end of the merge window). I will post it soon.
-Alex
Quoted 62 lines
--
commit
036872e87dc6e9201c6f86349afb91815a638d1e
Author: Alex Elder <[email protected]>PCI: of: don't zero flags in
of_pci_get_addr_flags()The flags variable whose address is passed to
of_pci_get_addr_flags()is zeroed before assigning a value to it. Skip the zeroing and just assign it instead.Quoted 7 lines
drivers/pci/of_property.c +0
-0@@ -82,12 +82,10 @@ static int of_pci_get_addr_flags(const struct resource *res, u32 *flags)else return -EINVAL ;drivers/pci/of_property.c static int of_pci_get_addr_flags(const struct resource *res, u32 *flags) · line 90
Quoted 10 lines
drivers/pci/of_property.c +1
-3- *flags =0 ; + *flags =FIELD_PREP (OF_PCI_ADDR_FIELD_SS , ss);if (res->flags &IORESOURCE_PREFETCH ) *flags |=OF_PCI_ADDR_FIELD_PREFETCH ; - *flags |=FIELD_PREP (OF_PCI_ADDR_FIELD_SS , ss); -return 0 ; }[Severity: High]
This is a pre-existing issue, but I noticed a potential null pointer dereference in this file under low memory conditions.Looking at
of_pci_prop_compatible(),kasprintf()can fail and return a null pointer:drivers/pci/of_property.c:of_pci_prop_compatible() { ... compat_strs[PROP_COMPAT_PCI_VVVV_DDDD] = kasprintf(GFP_KERNEL, "pci%x,%x", pdev->vendor, pdev->device); ... ret = of_changeset_add_prop_string_array(ocs, np, "compatible", compat_strs, PROP_COMPAT_NUM); ... }If
kasprintf()fails, thecompat_strsarray will contain a null pointer. When this array is passed toof_changeset_add_prop_string_array(), it unconditionally dereferences the strings to calculate their lengths:drivers/of/dynamic.c:of_changeset_add_prop_string_array() { ... prop.length = 0; for (i = 0; i < sz; i++) prop.length += strlen(str_array[i]) + 1; ... }Would it be better to add a check for allocation failures in
of_pci_prop_compatible()before passing the array toof_changeset_add_prop_string_array()to prevent this?
PATCH v3 3/4 PCI: of: introduce of_pci_verify_node()
In reply to Alex ElderCommit 407d1a51921e9 ("PCI: Create device tree node for bridge") linked the PCI enumeration process together with devicetree, creating a devicetree node for discovered PCI bridges. Its successor commit ae9813db1dc5a ("PCI:
Add quirks to generate device tree node for Xilinx Alveo U50") shows how to use a PCI final fixup quirk to also create a devicetree node for a non-bridge PCI device. These changes allowed devicetree overlays to describe components downstream of a PCI device, by providing a place to attach the overlay.
Note that the dynamic devicetree node is only created if the device didn't already have an assigned node.
Later, commit aa7b4bbcb3a1d ("arm64: dts: qcom: qcs6490-rb3gen2: Add TC9563 PCIe switch node") *pre-defined* devicetree nodes to represent the PCI device nodes that would (also) be discovered via the PCI enumeration process. The devicetree node in this case is created with the content from the DTS file. So when a (host) bridge is done being initialized during PCI enumeration, no node is dynamically created (the commits mentioned above do not apply).
Ideally, any pre-defined PCI devicetree node would contain exactly the same information as whatever the dynamic creation process would produce (though it could include more).
However that is not the case for the pre-defined Qualcomm RB3gen2 nodes. And in particular, the endpoint (function) nodes include this property:
device_type = "pci";
This is simply wrong; that property is meant only for bridge nodes.
Rob Herring requested that a runtime check to be added to spot this specific error, only for non-bridge PCI devices. Herve Codina further suggested we ensure that bridge PCI devices *do* define the device_type property, with value "pci".
---
v3: - Switch a function header to use kernel-doc format
- Add a warning if a PCI bridge node has no device_type property
drivers/pci/bus.c | 1 + drivers/pci/of.c | 31 +++++++++++++++++++++++++++++++ drivers/pci/pci.h | 3 +++ 3 files changed, 35 insertions(+)
drivers/pci/bus.c +1 -0
@@ -351,6 +351,7 @@ void pci_bus_add_device(struct pci_dev *dev)* are not assigned yet for some devices. */ pcibios_bus_add_device (dev); +of_pci_verify_node (dev);pci_fixup_device (pci_fixup_final, dev);if (pci_is_bridge (dev))of_pci_make_dev_node (dev);
drivers/pci/of.c +31 -0
@@ -1085,3 +1085,34 @@ int of_pci_get_equalization_presets(struct device *dev,return 0 ; }EXPORT_SYMBOL_GPL (of_pci_get_equalization_presets); + +/** +* of_pci_verify_node - Sanity check some PCI device node properties +* @pdev: The PCI device whose device node is checked +* +* PCI enumeration authoritatively discovers what we need to know about +* a PCI device. A devicetree-based platform will represent a PCI root +* bridge with a node, but otherwise devicetree doesn't typically include +* many PCI nodes. Where such nodes do exist, experience has shown that +* the "device_type" property is sometimes wrong, so warn about that. +*/ +void of_pci_verify_node (struct pci_dev *pdev) +{ +struct device_node *np =pci_device_to_OF_node (pdev); +bool device_is_bridge; +bool device_type_pci; + +/* Nothing to check if there's no pre-existing devicetree node */ +if (!np) +return ; + + device_is_bridge =pci_is_bridge (pdev); + device_type_pci =of_node_is_type (np,"pci" ); + +/* Bridges should have device type "pci"; endpoints should not */ +if (device_is_bridge == device_type_pci) +return ; + +dev_err (&pdev->dev,"PCI %s have \"pci\" device_type property\n" , + device_is_bridge ?"bridge should" :"endpoint should not" ); +}
drivers/pci/pci.h +3 -0
@@ -1253,6 +1253,7 @@ bool of_pci_supply_present(struct device_node *np);int of_pci_get_equalization_presets (struct device *dev,struct pci_eq_presets *presets,int num_lanes); +void of_pci_verify_node (struct pci_dev *pdev);#else static inline int of_get_pci_domain_nr (struct device_node *node)
@@ -1308,6 +1309,8 @@ static inline int of_pci_get_equalization_presets(struct device *dev, return 0; } + +static inline void of_pci_verify_node (struct pci_dev *pdev) { }#endif /* CONFIG_OF */ struct of_changeset ;
Signature · 1 line
2.53.0
[email protected]
AI reviewRe: [PATCH v3 3/4] PCI: of: introduce of_pci_verify_node()
Thank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider: - [Medium] The check in of_pci_verify_node() falsely flags compliant CardBus and PowerPC PCIe bridges as…
Thank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider:
- [Medium] The check in of_pci_verify_node() falsely flags compliant CardBus and PowerPC PCIe bridges as having an invalid device_type. --
commit 72a980b9469901bec37d04c04dd8de642179aa44
Author: Alex Elder <[email protected]>
PCI: of: introduce of_pci_verify_node()
This commit introduces a runtime check to verify PCI devicetree nodes. It ensures that bridge devices have the "pci" device_type property and that endpoint devices do not.
Quoted 4 lines
drivers/pci/of.c +0
-0
[ ... ]
Quoted 8 lines
drivers/pci/of.c +4
-0@@ -1085,3 +1085,34 @@ int of_pci_get_equalization_presets(struct device *dev,return 0 ; }EXPORT_SYMBOL_GPL (of_pci_get_equalization_presets); + +/** +* of_pci_verify_node - Sanity check some PCI device node properties +* @pdev: The PCI device whose device node is checked
[ ... ]
Quoted 9 lines
drivers/pci/of.c +9
-0+void of_pci_verify_node (struct pci_dev *pdev) +{ +struct device_node *np =pci_device_to_OF_node (pdev); +bool device_is_bridge; +bool device_type_pci; + +/* Nothing to check if there's no pre-existing devicetree node */ +if (!np) +return ;
drivers/pci/of.c int of_pci_get_equalization_presets(struct device *dev, · line 1117
Quoted 10 lines
drivers/pci/of.c +10
-0+ + device_is_bridge =pci_is_bridge (pdev); + device_type_pci =of_node_is_type (np,"pci" ); + +/* Bridges should have device type "pci"; endpoints should not */ +if (device_is_bridge == device_type_pci) +return ; + +dev_err (&pdev->dev,"PCI %s have \"pci\" device_type property\n" , + device_is_bridge ?"bridge should" :"endpoint should not" );
[Severity: Medium]
Will this falsely flag compliant CardBus and PowerPC PCIe bridges as having an invalid device type?
The check in of_pci_verify_node() expects all bridges to have a device type of exactly "pci". However, valid PCI bridges can legitimately use "cardbus" or "pciex" as their device_type property.
When a PCI bridge with one of these valid types is added, the following call chain unconditionally triggers this error:
pci_bus_add_device()
of_pci_verify_node()
This could emit a false dev_err() during boot on platforms using these standard bridges, which might alarm users by polluting the kernel logs.
Quoted 1 line
+}
Signature · 1 line
Sashiko AI review · https://sashiko.dev/#/patchset/[email protected]?part=3
Re: [PATCH v3 3/4] PCI: of: introduce of_pci_verify_node()
Quoted 2 lines · On 8/31/26 8:21 PM, [email protected] wrote:
Thank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider:
- [Medium] The check inof_pci_verify_node()falsely flags compliant CardBus and PowerPC PCIe bridges as having an invaliddevice_type.
I was unfortunately not considering those types of bridges, and don't have experience with (or access to) either.
In the devicetree code, of_bus_pci_match() does check for device_type "pciex" but does not handle "cardbus" (at least, not explicitly--the "default-flags" bus type might do the right thing).
I would love to get some pointers from others on how to do this correctly, but in any case I'll do a little more research on this before I post version 4.
-Alex
Quoted 66 lines
--
commit
72a980b9469901bec37d04c04dd8de642179aa44
Author: Alex Elder <[email protected]>PCI: of: introduce
of_pci_verify_node()This commit introduces a runtime check to verify PCI devicetree nodes. It ensures that bridge devices have the "pci"
device_typeproperty and that endpoint devices do not.Quoted 4 lines
drivers/pci/of.c +0
-0[ ... ]
Quoted 8 lines
drivers/pci/of.c +4
-0@@ -1085,3 +1085,34 @@ int of_pci_get_equalization_presets(struct device *dev,return 0 ; }EXPORT_SYMBOL_GPL (of_pci_get_equalization_presets); + +/** +* of_pci_verify_node - Sanity check some PCI device node properties +* @pdev: The PCI device whose device node is checked [ ... ]
Quoted 9 lines
drivers/pci/of.c +9
-0+void of_pci_verify_node (struct pci_dev *pdev) +{ +struct device_node *np =pci_device_to_OF_node (pdev); +bool device_is_bridge; +bool device_type_pci; + +/* Nothing to check if there's no pre-existing devicetree node */ +if (!np) +return ;drivers/pci/of.c int of_pci_get_equalization_presets(struct device *dev, · line 1117
Quoted 10 lines
drivers/pci/of.c +10
-0+ + device_is_bridge =pci_is_bridge (pdev); + device_type_pci =of_node_is_type (np,"pci" ); + +/* Bridges should have device type "pci"; endpoints should not */ +if (device_is_bridge == device_type_pci) +return ; + +dev_err (&pdev->dev,"PCI %s have \"pci\" device_type property\n" , + device_is_bridge ?"bridge should" :"endpoint should not" );[Severity: Medium]
Will this falsely flag compliant CardBus and PowerPC PCIe bridges as having an invalid device type?The check in
of_pci_verify_node()expects all bridges to have a device type of exactly "pci". However, valid PCI bridges can legitimately use "cardbus" or "pciex" as theirdevice_typeproperty.When a PCI bridge with one of these valid types is added, the following call chain unconditionally triggers this error:
pci_bus_add_device()
of_pci_verify_node()This could emit a false
dev_err()during boot on platforms using these standard bridges, which might alarm users by polluting the kernel logs.Quoted 1 line
+}
Rob Herring
maintainerRe: [PATCH v3 3/4] PCI: of: introduce of_pci_verify_node()
Quoted 7 lines · Alex Elder
Quoted 2 lines · On 8/31/26 8:21 PM, [email protected] wrote:
Thank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider:
- [Medium] The check inof_pci_verify_node()falsely flags compliant CardBus and PowerPC PCIe bridges as having an invaliddevice_type.I was unfortunately not considering those types of bridges, and don't have experience with (or access to) either.
Quoted 8 lines
In the devicetree code,
of_bus_pci_match()does check fordevice_type"pciex" but does not handle "cardbus" (at least, not explicitly--the "default-flags" bus type might do the right thing).I would love to get some pointers from others on how to do this correctly, but in any case I'll do a little more research on this before I post version 4.
I'm willing to wait and see if anyone cares about cardbus. I doubt it. Maybe there's some old PowerBooks with cardbus?
"pciex" should probably be handled.
Rob
Re: [PATCH v3 3/4] PCI: of: introduce of_pci_verify_node()
Quoted 13 lines · Rob Herring
Quoted 12 lines · Alex Elder
Quoted 2 lines · On 8/31/26 8:21 PM, [email protected] wrote:
Thank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider:
- [Medium] The check inof_pci_verify_node()falsely flags compliant CardBus and PowerPC PCIe bridges as having an invaliddevice_type.I was unfortunately not considering those types of bridges, and don't have experience with (or access to) either.
In the devicetree code,
of_bus_pci_match()does check fordevice_type"pciex" but does not handle "cardbus" (at least, not explicitly--the "default-flags" bus type might do the right thing).
Quoted 6 lines
Quoted 3 lines
I would love to get some pointers from others on how to do this correctly, but in any case I'll do a little more research on this before I post version 4.
I'm willing to wait and see if anyone cares about cardbus. I doubt it. Maybe there's some old PowerBooks with cardbus?
I'll give it another few days before posting v4.
Quoted 1 line
"pciex" should probably be handled.
I'll add that. I'll also try to find what the range of "compliant" device types is; I presume it's in the devicetree spec.
Thanks a lot.
-Alex>
Quoted 1 line
Rob
Re: [PATCH v3 3/4] PCI: of: introduce of_pci_verify_node()
Quoted 7 lines · Alex Elder
Quoted 6 lines
Quoted 3 lines
I would love to get some pointers from others on how to do this correctly, but in any case I'll do a little more research on this before I post version 4.
I'm willing to wait and see if anyone cares about cardbus. I doubt it. Maybe there's some old PowerBooks with cardbus?
Quoted 7 lines
I'll give it another few days before posting v4.
Quoted 1 line
"pciex" should probably be handled.
I'll add that. I'll also try to find what the range of "compliant" device types is; I presume it's in the devicetree spec.
I'm about to send v4 of this series. Here is some information on this suggestion:
- "cardbus" is referenced in two places (two very similar functions, one for PowerPC and one for SPARC.
of_create_pci_dev() in "arch/powerpc/kernel/pci_of_scan.c" of_create_pci_dev() in "arch/sparc/kernel/pci.c"
Based on the tone of your earlier comment, I'll ignore "cardbus".
- "pciex" is checked in 6 places, one of which is generic (the other five are related to the above two architectures). The generic one is in of_bus_pci_match(), mentioned earlier.
Sashiko's suggestion only mentioned those two device_type values. I'll just add a test for "pciex" as you suggested.
Herve, I will retain your "reviewed-by" tag; if you disagree with this minor change say so and I'll remove it in v5.
-Alex
Re: [PATCH v3 3/4] PCI: of: introduce of_pci_verify_node()
In reply to Alex ElderHi Alex,
Quoted 37 lines · On Mon, 31 Aug 2026 20:13:36 -0500 Alex Elder <[email protected]> wrote:
Commit
407d1a51921e9("PCI: Create device tree node for bridge") linked the PCI enumeration process together with devicetree, creating a devicetree node for discovered PCI bridges. Its successor commitae9813db1dc5a("PCI:
Add quirks to generate device tree node for Xilinx Alveo U50") shows how to use a PCI final fixup quirk to also create a devicetree node for a non-bridge PCI device. These changes allowed devicetree overlays to describe components downstream of a PCI device, by providing a place to attach the overlay.Note that the dynamic devicetree node is only created if the device didn't already have an assigned node.
Later, commit
aa7b4bbcb3a1d("arm64: dts: qcom: qcs6490-rb3gen2: Add TC9563 PCIe switch node") *pre-defined* devicetree nodes to represent the PCI device nodes that would (also) be discovered via the PCI enumeration process. The devicetree node in this case is created with the content from the DTS file. So when a (host) bridge is done being initialized during PCI enumeration, no node is dynamically created (the commits mentioned above do not apply).Ideally, any pre-defined PCI devicetree node would contain exactly the same information as whatever the dynamic creation process would produce (though it could include more).
However that is not the case for the pre-defined Qualcomm RB3gen2 nodes. And in particular, the endpoint (function) nodes include this property:
device_type = "pci";This is simply wrong; that property is meant only for bridge nodes.
Rob Herring requested that a runtime check to be added to spot this specific error, only for non-bridge PCI devices. Herve Codina further suggested we ensure that bridge PCI devices *do* define the
device_typeproperty, with value "pci".Signed-off-by Alex Elder <[email protected]>
Quoted 9 lines
---
v3: - Switch a function header to use kernel-doc format
- Add a warning if a PCI bridge node has nodevice_typepropertydrivers/pci/bus.c | 1 + drivers/pci/of.c | 31 +++++++++++++++++++++++++++++++ drivers/pci/pci.h | 3 +++ 3 files changed, 35 insertions(+)
LGTM.
Best regards,
Hervé
PATCH v3 4/4 of: address: kill of_node_is_pcie()
In reply to Alex ElderThe of_bus->match function for the "PCI" bus type is fairly liberal in what it accepts as a PCI bus devicetree node. If a node has no device_type property, it even allows a node named "pcie@" to be accepted as represnting a devicetree bus, though it issues a warning in that case.
A recent PCI commit introduced of_pci_verify_node(). When a PCI device is added, if it has a devicetree node, that function checks its device_type property. For PCI bridge devices, if there is no device_type property (value "pci"), a warning is issued.
That warning duplicates the warning made by of_node_is_pcie(), and there's no point in that. Avoid the second (OF) warning by just checking the node name directly in of_bus_pci_match().
That leaves of_node_is_pcie() unused, so get rid of it.
---
v3: - Added (new) in this version of the series
drivers/of/address.c | 12 +----------- 1 file changed, 1 insertion(+), 11 deletions(-)
drivers/of/address.c +1 -11
@@ -134,16 +134,6 @@ static unsigned int of_bus_pci_get_flags(const __be32 *addr)* PCI bus specific translator */ -static bool of_node_is_pcie (const struct device_node *np) -{ -bool is_pcie =of_node_name_eq (np,"pcie" ); - -if (is_pcie) -pr_warn_once ("%pOF: Missing device_type\n" , np); - -return is_pcie; -} -static int of_bus_pci_match (struct device_node *np) {/*
@@ -156,7 +146,7 @@ static int of_bus_pci_match(struct device_node *np)*/ return of_node_is_type (np,"pci" ) ||of_node_is_type (np,"pciex" ) ||of_node_is_type (np,"vci" ) ||of_node_is_type (np,"ht" ) || -of_node_is_pcie (np); +of_node_name_eq (np,"pcie" ); } static void of_bus_pci_count_cells(struct device_node *np,
Signature · 1 line
2.53.0
[email protected]
AI reviewRe: [PATCH v3 4/4] of: address: kill of_node_is_pcie()
Thank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider: - [Low] Outdated comment in `of_bus_pci_match()` incorrectly claims a warning is issued. --
Thank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider:
- [Low] Outdated comment in of_bus_pci_match() incorrectly claims a warning is issued. --
commit 0ffaade5a7eebd20cc4d79d7c8ed0d49f6da1857
Author: Alex Elder <[email protected]>
of: address: kill of_node_is_pcie()
The of_bus->match function for the "PCI" bus type is fairly liberal in what it accepts as a PCI bus devicetree node. If a node has no device_type property, it even allows a node named "pcie@" to be accepted as represnting a devicetree bus, though it issues a warning in that case.
Quoted 4 lines
drivers/of/address.c +0
-0
[ ... ]
drivers/of/address.c static int of_bus_pci_match(struct device_node *np) · line 150
Quoted 11 lines
drivers/of/address.c +1
-1@@ -156,7 +146,7 @@ static int of_bus_pci_match(struct device_node *np)* "ht" is hypertransport * * If none of the device_type match, and that the node name is * "pcie", accept the device as PCI (with a warning). */ return of_node_is_type (np,"pci" ) ||of_node_is_type (np,"pciex" ) ||of_node_is_type (np,"vci" ) ||of_node_is_type (np,"ht" ) || -of_node_is_pcie (np); +of_node_name_eq (np,"pcie" ); }
[Severity: Low]
Does the comment block above this return statement need to be updated?
Since the patch replaces the call to of_node_is_pcie() with a direct check of the node name to avoid duplicate warnings, the comment in of_bus_pci_match() claiming that it accepts the device "(with a warning)" seems to be a minor documentation regression.
Could we update the comment to reflect the new behavior?
Signature · 1 line
Sashiko AI review · https://sashiko.dev/#/patchset/[email protected]?part=4
Re: [PATCH v3 4/4] of: address: kill of_node_is_pcie()
Quoted 22 lines · On 8/31/26 8:18 PM, [email protected] wrote:
Thank you for your contribution! Sashiko AI review found 1 potential issue(s) to consider:
- [Low] Outdated comment inof_bus_pci_match()incorrectly claims a warning is issued. --commit
0ffaade5a7eebd20cc4d79d7c8ed0d49f6da1857
Author: Alex Elder <[email protected]>of: address: kill
of_node_is_pcie()The
of_bus->matchfunction for the "PCI" bus type is fairly liberal in what it accepts as a PCI bus devicetree node. If a node has nodevice_typeproperty, it even allows a node named "pcie@" to be accepted as represnting a devicetree bus, though it issues a warning in that case.Quoted 4 lines
drivers/of/address.c +0
-0[ ... ]
Quoted 14 lines
drivers/of/address.c static int of_bus_pci_match(struct device_node *np) · line 150
Quoted 11 lines
drivers/of/address.c +1
-1@@ -156,7 +146,7 @@ static int of_bus_pci_match(struct device_node *np)* "ht" is hypertransport * * If none of the device_type match, and that the node name is * "pcie", accept the device as PCI (with a warning). */ return of_node_is_type (np,"pci" ) ||of_node_is_type (np,"pciex" ) ||of_node_is_type (np,"vci" ) ||of_node_is_type (np,"ht" ) || -of_node_is_pcie (np); +of_node_name_eq (np,"pcie" ); }[Severity: Low]
Does the comment block above this return statement need to be updated?
Yes it does. I will issue a v4 of the series with this correction after others have had a chance for review.
-Alex
Quoted 8 lines
Since the patch replaces the call to
of_node_is_pcie()with a direct check of the node name to avoid duplicate warnings, the comment inof_bus_pci_match()claiming that it accepts the device "(with a warning)" seems to be a minor documentation regression.Could we update the comment to reflect the new behavior?
Re: [PATCH v3 4/4] of: address: kill of_node_is_pcie()
In reply to Alex ElderHi Alex,
Quoted 46 lines · On Mon, 31 Aug 2026 20:13:37 -0500 Alex Elder <[email protected]> wrote:
The
of_bus->matchfunction for the "PCI" bus type is fairly liberal in what it accepts as a PCI bus devicetree node. If a node has nodevice_typeproperty, it even allows a node named "pcie@" to be accepted as represnting a devicetree bus, though it issues a warning in that case.A recent PCI commit introduced
of_pci_verify_node(). When a PCI device is added, if it has a devicetree node, that function checks itsdevice_typeproperty. For PCI bridge devices, if there is nodevice_typeproperty (value "pci"), a warning is issued.That warning duplicates the warning made by
of_node_is_pcie(), and there's no point in that. Avoid the second (OF) warning by just checking the node name directly inof_bus_pci_match().That leaves
of_node_is_pcie()unused, so get rid of it.Signed-off-by Alex Elder <[email protected]>---
v3: - Added (new) in this version of the seriesdrivers/of/address.c | 12 +----------- 1 file changed, 1 insertion(+), 11 deletions(-)drivers/of/address.c +0
-10@@ -134,16 +134,6 @@ static unsigned int of_bus_pci_get_flags(const __be32 *addr)* PCI bus specific translator */ -static bool of_node_is_pcie (const struct device_node *np) -{ -bool is_pcie =of_node_name_eq (np,"pcie" ); - -if (is_pcie) -pr_warn_once ("%pOF: Missing device_type\n" , np); - -return is_pcie; -} -static int of_bus_pci_match (struct device_node *np) {/*
drivers/of/address.c static int of_bus_pci_match(struct device_node *np) · line 152
Quoted 8 lines
drivers/of/address.c +1
-1@@ -156,7 +146,7 @@ static int of_bus_pci_match(struct device_node *np)*/ return of_node_is_type (np,"pci" ) ||of_node_is_type (np,"pciex" ) ||of_node_is_type (np,"vci" ) ||of_node_is_type (np,"ht" ) || -of_node_is_pcie (np); +of_node_name_eq (np,"pcie" ); } static void of_bus_pci_count_cells(struct device_node *np,
The warning here was printed based on the node name whereas of_node_is_pcie() prints the message based on the 'device_type' property of a pci_dev node.
For PCI to PCI bridges, no problem the warning is indeed duplicated but what happens for the PCI host controller?
PCI host controller drivers calls pci_host_probe() and are seen by the PCI core as a struct pci_host_bridge.
of_node_is_pcie() is called for children of the PCI host controller (i.e. PCI devices scanned on the PCI bus handled by the host controller) but not for the PCI host controller itself.
The OF node of the host controller must have the 'device_type' property set to "pci".
I am not so sure that this warning was duplicated when we consider the PCI host controller node.
Can you double check on your side?
Best regards,
Hervé
Re: [PATCH v3 4/4] of: address: kill of_node_is_pcie()
Quoted 58 lines · Herve Codina
Hi Alex,
Quoted 53 lines · On Mon, 31 Aug 2026 20:13:37 -0500 Alex Elder <[email protected]> wrote:
The
of_bus->matchfunction for the "PCI" bus type is fairly liberal in what it accepts as a PCI bus devicetree node. If a node has nodevice_typeproperty, it even allows a node named "pcie@" to be accepted as represnting a devicetree bus, though it issues a warning in that case.A recent PCI commit introduced
of_pci_verify_node(). When a PCI device is added, if it has a devicetree node, that function checks itsdevice_typeproperty. For PCI bridge devices, if there is nodevice_typeproperty (value "pci"), a warning is issued.That warning duplicates the warning made by
of_node_is_pcie(), and there's no point in that. Avoid the second (OF) warning by just checking the node name directly inof_bus_pci_match().That leaves
of_node_is_pcie()unused, so get rid of it.Signed-off-by Alex Elder <[email protected]>---
v3: - Added (new) in this version of the seriesdrivers/of/address.c | 12 +----------- 1 file changed, 1 insertion(+), 11 deletions(-)drivers/of/address.c +1
-11@@ -134,16 +134,6 @@ static unsigned int of_bus_pci_get_flags(const __be32 *addr)* PCI bus specific translator */ -static bool of_node_is_pcie (const struct device_node *np) -{ -bool is_pcie =of_node_name_eq (np,"pcie" ); - -if (is_pcie) -pr_warn_once ("%pOF: Missing device_type\n" , np); - -return is_pcie; -} -static int of_bus_pci_match (struct device_node *np) {/* @@ -156,7 +146,7 @@ static int of_bus_pci_match(struct device_node *np)*/ return of_node_is_type (np,"pci" ) ||of_node_is_type (np,"pciex" ) ||of_node_is_type (np,"vci" ) ||of_node_is_type (np,"ht" ) || -of_node_is_pcie (np); +of_node_name_eq (np,"pcie" ); }
Quoted 4 lines
drivers/of/address.c static int of_bus_pci_match(struct device_node *np) · line 152
Quoted 1 line
drivers/of/address.c +0
-0static void of_bus_pci_count_cells(struct device_node *np,The warning here was printed based on the node name whereas
of_node_is_pcie()prints the message based on the 'device_type' property of apci_devnode.
You're right. Both warnings were getting reported for me, but for different reasons.
I would be happy to just drop this patch and live with two warnings in some cases (we should rarely see either one of them anyway, right?).
Is that OK with you? Does anyone feel this patch should be kept?
Thank you.
-Alex
Quoted 20 lines
For PCI to PCI bridges, no problem the warning is indeed duplicated but what happens for the PCI host controller?
PCI host controller drivers calls
pci_host_probe()and are seen by the PCI core as a structpci_host_bridge.
of_node_is_pcie()is called for children of the PCI host controller (i.e. PCI devices scanned on the PCI bus handled by the host controller) but not for the PCI host controller itself.The OF node of the host controller must have the '
device_type' property set to "pci".I am not so sure that this warning was duplicated when we consider the PCI host controller node.
Can you double check on your side?
Best regards,
Hervé
Re: [PATCH v3 4/4] of: address: kill of_node_is_pcie()
Hi Alex,
Quoted 64 lines · On Tue, 1 Sep 2026 09:58:10 -0500 Alex Elder <[email protected]> wrote:
Quoted 58 lines · Herve Codina
Hi Alex,
Quoted 53 lines · On Mon, 31 Aug 2026 20:13:37 -0500 Alex Elder <[email protected]> wrote:
The
of_bus->matchfunction for the "PCI" bus type is fairly liberal in what it accepts as a PCI bus devicetree node. If a node has nodevice_typeproperty, it even allows a node named "pcie@" to be accepted as represnting a devicetree bus, though it issues a warning in that case.A recent PCI commit introduced
of_pci_verify_node(). When a PCI device is added, if it has a devicetree node, that function checks itsdevice_typeproperty. For PCI bridge devices, if there is nodevice_typeproperty (value "pci"), a warning is issued.That warning duplicates the warning made by
of_node_is_pcie(), and there's no point in that. Avoid the second (OF) warning by just checking the node name directly inof_bus_pci_match().That leaves
of_node_is_pcie()unused, so get rid of it.Signed-off-by Alex Elder <[email protected]>---
v3: - Added (new) in this version of the seriesdrivers/of/address.c | 12 +----------- 1 file changed, 1 insertion(+), 11 deletions(-)drivers/of/address.c +1
-11@@ -134,16 +134,6 @@ static unsigned int of_bus_pci_get_flags(const __be32 *addr)* PCI bus specific translator */ -static bool of_node_is_pcie (const struct device_node *np) -{ -bool is_pcie =of_node_name_eq (np,"pcie" ); - -if (is_pcie) -pr_warn_once ("%pOF: Missing device_type\n" , np); - -return is_pcie; -} -static int of_bus_pci_match (struct device_node *np) {/* @@ -156,7 +146,7 @@ static int of_bus_pci_match(struct device_node *np)*/ return of_node_is_type (np,"pci" ) ||of_node_is_type (np,"pciex" ) ||of_node_is_type (np,"vci" ) ||of_node_is_type (np,"ht" ) || -of_node_is_pcie (np); +of_node_name_eq (np,"pcie" ); }Quoted 4 lines
drivers/of/address.c static int of_bus_pci_match(struct device_node *np) · line 152
Quoted 1 line
drivers/of/address.c +0
-0static void of_bus_pci_count_cells(struct device_node *np,The warning here was printed based on the node name whereas
of_node_is_pcie()prints the message based on the 'device_type' property of apci_devnode.
Quoted 7 lines
You're right. Both warnings were getting reported for me, but for different reasons.
I would be happy to just drop this patch and live with two warnings in some cases (we should rarely see either one of them anyway, right?).
Is that OK with you? Does anyone feel this patch should be kept?
On my side, I have no problem to see two warnings and so, IHMO, this patch can be dropped.
Best regards,
Hervé
Re: [PATCH v3 4/4] of: address: kill of_node_is_pcie()
Quoted 11 lines · Herve Codina
Quoted 9 lines
Quoted 2 lines
The warning here was printed based on the node name whereas
of_node_is_pcie()prints the message based on the 'device_type' property of apci_devnode.You're right. Both warnings were getting reported for me, but for different reasons.
I would be happy to just drop this patch and live with two warnings in some cases (we should rarely see either one of them anyway, right?).
Is that OK with you? Does anyone feel this patch should be kept?
On my side, I have no problem to see two warnings and so, IHMO, this patch can be dropped.
Unless I hear otherwise, that's what I will do, for v4, which I'll send out sometime this week after addressing concerns pointed out by Sashiko.
Thank you.
-Alex