root/drivers/pci/bus.c

DEFINITIONS

1. pci_add_resource_offset
2. pci_add_resource
3. pci_free_resource_list
4. pci_bus_add_resource
5. pci_bus_resource_n
6. pci_bus_remove_resources
7. devm_request_pci_bus_resources
8. pci_clip_resource_to_region
9. pci_bus_alloc_from_region
10. pci_bus_alloc_resource
11. pci_bus_clip_resource
12. pcibios_resource_survey_bus
13. pcibios_bus_add_device
14. pci_bus_add_device
15. pci_bus_add_devices
16. pci_walk_bus
17. pci_bus_get
18. pci_bus_put

   1 // SPDX-License-Identifier: GPL-2.0
   2 /*
   3  * From setup-res.c, by:
   4  *      Dave Rusling (david.rusling@reo.mts.dec.com)
   5  *      David Mosberger (davidm@cs.arizona.edu)
   6  *      David Miller (davem@redhat.com)
   7  *      Ivan Kokshaysky (ink@jurassic.park.msu.ru)
   8  */
   9 #include <linux/module.h>
  10 #include <linux/kernel.h>
  11 #include <linux/pci.h>
  12 #include <linux/errno.h>
  13 #include <linux/ioport.h>
  14 #include <linux/proc_fs.h>
  15 #include <linux/slab.h>
  16 
  17 #include "pci.h"
  18 
  19 void pci_add_resource_offset(struct list_head *resources, struct resource *res,
  20                              resource_size_t offset)
  21 {
  22         struct resource_entry *entry;
  23 
  24         entry = resource_list_create_entry(res, 0);
  25         if (!entry) {
  26                 pr_err("PCI: can't add host bridge window %pR\n", res);
  27                 return;
  28         }
  29 
  30         entry->offset = offset;
  31         resource_list_add_tail(entry, resources);
  32 }
  33 EXPORT_SYMBOL(pci_add_resource_offset);
  34 
  35 void pci_add_resource(struct list_head *resources, struct resource *res)
  36 {
  37         pci_add_resource_offset(resources, res, 0);
  38 }
  39 EXPORT_SYMBOL(pci_add_resource);
  40 
  41 void pci_free_resource_list(struct list_head *resources)
  42 {
  43         resource_list_free(resources);
  44 }
  45 EXPORT_SYMBOL(pci_free_resource_list);
  46 
  47 void pci_bus_add_resource(struct pci_bus *bus, struct resource *res,
  48                           unsigned int flags)
  49 {
  50         struct pci_bus_resource *bus_res;
  51 
  52         bus_res = kzalloc(sizeof(struct pci_bus_resource), GFP_KERNEL);
  53         if (!bus_res) {
  54                 dev_err(&bus->dev, "can't add %pR resource\n", res);
  55                 return;
  56         }
  57 
  58         bus_res->res = res;
  59         bus_res->flags = flags;
  60         list_add_tail(&bus_res->list, &bus->resources);
  61 }
  62 
  63 struct resource *pci_bus_resource_n(const struct pci_bus *bus, int n)
  64 {
  65         struct pci_bus_resource *bus_res;
  66 
  67         if (n < PCI_BRIDGE_RESOURCE_NUM)
  68                 return bus->resource[n];
  69 
  70         n -= PCI_BRIDGE_RESOURCE_NUM;
  71         list_for_each_entry(bus_res, &bus->resources, list) {
  72                 if (n-- == 0)
  73                         return bus_res->res;
  74         }
  75         return NULL;
  76 }
  77 EXPORT_SYMBOL_GPL(pci_bus_resource_n);
  78 
  79 void pci_bus_remove_resources(struct pci_bus *bus)
  80 {
  81         int i;
  82         struct pci_bus_resource *bus_res, *tmp;
  83 
  84         for (i = 0; i < PCI_BRIDGE_RESOURCE_NUM; i++)
  85                 bus->resource[i] = NULL;
  86 
  87         list_for_each_entry_safe(bus_res, tmp, &bus->resources, list) {
  88                 list_del(&bus_res->list);
  89                 kfree(bus_res);
  90         }
  91 }
  92 
  93 int devm_request_pci_bus_resources(struct device *dev,
  94                                    struct list_head *resources)
  95 {
  96         struct resource_entry *win;
  97         struct resource *parent, *res;
  98         int err;
  99 
 100         resource_list_for_each_entry(win, resources) {
 101                 res = win->res;
 102                 switch (resource_type(res)) {
 103                 case IORESOURCE_IO:
 104                         parent = &ioport_resource;
 105                         break;
 106                 case IORESOURCE_MEM:
 107                         parent = &iomem_resource;
 108                         break;
 109                 default:
 110                         continue;
 111                 }
 112 
 113                 err = devm_request_resource(dev, parent, res);
 114                 if (err)
 115                         return err;
 116         }
 117 
 118         return 0;
 119 }
 120 EXPORT_SYMBOL_GPL(devm_request_pci_bus_resources);
 121 
 122 static struct pci_bus_region pci_32_bit = {0, 0xffffffffULL};
 123 #ifdef CONFIG_ARCH_DMA_ADDR_T_64BIT
 124 static struct pci_bus_region pci_64_bit = {0,
 125                                 (pci_bus_addr_t) 0xffffffffffffffffULL};
 126 static struct pci_bus_region pci_high = {(pci_bus_addr_t) 0x100000000ULL,
 127                                 (pci_bus_addr_t) 0xffffffffffffffffULL};
 128 #endif
 129 
 130 /*
 131  * @res contains CPU addresses.  Clip it so the corresponding bus addresses
 132  * on @bus are entirely within @region.  This is used to control the bus
 133  * addresses of resources we allocate, e.g., we may need a resource that
 134  * can be mapped by a 32-bit BAR.
 135  */
 136 static void pci_clip_resource_to_region(struct pci_bus *bus,
 137                                         struct resource *res,
 138                                         struct pci_bus_region *region)
 139 {
 140         struct pci_bus_region r;
 141 
 142         pcibios_resource_to_bus(bus, &r, res);
 143         if (r.start < region->start)
 144                 r.start = region->start;
 145         if (r.end > region->end)
 146                 r.end = region->end;
 147 
 148         if (r.end < r.start)
 149                 res->end = res->start - 1;
 150         else
 151                 pcibios_bus_to_resource(bus, res, &r);
 152 }
 153 
 154 static int pci_bus_alloc_from_region(struct pci_bus *bus, struct resource *res,
 155                 resource_size_t size, resource_size_t align,
 156                 resource_size_t min, unsigned long type_mask,
 157                 resource_size_t (*alignf)(void *,
 158                                           const struct resource *,
 159                                           resource_size_t,
 160                                           resource_size_t),
 161                 void *alignf_data,
 162                 struct pci_bus_region *region)
 163 {
 164         int i, ret;
 165         struct resource *r, avail;
 166         resource_size_t max;
 167 
 168         type_mask |= IORESOURCE_TYPE_BITS;
 169 
 170         pci_bus_for_each_resource(bus, r, i) {
 171                 resource_size_t min_used = min;
 172 
 173                 if (!r)
 174                         continue;
 175 
 176                 /* type_mask must match */
 177                 if ((res->flags ^ r->flags) & type_mask)
 178                         continue;
 179 
 180                 /* We cannot allocate a non-prefetching resource
 181                    from a pre-fetching area */
 182                 if ((r->flags & IORESOURCE_PREFETCH) &&
 183                     !(res->flags & IORESOURCE_PREFETCH))
 184                         continue;
 185 
 186                 avail = *r;
 187                 pci_clip_resource_to_region(bus, &avail, region);
 188 
 189                 /*
 190                  * "min" is typically PCIBIOS_MIN_IO or PCIBIOS_MIN_MEM to
 191                  * protect badly documented motherboard resources, but if
 192                  * this is an already-configured bridge window, its start
 193                  * overrides "min".
 194                  */
 195                 if (avail.start)
 196                         min_used = avail.start;
 197 
 198                 max = avail.end;
 199 
 200                 /* Ok, try it out.. */
 201                 ret = allocate_resource(r, res, size, min_used, max,
 202                                         align, alignf, alignf_data);
 203                 if (ret == 0)
 204                         return 0;
 205         }
 206         return -ENOMEM;
 207 }
 208 
 209 /**
 210  * pci_bus_alloc_resource - allocate a resource from a parent bus
 211  * @bus: PCI bus
 212  * @res: resource to allocate
 213  * @size: size of resource to allocate
 214  * @align: alignment of resource to allocate
 215  * @min: minimum /proc/iomem address to allocate
 216  * @type_mask: IORESOURCE_* type flags
 217  * @alignf: resource alignment function
 218  * @alignf_data: data argument for resource alignment function
 219  *
 220  * Given the PCI bus a device resides on, the size, minimum address,
 221  * alignment and type, try to find an acceptable resource allocation
 222  * for a specific device resource.
 223  */
 224 int pci_bus_alloc_resource(struct pci_bus *bus, struct resource *res,
 225                 resource_size_t size, resource_size_t align,
 226                 resource_size_t min, unsigned long type_mask,
 227                 resource_size_t (*alignf)(void *,
 228                                           const struct resource *,
 229                                           resource_size_t,
 230                                           resource_size_t),
 231                 void *alignf_data)
 232 {
 233 #ifdef CONFIG_ARCH_DMA_ADDR_T_64BIT
 234         int rc;
 235 
 236         if (res->flags & IORESOURCE_MEM_64) {
 237                 rc = pci_bus_alloc_from_region(bus, res, size, align, min,
 238                                                type_mask, alignf, alignf_data,
 239                                                &pci_high);
 240                 if (rc == 0)
 241                         return 0;
 242 
 243                 return pci_bus_alloc_from_region(bus, res, size, align, min,
 244                                                  type_mask, alignf, alignf_data,
 245                                                  &pci_64_bit);
 246         }
 247 #endif
 248 
 249         return pci_bus_alloc_from_region(bus, res, size, align, min,
 250                                          type_mask, alignf, alignf_data,
 251                                          &pci_32_bit);
 252 }
 253 EXPORT_SYMBOL(pci_bus_alloc_resource);
 254 
 255 /*
 256  * The @idx resource of @dev should be a PCI-PCI bridge window.  If this
 257  * resource fits inside a window of an upstream bridge, do nothing.  If it
 258  * overlaps an upstream window but extends outside it, clip the resource so
 259  * it fits completely inside.
 260  */
 261 bool pci_bus_clip_resource(struct pci_dev *dev, int idx)
 262 {
 263         struct pci_bus *bus = dev->bus;
 264         struct resource *res = &dev->resource[idx];
 265         struct resource orig_res = *res;
 266         struct resource *r;
 267         int i;
 268 
 269         pci_bus_for_each_resource(bus, r, i) {
 270                 resource_size_t start, end;
 271 
 272                 if (!r)
 273                         continue;
 274 
 275                 if (resource_type(res) != resource_type(r))
 276                         continue;
 277 
 278                 start = max(r->start, res->start);
 279                 end = min(r->end, res->end);
 280 
 281                 if (start > end)
 282                         continue;       /* no overlap */
 283 
 284                 if (res->start == start && res->end == end)
 285                         return false;   /* no change */
 286 
 287                 res->start = start;
 288                 res->end = end;
 289                 res->flags &= ~IORESOURCE_UNSET;
 290                 orig_res.flags &= ~IORESOURCE_UNSET;
 291                 pci_info(dev, "%pR clipped to %pR\n", &orig_res, res);
 292 
 293                 return true;
 294         }
 295 
 296         return false;
 297 }
 298 
 299 void __weak pcibios_resource_survey_bus(struct pci_bus *bus) { }
 300 
 301 void __weak pcibios_bus_add_device(struct pci_dev *pdev) { }
 302 
 303 /**
 304  * pci_bus_add_device - start driver for a single device
 305  * @dev: device to add
 306  *
 307  * This adds add sysfs entries and start device drivers
 308  */
 309 void pci_bus_add_device(struct pci_dev *dev)
 310 {
 311         int retval;
 312 
 313         /*
 314          * Can not put in pci_device_add yet because resources
 315          * are not assigned yet for some devices.
 316          */
 317         pcibios_bus_add_device(dev);
 318         pci_fixup_device(pci_fixup_final, dev);
 319         pci_create_sysfs_dev_files(dev);
 320         pci_proc_attach_device(dev);
 321         pci_bridge_d3_update(dev);
 322 
 323         dev->match_driver = true;
 324         retval = device_attach(&dev->dev);
 325         if (retval < 0 && retval != -EPROBE_DEFER) {
 326                 pci_warn(dev, "device attach failed (%d)\n", retval);
 327                 pci_proc_detach_device(dev);
 328                 pci_remove_sysfs_dev_files(dev);
 329                 return;
 330         }
 331 
 332         pci_dev_assign_added(dev, true);
 333 }
 334 EXPORT_SYMBOL_GPL(pci_bus_add_device);
 335 
 336 /**
 337  * pci_bus_add_devices - start driver for PCI devices
 338  * @bus: bus to check for new devices
 339  *
 340  * Start driver for PCI devices and add some sysfs entries.
 341  */
 342 void pci_bus_add_devices(const struct pci_bus *bus)
 343 {
 344         struct pci_dev *dev;
 345         struct pci_bus *child;
 346 
 347         list_for_each_entry(dev, &bus->devices, bus_list) {
 348                 /* Skip already-added devices */
 349                 if (pci_dev_is_added(dev))
 350                         continue;
 351                 pci_bus_add_device(dev);
 352         }
 353 
 354         list_for_each_entry(dev, &bus->devices, bus_list) {
 355                 /* Skip if device attach failed */
 356                 if (!pci_dev_is_added(dev))
 357                         continue;
 358                 child = dev->subordinate;
 359                 if (child)
 360                         pci_bus_add_devices(child);
 361         }
 362 }
 363 EXPORT_SYMBOL(pci_bus_add_devices);
 364 
 365 /** pci_walk_bus - walk devices on/under bus, calling callback.
 366  *  @top      bus whose devices should be walked
 367  *  @cb       callback to be called for each device found
 368  *  @userdata arbitrary pointer to be passed to callback.
 369  *
 370  *  Walk the given bus, including any bridged devices
 371  *  on buses under this bus.  Call the provided callback
 372  *  on each device found.
 373  *
 374  *  We check the return of @cb each time. If it returns anything
 375  *  other than 0, we break out.
 376  *
 377  */
 378 void pci_walk_bus(struct pci_bus *top, int (*cb)(struct pci_dev *, void *),
 379                   void *userdata)
 380 {
 381         struct pci_dev *dev;
 382         struct pci_bus *bus;
 383         struct list_head *next;
 384         int retval;
 385 
 386         bus = top;
 387         down_read(&pci_bus_sem);
 388         next = top->devices.next;
 389         for (;;) {
 390                 if (next == &bus->devices) {
 391                         /* end of this bus, go up or finish */
 392                         if (bus == top)
 393                                 break;
 394                         next = bus->self->bus_list.next;
 395                         bus = bus->self->bus;
 396                         continue;
 397                 }
 398                 dev = list_entry(next, struct pci_dev, bus_list);
 399                 if (dev->subordinate) {
 400                         /* this is a pci-pci bridge, do its devices next */
 401                         next = dev->subordinate->devices.next;
 402                         bus = dev->subordinate;
 403                 } else
 404                         next = dev->bus_list.next;
 405 
 406                 retval = cb(dev, userdata);
 407                 if (retval)
 408                         break;
 409         }
 410         up_read(&pci_bus_sem);
 411 }
 412 EXPORT_SYMBOL_GPL(pci_walk_bus);
 413 
 414 struct pci_bus *pci_bus_get(struct pci_bus *bus)
 415 {
 416         if (bus)
 417                 get_device(&bus->dev);
 418         return bus;
 419 }
 420 
 421 void pci_bus_put(struct pci_bus *bus)
 422 {
 423         if (bus)
 424                 put_device(&bus->dev);
 425 }