From: David Matlack <dmatlack@google.com>
To: linux-kernel@vger.kernel.org, linux-pci@vger.kernel.org,
linuxppc-dev@lists.ozlabs.org
Cc: Alex Williamson <alex@shazbot.org>,
Bjorn Helgaas <bhelgaas@google.com>,
Jason Gunthorpe <jgg@nvidia.com>,
Josh Hilke <jrhilke@google.com>, Lukas Wunner <lukas@wunner.de>,
Mahesh J Salgaonkar <mahesh@linux.ibm.com>,
"Oliver O'Halloran" <oohall@gmail.com>,
Pasha Tatashin <pasha.tatashin@soleen.com>,
Pratyush Yadav <pratyush@kernel.org>,
Samiullah Khawaja <skhawaja@google.com>,
Vipin Sharma <vipinsh@google.com>,
David Matlack <dmatlack@google.com>
Subject: [PATCH 04/15] PCI: Save PCIe state in the saved capability store
Date: Thu, 24 Sep 2026 17:34:50 +0000 [thread overview]
Message-ID: <20260924173501.856380-5-dmatlack@google.com> (raw)
In-Reply-To: <20260924173501.856380-1-dmatlack@google.com>
Save and restore the PCIe capability control registers through the
per-device saved capability store instead of a private pci_cap_saved_state
buffer.
The private buffer is an opaque array of u16s whose layout is a contract
between pci_save_pcie_state() and pci_restore_pcie_state(). Anything else
that needs to touch the saved state has to know that contract, e.g.
pci_update_aspm_saved_state() patches the saved Link Control register with
a comment reminding the reader that cap[1] is LNKCTL. Indexing the saved
state by configuration space offset removes the coupling.
Describe the registers to save in pcie_saved_regs[] and drive the
reservation, save, and restore loops from it so that the three can no
longer disagree about which register is where.
Reserve the registers based on pci_is_pcie() rather than
pci_find_capability(PCI_CAP_ID_EXP), so that a device whose capability
list is broken but whose pcie_cap a quirk has fixed up gets saved state
like any other PCIe device. Drop the save buffer that
quirk_intel_qat_vf_cap() builds by hand, since it is no longer needed.
Keep using pcie_capability_read_word() and pcie_capability_write_word() to
access the hardware so that registers the device does not implement are
skipped. Reserve space for all of the registers regardless; that is
harmless, since an unimplemented register reads back as zero and is
never written.
While here, make pci_save_pcie_state() void now that it cannot fail.
No functional change intended.
Assisted-by: LLM
Signed-off-by: David Matlack <dmatlack@google.com>
---
drivers/pci/pci.c | 83 +++++++++++++++++++++--------------------
drivers/pci/pcie/aspm.c | 16 +++-----
drivers/pci/quirks.c | 30 +--------------
3 files changed, 49 insertions(+), 80 deletions(-)
diff --git a/drivers/pci/pci.c b/drivers/pci/pci.c
index 7be54751a5d3..1c2c572aa49c 100644
--- a/drivers/pci/pci.c
+++ b/drivers/pci/pci.c
@@ -1648,7 +1648,20 @@ int pci_set_power_state_locked(struct pci_dev *dev, pci_power_t state)
}
EXPORT_SYMBOL(pci_set_power_state_locked);
-#define PCI_EXP_SAVE_REGS 7
+/*
+ * PCIe capability registers saved and restored by the PCI core. Registers a
+ * device does not implement are skipped by the pcie_capability_*() accessors,
+ * so space is reserved for all of them regardless of the device.
+ */
+static const u16 pcie_saved_regs[] = {
+ PCI_EXP_DEVCTL,
+ PCI_EXP_LNKCTL,
+ PCI_EXP_SLTCTL,
+ PCI_EXP_RTCTL,
+ PCI_EXP_DEVCTL2,
+ PCI_EXP_LNKCTL2,
+ PCI_EXP_SLTCTL2,
+};
static struct pci_cap_saved_state *_pci_find_saved_cap(struct pci_dev *pci_dev,
u16 cap, bool extended)
@@ -1672,41 +1685,27 @@ struct pci_cap_saved_state *pci_find_saved_ext_cap(struct pci_dev *dev, u16 cap)
return _pci_find_saved_cap(dev, cap, true);
}
-static int pci_save_pcie_state(struct pci_dev *dev)
+static void pci_save_pcie_state(struct pci_dev *dev)
{
- int i = 0;
- struct pci_cap_saved_state *save_state;
- u16 *cap;
+ unsigned int i;
+ u16 val;
if (!pci_is_pcie(dev))
- return 0;
+ return;
- save_state = pci_find_saved_cap(dev, PCI_CAP_ID_EXP);
- if (!save_state) {
- pci_err(dev, "buffer not found in %s\n", __func__);
- return -ENOMEM;
+ for (i = 0; i < ARRAY_SIZE(pcie_saved_regs); i++) {
+ pcie_capability_read_word(dev, pcie_saved_regs[i], &val);
+ pci_write_saved_cap_word(dev, dev->pcie_cap + pcie_saved_regs[i],
+ val);
}
- cap = (u16 *)&save_state->cap.data[0];
- pcie_capability_read_word(dev, PCI_EXP_DEVCTL, &cap[i++]);
- pcie_capability_read_word(dev, PCI_EXP_LNKCTL, &cap[i++]);
- pcie_capability_read_word(dev, PCI_EXP_SLTCTL, &cap[i++]);
- pcie_capability_read_word(dev, PCI_EXP_RTCTL, &cap[i++]);
- pcie_capability_read_word(dev, PCI_EXP_DEVCTL2, &cap[i++]);
- pcie_capability_read_word(dev, PCI_EXP_LNKCTL2, &cap[i++]);
- pcie_capability_read_word(dev, PCI_EXP_SLTCTL2, &cap[i++]);
-
pci_save_aspm_l1ss_state(dev);
pci_save_ltr_state(dev);
-
- return 0;
}
static void pci_restore_pcie_state(struct pci_dev *dev)
{
- int i = 0;
- struct pci_cap_saved_state *save_state;
- u16 *cap;
+ unsigned int i;
/*
* Restore max latencies (in the LTR capability) before enabling
@@ -1715,8 +1714,7 @@ static void pci_restore_pcie_state(struct pci_dev *dev)
pci_restore_ltr_state(dev);
pci_restore_aspm_l1ss_state(dev);
- save_state = pci_find_saved_cap(dev, PCI_CAP_ID_EXP);
- if (!save_state)
+ if (!pci_is_pcie(dev))
return;
/*
@@ -1726,14 +1724,13 @@ static void pci_restore_pcie_state(struct pci_dev *dev)
*/
pci_bridge_reconfigure_ltr(dev);
- cap = (u16 *)&save_state->cap.data[0];
- pcie_capability_write_word(dev, PCI_EXP_DEVCTL, cap[i++]);
- pcie_capability_write_word(dev, PCI_EXP_LNKCTL, cap[i++]);
- pcie_capability_write_word(dev, PCI_EXP_SLTCTL, cap[i++]);
- pcie_capability_write_word(dev, PCI_EXP_RTCTL, cap[i++]);
- pcie_capability_write_word(dev, PCI_EXP_DEVCTL2, cap[i++]);
- pcie_capability_write_word(dev, PCI_EXP_LNKCTL2, cap[i++]);
- pcie_capability_write_word(dev, PCI_EXP_SLTCTL2, cap[i++]);
+ for (i = 0; i < ARRAY_SIZE(pcie_saved_regs); i++) {
+ u16 reg = pcie_saved_regs[i];
+ u16 val;
+
+ if (pci_read_saved_cap_word(dev, dev->pcie_cap + reg, &val))
+ pcie_capability_write_word(dev, reg, val);
+ }
}
static int pci_save_pcix_state(struct pci_dev *dev)
@@ -1788,9 +1785,7 @@ int pci_save_state(struct pci_dev *dev)
}
dev->state_saved = true;
- i = pci_save_pcie_state(dev);
- if (i != 0)
- return i;
+ pci_save_pcie_state(dev);
i = pci_save_pcix_state(dev);
if (i != 0)
@@ -3583,12 +3578,18 @@ int pci_add_ext_cap_save_buffer(struct pci_dev *dev, u16 cap, unsigned int size)
*/
void pci_allocate_cap_save_buffers(struct pci_dev *dev)
{
+ unsigned int i;
int error;
- error = pci_add_cap_save_buffer(dev, PCI_CAP_ID_EXP,
- PCI_EXP_SAVE_REGS * sizeof(u16));
- if (error)
- pci_err(dev, "unable to preallocate PCI Express save buffer\n");
+ for (i = 0; pci_is_pcie(dev) && i < ARRAY_SIZE(pcie_saved_regs); i++) {
+ unsigned int off = dev->pcie_cap + pcie_saved_regs[i];
+
+ error = pci_reserve_saved_cap(dev, off, sizeof(u16));
+ if (error) {
+ pci_err(dev, "unable to reserve PCI Express save state\n");
+ break;
+ }
+ }
error = pci_add_cap_save_buffer(dev, PCI_CAP_ID_PCIX, sizeof(u16));
if (error)
diff --git a/drivers/pci/pcie/aspm.c b/drivers/pci/pcie/aspm.c
index 95ac34a34bd5..02922b887ec6 100644
--- a/drivers/pci/pcie/aspm.c
+++ b/drivers/pci/pcie/aspm.c
@@ -324,26 +324,20 @@ static int policy_to_clkpm_state(struct pcie_link_state *link)
static void pci_update_aspm_saved_state(struct pci_dev *dev)
{
- struct pci_cap_saved_state *save_state;
- u16 *cap, lnkctl, aspm_ctl;
-
- save_state = pci_find_saved_cap(dev, PCI_CAP_ID_EXP);
- if (!save_state)
- return;
+ u16 lnkctl, aspm_ctl;
pcie_capability_read_word(dev, PCI_EXP_LNKCTL, &lnkctl);
/*
- * Update ASPM and CLKREQ bits of LNKCTL in save_state. We only
+ * Update ASPM and CLKREQ bits of LNKCTL in the saved state. We only
* write PCI_EXP_LNKCTL_CCC during enumeration, so it shouldn't
- * change after being captured in save_state.
+ * change after being captured in the saved state.
*/
aspm_ctl = lnkctl & (PCI_EXP_LNKCTL_ASPMC | PCI_EXP_LNKCTL_CLKREQ_EN);
lnkctl &= ~(PCI_EXP_LNKCTL_ASPMC | PCI_EXP_LNKCTL_CLKREQ_EN);
- /* Depends on pci_save_pcie_state(): cap[1] is LNKCTL */
- cap = (u16 *)&save_state->cap.data[0];
- cap[1] = lnkctl | aspm_ctl;
+ pci_write_saved_cap_word(dev, dev->pcie_cap + PCI_EXP_LNKCTL,
+ lnkctl | aspm_ctl);
}
static void pcie_set_clkpm_nocheck(struct pcie_link_state *link, int enable)
diff --git a/drivers/pci/quirks.c b/drivers/pci/quirks.c
index de9bbccda21f..ffebab844165 100644
--- a/drivers/pci/quirks.c
+++ b/drivers/pci/quirks.c
@@ -5514,10 +5514,9 @@ int pci_dev_specific_disable_acs_redir(struct pci_dev *dev)
*/
static void quirk_intel_qat_vf_cap(struct pci_dev *pdev)
{
- int pos, i = 0, ret;
+ int pos, ret;
u8 next_cap;
- u16 reg16, *cap;
- struct pci_cap_saved_state *state;
+ u16 reg16;
/* Bail if the hardware bug is fixed */
if (pdev->pcie_cap || pci_find_capability(pdev, PCI_CAP_ID_EXP))
@@ -5548,10 +5547,6 @@ static void quirk_intel_qat_vf_cap(struct pci_dev *pdev)
pci_read_config_word(pdev, pos, ®16);
if (reg16 == (0x0000 | PCI_CAP_ID_EXP)) {
u32 status;
-#ifndef PCI_EXP_SAVE_REGS
-#define PCI_EXP_SAVE_REGS 7
-#endif
- int size = PCI_EXP_SAVE_REGS * sizeof(u16);
pdev->pcie_cap = pos;
pci_read_config_word(pdev, pos + PCI_EXP_FLAGS, ®16);
@@ -5563,27 +5558,6 @@ static void quirk_intel_qat_vf_cap(struct pci_dev *pdev)
ret = pci_read_config_dword(pdev, PCI_CFG_SPACE_SIZE, &status);
if ((ret != PCIBIOS_SUCCESSFUL) || (PCI_POSSIBLE_ERROR(status)))
pdev->cfg_size = PCI_CFG_SPACE_SIZE;
-
- if (pci_find_saved_cap(pdev, PCI_CAP_ID_EXP))
- return;
-
- /* Save PCIe cap */
- state = kzalloc(sizeof(*state) + size, GFP_KERNEL);
- if (!state)
- return;
-
- state->cap.cap_nr = PCI_CAP_ID_EXP;
- state->cap.cap_extended = 0;
- state->cap.size = size;
- cap = (u16 *)&state->cap.data[0];
- pcie_capability_read_word(pdev, PCI_EXP_DEVCTL, &cap[i++]);
- pcie_capability_read_word(pdev, PCI_EXP_LNKCTL, &cap[i++]);
- pcie_capability_read_word(pdev, PCI_EXP_SLTCTL, &cap[i++]);
- pcie_capability_read_word(pdev, PCI_EXP_RTCTL, &cap[i++]);
- pcie_capability_read_word(pdev, PCI_EXP_DEVCTL2, &cap[i++]);
- pcie_capability_read_word(pdev, PCI_EXP_LNKCTL2, &cap[i++]);
- pcie_capability_read_word(pdev, PCI_EXP_SLTCTL2, &cap[i++]);
- hlist_add_head(&state->next, &pdev->saved_cap_space);
}
}
DECLARE_PCI_FIXUP_EARLY(PCI_VENDOR_ID_INTEL, 0x443, quirk_intel_qat_vf_cap);
--
2.56.0.rc1.315.gc6ed9934b7-goog
next prev parent reply other threads:[~2026-09-24 17:35 UTC|newest]
Thread overview: 16+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-09-24 17:34 [PATCH 00/15] PCI: Index saved capability state by configuration space offset David Matlack
2026-09-24 17:34 ` [PATCH 01/15] PCI/DPC: Allocate the DPC save buffer during device setup David Matlack
2026-09-24 17:34 ` [PATCH 02/15] PCI: Add an offset-indexed store for saved capability registers David Matlack
2026-09-24 17:34 ` [PATCH 03/15] PCI: Lay out struct pci_saved_state by configuration space offset David Matlack
2026-09-24 17:34 ` David Matlack [this message]
2026-09-24 17:34 ` [PATCH 05/15] PCI: Save PCI-X state in the saved capability store David Matlack
2026-09-24 17:34 ` [PATCH 06/15] PCI/ASPM: Save LTR " David Matlack
2026-09-24 17:34 ` [PATCH 07/15] PCI/ASPM: Save L1SS " David Matlack
2026-09-24 17:34 ` [PATCH 08/15] PCI/AER: Save AER " David Matlack
2026-09-24 17:34 ` [PATCH 09/15] PCI/PTM: Save PTM " David Matlack
2026-09-24 17:34 ` [PATCH 10/15] PCI/TPH: Save TPH " David Matlack
2026-09-24 17:34 ` [PATCH 11/15] PCI/DPC: Save DPC " David Matlack
2026-09-24 17:34 ` [PATCH 12/15] PCI/VC: Split the VC Resource Control restore into a helper David Matlack
2026-09-24 17:34 ` [PATCH 13/15] PCI/VC: Save VC state in the saved capability store David Matlack
2026-09-24 17:35 ` [PATCH 14/15] PCI: Save reserved capability registers in a single pass David Matlack
2026-09-24 17:35 ` [PATCH 15/15] PCI: Remove the per-capability save buffers David Matlack
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260924173501.856380-5-dmatlack@google.com \
--to=dmatlack@google.com \
--cc=alex@shazbot.org \
--cc=bhelgaas@google.com \
--cc=jgg@nvidia.com \
--cc=jrhilke@google.com \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-pci@vger.kernel.org \
--cc=linuxppc-dev@lists.ozlabs.org \
--cc=lukas@wunner.de \
--cc=mahesh@linux.ibm.com \
--cc=oohall@gmail.com \
--cc=pasha.tatashin@soleen.com \
--cc=pratyush@kernel.org \
--cc=skhawaja@google.com \
--cc=vipinsh@google.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®