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 sysfs_emit(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 sysfs_emit(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);
127 static ssize_t power_state_show(struct device *dev,
128 struct device_attribute *attr, char *buf)
130 struct pci_dev *pdev = to_pci_dev(dev);
132 return sysfs_emit(buf, "%s\n", pci_power_name(pdev->current_state));
134 static DEVICE_ATTR_RO(power_state);
137 static ssize_t resource_show(struct device *dev, struct device_attribute *attr,
140 struct pci_dev *pci_dev = to_pci_dev(dev);
143 resource_size_t start, end;
146 if (pci_dev->subordinate)
147 max = DEVICE_COUNT_RESOURCE;
149 max = PCI_BRIDGE_RESOURCES;
151 for (i = 0; i < max; i++) {
152 struct resource *res = &pci_dev->resource[i];
153 pci_resource_to_user(pci_dev, i, res, &start, &end);
154 len += sysfs_emit_at(buf, len, "0x%016llx 0x%016llx 0x%016llx\n",
155 (unsigned long long)start,
156 (unsigned long long)end,
157 (unsigned long long)res->flags);
161 static DEVICE_ATTR_RO(resource);
163 static ssize_t max_link_speed_show(struct device *dev,
164 struct device_attribute *attr, char *buf)
166 struct pci_dev *pdev = to_pci_dev(dev);
168 return sysfs_emit(buf, "%s\n",
169 pci_speed_string(pcie_get_speed_cap(pdev)));
171 static DEVICE_ATTR_RO(max_link_speed);
173 static ssize_t max_link_width_show(struct device *dev,
174 struct device_attribute *attr, char *buf)
176 struct pci_dev *pdev = to_pci_dev(dev);
178 return sysfs_emit(buf, "%u\n", pcie_get_width_cap(pdev));
180 static DEVICE_ATTR_RO(max_link_width);
182 static ssize_t current_link_speed_show(struct device *dev,
183 struct device_attribute *attr, char *buf)
185 struct pci_dev *pci_dev = to_pci_dev(dev);
188 enum pci_bus_speed speed;
190 err = pcie_capability_read_word(pci_dev, PCI_EXP_LNKSTA, &linkstat);
194 speed = pcie_link_speed[linkstat & PCI_EXP_LNKSTA_CLS];
196 return sysfs_emit(buf, "%s\n", pci_speed_string(speed));
198 static DEVICE_ATTR_RO(current_link_speed);
200 static ssize_t current_link_width_show(struct device *dev,
201 struct device_attribute *attr, char *buf)
203 struct pci_dev *pci_dev = to_pci_dev(dev);
207 err = pcie_capability_read_word(pci_dev, PCI_EXP_LNKSTA, &linkstat);
211 return sysfs_emit(buf, "%u\n",
212 (linkstat & PCI_EXP_LNKSTA_NLW) >> PCI_EXP_LNKSTA_NLW_SHIFT);
214 static DEVICE_ATTR_RO(current_link_width);
216 static ssize_t secondary_bus_number_show(struct device *dev,
217 struct device_attribute *attr,
220 struct pci_dev *pci_dev = to_pci_dev(dev);
224 err = pci_read_config_byte(pci_dev, PCI_SECONDARY_BUS, &sec_bus);
228 return sysfs_emit(buf, "%u\n", sec_bus);
230 static DEVICE_ATTR_RO(secondary_bus_number);
232 static ssize_t subordinate_bus_number_show(struct device *dev,
233 struct device_attribute *attr,
236 struct pci_dev *pci_dev = to_pci_dev(dev);
240 err = pci_read_config_byte(pci_dev, PCI_SUBORDINATE_BUS, &sub_bus);
244 return sysfs_emit(buf, "%u\n", sub_bus);
246 static DEVICE_ATTR_RO(subordinate_bus_number);
248 static ssize_t ari_enabled_show(struct device *dev,
249 struct device_attribute *attr,
252 struct pci_dev *pci_dev = to_pci_dev(dev);
254 return sysfs_emit(buf, "%u\n", pci_ari_enabled(pci_dev->bus));
256 static DEVICE_ATTR_RO(ari_enabled);
258 static ssize_t modalias_show(struct device *dev, struct device_attribute *attr,
261 struct pci_dev *pci_dev = to_pci_dev(dev);
263 return sysfs_emit(buf, "pci:v%08Xd%08Xsv%08Xsd%08Xbc%02Xsc%02Xi%02X\n",
264 pci_dev->vendor, pci_dev->device,
265 pci_dev->subsystem_vendor, pci_dev->subsystem_device,
266 (u8)(pci_dev->class >> 16), (u8)(pci_dev->class >> 8),
267 (u8)(pci_dev->class));
269 static DEVICE_ATTR_RO(modalias);
271 static ssize_t enable_store(struct device *dev, struct device_attribute *attr,
272 const char *buf, size_t count)
274 struct pci_dev *pdev = to_pci_dev(dev);
276 ssize_t result = kstrtoul(buf, 0, &val);
281 /* this can crash the machine when done on the "wrong" device */
282 if (!capable(CAP_SYS_ADMIN))
289 result = pci_enable_device(pdev);
290 else if (pci_is_enabled(pdev))
291 pci_disable_device(pdev);
296 return result < 0 ? result : count;
299 static ssize_t enable_show(struct device *dev, struct device_attribute *attr,
302 struct pci_dev *pdev;
304 pdev = to_pci_dev(dev);
305 return sysfs_emit(buf, "%u\n", atomic_read(&pdev->enable_cnt));
307 static DEVICE_ATTR_RW(enable);
310 static ssize_t numa_node_store(struct device *dev,
311 struct device_attribute *attr, const char *buf,
314 struct pci_dev *pdev = to_pci_dev(dev);
317 if (!capable(CAP_SYS_ADMIN))
320 ret = kstrtoint(buf, 0, &node);
324 if ((node < 0 && node != NUMA_NO_NODE) || node >= MAX_NUMNODES)
327 if (node != NUMA_NO_NODE && !node_online(node))
330 add_taint(TAINT_FIRMWARE_WORKAROUND, LOCKDEP_STILL_OK);
331 pci_alert(pdev, FW_BUG "Overriding NUMA node to %d. Contact your vendor for updates.",
334 dev->numa_node = node;
338 static ssize_t numa_node_show(struct device *dev, struct device_attribute *attr,
341 return sysfs_emit(buf, "%d\n", dev->numa_node);
343 static DEVICE_ATTR_RW(numa_node);
346 static ssize_t dma_mask_bits_show(struct device *dev,
347 struct device_attribute *attr, char *buf)
349 struct pci_dev *pdev = to_pci_dev(dev);
351 return sysfs_emit(buf, "%d\n", fls64(pdev->dma_mask));
353 static DEVICE_ATTR_RO(dma_mask_bits);
355 static ssize_t consistent_dma_mask_bits_show(struct device *dev,
356 struct device_attribute *attr,
359 return sysfs_emit(buf, "%d\n", fls64(dev->coherent_dma_mask));
361 static DEVICE_ATTR_RO(consistent_dma_mask_bits);
363 static ssize_t msi_bus_show(struct device *dev, struct device_attribute *attr,
366 struct pci_dev *pdev = to_pci_dev(dev);
367 struct pci_bus *subordinate = pdev->subordinate;
369 return sysfs_emit(buf, "%u\n", subordinate ?
370 !(subordinate->bus_flags & PCI_BUS_FLAGS_NO_MSI)
374 static ssize_t msi_bus_store(struct device *dev, struct device_attribute *attr,
375 const char *buf, size_t count)
377 struct pci_dev *pdev = to_pci_dev(dev);
378 struct pci_bus *subordinate = pdev->subordinate;
381 if (kstrtoul(buf, 0, &val) < 0)
384 if (!capable(CAP_SYS_ADMIN))
388 * "no_msi" and "bus_flags" only affect what happens when a driver
389 * requests MSI or MSI-X. They don't affect any drivers that have
390 * already requested MSI or MSI-X.
394 pci_info(pdev, "MSI/MSI-X %s for future drivers\n",
395 val ? "allowed" : "disallowed");
400 subordinate->bus_flags &= ~PCI_BUS_FLAGS_NO_MSI;
402 subordinate->bus_flags |= PCI_BUS_FLAGS_NO_MSI;
404 dev_info(&subordinate->dev, "MSI/MSI-X %s for future drivers of devices on this bus\n",
405 val ? "allowed" : "disallowed");
408 static DEVICE_ATTR_RW(msi_bus);
410 static ssize_t rescan_store(struct bus_type *bus, const char *buf, size_t count)
413 struct pci_bus *b = NULL;
415 if (kstrtoul(buf, 0, &val) < 0)
419 pci_lock_rescan_remove();
420 while ((b = pci_find_next_bus(b)) != NULL)
422 pci_unlock_rescan_remove();
426 static BUS_ATTR_WO(rescan);
428 static struct attribute *pci_bus_attrs[] = {
429 &bus_attr_rescan.attr,
433 static const struct attribute_group pci_bus_group = {
434 .attrs = pci_bus_attrs,
437 const struct attribute_group *pci_bus_groups[] = {
442 static ssize_t dev_rescan_store(struct device *dev,
443 struct device_attribute *attr, const char *buf,
447 struct pci_dev *pdev = to_pci_dev(dev);
449 if (kstrtoul(buf, 0, &val) < 0)
453 pci_lock_rescan_remove();
454 pci_rescan_bus(pdev->bus);
455 pci_unlock_rescan_remove();
459 static struct device_attribute dev_attr_dev_rescan = __ATTR(rescan, 0200, NULL,
462 static ssize_t remove_store(struct device *dev, struct device_attribute *attr,
463 const char *buf, size_t count)
467 if (kstrtoul(buf, 0, &val) < 0)
470 if (val && device_remove_file_self(dev, attr))
471 pci_stop_and_remove_bus_device_locked(to_pci_dev(dev));
474 static DEVICE_ATTR_IGNORE_LOCKDEP(remove, 0220, NULL,
477 static ssize_t bus_rescan_store(struct device *dev,
478 struct device_attribute *attr,
479 const char *buf, size_t count)
482 struct pci_bus *bus = to_pci_bus(dev);
484 if (kstrtoul(buf, 0, &val) < 0)
488 pci_lock_rescan_remove();
489 if (!pci_is_root_bus(bus) && list_empty(&bus->devices))
490 pci_rescan_bus_bridge_resize(bus->self);
493 pci_unlock_rescan_remove();
497 static struct device_attribute dev_attr_bus_rescan = __ATTR(rescan, 0200, NULL,
500 #if defined(CONFIG_PM) && defined(CONFIG_ACPI)
501 static ssize_t d3cold_allowed_store(struct device *dev,
502 struct device_attribute *attr,
503 const char *buf, size_t count)
505 struct pci_dev *pdev = to_pci_dev(dev);
508 if (kstrtoul(buf, 0, &val) < 0)
511 pdev->d3cold_allowed = !!val;
512 if (pdev->d3cold_allowed)
513 pci_d3cold_enable(pdev);
515 pci_d3cold_disable(pdev);
517 pm_runtime_resume(dev);
522 static ssize_t d3cold_allowed_show(struct device *dev,
523 struct device_attribute *attr, char *buf)
525 struct pci_dev *pdev = to_pci_dev(dev);
526 return sysfs_emit(buf, "%u\n", pdev->d3cold_allowed);
528 static DEVICE_ATTR_RW(d3cold_allowed);
532 static ssize_t devspec_show(struct device *dev,
533 struct device_attribute *attr, char *buf)
535 struct pci_dev *pdev = to_pci_dev(dev);
536 struct device_node *np = pci_device_to_OF_node(pdev);
540 return sysfs_emit(buf, "%pOF\n", np);
542 static DEVICE_ATTR_RO(devspec);
545 static ssize_t driver_override_store(struct device *dev,
546 struct device_attribute *attr,
547 const char *buf, size_t count)
549 struct pci_dev *pdev = to_pci_dev(dev);
550 char *driver_override, *old, *cp;
552 /* We need to keep extra room for a newline */
553 if (count >= (PAGE_SIZE - 1))
556 driver_override = kstrndup(buf, count, GFP_KERNEL);
557 if (!driver_override)
560 cp = strchr(driver_override, '\n');
565 old = pdev->driver_override;
566 if (strlen(driver_override)) {
567 pdev->driver_override = driver_override;
569 kfree(driver_override);
570 pdev->driver_override = NULL;
579 static ssize_t driver_override_show(struct device *dev,
580 struct device_attribute *attr, char *buf)
582 struct pci_dev *pdev = to_pci_dev(dev);
586 len = sysfs_emit(buf, "%s\n", pdev->driver_override);
590 static DEVICE_ATTR_RW(driver_override);
592 static struct attribute *pci_dev_attrs[] = {
593 &dev_attr_power_state.attr,
594 &dev_attr_resource.attr,
595 &dev_attr_vendor.attr,
596 &dev_attr_device.attr,
597 &dev_attr_subsystem_vendor.attr,
598 &dev_attr_subsystem_device.attr,
599 &dev_attr_revision.attr,
600 &dev_attr_class.attr,
602 &dev_attr_local_cpus.attr,
603 &dev_attr_local_cpulist.attr,
604 &dev_attr_modalias.attr,
606 &dev_attr_numa_node.attr,
608 &dev_attr_dma_mask_bits.attr,
609 &dev_attr_consistent_dma_mask_bits.attr,
610 &dev_attr_enable.attr,
611 &dev_attr_broken_parity_status.attr,
612 &dev_attr_msi_bus.attr,
613 #if defined(CONFIG_PM) && defined(CONFIG_ACPI)
614 &dev_attr_d3cold_allowed.attr,
617 &dev_attr_devspec.attr,
619 &dev_attr_driver_override.attr,
620 &dev_attr_ari_enabled.attr,
624 static struct attribute *pci_bridge_attrs[] = {
625 &dev_attr_subordinate_bus_number.attr,
626 &dev_attr_secondary_bus_number.attr,
630 static struct attribute *pcie_dev_attrs[] = {
631 &dev_attr_current_link_speed.attr,
632 &dev_attr_current_link_width.attr,
633 &dev_attr_max_link_width.attr,
634 &dev_attr_max_link_speed.attr,
638 static struct attribute *pcibus_attrs[] = {
639 &dev_attr_bus_rescan.attr,
640 &dev_attr_cpuaffinity.attr,
641 &dev_attr_cpulistaffinity.attr,
645 static const struct attribute_group pcibus_group = {
646 .attrs = pcibus_attrs,
649 const struct attribute_group *pcibus_groups[] = {
654 static ssize_t boot_vga_show(struct device *dev, struct device_attribute *attr,
657 struct pci_dev *pdev = to_pci_dev(dev);
658 struct pci_dev *vga_dev = vga_default_device();
661 return sysfs_emit(buf, "%u\n", (pdev == vga_dev));
663 return sysfs_emit(buf, "%u\n",
664 !!(pdev->resource[PCI_ROM_RESOURCE].flags &
665 IORESOURCE_ROM_SHADOW));
667 static DEVICE_ATTR_RO(boot_vga);
669 static ssize_t pci_read_config(struct file *filp, struct kobject *kobj,
670 struct bin_attribute *bin_attr, char *buf,
671 loff_t off, size_t count)
673 struct pci_dev *dev = to_pci_dev(kobj_to_dev(kobj));
674 unsigned int size = 64;
675 loff_t init_off = off;
676 u8 *data = (u8 *) buf;
678 /* Several chips lock up trying to read undefined config space */
679 if (file_ns_capable(filp, &init_user_ns, CAP_SYS_ADMIN))
680 size = dev->cfg_size;
681 else if (dev->hdr_type == PCI_HEADER_TYPE_CARDBUS)
686 if (off + count > size) {
693 pci_config_pm_runtime_get(dev);
695 if ((off & 1) && size) {
697 pci_user_read_config_byte(dev, off, &val);
698 data[off - init_off] = val;
703 if ((off & 3) && size > 2) {
705 pci_user_read_config_word(dev, off, &val);
706 data[off - init_off] = val & 0xff;
707 data[off - init_off + 1] = (val >> 8) & 0xff;
714 pci_user_read_config_dword(dev, off, &val);
715 data[off - init_off] = val & 0xff;
716 data[off - init_off + 1] = (val >> 8) & 0xff;
717 data[off - init_off + 2] = (val >> 16) & 0xff;
718 data[off - init_off + 3] = (val >> 24) & 0xff;
726 pci_user_read_config_word(dev, off, &val);
727 data[off - init_off] = val & 0xff;
728 data[off - init_off + 1] = (val >> 8) & 0xff;
735 pci_user_read_config_byte(dev, off, &val);
736 data[off - init_off] = val;
741 pci_config_pm_runtime_put(dev);
746 static ssize_t pci_write_config(struct file *filp, struct kobject *kobj,
747 struct bin_attribute *bin_attr, char *buf,
748 loff_t off, size_t count)
750 struct pci_dev *dev = to_pci_dev(kobj_to_dev(kobj));
751 unsigned int size = count;
752 loff_t init_off = off;
753 u8 *data = (u8 *) buf;
756 ret = security_locked_down(LOCKDOWN_PCI_ACCESS);
760 if (off > dev->cfg_size)
762 if (off + count > dev->cfg_size) {
763 size = dev->cfg_size - off;
767 pci_config_pm_runtime_get(dev);
769 if ((off & 1) && size) {
770 pci_user_write_config_byte(dev, off, data[off - init_off]);
775 if ((off & 3) && size > 2) {
776 u16 val = data[off - init_off];
777 val |= (u16) data[off - init_off + 1] << 8;
778 pci_user_write_config_word(dev, off, val);
784 u32 val = data[off - init_off];
785 val |= (u32) data[off - init_off + 1] << 8;
786 val |= (u32) data[off - init_off + 2] << 16;
787 val |= (u32) data[off - init_off + 3] << 24;
788 pci_user_write_config_dword(dev, off, val);
794 u16 val = data[off - init_off];
795 val |= (u16) data[off - init_off + 1] << 8;
796 pci_user_write_config_word(dev, off, val);
802 pci_user_write_config_byte(dev, off, data[off - init_off]);
807 pci_config_pm_runtime_put(dev);
811 static BIN_ATTR(config, 0644, pci_read_config, pci_write_config, 0);
813 static struct bin_attribute *pci_dev_config_attrs[] = {
818 static umode_t pci_dev_config_attr_is_visible(struct kobject *kobj,
819 struct bin_attribute *a, int n)
821 struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
823 a->size = PCI_CFG_SPACE_SIZE;
824 if (pdev->cfg_size > PCI_CFG_SPACE_SIZE)
825 a->size = PCI_CFG_SPACE_EXP_SIZE;
830 static const struct attribute_group pci_dev_config_attr_group = {
831 .bin_attrs = pci_dev_config_attrs,
832 .is_bin_visible = pci_dev_config_attr_is_visible,
835 #ifdef HAVE_PCI_LEGACY
837 * pci_read_legacy_io - read byte(s) from legacy I/O port space
838 * @filp: open sysfs file
839 * @kobj: kobject corresponding to file to read from
840 * @bin_attr: struct bin_attribute for this file
841 * @buf: buffer to store results
842 * @off: offset into legacy I/O port space
843 * @count: number of bytes to read
845 * Reads 1, 2, or 4 bytes from legacy I/O port space using an arch specific
846 * callback routine (pci_legacy_read).
848 static ssize_t pci_read_legacy_io(struct file *filp, struct kobject *kobj,
849 struct bin_attribute *bin_attr, char *buf,
850 loff_t off, size_t count)
852 struct pci_bus *bus = to_pci_bus(kobj_to_dev(kobj));
854 /* Only support 1, 2 or 4 byte accesses */
855 if (count != 1 && count != 2 && count != 4)
858 return pci_legacy_read(bus, off, (u32 *)buf, count);
862 * pci_write_legacy_io - write byte(s) to legacy I/O port space
863 * @filp: open sysfs file
864 * @kobj: kobject corresponding to file to read from
865 * @bin_attr: struct bin_attribute for this file
866 * @buf: buffer containing value to be written
867 * @off: offset into legacy I/O port space
868 * @count: number of bytes to write
870 * Writes 1, 2, or 4 bytes from legacy I/O port space using an arch specific
871 * callback routine (pci_legacy_write).
873 static ssize_t pci_write_legacy_io(struct file *filp, struct kobject *kobj,
874 struct bin_attribute *bin_attr, char *buf,
875 loff_t off, size_t count)
877 struct pci_bus *bus = to_pci_bus(kobj_to_dev(kobj));
879 /* Only support 1, 2 or 4 byte accesses */
880 if (count != 1 && count != 2 && count != 4)
883 return pci_legacy_write(bus, off, *(u32 *)buf, count);
887 * pci_mmap_legacy_mem - map legacy PCI memory into user memory space
888 * @filp: open sysfs file
889 * @kobj: kobject corresponding to device to be mapped
890 * @attr: struct bin_attribute for this file
891 * @vma: struct vm_area_struct passed to mmap
893 * Uses an arch specific callback, pci_mmap_legacy_mem_page_range, to mmap
894 * legacy memory space (first meg of bus space) into application virtual
897 static int pci_mmap_legacy_mem(struct file *filp, struct kobject *kobj,
898 struct bin_attribute *attr,
899 struct vm_area_struct *vma)
901 struct pci_bus *bus = to_pci_bus(kobj_to_dev(kobj));
903 return pci_mmap_legacy_page_range(bus, vma, pci_mmap_mem);
907 * pci_mmap_legacy_io - map legacy PCI IO into user memory space
908 * @filp: open sysfs file
909 * @kobj: kobject corresponding to device to be mapped
910 * @attr: struct bin_attribute for this file
911 * @vma: struct vm_area_struct passed to mmap
913 * Uses an arch specific callback, pci_mmap_legacy_io_page_range, to mmap
914 * legacy IO space (first meg of bus space) into application virtual
915 * memory space. Returns -ENOSYS if the operation isn't supported
917 static int pci_mmap_legacy_io(struct file *filp, struct kobject *kobj,
918 struct bin_attribute *attr,
919 struct vm_area_struct *vma)
921 struct pci_bus *bus = to_pci_bus(kobj_to_dev(kobj));
923 return pci_mmap_legacy_page_range(bus, vma, pci_mmap_io);
927 * pci_adjust_legacy_attr - adjustment of legacy file attributes
928 * @b: bus to create files under
929 * @mmap_type: I/O port or memory
931 * Stub implementation. Can be overridden by arch if necessary.
933 void __weak pci_adjust_legacy_attr(struct pci_bus *b,
934 enum pci_mmap_state mmap_type)
939 * pci_create_legacy_files - create legacy I/O port and memory files
940 * @b: bus to create files under
942 * Some platforms allow access to legacy I/O port and ISA memory space on
943 * a per-bus basis. This routine creates the files and ties them into
944 * their associated read, write and mmap files from pci-sysfs.c
946 * On error unwind, but don't propagate the error to the caller
947 * as it is ok to set up the PCI bus without these files.
949 void pci_create_legacy_files(struct pci_bus *b)
953 if (!sysfs_initialized)
956 b->legacy_io = kcalloc(2, sizeof(struct bin_attribute),
961 sysfs_bin_attr_init(b->legacy_io);
962 b->legacy_io->attr.name = "legacy_io";
963 b->legacy_io->size = 0xffff;
964 b->legacy_io->attr.mode = 0600;
965 b->legacy_io->read = pci_read_legacy_io;
966 b->legacy_io->write = pci_write_legacy_io;
967 b->legacy_io->mmap = pci_mmap_legacy_io;
968 b->legacy_io->mapping = iomem_get_mapping();
969 pci_adjust_legacy_attr(b, pci_mmap_io);
970 error = device_create_bin_file(&b->dev, b->legacy_io);
974 /* Allocated above after the legacy_io struct */
975 b->legacy_mem = b->legacy_io + 1;
976 sysfs_bin_attr_init(b->legacy_mem);
977 b->legacy_mem->attr.name = "legacy_mem";
978 b->legacy_mem->size = 1024*1024;
979 b->legacy_mem->attr.mode = 0600;
980 b->legacy_mem->mmap = pci_mmap_legacy_mem;
981 b->legacy_io->mapping = iomem_get_mapping();
982 pci_adjust_legacy_attr(b, pci_mmap_mem);
983 error = device_create_bin_file(&b->dev, b->legacy_mem);
990 device_remove_bin_file(&b->dev, b->legacy_io);
995 dev_warn(&b->dev, "could not create legacy I/O port and ISA memory resources in sysfs\n");
998 void pci_remove_legacy_files(struct pci_bus *b)
1001 device_remove_bin_file(&b->dev, b->legacy_io);
1002 device_remove_bin_file(&b->dev, b->legacy_mem);
1003 kfree(b->legacy_io); /* both are allocated here */
1006 #endif /* HAVE_PCI_LEGACY */
1008 #if defined(HAVE_PCI_MMAP) || defined(ARCH_GENERIC_PCI_MMAP_RESOURCE)
1010 int pci_mmap_fits(struct pci_dev *pdev, int resno, struct vm_area_struct *vma,
1011 enum pci_mmap_api mmap_api)
1013 unsigned long nr, start, size;
1014 resource_size_t pci_start = 0, pci_end;
1016 if (pci_resource_len(pdev, resno) == 0)
1018 nr = vma_pages(vma);
1019 start = vma->vm_pgoff;
1020 size = ((pci_resource_len(pdev, resno) - 1) >> PAGE_SHIFT) + 1;
1021 if (mmap_api == PCI_MMAP_PROCFS) {
1022 pci_resource_to_user(pdev, resno, &pdev->resource[resno],
1023 &pci_start, &pci_end);
1024 pci_start >>= PAGE_SHIFT;
1026 if (start >= pci_start && start < pci_start + size &&
1027 start + nr <= pci_start + size)
1033 * pci_mmap_resource - map a PCI resource into user memory space
1034 * @kobj: kobject for mapping
1035 * @attr: struct bin_attribute for the file being mapped
1036 * @vma: struct vm_area_struct passed into the mmap
1037 * @write_combine: 1 for write_combine mapping
1039 * Use the regular PCI mapping routines to map a PCI resource into userspace.
1041 static int pci_mmap_resource(struct kobject *kobj, struct bin_attribute *attr,
1042 struct vm_area_struct *vma, int write_combine)
1044 struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
1045 int bar = (unsigned long)attr->private;
1046 enum pci_mmap_state mmap_type;
1047 struct resource *res = &pdev->resource[bar];
1050 ret = security_locked_down(LOCKDOWN_PCI_ACCESS);
1054 if (res->flags & IORESOURCE_MEM && iomem_is_exclusive(res->start))
1057 if (!pci_mmap_fits(pdev, bar, vma, PCI_MMAP_SYSFS))
1060 mmap_type = res->flags & IORESOURCE_MEM ? pci_mmap_mem : pci_mmap_io;
1062 return pci_mmap_resource_range(pdev, bar, vma, mmap_type, write_combine);
1065 static int pci_mmap_resource_uc(struct file *filp, struct kobject *kobj,
1066 struct bin_attribute *attr,
1067 struct vm_area_struct *vma)
1069 return pci_mmap_resource(kobj, attr, vma, 0);
1072 static int pci_mmap_resource_wc(struct file *filp, struct kobject *kobj,
1073 struct bin_attribute *attr,
1074 struct vm_area_struct *vma)
1076 return pci_mmap_resource(kobj, attr, vma, 1);
1079 static ssize_t pci_resource_io(struct file *filp, struct kobject *kobj,
1080 struct bin_attribute *attr, char *buf,
1081 loff_t off, size_t count, bool write)
1083 struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
1084 int bar = (unsigned long)attr->private;
1085 unsigned long port = off;
1087 port += pci_resource_start(pdev, bar);
1089 if (port > pci_resource_end(pdev, bar))
1092 if (port + count - 1 > pci_resource_end(pdev, bar))
1098 outb(*(u8 *)buf, port);
1100 *(u8 *)buf = inb(port);
1104 outw(*(u16 *)buf, port);
1106 *(u16 *)buf = inw(port);
1110 outl(*(u32 *)buf, port);
1112 *(u32 *)buf = inl(port);
1118 static ssize_t pci_read_resource_io(struct file *filp, struct kobject *kobj,
1119 struct bin_attribute *attr, char *buf,
1120 loff_t off, size_t count)
1122 return pci_resource_io(filp, kobj, attr, buf, off, count, false);
1125 static ssize_t pci_write_resource_io(struct file *filp, struct kobject *kobj,
1126 struct bin_attribute *attr, char *buf,
1127 loff_t off, size_t count)
1131 ret = security_locked_down(LOCKDOWN_PCI_ACCESS);
1135 return pci_resource_io(filp, kobj, attr, buf, off, count, true);
1139 * pci_remove_resource_files - cleanup resource files
1140 * @pdev: dev to cleanup
1142 * If we created resource files for @pdev, remove them from sysfs and
1143 * free their resources.
1145 static void pci_remove_resource_files(struct pci_dev *pdev)
1149 for (i = 0; i < PCI_STD_NUM_BARS; i++) {
1150 struct bin_attribute *res_attr;
1152 res_attr = pdev->res_attr[i];
1154 sysfs_remove_bin_file(&pdev->dev.kobj, res_attr);
1158 res_attr = pdev->res_attr_wc[i];
1160 sysfs_remove_bin_file(&pdev->dev.kobj, res_attr);
1166 static int pci_create_attr(struct pci_dev *pdev, int num, int write_combine)
1168 /* allocate attribute structure, piggyback attribute name */
1169 int name_len = write_combine ? 13 : 10;
1170 struct bin_attribute *res_attr;
1171 char *res_attr_name;
1174 res_attr = kzalloc(sizeof(*res_attr) + name_len, GFP_ATOMIC);
1178 res_attr_name = (char *)(res_attr + 1);
1180 sysfs_bin_attr_init(res_attr);
1181 if (write_combine) {
1182 pdev->res_attr_wc[num] = res_attr;
1183 sprintf(res_attr_name, "resource%d_wc", num);
1184 res_attr->mmap = pci_mmap_resource_wc;
1186 pdev->res_attr[num] = res_attr;
1187 sprintf(res_attr_name, "resource%d", num);
1188 if (pci_resource_flags(pdev, num) & IORESOURCE_IO) {
1189 res_attr->read = pci_read_resource_io;
1190 res_attr->write = pci_write_resource_io;
1191 if (arch_can_pci_mmap_io())
1192 res_attr->mmap = pci_mmap_resource_uc;
1194 res_attr->mmap = pci_mmap_resource_uc;
1198 res_attr->mapping = iomem_get_mapping();
1199 res_attr->attr.name = res_attr_name;
1200 res_attr->attr.mode = 0600;
1201 res_attr->size = pci_resource_len(pdev, num);
1202 res_attr->private = (void *)(unsigned long)num;
1203 retval = sysfs_create_bin_file(&pdev->dev.kobj, res_attr);
1211 * pci_create_resource_files - create resource files in sysfs for @dev
1212 * @pdev: dev in question
1214 * Walk the resources in @pdev creating files for each resource available.
1216 static int pci_create_resource_files(struct pci_dev *pdev)
1221 /* Expose the PCI resources from this device as files */
1222 for (i = 0; i < PCI_STD_NUM_BARS; i++) {
1224 /* skip empty resources */
1225 if (!pci_resource_len(pdev, i))
1228 retval = pci_create_attr(pdev, i, 0);
1229 /* for prefetchable resources, create a WC mappable file */
1230 if (!retval && arch_can_pci_mmap_wc() &&
1231 pdev->resource[i].flags & IORESOURCE_PREFETCH)
1232 retval = pci_create_attr(pdev, i, 1);
1234 pci_remove_resource_files(pdev);
1240 #else /* !(defined(HAVE_PCI_MMAP) || defined(ARCH_GENERIC_PCI_MMAP_RESOURCE)) */
1241 int __weak pci_create_resource_files(struct pci_dev *dev) { return 0; }
1242 void __weak pci_remove_resource_files(struct pci_dev *dev) { return; }
1246 * pci_write_rom - used to enable access to the PCI ROM display
1248 * @kobj: kernel object handle
1249 * @bin_attr: struct bin_attribute for this file
1252 * @count: number of byte in input
1254 * writing anything except 0 enables it
1256 static ssize_t pci_write_rom(struct file *filp, struct kobject *kobj,
1257 struct bin_attribute *bin_attr, char *buf,
1258 loff_t off, size_t count)
1260 struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
1262 if ((off == 0) && (*buf == '0') && (count == 2))
1263 pdev->rom_attr_enabled = 0;
1265 pdev->rom_attr_enabled = 1;
1271 * pci_read_rom - read a PCI ROM
1273 * @kobj: kernel object handle
1274 * @bin_attr: struct bin_attribute for this file
1275 * @buf: where to put the data we read from the ROM
1277 * @count: number of bytes to read
1279 * Put @count bytes starting at @off into @buf from the ROM in the PCI
1280 * device corresponding to @kobj.
1282 static ssize_t pci_read_rom(struct file *filp, struct kobject *kobj,
1283 struct bin_attribute *bin_attr, char *buf,
1284 loff_t off, size_t count)
1286 struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
1290 if (!pdev->rom_attr_enabled)
1293 rom = pci_map_rom(pdev, &size); /* size starts out as PCI window size */
1300 if (off + count > size)
1303 memcpy_fromio(buf, rom + off, count);
1305 pci_unmap_rom(pdev, rom);
1309 static BIN_ATTR(rom, 0600, pci_read_rom, pci_write_rom, 0);
1311 static struct bin_attribute *pci_dev_rom_attrs[] = {
1316 static umode_t pci_dev_rom_attr_is_visible(struct kobject *kobj,
1317 struct bin_attribute *a, int n)
1319 struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
1322 /* If the device has a ROM, try to expose it in sysfs. */
1323 rom_size = pci_resource_len(pdev, PCI_ROM_RESOURCE);
1329 return a->attr.mode;
1332 static const struct attribute_group pci_dev_rom_attr_group = {
1333 .bin_attrs = pci_dev_rom_attrs,
1334 .is_bin_visible = pci_dev_rom_attr_is_visible,
1337 static ssize_t reset_store(struct device *dev, struct device_attribute *attr,
1338 const char *buf, size_t count)
1340 struct pci_dev *pdev = to_pci_dev(dev);
1342 ssize_t result = kstrtoul(buf, 0, &val);
1350 pm_runtime_get_sync(dev);
1351 result = pci_reset_function(pdev);
1352 pm_runtime_put(dev);
1358 static DEVICE_ATTR_WO(reset);
1360 static struct attribute *pci_dev_reset_attrs[] = {
1361 &dev_attr_reset.attr,
1365 static umode_t pci_dev_reset_attr_is_visible(struct kobject *kobj,
1366 struct attribute *a, int n)
1368 struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
1370 if (!pdev->reset_fn)
1376 static const struct attribute_group pci_dev_reset_attr_group = {
1377 .attrs = pci_dev_reset_attrs,
1378 .is_visible = pci_dev_reset_attr_is_visible,
1381 int __must_check pci_create_sysfs_dev_files(struct pci_dev *pdev)
1383 if (!sysfs_initialized)
1386 return pci_create_resource_files(pdev);
1390 * pci_remove_sysfs_dev_files - cleanup PCI specific sysfs files
1391 * @pdev: device whose entries we should free
1393 * Cleanup when @pdev is removed from sysfs.
1395 void pci_remove_sysfs_dev_files(struct pci_dev *pdev)
1397 if (!sysfs_initialized)
1400 pci_remove_resource_files(pdev);
1403 static int __init pci_sysfs_init(void)
1405 struct pci_dev *pdev = NULL;
1406 struct pci_bus *pbus = NULL;
1409 sysfs_initialized = 1;
1410 for_each_pci_dev(pdev) {
1411 retval = pci_create_sysfs_dev_files(pdev);
1418 while ((pbus = pci_find_next_bus(pbus)))
1419 pci_create_legacy_files(pbus);
1423 late_initcall(pci_sysfs_init);
1425 static struct attribute *pci_dev_dev_attrs[] = {
1426 &dev_attr_boot_vga.attr,
1430 static umode_t pci_dev_attrs_are_visible(struct kobject *kobj,
1431 struct attribute *a, int n)
1433 struct device *dev = kobj_to_dev(kobj);
1434 struct pci_dev *pdev = to_pci_dev(dev);
1436 if (a == &dev_attr_boot_vga.attr)
1437 if ((pdev->class >> 8) != PCI_CLASS_DISPLAY_VGA)
1443 static struct attribute *pci_dev_hp_attrs[] = {
1444 &dev_attr_remove.attr,
1445 &dev_attr_dev_rescan.attr,
1449 static umode_t pci_dev_hp_attrs_are_visible(struct kobject *kobj,
1450 struct attribute *a, int n)
1452 struct device *dev = kobj_to_dev(kobj);
1453 struct pci_dev *pdev = to_pci_dev(dev);
1455 if (pdev->is_virtfn)
1461 static umode_t pci_bridge_attrs_are_visible(struct kobject *kobj,
1462 struct attribute *a, int n)
1464 struct device *dev = kobj_to_dev(kobj);
1465 struct pci_dev *pdev = to_pci_dev(dev);
1467 if (pci_is_bridge(pdev))
1473 static umode_t pcie_dev_attrs_are_visible(struct kobject *kobj,
1474 struct attribute *a, int n)
1476 struct device *dev = kobj_to_dev(kobj);
1477 struct pci_dev *pdev = to_pci_dev(dev);
1479 if (pci_is_pcie(pdev))
1485 static const struct attribute_group pci_dev_group = {
1486 .attrs = pci_dev_attrs,
1489 const struct attribute_group *pci_dev_groups[] = {
1491 &pci_dev_config_attr_group,
1492 &pci_dev_rom_attr_group,
1493 &pci_dev_reset_attr_group,
1494 &pci_dev_vpd_attr_group,
1496 &pci_dev_smbios_attr_group,
1499 &pci_dev_acpi_attr_group,
1504 static const struct attribute_group pci_dev_hp_attr_group = {
1505 .attrs = pci_dev_hp_attrs,
1506 .is_visible = pci_dev_hp_attrs_are_visible,
1509 static const struct attribute_group pci_dev_attr_group = {
1510 .attrs = pci_dev_dev_attrs,
1511 .is_visible = pci_dev_attrs_are_visible,
1514 static const struct attribute_group pci_bridge_attr_group = {
1515 .attrs = pci_bridge_attrs,
1516 .is_visible = pci_bridge_attrs_are_visible,
1519 static const struct attribute_group pcie_dev_attr_group = {
1520 .attrs = pcie_dev_attrs,
1521 .is_visible = pcie_dev_attrs_are_visible,
1524 static const struct attribute_group *pci_dev_attr_groups[] = {
1525 &pci_dev_attr_group,
1526 &pci_dev_hp_attr_group,
1527 #ifdef CONFIG_PCI_IOV
1528 &sriov_pf_dev_attr_group,
1529 &sriov_vf_dev_attr_group,
1531 &pci_bridge_attr_group,
1532 &pcie_dev_attr_group,
1533 #ifdef CONFIG_PCIEAER
1534 &aer_stats_attr_group,
1536 #ifdef CONFIG_PCIEASPM
1537 &aspm_ctrl_attr_group,
1542 const struct device_type pci_dev_type = {
1543 .groups = pci_dev_attr_groups,