1 // SPDX-License-Identifier: GPL-2.0
3 * (C) Copyright 2002-2004 Greg Kroah-Hartman <greg@kroah.com>
4 * (C) Copyright 2002-2004 IBM Corp.
5 * (C) Copyright 2003 Matthew Wilcox
6 * (C) Copyright 2003 Hewlett-Packard
7 * (C) Copyright 2004 Jon Smirl <jonsmirl@yahoo.com>
8 * (C) Copyright 2004 Silicon Graphics, Inc. Jesse Barnes <jbarnes@sgi.com>
10 * File attributes for PCI devices
12 * Modeled after usb's driverfs.c
16 #include <linux/kernel.h>
17 #include <linux/sched.h>
18 #include <linux/pci.h>
19 #include <linux/stat.h>
20 #include <linux/export.h>
21 #include <linux/topology.h>
24 #include <linux/capability.h>
25 #include <linux/security.h>
26 #include <linux/slab.h>
27 #include <linux/vgaarb.h>
28 #include <linux/pm_runtime.h>
32 static int sysfs_initialized; /* = 0 */
34 /* show configuration fields */
35 #define pci_config_attr(field, format_string) \
37 field##_show(struct device *dev, struct device_attribute *attr, char *buf) \
39 struct pci_dev *pdev; \
41 pdev = to_pci_dev(dev); \
42 return sprintf(buf, format_string, pdev->field); \
44 static DEVICE_ATTR_RO(field)
46 pci_config_attr(vendor, "0x%04x\n");
47 pci_config_attr(device, "0x%04x\n");
48 pci_config_attr(subsystem_vendor, "0x%04x\n");
49 pci_config_attr(subsystem_device, "0x%04x\n");
50 pci_config_attr(revision, "0x%02x\n");
51 pci_config_attr(class, "0x%06x\n");
52 pci_config_attr(irq, "%u\n");
54 static ssize_t broken_parity_status_show(struct device *dev,
55 struct device_attribute *attr,
58 struct pci_dev *pdev = to_pci_dev(dev);
59 return sprintf(buf, "%u\n", pdev->broken_parity_status);
62 static ssize_t broken_parity_status_store(struct device *dev,
63 struct device_attribute *attr,
64 const char *buf, size_t count)
66 struct pci_dev *pdev = to_pci_dev(dev);
69 if (kstrtoul(buf, 0, &val) < 0)
72 pdev->broken_parity_status = !!val;
76 static DEVICE_ATTR_RW(broken_parity_status);
78 static ssize_t pci_dev_show_local_cpu(struct device *dev, bool list,
79 struct device_attribute *attr, char *buf)
81 const struct cpumask *mask;
84 mask = (dev_to_node(dev) == -1) ? cpu_online_mask :
85 cpumask_of_node(dev_to_node(dev));
87 mask = cpumask_of_pcibus(to_pci_dev(dev)->bus);
89 return cpumap_print_to_pagebuf(list, buf, mask);
92 static ssize_t local_cpus_show(struct device *dev,
93 struct device_attribute *attr, char *buf)
95 return pci_dev_show_local_cpu(dev, false, attr, buf);
97 static DEVICE_ATTR_RO(local_cpus);
99 static ssize_t local_cpulist_show(struct device *dev,
100 struct device_attribute *attr, char *buf)
102 return pci_dev_show_local_cpu(dev, true, attr, buf);
104 static DEVICE_ATTR_RO(local_cpulist);
107 * PCI Bus Class Devices
109 static ssize_t cpuaffinity_show(struct device *dev,
110 struct device_attribute *attr, char *buf)
112 const struct cpumask *cpumask = cpumask_of_pcibus(to_pci_bus(dev));
114 return cpumap_print_to_pagebuf(false, buf, cpumask);
116 static DEVICE_ATTR_RO(cpuaffinity);
118 static ssize_t cpulistaffinity_show(struct device *dev,
119 struct device_attribute *attr, char *buf)
121 const struct cpumask *cpumask = cpumask_of_pcibus(to_pci_bus(dev));
123 return cpumap_print_to_pagebuf(true, buf, cpumask);
125 static DEVICE_ATTR_RO(cpulistaffinity);
128 static ssize_t resource_show(struct device *dev, struct device_attribute *attr,
131 struct pci_dev *pci_dev = to_pci_dev(dev);
135 resource_size_t start, end;
137 if (pci_dev->subordinate)
138 max = DEVICE_COUNT_RESOURCE;
140 max = PCI_BRIDGE_RESOURCES;
142 for (i = 0; i < max; i++) {
143 struct resource *res = &pci_dev->resource[i];
144 pci_resource_to_user(pci_dev, i, res, &start, &end);
145 str += sprintf(str, "0x%016llx 0x%016llx 0x%016llx\n",
146 (unsigned long long)start,
147 (unsigned long long)end,
148 (unsigned long long)res->flags);
152 static DEVICE_ATTR_RO(resource);
154 static ssize_t max_link_speed_show(struct device *dev,
155 struct device_attribute *attr, char *buf)
157 struct pci_dev *pdev = to_pci_dev(dev);
159 return sprintf(buf, "%s\n", PCIE_SPEED2STR(pcie_get_speed_cap(pdev)));
161 static DEVICE_ATTR_RO(max_link_speed);
163 static ssize_t max_link_width_show(struct device *dev,
164 struct device_attribute *attr, char *buf)
166 struct pci_dev *pdev = to_pci_dev(dev);
168 return sprintf(buf, "%u\n", pcie_get_width_cap(pdev));
170 static DEVICE_ATTR_RO(max_link_width);
172 static ssize_t current_link_speed_show(struct device *dev,
173 struct device_attribute *attr, char *buf)
175 struct pci_dev *pci_dev = to_pci_dev(dev);
180 err = pcie_capability_read_word(pci_dev, PCI_EXP_LNKSTA, &linkstat);
184 switch (linkstat & PCI_EXP_LNKSTA_CLS) {
185 case PCI_EXP_LNKSTA_CLS_32_0GB:
188 case PCI_EXP_LNKSTA_CLS_16_0GB:
191 case PCI_EXP_LNKSTA_CLS_8_0GB:
194 case PCI_EXP_LNKSTA_CLS_5_0GB:
197 case PCI_EXP_LNKSTA_CLS_2_5GB:
201 speed = "Unknown speed";
204 return sprintf(buf, "%s\n", speed);
206 static DEVICE_ATTR_RO(current_link_speed);
208 static ssize_t current_link_width_show(struct device *dev,
209 struct device_attribute *attr, char *buf)
211 struct pci_dev *pci_dev = to_pci_dev(dev);
215 err = pcie_capability_read_word(pci_dev, PCI_EXP_LNKSTA, &linkstat);
219 return sprintf(buf, "%u\n",
220 (linkstat & PCI_EXP_LNKSTA_NLW) >> PCI_EXP_LNKSTA_NLW_SHIFT);
222 static DEVICE_ATTR_RO(current_link_width);
224 static ssize_t secondary_bus_number_show(struct device *dev,
225 struct device_attribute *attr,
228 struct pci_dev *pci_dev = to_pci_dev(dev);
232 err = pci_read_config_byte(pci_dev, PCI_SECONDARY_BUS, &sec_bus);
236 return sprintf(buf, "%u\n", sec_bus);
238 static DEVICE_ATTR_RO(secondary_bus_number);
240 static ssize_t subordinate_bus_number_show(struct device *dev,
241 struct device_attribute *attr,
244 struct pci_dev *pci_dev = to_pci_dev(dev);
248 err = pci_read_config_byte(pci_dev, PCI_SUBORDINATE_BUS, &sub_bus);
252 return sprintf(buf, "%u\n", sub_bus);
254 static DEVICE_ATTR_RO(subordinate_bus_number);
256 static ssize_t ari_enabled_show(struct device *dev,
257 struct device_attribute *attr,
260 struct pci_dev *pci_dev = to_pci_dev(dev);
262 return sprintf(buf, "%u\n", pci_ari_enabled(pci_dev->bus));
264 static DEVICE_ATTR_RO(ari_enabled);
266 static ssize_t modalias_show(struct device *dev, struct device_attribute *attr,
269 struct pci_dev *pci_dev = to_pci_dev(dev);
271 return sprintf(buf, "pci:v%08Xd%08Xsv%08Xsd%08Xbc%02Xsc%02Xi%02X\n",
272 pci_dev->vendor, pci_dev->device,
273 pci_dev->subsystem_vendor, pci_dev->subsystem_device,
274 (u8)(pci_dev->class >> 16), (u8)(pci_dev->class >> 8),
275 (u8)(pci_dev->class));
277 static DEVICE_ATTR_RO(modalias);
279 static ssize_t enable_store(struct device *dev, struct device_attribute *attr,
280 const char *buf, size_t count)
282 struct pci_dev *pdev = to_pci_dev(dev);
284 ssize_t result = kstrtoul(buf, 0, &val);
289 /* this can crash the machine when done on the "wrong" device */
290 if (!capable(CAP_SYS_ADMIN))
297 result = pci_enable_device(pdev);
298 else if (pci_is_enabled(pdev))
299 pci_disable_device(pdev);
304 return result < 0 ? result : count;
307 static ssize_t enable_show(struct device *dev, struct device_attribute *attr,
310 struct pci_dev *pdev;
312 pdev = to_pci_dev(dev);
313 return sprintf(buf, "%u\n", atomic_read(&pdev->enable_cnt));
315 static DEVICE_ATTR_RW(enable);
318 static ssize_t numa_node_store(struct device *dev,
319 struct device_attribute *attr, const char *buf,
322 struct pci_dev *pdev = to_pci_dev(dev);
325 if (!capable(CAP_SYS_ADMIN))
328 ret = kstrtoint(buf, 0, &node);
332 if ((node < 0 && node != NUMA_NO_NODE) || node >= MAX_NUMNODES)
335 if (node != NUMA_NO_NODE && !node_online(node))
338 add_taint(TAINT_FIRMWARE_WORKAROUND, LOCKDEP_STILL_OK);
339 pci_alert(pdev, FW_BUG "Overriding NUMA node to %d. Contact your vendor for updates.",
342 dev->numa_node = node;
346 static ssize_t numa_node_show(struct device *dev, struct device_attribute *attr,
349 return sprintf(buf, "%d\n", dev->numa_node);
351 static DEVICE_ATTR_RW(numa_node);
354 static ssize_t dma_mask_bits_show(struct device *dev,
355 struct device_attribute *attr, char *buf)
357 struct pci_dev *pdev = to_pci_dev(dev);
359 return sprintf(buf, "%d\n", fls64(pdev->dma_mask));
361 static DEVICE_ATTR_RO(dma_mask_bits);
363 static ssize_t consistent_dma_mask_bits_show(struct device *dev,
364 struct device_attribute *attr,
367 return sprintf(buf, "%d\n", fls64(dev->coherent_dma_mask));
369 static DEVICE_ATTR_RO(consistent_dma_mask_bits);
371 static ssize_t msi_bus_show(struct device *dev, struct device_attribute *attr,
374 struct pci_dev *pdev = to_pci_dev(dev);
375 struct pci_bus *subordinate = pdev->subordinate;
377 return sprintf(buf, "%u\n", subordinate ?
378 !(subordinate->bus_flags & PCI_BUS_FLAGS_NO_MSI)
382 static ssize_t msi_bus_store(struct device *dev, struct device_attribute *attr,
383 const char *buf, size_t count)
385 struct pci_dev *pdev = to_pci_dev(dev);
386 struct pci_bus *subordinate = pdev->subordinate;
389 if (kstrtoul(buf, 0, &val) < 0)
392 if (!capable(CAP_SYS_ADMIN))
396 * "no_msi" and "bus_flags" only affect what happens when a driver
397 * requests MSI or MSI-X. They don't affect any drivers that have
398 * already requested MSI or MSI-X.
402 pci_info(pdev, "MSI/MSI-X %s for future drivers\n",
403 val ? "allowed" : "disallowed");
408 subordinate->bus_flags &= ~PCI_BUS_FLAGS_NO_MSI;
410 subordinate->bus_flags |= PCI_BUS_FLAGS_NO_MSI;
412 dev_info(&subordinate->dev, "MSI/MSI-X %s for future drivers of devices on this bus\n",
413 val ? "allowed" : "disallowed");
416 static DEVICE_ATTR_RW(msi_bus);
418 static ssize_t rescan_store(struct bus_type *bus, const char *buf, size_t count)
421 struct pci_bus *b = NULL;
423 if (kstrtoul(buf, 0, &val) < 0)
427 pci_lock_rescan_remove();
428 while ((b = pci_find_next_bus(b)) != NULL)
430 pci_unlock_rescan_remove();
434 static BUS_ATTR_WO(rescan);
436 static struct attribute *pci_bus_attrs[] = {
437 &bus_attr_rescan.attr,
441 static const struct attribute_group pci_bus_group = {
442 .attrs = pci_bus_attrs,
445 const struct attribute_group *pci_bus_groups[] = {
450 static ssize_t dev_rescan_store(struct device *dev,
451 struct device_attribute *attr, const char *buf,
455 struct pci_dev *pdev = to_pci_dev(dev);
457 if (kstrtoul(buf, 0, &val) < 0)
461 pci_lock_rescan_remove();
462 pci_rescan_bus(pdev->bus);
463 pci_unlock_rescan_remove();
467 static struct device_attribute dev_attr_dev_rescan = __ATTR(rescan, 0200, NULL,
470 static ssize_t remove_store(struct device *dev, struct device_attribute *attr,
471 const char *buf, size_t count)
475 if (kstrtoul(buf, 0, &val) < 0)
478 if (val && device_remove_file_self(dev, attr))
479 pci_stop_and_remove_bus_device_locked(to_pci_dev(dev));
482 static DEVICE_ATTR_IGNORE_LOCKDEP(remove, 0220, NULL,
485 static ssize_t bus_rescan_store(struct device *dev,
486 struct device_attribute *attr,
487 const char *buf, size_t count)
490 struct pci_bus *bus = to_pci_bus(dev);
492 if (kstrtoul(buf, 0, &val) < 0)
496 pci_lock_rescan_remove();
497 if (!pci_is_root_bus(bus) && list_empty(&bus->devices))
498 pci_rescan_bus_bridge_resize(bus->self);
501 pci_unlock_rescan_remove();
505 static struct device_attribute dev_attr_bus_rescan = __ATTR(rescan, 0200, NULL,
508 #if defined(CONFIG_PM) && defined(CONFIG_ACPI)
509 static ssize_t d3cold_allowed_store(struct device *dev,
510 struct device_attribute *attr,
511 const char *buf, size_t count)
513 struct pci_dev *pdev = to_pci_dev(dev);
516 if (kstrtoul(buf, 0, &val) < 0)
519 pdev->d3cold_allowed = !!val;
520 if (pdev->d3cold_allowed)
521 pci_d3cold_enable(pdev);
523 pci_d3cold_disable(pdev);
525 pm_runtime_resume(dev);
530 static ssize_t d3cold_allowed_show(struct device *dev,
531 struct device_attribute *attr, char *buf)
533 struct pci_dev *pdev = to_pci_dev(dev);
534 return sprintf(buf, "%u\n", pdev->d3cold_allowed);
536 static DEVICE_ATTR_RW(d3cold_allowed);
540 static ssize_t devspec_show(struct device *dev,
541 struct device_attribute *attr, char *buf)
543 struct pci_dev *pdev = to_pci_dev(dev);
544 struct device_node *np = pci_device_to_OF_node(pdev);
548 return sprintf(buf, "%pOF", np);
550 static DEVICE_ATTR_RO(devspec);
553 static ssize_t driver_override_store(struct device *dev,
554 struct device_attribute *attr,
555 const char *buf, size_t count)
557 struct pci_dev *pdev = to_pci_dev(dev);
558 char *driver_override, *old, *cp;
560 /* We need to keep extra room for a newline */
561 if (count >= (PAGE_SIZE - 1))
564 driver_override = kstrndup(buf, count, GFP_KERNEL);
565 if (!driver_override)
568 cp = strchr(driver_override, '\n');
573 old = pdev->driver_override;
574 if (strlen(driver_override)) {
575 pdev->driver_override = driver_override;
577 kfree(driver_override);
578 pdev->driver_override = NULL;
587 static ssize_t driver_override_show(struct device *dev,
588 struct device_attribute *attr, char *buf)
590 struct pci_dev *pdev = to_pci_dev(dev);
594 len = snprintf(buf, PAGE_SIZE, "%s\n", pdev->driver_override);
598 static DEVICE_ATTR_RW(driver_override);
600 static struct attribute *pci_dev_attrs[] = {
601 &dev_attr_resource.attr,
602 &dev_attr_vendor.attr,
603 &dev_attr_device.attr,
604 &dev_attr_subsystem_vendor.attr,
605 &dev_attr_subsystem_device.attr,
606 &dev_attr_revision.attr,
607 &dev_attr_class.attr,
609 &dev_attr_local_cpus.attr,
610 &dev_attr_local_cpulist.attr,
611 &dev_attr_modalias.attr,
613 &dev_attr_numa_node.attr,
615 &dev_attr_dma_mask_bits.attr,
616 &dev_attr_consistent_dma_mask_bits.attr,
617 &dev_attr_enable.attr,
618 &dev_attr_broken_parity_status.attr,
619 &dev_attr_msi_bus.attr,
620 #if defined(CONFIG_PM) && defined(CONFIG_ACPI)
621 &dev_attr_d3cold_allowed.attr,
624 &dev_attr_devspec.attr,
626 &dev_attr_driver_override.attr,
627 &dev_attr_ari_enabled.attr,
631 static struct attribute *pci_bridge_attrs[] = {
632 &dev_attr_subordinate_bus_number.attr,
633 &dev_attr_secondary_bus_number.attr,
637 static struct attribute *pcie_dev_attrs[] = {
638 &dev_attr_current_link_speed.attr,
639 &dev_attr_current_link_width.attr,
640 &dev_attr_max_link_width.attr,
641 &dev_attr_max_link_speed.attr,
645 static struct attribute *pcibus_attrs[] = {
646 &dev_attr_bus_rescan.attr,
647 &dev_attr_cpuaffinity.attr,
648 &dev_attr_cpulistaffinity.attr,
652 static const struct attribute_group pcibus_group = {
653 .attrs = pcibus_attrs,
656 const struct attribute_group *pcibus_groups[] = {
661 static ssize_t boot_vga_show(struct device *dev, struct device_attribute *attr,
664 struct pci_dev *pdev = to_pci_dev(dev);
665 struct pci_dev *vga_dev = vga_default_device();
668 return sprintf(buf, "%u\n", (pdev == vga_dev));
670 return sprintf(buf, "%u\n",
671 !!(pdev->resource[PCI_ROM_RESOURCE].flags &
672 IORESOURCE_ROM_SHADOW));
674 static DEVICE_ATTR_RO(boot_vga);
676 static ssize_t pci_read_config(struct file *filp, struct kobject *kobj,
677 struct bin_attribute *bin_attr, char *buf,
678 loff_t off, size_t count)
680 struct pci_dev *dev = to_pci_dev(kobj_to_dev(kobj));
681 unsigned int size = 64;
682 loff_t init_off = off;
683 u8 *data = (u8 *) buf;
685 /* Several chips lock up trying to read undefined config space */
686 if (file_ns_capable(filp, &init_user_ns, CAP_SYS_ADMIN))
687 size = dev->cfg_size;
688 else if (dev->hdr_type == PCI_HEADER_TYPE_CARDBUS)
693 if (off + count > size) {
700 pci_config_pm_runtime_get(dev);
702 if ((off & 1) && size) {
704 pci_user_read_config_byte(dev, off, &val);
705 data[off - init_off] = val;
710 if ((off & 3) && size > 2) {
712 pci_user_read_config_word(dev, off, &val);
713 data[off - init_off] = val & 0xff;
714 data[off - init_off + 1] = (val >> 8) & 0xff;
721 pci_user_read_config_dword(dev, off, &val);
722 data[off - init_off] = val & 0xff;
723 data[off - init_off + 1] = (val >> 8) & 0xff;
724 data[off - init_off + 2] = (val >> 16) & 0xff;
725 data[off - init_off + 3] = (val >> 24) & 0xff;
732 pci_user_read_config_word(dev, off, &val);
733 data[off - init_off] = val & 0xff;
734 data[off - init_off + 1] = (val >> 8) & 0xff;
741 pci_user_read_config_byte(dev, off, &val);
742 data[off - init_off] = val;
747 pci_config_pm_runtime_put(dev);
752 static ssize_t pci_write_config(struct file *filp, struct kobject *kobj,
753 struct bin_attribute *bin_attr, char *buf,
754 loff_t off, size_t count)
756 struct pci_dev *dev = to_pci_dev(kobj_to_dev(kobj));
757 unsigned int size = count;
758 loff_t init_off = off;
759 u8 *data = (u8 *) buf;
762 ret = security_locked_down(LOCKDOWN_PCI_ACCESS);
766 if (off > dev->cfg_size)
768 if (off + count > dev->cfg_size) {
769 size = dev->cfg_size - off;
773 pci_config_pm_runtime_get(dev);
775 if ((off & 1) && size) {
776 pci_user_write_config_byte(dev, off, data[off - init_off]);
781 if ((off & 3) && size > 2) {
782 u16 val = data[off - init_off];
783 val |= (u16) data[off - init_off + 1] << 8;
784 pci_user_write_config_word(dev, off, val);
790 u32 val = data[off - init_off];
791 val |= (u32) data[off - init_off + 1] << 8;
792 val |= (u32) data[off - init_off + 2] << 16;
793 val |= (u32) data[off - init_off + 3] << 24;
794 pci_user_write_config_dword(dev, off, val);
800 u16 val = data[off - init_off];
801 val |= (u16) data[off - init_off + 1] << 8;
802 pci_user_write_config_word(dev, off, val);
808 pci_user_write_config_byte(dev, off, data[off - init_off]);
813 pci_config_pm_runtime_put(dev);
818 #ifdef HAVE_PCI_LEGACY
820 * pci_read_legacy_io - read byte(s) from legacy I/O port space
821 * @filp: open sysfs file
822 * @kobj: kobject corresponding to file to read from
823 * @bin_attr: struct bin_attribute for this file
824 * @buf: buffer to store results
825 * @off: offset into legacy I/O port space
826 * @count: number of bytes to read
828 * Reads 1, 2, or 4 bytes from legacy I/O port space using an arch specific
829 * callback routine (pci_legacy_read).
831 static ssize_t pci_read_legacy_io(struct file *filp, struct kobject *kobj,
832 struct bin_attribute *bin_attr, char *buf,
833 loff_t off, size_t count)
835 struct pci_bus *bus = to_pci_bus(kobj_to_dev(kobj));
837 /* Only support 1, 2 or 4 byte accesses */
838 if (count != 1 && count != 2 && count != 4)
841 return pci_legacy_read(bus, off, (u32 *)buf, count);
845 * pci_write_legacy_io - write byte(s) to legacy I/O port space
846 * @filp: open sysfs file
847 * @kobj: kobject corresponding to file to read from
848 * @bin_attr: struct bin_attribute for this file
849 * @buf: buffer containing value to be written
850 * @off: offset into legacy I/O port space
851 * @count: number of bytes to write
853 * Writes 1, 2, or 4 bytes from legacy I/O port space using an arch specific
854 * callback routine (pci_legacy_write).
856 static ssize_t pci_write_legacy_io(struct file *filp, struct kobject *kobj,
857 struct bin_attribute *bin_attr, char *buf,
858 loff_t off, size_t count)
860 struct pci_bus *bus = to_pci_bus(kobj_to_dev(kobj));
862 /* Only support 1, 2 or 4 byte accesses */
863 if (count != 1 && count != 2 && count != 4)
866 return pci_legacy_write(bus, off, *(u32 *)buf, count);
870 * pci_mmap_legacy_mem - map legacy PCI memory into user memory space
871 * @filp: open sysfs file
872 * @kobj: kobject corresponding to device to be mapped
873 * @attr: struct bin_attribute for this file
874 * @vma: struct vm_area_struct passed to mmap
876 * Uses an arch specific callback, pci_mmap_legacy_mem_page_range, to mmap
877 * legacy memory space (first meg of bus space) into application virtual
880 static int pci_mmap_legacy_mem(struct file *filp, struct kobject *kobj,
881 struct bin_attribute *attr,
882 struct vm_area_struct *vma)
884 struct pci_bus *bus = to_pci_bus(kobj_to_dev(kobj));
886 return pci_mmap_legacy_page_range(bus, vma, pci_mmap_mem);
890 * pci_mmap_legacy_io - map legacy PCI IO into user memory space
891 * @filp: open sysfs file
892 * @kobj: kobject corresponding to device to be mapped
893 * @attr: struct bin_attribute for this file
894 * @vma: struct vm_area_struct passed to mmap
896 * Uses an arch specific callback, pci_mmap_legacy_io_page_range, to mmap
897 * legacy IO space (first meg of bus space) into application virtual
898 * memory space. Returns -ENOSYS if the operation isn't supported
900 static int pci_mmap_legacy_io(struct file *filp, struct kobject *kobj,
901 struct bin_attribute *attr,
902 struct vm_area_struct *vma)
904 struct pci_bus *bus = to_pci_bus(kobj_to_dev(kobj));
906 return pci_mmap_legacy_page_range(bus, vma, pci_mmap_io);
910 * pci_adjust_legacy_attr - adjustment of legacy file attributes
911 * @b: bus to create files under
912 * @mmap_type: I/O port or memory
914 * Stub implementation. Can be overridden by arch if necessary.
916 void __weak pci_adjust_legacy_attr(struct pci_bus *b,
917 enum pci_mmap_state mmap_type)
922 * pci_create_legacy_files - create legacy I/O port and memory files
923 * @b: bus to create files under
925 * Some platforms allow access to legacy I/O port and ISA memory space on
926 * a per-bus basis. This routine creates the files and ties them into
927 * their associated read, write and mmap files from pci-sysfs.c
929 * On error unwind, but don't propagate the error to the caller
930 * as it is ok to set up the PCI bus without these files.
932 void pci_create_legacy_files(struct pci_bus *b)
936 b->legacy_io = kcalloc(2, sizeof(struct bin_attribute),
941 sysfs_bin_attr_init(b->legacy_io);
942 b->legacy_io->attr.name = "legacy_io";
943 b->legacy_io->size = 0xffff;
944 b->legacy_io->attr.mode = 0600;
945 b->legacy_io->read = pci_read_legacy_io;
946 b->legacy_io->write = pci_write_legacy_io;
947 b->legacy_io->mmap = pci_mmap_legacy_io;
948 pci_adjust_legacy_attr(b, pci_mmap_io);
949 error = device_create_bin_file(&b->dev, b->legacy_io);
953 /* Allocated above after the legacy_io struct */
954 b->legacy_mem = b->legacy_io + 1;
955 sysfs_bin_attr_init(b->legacy_mem);
956 b->legacy_mem->attr.name = "legacy_mem";
957 b->legacy_mem->size = 1024*1024;
958 b->legacy_mem->attr.mode = 0600;
959 b->legacy_mem->mmap = pci_mmap_legacy_mem;
960 pci_adjust_legacy_attr(b, pci_mmap_mem);
961 error = device_create_bin_file(&b->dev, b->legacy_mem);
968 device_remove_bin_file(&b->dev, b->legacy_io);
973 dev_warn(&b->dev, "could not create legacy I/O port and ISA memory resources in sysfs\n");
976 void pci_remove_legacy_files(struct pci_bus *b)
979 device_remove_bin_file(&b->dev, b->legacy_io);
980 device_remove_bin_file(&b->dev, b->legacy_mem);
981 kfree(b->legacy_io); /* both are allocated here */
984 #endif /* HAVE_PCI_LEGACY */
986 #if defined(HAVE_PCI_MMAP) || defined(ARCH_GENERIC_PCI_MMAP_RESOURCE)
988 int pci_mmap_fits(struct pci_dev *pdev, int resno, struct vm_area_struct *vma,
989 enum pci_mmap_api mmap_api)
991 unsigned long nr, start, size;
992 resource_size_t pci_start = 0, pci_end;
994 if (pci_resource_len(pdev, resno) == 0)
997 start = vma->vm_pgoff;
998 size = ((pci_resource_len(pdev, resno) - 1) >> PAGE_SHIFT) + 1;
999 if (mmap_api == PCI_MMAP_PROCFS) {
1000 pci_resource_to_user(pdev, resno, &pdev->resource[resno],
1001 &pci_start, &pci_end);
1002 pci_start >>= PAGE_SHIFT;
1004 if (start >= pci_start && start < pci_start + size &&
1005 start + nr <= pci_start + size)
1011 * pci_mmap_resource - map a PCI resource into user memory space
1012 * @kobj: kobject for mapping
1013 * @attr: struct bin_attribute for the file being mapped
1014 * @vma: struct vm_area_struct passed into the mmap
1015 * @write_combine: 1 for write_combine mapping
1017 * Use the regular PCI mapping routines to map a PCI resource into userspace.
1019 static int pci_mmap_resource(struct kobject *kobj, struct bin_attribute *attr,
1020 struct vm_area_struct *vma, int write_combine)
1022 struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
1023 int bar = (unsigned long)attr->private;
1024 enum pci_mmap_state mmap_type;
1025 struct resource *res = &pdev->resource[bar];
1028 ret = security_locked_down(LOCKDOWN_PCI_ACCESS);
1032 if (res->flags & IORESOURCE_MEM && iomem_is_exclusive(res->start))
1035 if (!pci_mmap_fits(pdev, bar, vma, PCI_MMAP_SYSFS))
1038 mmap_type = res->flags & IORESOURCE_MEM ? pci_mmap_mem : pci_mmap_io;
1040 return pci_mmap_resource_range(pdev, bar, vma, mmap_type, write_combine);
1043 static int pci_mmap_resource_uc(struct file *filp, struct kobject *kobj,
1044 struct bin_attribute *attr,
1045 struct vm_area_struct *vma)
1047 return pci_mmap_resource(kobj, attr, vma, 0);
1050 static int pci_mmap_resource_wc(struct file *filp, struct kobject *kobj,
1051 struct bin_attribute *attr,
1052 struct vm_area_struct *vma)
1054 return pci_mmap_resource(kobj, attr, vma, 1);
1057 static ssize_t pci_resource_io(struct file *filp, struct kobject *kobj,
1058 struct bin_attribute *attr, char *buf,
1059 loff_t off, size_t count, bool write)
1061 struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
1062 int bar = (unsigned long)attr->private;
1063 unsigned long port = off;
1065 port += pci_resource_start(pdev, bar);
1067 if (port > pci_resource_end(pdev, bar))
1070 if (port + count - 1 > pci_resource_end(pdev, bar))
1076 outb(*(u8 *)buf, port);
1078 *(u8 *)buf = inb(port);
1082 outw(*(u16 *)buf, port);
1084 *(u16 *)buf = inw(port);
1088 outl(*(u32 *)buf, port);
1090 *(u32 *)buf = inl(port);
1096 static ssize_t pci_read_resource_io(struct file *filp, struct kobject *kobj,
1097 struct bin_attribute *attr, char *buf,
1098 loff_t off, size_t count)
1100 return pci_resource_io(filp, kobj, attr, buf, off, count, false);
1103 static ssize_t pci_write_resource_io(struct file *filp, struct kobject *kobj,
1104 struct bin_attribute *attr, char *buf,
1105 loff_t off, size_t count)
1109 ret = security_locked_down(LOCKDOWN_PCI_ACCESS);
1113 return pci_resource_io(filp, kobj, attr, buf, off, count, true);
1117 * pci_remove_resource_files - cleanup resource files
1118 * @pdev: dev to cleanup
1120 * If we created resource files for @pdev, remove them from sysfs and
1121 * free their resources.
1123 static void pci_remove_resource_files(struct pci_dev *pdev)
1127 for (i = 0; i < PCI_ROM_RESOURCE; i++) {
1128 struct bin_attribute *res_attr;
1130 res_attr = pdev->res_attr[i];
1132 sysfs_remove_bin_file(&pdev->dev.kobj, res_attr);
1136 res_attr = pdev->res_attr_wc[i];
1138 sysfs_remove_bin_file(&pdev->dev.kobj, res_attr);
1144 static int pci_create_attr(struct pci_dev *pdev, int num, int write_combine)
1146 /* allocate attribute structure, piggyback attribute name */
1147 int name_len = write_combine ? 13 : 10;
1148 struct bin_attribute *res_attr;
1149 char *res_attr_name;
1152 res_attr = kzalloc(sizeof(*res_attr) + name_len, GFP_ATOMIC);
1156 res_attr_name = (char *)(res_attr + 1);
1158 sysfs_bin_attr_init(res_attr);
1159 if (write_combine) {
1160 sprintf(res_attr_name, "resource%d_wc", num);
1161 res_attr->mmap = pci_mmap_resource_wc;
1163 sprintf(res_attr_name, "resource%d", num);
1164 if (pci_resource_flags(pdev, num) & IORESOURCE_IO) {
1165 res_attr->read = pci_read_resource_io;
1166 res_attr->write = pci_write_resource_io;
1167 if (arch_can_pci_mmap_io())
1168 res_attr->mmap = pci_mmap_resource_uc;
1170 res_attr->mmap = pci_mmap_resource_uc;
1173 res_attr->attr.name = res_attr_name;
1174 res_attr->attr.mode = 0600;
1175 res_attr->size = pci_resource_len(pdev, num);
1176 res_attr->private = (void *)(unsigned long)num;
1177 retval = sysfs_create_bin_file(&pdev->dev.kobj, res_attr);
1184 pdev->res_attr_wc[num] = res_attr;
1186 pdev->res_attr[num] = res_attr;
1192 * pci_create_resource_files - create resource files in sysfs for @dev
1193 * @pdev: dev in question
1195 * Walk the resources in @pdev creating files for each resource available.
1197 static int pci_create_resource_files(struct pci_dev *pdev)
1202 /* Expose the PCI resources from this device as files */
1203 for (i = 0; i < PCI_ROM_RESOURCE; i++) {
1205 /* skip empty resources */
1206 if (!pci_resource_len(pdev, i))
1209 retval = pci_create_attr(pdev, i, 0);
1210 /* for prefetchable resources, create a WC mappable file */
1211 if (!retval && arch_can_pci_mmap_wc() &&
1212 pdev->resource[i].flags & IORESOURCE_PREFETCH)
1213 retval = pci_create_attr(pdev, i, 1);
1215 pci_remove_resource_files(pdev);
1221 #else /* !HAVE_PCI_MMAP */
1222 int __weak pci_create_resource_files(struct pci_dev *dev) { return 0; }
1223 void __weak pci_remove_resource_files(struct pci_dev *dev) { return; }
1224 #endif /* HAVE_PCI_MMAP */
1227 * pci_write_rom - used to enable access to the PCI ROM display
1229 * @kobj: kernel object handle
1230 * @bin_attr: struct bin_attribute for this file
1233 * @count: number of byte in input
1235 * writing anything except 0 enables it
1237 static ssize_t pci_write_rom(struct file *filp, struct kobject *kobj,
1238 struct bin_attribute *bin_attr, char *buf,
1239 loff_t off, size_t count)
1241 struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
1243 if ((off == 0) && (*buf == '0') && (count == 2))
1244 pdev->rom_attr_enabled = 0;
1246 pdev->rom_attr_enabled = 1;
1252 * pci_read_rom - read a PCI ROM
1254 * @kobj: kernel object handle
1255 * @bin_attr: struct bin_attribute for this file
1256 * @buf: where to put the data we read from the ROM
1258 * @count: number of bytes to read
1260 * Put @count bytes starting at @off into @buf from the ROM in the PCI
1261 * device corresponding to @kobj.
1263 static ssize_t pci_read_rom(struct file *filp, struct kobject *kobj,
1264 struct bin_attribute *bin_attr, char *buf,
1265 loff_t off, size_t count)
1267 struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
1271 if (!pdev->rom_attr_enabled)
1274 rom = pci_map_rom(pdev, &size); /* size starts out as PCI window size */
1281 if (off + count > size)
1284 memcpy_fromio(buf, rom + off, count);
1286 pci_unmap_rom(pdev, rom);
1291 static const struct bin_attribute pci_config_attr = {
1296 .size = PCI_CFG_SPACE_SIZE,
1297 .read = pci_read_config,
1298 .write = pci_write_config,
1301 static const struct bin_attribute pcie_config_attr = {
1306 .size = PCI_CFG_SPACE_EXP_SIZE,
1307 .read = pci_read_config,
1308 .write = pci_write_config,
1311 static ssize_t reset_store(struct device *dev, struct device_attribute *attr,
1312 const char *buf, size_t count)
1314 struct pci_dev *pdev = to_pci_dev(dev);
1316 ssize_t result = kstrtoul(buf, 0, &val);
1324 pm_runtime_get_sync(dev);
1325 result = pci_reset_function(pdev);
1326 pm_runtime_put(dev);
1333 static DEVICE_ATTR(reset, 0200, NULL, reset_store);
1335 static int pci_create_capabilities_sysfs(struct pci_dev *dev)
1339 pcie_vpd_create_sysfs_dev_files(dev);
1340 pcie_aspm_create_sysfs_dev_files(dev);
1342 if (dev->reset_fn) {
1343 retval = device_create_file(&dev->dev, &dev_attr_reset);
1350 pcie_aspm_remove_sysfs_dev_files(dev);
1351 pcie_vpd_remove_sysfs_dev_files(dev);
1355 int __must_check pci_create_sysfs_dev_files(struct pci_dev *pdev)
1359 struct bin_attribute *attr;
1361 if (!sysfs_initialized)
1364 if (pdev->cfg_size > PCI_CFG_SPACE_SIZE)
1365 retval = sysfs_create_bin_file(&pdev->dev.kobj, &pcie_config_attr);
1367 retval = sysfs_create_bin_file(&pdev->dev.kobj, &pci_config_attr);
1371 retval = pci_create_resource_files(pdev);
1373 goto err_config_file;
1375 /* If the device has a ROM, try to expose it in sysfs. */
1376 rom_size = pci_resource_len(pdev, PCI_ROM_RESOURCE);
1378 attr = kzalloc(sizeof(*attr), GFP_ATOMIC);
1381 goto err_resource_files;
1383 sysfs_bin_attr_init(attr);
1384 attr->size = rom_size;
1385 attr->attr.name = "rom";
1386 attr->attr.mode = 0600;
1387 attr->read = pci_read_rom;
1388 attr->write = pci_write_rom;
1389 retval = sysfs_create_bin_file(&pdev->dev.kobj, attr);
1392 goto err_resource_files;
1394 pdev->rom_attr = attr;
1397 /* add sysfs entries for various capabilities */
1398 retval = pci_create_capabilities_sysfs(pdev);
1402 pci_create_firmware_label_files(pdev);
1407 if (pdev->rom_attr) {
1408 sysfs_remove_bin_file(&pdev->dev.kobj, pdev->rom_attr);
1409 kfree(pdev->rom_attr);
1410 pdev->rom_attr = NULL;
1413 pci_remove_resource_files(pdev);
1415 if (pdev->cfg_size > PCI_CFG_SPACE_SIZE)
1416 sysfs_remove_bin_file(&pdev->dev.kobj, &pcie_config_attr);
1418 sysfs_remove_bin_file(&pdev->dev.kobj, &pci_config_attr);
1423 static void pci_remove_capabilities_sysfs(struct pci_dev *dev)
1425 pcie_vpd_remove_sysfs_dev_files(dev);
1426 pcie_aspm_remove_sysfs_dev_files(dev);
1427 if (dev->reset_fn) {
1428 device_remove_file(&dev->dev, &dev_attr_reset);
1434 * pci_remove_sysfs_dev_files - cleanup PCI specific sysfs files
1435 * @pdev: device whose entries we should free
1437 * Cleanup when @pdev is removed from sysfs.
1439 void pci_remove_sysfs_dev_files(struct pci_dev *pdev)
1441 if (!sysfs_initialized)
1444 pci_remove_capabilities_sysfs(pdev);
1446 if (pdev->cfg_size > PCI_CFG_SPACE_SIZE)
1447 sysfs_remove_bin_file(&pdev->dev.kobj, &pcie_config_attr);
1449 sysfs_remove_bin_file(&pdev->dev.kobj, &pci_config_attr);
1451 pci_remove_resource_files(pdev);
1453 if (pdev->rom_attr) {
1454 sysfs_remove_bin_file(&pdev->dev.kobj, pdev->rom_attr);
1455 kfree(pdev->rom_attr);
1456 pdev->rom_attr = NULL;
1459 pci_remove_firmware_label_files(pdev);
1462 static int __init pci_sysfs_init(void)
1464 struct pci_dev *pdev = NULL;
1467 sysfs_initialized = 1;
1468 for_each_pci_dev(pdev) {
1469 retval = pci_create_sysfs_dev_files(pdev);
1478 late_initcall(pci_sysfs_init);
1480 static struct attribute *pci_dev_dev_attrs[] = {
1481 &dev_attr_boot_vga.attr,
1485 static umode_t pci_dev_attrs_are_visible(struct kobject *kobj,
1486 struct attribute *a, int n)
1488 struct device *dev = kobj_to_dev(kobj);
1489 struct pci_dev *pdev = to_pci_dev(dev);
1491 if (a == &dev_attr_boot_vga.attr)
1492 if ((pdev->class >> 8) != PCI_CLASS_DISPLAY_VGA)
1498 static struct attribute *pci_dev_hp_attrs[] = {
1499 &dev_attr_remove.attr,
1500 &dev_attr_dev_rescan.attr,
1504 static umode_t pci_dev_hp_attrs_are_visible(struct kobject *kobj,
1505 struct attribute *a, int n)
1507 struct device *dev = kobj_to_dev(kobj);
1508 struct pci_dev *pdev = to_pci_dev(dev);
1510 if (pdev->is_virtfn)
1516 static umode_t pci_bridge_attrs_are_visible(struct kobject *kobj,
1517 struct attribute *a, int n)
1519 struct device *dev = kobj_to_dev(kobj);
1520 struct pci_dev *pdev = to_pci_dev(dev);
1522 if (pci_is_bridge(pdev))
1528 static umode_t pcie_dev_attrs_are_visible(struct kobject *kobj,
1529 struct attribute *a, int n)
1531 struct device *dev = kobj_to_dev(kobj);
1532 struct pci_dev *pdev = to_pci_dev(dev);
1534 if (pci_is_pcie(pdev))
1540 static const struct attribute_group pci_dev_group = {
1541 .attrs = pci_dev_attrs,
1544 const struct attribute_group *pci_dev_groups[] = {
1549 static const struct attribute_group pci_bridge_group = {
1550 .attrs = pci_bridge_attrs,
1553 const struct attribute_group *pci_bridge_groups[] = {
1558 static const struct attribute_group pcie_dev_group = {
1559 .attrs = pcie_dev_attrs,
1562 const struct attribute_group *pcie_dev_groups[] = {
1567 static const struct attribute_group pci_dev_hp_attr_group = {
1568 .attrs = pci_dev_hp_attrs,
1569 .is_visible = pci_dev_hp_attrs_are_visible,
1572 static const struct attribute_group pci_dev_attr_group = {
1573 .attrs = pci_dev_dev_attrs,
1574 .is_visible = pci_dev_attrs_are_visible,
1577 static const struct attribute_group pci_bridge_attr_group = {
1578 .attrs = pci_bridge_attrs,
1579 .is_visible = pci_bridge_attrs_are_visible,
1582 static const struct attribute_group pcie_dev_attr_group = {
1583 .attrs = pcie_dev_attrs,
1584 .is_visible = pcie_dev_attrs_are_visible,
1587 static const struct attribute_group *pci_dev_attr_groups[] = {
1588 &pci_dev_attr_group,
1589 &pci_dev_hp_attr_group,
1590 #ifdef CONFIG_PCI_IOV
1591 &sriov_dev_attr_group,
1593 &pci_bridge_attr_group,
1594 &pcie_dev_attr_group,
1595 #ifdef CONFIG_PCIEAER
1596 &aer_stats_attr_group,
1601 const struct device_type pci_dev_type = {
1602 .groups = pci_dev_attr_groups,