Skip to content

Commit

Permalink
PCI: hotplug: Initial support of the movable BARs feature
Browse files Browse the repository at this point in the history
When hot-adding a device, the involved bridge may have windows not big
enough (or fragmented too much) for newly requested BARs to fit in. But
expanding these bridge windows may be impossible if they are wedged between
existing neighboring BARs.

Still, it may be possible to allocate a memory region for new BARs, if at
least some working BARs can be moved, using the following procedure:

1) Notify all the drivers which support movable BARs to pause and release
   the BARs; the rest of the drivers are guaranteed that their devices will
   not get BARs moved;

2) Release all the bridge windows and movable BARs;

3) Try to recalculate new bridge windows that will fit all the BAR types:
   - fixed (those marked with PCI_FIXED or bound by not-updated drivers);
   - movable;
   - newly requested by hot-added devices;

4) If that failed, disable BARs for one of the hot-added devices and repeat
   the step 3;

5) Notify the drivers, so they remap BARs and resume.

If bridge calculation and BAR assignment fail with hot-added devices, this
patchset disables their BARs, falling back to the same amount and size of
BARs as they were before the hotplug event. The kernel succeeded then, so
the same BAR layout will be reproduced again.

This makes the prior reservation of memory by BIOS/bootloader/firmware not
required anymore for the PCI hotplug.

Drivers indicate support of movable BARs by implementing a new .bar_fixed()
hook and two optional ones: .rescan_prepare() and .rescan_done() in the
struct pci_driver. All device's activity must be paused during a rescan,
and iounmap()+ioremap() must be applied to every used BAR.

If a device is not bound to a driver, its BARs are considered movable,
except VGA devices, due to sometimes indirect usage of their framebuffers.

For a higher probability of the successful BAR reassignment, all the BARs
and bridge windows should be released during a rescan, not only those with
higher addresses.

One example when it is needed, BAR(I) is moved to free a gap for the new
BAR(II):

Before:

    ==================== parent bridge window ===============
                   ---- hotplug bridge window ----
    |   BAR(I)    |   fixed BAR   |   fixed BAR   | fixed BAR |
        ^^^^^^                 ^
                               |
                           new BAR(II)

After:

    ==================== parent bridge window =========================
     ----------- hotplug bridge window -----------
    | new BAR(II) |   fixed BAR   |   fixed BAR   | fixed BAR | BAR(I)  |
      ^^^^^^^^^^^                                               ^^^^^^

Another example is a fragmented bridge window jammed between fixed BARs:

Before:

     ===================== parent bridge window ========================
                 ---------- hotplug bridge window ----------
    | fixed BAR |   | BAR(I) |    | BAR(II) |    | BAR(III) | fixed BAR |
                      ^^^^^^   ^    ^^^^^^^        ^^^^^^^^
                               |
                           new BAR(IV)

After:

     ==================== parent bridge window =========================
                 ---------- hotplug bridge window ----------
    | fixed BAR | BAR(I) | BAR(II) | BAR(III) | new BAR(IV) | fixed BAR |
                  ^^^^^^   ^^^^^^^   ^^^^^^^^   ^^^^^^^^^^^

This patch is a preparation for future patches with actual implementation,
and for now it just does the following:
 - declares the feature;
 - defines bool pci_can_move_bars and bool pci_dev_bar_fixed(dev, bar);
 - invokes the new .rescan_prepare() and .rescan_done() driver notifiers;
 - disables the feature for the powerpc (support will be added later, in
   another series).

The feature is disabled in this first patch of the series, until the actual
implementation if finalized by the following patches. It can be overridden
per-arch using the pci_can_move_bars=false flag or by the following command
line option:

    pci=no_movable_bars

Current approach doesn't support calculating windows for subtractive decode
bridges, so disable BAR movement if such bridge is present.

Signed-off-by: Sergei Miroshnichenko <s.miroshnichenko@yadro.com>
  • Loading branch information
Sergei Miroshnichenko committed Jan 13, 2021
1 parent 93e4d12 commit 5bc12ba
Show file tree
Hide file tree
Showing 8 changed files with 181 additions and 2 deletions.
63 changes: 63 additions & 0 deletions Documentation/PCI/pci.rst
Expand Up @@ -575,3 +575,66 @@ handle the PCI master abort on all platforms if the PCI device is
expected to not respond to a readl(). Most x86 platforms will allow
MMIO reads to master abort (a.k.a. "Soft Fail") and return garbage
(e.g. ~0). But many RISC platforms will crash (a.k.a."Hard Fail").


Movable BARs
============

To increase the probability of finding a space for BARs of hot-added devices,
the kernel requests the drivers to release used BARs, so they can be moved
to free a gap for new BARs.

This ability can be added to a driver by implementing the
:c:type:`rescan_prepare()`, :c:type:`bar_fixed()` and :c:type:`rescan_done()`
hooks from the :c:type:`struct pci_driver`.

Before a PCI bus rescan the driver must pause its activity and unmap its
BARs, here is an example of how the NVMe driver can perform this::

static struct pci_driver nvme_driver = {
...
.bar_fixed = nvme_bar_fixed,
.rescan_prepare = nvme_rescan_prepare,
.rescan_done = nvme_rescan_done,
};

static bool nvme_bar_fixed(struct pci_dev *pdev, int resno)
{
return false;
}

static void nvme_rescan_prepare(struct pci_dev *pdev)
{
struct nvme_dev *dev = pci_get_drvdata(pdev);

nvme_dev_disable(dev, true);
nvme_dev_unmap(dev);
dev->bar = NULL;
}

The NVMe driver uses a single BAR, which is movable. After a PCI rescan,
the driver must re-read new addresses of BARs, remap them and resume::

static void nvme_rescan_done(struct pci_dev *pdev)
{
struct nvme_dev *dev = pci_get_drvdata(pdev);

nvme_dev_map(dev);
nvme_reset_ctrl(&dev->ctrl);
}

Currently there are no reliable way to determine if a driver uses BARs of
its devices or not (their :c:type:`struct resource` don't always have a child),
so if it doesn't explicitly support movable BARs, they are considered fixed.
To let the PCI subsystem move unused BARs, a driver have to implement one hook::

static bool pcie_portdrv_bar_fixed(struct pci_dev *pdev, int resno)
{
return false;
}

static struct pci_driver pcie_portdriver = {
{
...
.bar_fixed = pcie_portdrv_bar_fixed,
}
1 change: 1 addition & 0 deletions Documentation/admin-guide/kernel-parameters.txt
Expand Up @@ -3798,6 +3798,7 @@
nomio [S390] Do not use MIO instructions.
norid [S390] ignore the RID field and force use of
one PCI domain per PCI function
no_movable_bars Don't allow BARs to be moved during hotplug

pcie_aspm= [PCIE] Forcibly enable or disable PCIe Active State Power
Management.
Expand Down
2 changes: 2 additions & 0 deletions arch/powerpc/platforms/powernv/pci.c
Expand Up @@ -890,6 +890,8 @@ void __init pnv_pci_init(void)
{
struct device_node *np;

pci_can_move_bars = false;

pci_add_flags(PCI_CAN_SKIP_ISA_ALIGN);

/* If we don't have OPAL, eg. in sim, just skip PCI probe */
Expand Down
2 changes: 2 additions & 0 deletions arch/powerpc/platforms/pseries/setup.c
Expand Up @@ -964,6 +964,8 @@ static void __init pseries_init(void)
{
pr_debug(" -> pseries_init()\n");

pci_can_move_bars = false;

#ifdef CONFIG_HVC_CONSOLE
if (firmware_has_feature(FW_FEATURE_LPAR))
hvc_vio_init_early();
Expand Down
4 changes: 4 additions & 0 deletions drivers/pci/pci.c
Expand Up @@ -76,6 +76,8 @@ static void pci_dev_d3_sleep(struct pci_dev *dev)
int pci_domains_supported = 1;
#endif

bool pci_can_move_bars;

#define DEFAULT_CARDBUS_IO_SIZE (256)
#define DEFAULT_CARDBUS_MEM_SIZE (64*1024*1024)
/* pci=cbmemsize=nnM,cbiosize=nn can override this */
Expand Down Expand Up @@ -6602,6 +6604,8 @@ static int __init pci_setup(char *str)
pci_add_flags(PCI_SCAN_ALL_PCIE_DEVS);
} else if (!strncmp(str, "disable_acs_redir=", 18)) {
disable_acs_redir_param = str + 18;
} else if (!strncmp(str, "no_movable_bars", 15)) {
pci_can_move_bars = false;
} else {
pr_err("PCI: Unknown option `%s'\n", str);
}
Expand Down
2 changes: 2 additions & 0 deletions drivers/pci/pci.h
Expand Up @@ -273,6 +273,8 @@ void pci_disable_bridge_window(struct pci_dev *dev);
struct pci_bus *pci_bus_get(struct pci_bus *bus);
void pci_bus_put(struct pci_bus *bus);

bool pci_dev_bar_fixed(struct pci_dev *dev, struct resource *res);

/* PCIe link information from Link Capabilities 2 */
#define PCIE_LNKCAP2_SLS2SPEED(lnkcap2) \
((lnkcap2) & PCI_EXP_LNKCAP2_SLS_64_0GB ? PCIE_SPEED_64_0GT : \
Expand Down
101 changes: 99 additions & 2 deletions drivers/pci/probe.c
Expand Up @@ -2473,6 +2473,11 @@ void pci_device_add(struct pci_dev *dev, struct pci_bus *bus)
/* Fix up broken headers */
pci_fixup_device(pci_fixup_header, dev);

if (dev->transparent && pci_can_move_bars) {
pci_info(dev, "Disable movable BARs in presence of a transparent bridge\n");
pci_can_move_bars = false;
}

pci_reassigndev_resource_alignment(dev);

dev->state_saved = false;
Expand Down Expand Up @@ -3007,6 +3012,7 @@ int pci_host_probe(struct pci_host_bridge *bridge)
* or pci_bus_assign_resources().
*/
if (pci_has_flag(PCI_PROBE_ONLY)) {
pci_can_move_bars = false;
pci_bus_claim_resources(bus);
} else {
pci_bus_size_bridges(bus);
Expand Down Expand Up @@ -3200,6 +3206,83 @@ unsigned int pci_rescan_bus_bridge_resize(struct pci_dev *bridge)
return max;
}

bool pci_dev_bar_fixed(struct pci_dev *dev, struct resource *res)
{
int resno = res - dev->resource;

/* Bridge windows are never fixed */
if (resno >= PCI_BRIDGE_RESOURCES)
return false;

if (res->flags & IORESOURCE_PCI_FIXED)
return true;

if (res->flags & IORESOURCE_UNSET)
return false;

if (!pci_can_move_bars)
return false;

if (dev->driver && dev->driver->bar_fixed)
return dev->driver->bar_fixed(dev, resno);

if (res->start &&
!(res->flags & IORESOURCE_IO) &&
(dev->class >> 8) == PCI_CLASS_DISPLAY_VGA)
return true;

if (!dev->driver && !res->child)
return false;

return true;
}

static void pci_bus_rescan_prepare(struct pci_bus *bus)
{
struct pci_dev *dev;

if (bus->self) {
pci_config_pm_runtime_get(bus->self);
pm_runtime_get_sync(&bus->self->dev);
}

list_for_each_entry(dev, &bus->devices, bus_list) {
struct pci_bus *child = dev->subordinate;

if (child)
pci_bus_rescan_prepare(child);

if (dev->driver &&
dev->driver->rescan_prepare)
dev->driver->rescan_prepare(dev);
}
}

static void pci_bus_rescan_done(struct pci_bus *bus)
{
struct pci_dev *dev;

if (bus->self && !pci_dev_is_added(bus->self))
return;

list_for_each_entry(dev, &bus->devices, bus_list) {
struct pci_bus *child = dev->subordinate;

if (dev->driver &&
dev->driver->rescan_done)
dev->driver->rescan_done(dev);

if (child)
pci_bus_rescan_done(child);
}

if (bus->self) {
pci_save_state(bus->self);
pm_runtime_put(&bus->self->dev);
pci_config_pm_runtime_put(bus->self);
}
}

/**
* pci_rescan_bus - Scan a PCI bus for devices
* @bus: PCI bus to scan
Expand All @@ -3212,9 +3295,23 @@ unsigned int pci_rescan_bus_bridge_resize(struct pci_dev *bridge)
unsigned int pci_rescan_bus(struct pci_bus *bus)
{
unsigned int max;
struct pci_bus *root = bus;

while (!pci_is_root_bus(root))
root = root->parent;

if (pci_can_move_bars) {
pci_bus_rescan_prepare(root);

max = pci_scan_child_bus(root);
pci_assign_unassigned_root_bus_resources(root);

pci_bus_rescan_done(root);
} else {
max = pci_scan_child_bus(bus);
pci_assign_unassigned_bus_resources(bus);
}

max = pci_scan_child_bus(bus);
pci_assign_unassigned_bus_resources(bus);
pci_bus_add_devices(bus);

return max;
Expand Down
8 changes: 8 additions & 0 deletions include/linux/pci.h
Expand Up @@ -857,6 +857,9 @@ struct module;
* e.g. drivers/net/e100.c.
* @sriov_configure: Optional driver callback to allow configuration of
* number of VFs to enable via sysfs "sriov_numvfs" file.
* @bar_fixed: Returns true if the driver doesn't allow to move this BAR.
* @rescan_prepare: Prepare to BAR movement - called before PCI rescan.
* @rescan_done: Remap BARs and restore after PCI rescan.
* @err_handler: See Documentation/PCI/pci-error-recovery.rst
* @groups: Sysfs attribute groups.
* @driver: Driver model structure.
Expand All @@ -872,6 +875,9 @@ struct pci_driver {
int (*resume)(struct pci_dev *dev); /* Device woken up */
void (*shutdown)(struct pci_dev *dev);
int (*sriov_configure)(struct pci_dev *dev, int num_vfs); /* On PF */
bool (*bar_fixed)(struct pci_dev *dev, int resno);
void (*rescan_prepare)(struct pci_dev *dev);
void (*rescan_done)(struct pci_dev *dev);
const struct pci_error_handlers *err_handler;
const struct attribute_group **groups;
struct device_driver driver;
Expand Down Expand Up @@ -1426,6 +1432,8 @@ void pci_setup_bridge(struct pci_bus *bus);
resource_size_t pcibios_window_alignment(struct pci_bus *bus,
unsigned long type);

extern bool pci_can_move_bars;

#define PCI_VGA_STATE_CHANGE_BRIDGE (1 << 0)
#define PCI_VGA_STATE_CHANGE_DECODES (1 << 1)

Expand Down

0 comments on commit 5bc12ba

Please sign in to comment.