2 * drivers/pci/pci-sysfs.c
4 * (C) Copyright 2002-2004 Greg Kroah-Hartman <greg@kroah.com>
5 * (C) Copyright 2002-2004 IBM Corp.
6 * (C) Copyright 2003 Matthew Wilcox
7 * (C) Copyright 2003 Hewlett-Packard
8 * (C) Copyright 2004 Jon Smirl <jonsmirl@yahoo.com>
9 * (C) Copyright 2004 Silicon Graphics, Inc. Jesse Barnes <jbarnes@sgi.com>
11 * File attributes for PCI devices
13 * Modeled after usb's driverfs.c
18 #include <linux/kernel.h>
19 #include <linux/sched.h>
20 #include <linux/pci.h>
21 #include <linux/stat.h>
22 #include <linux/export.h>
23 #include <linux/topology.h>
26 #include <linux/capability.h>
27 #include <linux/security.h>
28 #include <linux/pci-aspm.h>
29 #include <linux/slab.h>
30 #include <linux/vgaarb.h>
31 #include <linux/pm_runtime.h>
35 static int sysfs_initialized; /* = 0 */
37 /* show configuration fields */
38 #define pci_config_attr(field, format_string) \
40 field##_show(struct device *dev, struct device_attribute *attr, char *buf) \
42 struct pci_dev *pdev; \
44 pdev = to_pci_dev(dev); \
45 return sprintf(buf, format_string, pdev->field); \
47 static DEVICE_ATTR_RO(field)
49 pci_config_attr(vendor, "0x%04x\n");
50 pci_config_attr(device, "0x%04x\n");
51 pci_config_attr(subsystem_vendor, "0x%04x\n");
52 pci_config_attr(subsystem_device, "0x%04x\n");
53 pci_config_attr(class, "0x%06x\n");
54 pci_config_attr(irq, "%u\n");
56 static ssize_t broken_parity_status_show(struct device *dev,
57 struct device_attribute *attr,
60 struct pci_dev *pdev = to_pci_dev(dev);
61 return sprintf(buf, "%u\n", pdev->broken_parity_status);
64 static ssize_t broken_parity_status_store(struct device *dev,
65 struct device_attribute *attr,
66 const char *buf, size_t count)
68 struct pci_dev *pdev = to_pci_dev(dev);
71 if (kstrtoul(buf, 0, &val) < 0)
74 pdev->broken_parity_status = !!val;
78 static DEVICE_ATTR_RW(broken_parity_status);
80 static ssize_t pci_dev_show_local_cpu(struct device *dev, bool list,
81 struct device_attribute *attr, char *buf)
83 const struct cpumask *mask;
86 mask = (dev_to_node(dev) == -1) ? cpu_online_mask :
87 cpumask_of_node(dev_to_node(dev));
89 mask = cpumask_of_pcibus(to_pci_dev(dev)->bus);
91 return cpumap_print_to_pagebuf(list, buf, mask);
94 static ssize_t local_cpus_show(struct device *dev,
95 struct device_attribute *attr, char *buf)
97 return pci_dev_show_local_cpu(dev, false, attr, buf);
99 static DEVICE_ATTR_RO(local_cpus);
101 static ssize_t local_cpulist_show(struct device *dev,
102 struct device_attribute *attr, char *buf)
104 return pci_dev_show_local_cpu(dev, true, attr, buf);
106 static DEVICE_ATTR_RO(local_cpulist);
109 * PCI Bus Class Devices
111 static ssize_t cpuaffinity_show(struct device *dev,
112 struct device_attribute *attr, char *buf)
114 const struct cpumask *cpumask = cpumask_of_pcibus(to_pci_bus(dev));
116 return cpumap_print_to_pagebuf(false, buf, cpumask);
118 static DEVICE_ATTR_RO(cpuaffinity);
120 static ssize_t cpulistaffinity_show(struct device *dev,
121 struct device_attribute *attr, char *buf)
123 const struct cpumask *cpumask = cpumask_of_pcibus(to_pci_bus(dev));
125 return cpumap_print_to_pagebuf(true, buf, cpumask);
127 static DEVICE_ATTR_RO(cpulistaffinity);
130 static ssize_t resource_show(struct device *dev, struct device_attribute *attr,
133 struct pci_dev *pci_dev = to_pci_dev(dev);
137 resource_size_t start, end;
139 if (pci_dev->subordinate)
140 max = DEVICE_COUNT_RESOURCE;
142 max = PCI_BRIDGE_RESOURCES;
144 for (i = 0; i < max; i++) {
145 struct resource *res = &pci_dev->resource[i];
146 pci_resource_to_user(pci_dev, i, res, &start, &end);
147 str += sprintf(str, "0x%016llx 0x%016llx 0x%016llx\n",
148 (unsigned long long)start,
149 (unsigned long long)end,
150 (unsigned long long)res->flags);
154 static DEVICE_ATTR_RO(resource);
156 static ssize_t modalias_show(struct device *dev, struct device_attribute *attr,
159 struct pci_dev *pci_dev = to_pci_dev(dev);
161 return sprintf(buf, "pci:v%08Xd%08Xsv%08Xsd%08Xbc%02Xsc%02Xi%02X\n",
162 pci_dev->vendor, pci_dev->device,
163 pci_dev->subsystem_vendor, pci_dev->subsystem_device,
164 (u8)(pci_dev->class >> 16), (u8)(pci_dev->class >> 8),
165 (u8)(pci_dev->class));
167 static DEVICE_ATTR_RO(modalias);
169 static ssize_t enable_store(struct device *dev, struct device_attribute *attr,
170 const char *buf, size_t count)
172 struct pci_dev *pdev = to_pci_dev(dev);
174 ssize_t result = kstrtoul(buf, 0, &val);
179 /* this can crash the machine when done on the "wrong" device */
180 if (!capable(CAP_SYS_ADMIN))
187 result = pci_enable_device(pdev);
188 else if (pci_is_enabled(pdev))
189 pci_disable_device(pdev);
194 return result < 0 ? result : count;
197 static ssize_t enable_show(struct device *dev, struct device_attribute *attr,
200 struct pci_dev *pdev;
202 pdev = to_pci_dev(dev);
203 return sprintf(buf, "%u\n", atomic_read(&pdev->enable_cnt));
205 static DEVICE_ATTR_RW(enable);
208 static ssize_t numa_node_store(struct device *dev,
209 struct device_attribute *attr, const char *buf,
212 struct pci_dev *pdev = to_pci_dev(dev);
215 if (!capable(CAP_SYS_ADMIN))
218 ret = kstrtoint(buf, 0, &node);
222 if ((node < 0 && node != NUMA_NO_NODE) || node >= MAX_NUMNODES)
225 if (node != NUMA_NO_NODE && !node_online(node))
228 add_taint(TAINT_FIRMWARE_WORKAROUND, LOCKDEP_STILL_OK);
229 dev_alert(&pdev->dev, FW_BUG "Overriding NUMA node to %d. Contact your vendor for updates.",
232 dev->numa_node = node;
236 static ssize_t numa_node_show(struct device *dev, struct device_attribute *attr,
239 return sprintf(buf, "%d\n", dev->numa_node);
241 static DEVICE_ATTR_RW(numa_node);
244 static ssize_t dma_mask_bits_show(struct device *dev,
245 struct device_attribute *attr, char *buf)
247 struct pci_dev *pdev = to_pci_dev(dev);
249 return sprintf(buf, "%d\n", fls64(pdev->dma_mask));
251 static DEVICE_ATTR_RO(dma_mask_bits);
253 static ssize_t consistent_dma_mask_bits_show(struct device *dev,
254 struct device_attribute *attr,
257 return sprintf(buf, "%d\n", fls64(dev->coherent_dma_mask));
259 static DEVICE_ATTR_RO(consistent_dma_mask_bits);
261 static ssize_t msi_bus_show(struct device *dev, struct device_attribute *attr,
264 struct pci_dev *pdev = to_pci_dev(dev);
265 struct pci_bus *subordinate = pdev->subordinate;
267 return sprintf(buf, "%u\n", subordinate ?
268 !(subordinate->bus_flags & PCI_BUS_FLAGS_NO_MSI)
272 static ssize_t msi_bus_store(struct device *dev, struct device_attribute *attr,
273 const char *buf, size_t count)
275 struct pci_dev *pdev = to_pci_dev(dev);
276 struct pci_bus *subordinate = pdev->subordinate;
279 if (kstrtoul(buf, 0, &val) < 0)
282 if (!capable(CAP_SYS_ADMIN))
286 * "no_msi" and "bus_flags" only affect what happens when a driver
287 * requests MSI or MSI-X. They don't affect any drivers that have
288 * already requested MSI or MSI-X.
292 dev_info(&pdev->dev, "MSI/MSI-X %s for future drivers\n",
293 val ? "allowed" : "disallowed");
298 subordinate->bus_flags &= ~PCI_BUS_FLAGS_NO_MSI;
300 subordinate->bus_flags |= PCI_BUS_FLAGS_NO_MSI;
302 dev_info(&subordinate->dev, "MSI/MSI-X %s for future drivers of devices on this bus\n",
303 val ? "allowed" : "disallowed");
306 static DEVICE_ATTR_RW(msi_bus);
308 static ssize_t bus_rescan_store(struct bus_type *bus, const char *buf,
312 struct pci_bus *b = NULL;
314 if (kstrtoul(buf, 0, &val) < 0)
318 pci_lock_rescan_remove();
319 while ((b = pci_find_next_bus(b)) != NULL)
321 pci_unlock_rescan_remove();
325 static BUS_ATTR(rescan, (S_IWUSR|S_IWGRP), NULL, bus_rescan_store);
327 static struct attribute *pci_bus_attrs[] = {
328 &bus_attr_rescan.attr,
332 static const struct attribute_group pci_bus_group = {
333 .attrs = pci_bus_attrs,
336 const struct attribute_group *pci_bus_groups[] = {
341 static ssize_t dev_rescan_store(struct device *dev,
342 struct device_attribute *attr, const char *buf,
346 struct pci_dev *pdev = to_pci_dev(dev);
348 if (kstrtoul(buf, 0, &val) < 0)
352 pci_lock_rescan_remove();
353 pci_rescan_bus(pdev->bus);
354 pci_unlock_rescan_remove();
358 static struct device_attribute dev_rescan_attr = __ATTR(rescan,
360 NULL, dev_rescan_store);
362 static ssize_t remove_store(struct device *dev, struct device_attribute *attr,
363 const char *buf, size_t count)
367 if (kstrtoul(buf, 0, &val) < 0)
370 if (val && device_remove_file_self(dev, attr))
371 pci_stop_and_remove_bus_device_locked(to_pci_dev(dev));
374 static struct device_attribute dev_remove_attr = __ATTR_IGNORE_LOCKDEP(remove,
378 static ssize_t dev_bus_rescan_store(struct device *dev,
379 struct device_attribute *attr,
380 const char *buf, size_t count)
383 struct pci_bus *bus = to_pci_bus(dev);
385 if (kstrtoul(buf, 0, &val) < 0)
389 pci_lock_rescan_remove();
390 if (!pci_is_root_bus(bus) && list_empty(&bus->devices))
391 pci_rescan_bus_bridge_resize(bus->self);
394 pci_unlock_rescan_remove();
398 static DEVICE_ATTR(rescan, (S_IWUSR|S_IWGRP), NULL, dev_bus_rescan_store);
400 #if defined(CONFIG_PM) && defined(CONFIG_ACPI)
401 static ssize_t d3cold_allowed_store(struct device *dev,
402 struct device_attribute *attr,
403 const char *buf, size_t count)
405 struct pci_dev *pdev = to_pci_dev(dev);
408 if (kstrtoul(buf, 0, &val) < 0)
411 pdev->d3cold_allowed = !!val;
412 if (pdev->d3cold_allowed)
413 pci_d3cold_enable(pdev);
415 pci_d3cold_disable(pdev);
417 pm_runtime_resume(dev);
422 static ssize_t d3cold_allowed_show(struct device *dev,
423 struct device_attribute *attr, char *buf)
425 struct pci_dev *pdev = to_pci_dev(dev);
426 return sprintf(buf, "%u\n", pdev->d3cold_allowed);
428 static DEVICE_ATTR_RW(d3cold_allowed);
432 static ssize_t devspec_show(struct device *dev,
433 struct device_attribute *attr, char *buf)
435 struct pci_dev *pdev = to_pci_dev(dev);
436 struct device_node *np = pci_device_to_OF_node(pdev);
438 if (np == NULL || np->full_name == NULL)
440 return sprintf(buf, "%s", np->full_name);
442 static DEVICE_ATTR_RO(devspec);
445 #ifdef CONFIG_PCI_IOV
446 static ssize_t sriov_totalvfs_show(struct device *dev,
447 struct device_attribute *attr,
450 struct pci_dev *pdev = to_pci_dev(dev);
452 return sprintf(buf, "%u\n", pci_sriov_get_totalvfs(pdev));
456 static ssize_t sriov_numvfs_show(struct device *dev,
457 struct device_attribute *attr,
460 struct pci_dev *pdev = to_pci_dev(dev);
462 return sprintf(buf, "%u\n", pdev->sriov->num_VFs);
466 * num_vfs > 0; number of VFs to enable
467 * num_vfs = 0; disable all VFs
469 * Note: SRIOV spec doesn't allow partial VF
470 * disable, so it's all or none.
472 static ssize_t sriov_numvfs_store(struct device *dev,
473 struct device_attribute *attr,
474 const char *buf, size_t count)
476 struct pci_dev *pdev = to_pci_dev(dev);
480 ret = kstrtou16(buf, 0, &num_vfs);
484 if (num_vfs > pci_sriov_get_totalvfs(pdev))
487 if (num_vfs == pdev->sriov->num_VFs)
488 return count; /* no change */
490 /* is PF driver loaded w/callback */
491 if (!pdev->driver || !pdev->driver->sriov_configure) {
492 dev_info(&pdev->dev, "Driver doesn't support SRIOV configuration via sysfs\n");
498 ret = pdev->driver->sriov_configure(pdev, 0);
505 if (pdev->sriov->num_VFs) {
506 dev_warn(&pdev->dev, "%d VFs already enabled. Disable before enabling %d VFs\n",
507 pdev->sriov->num_VFs, num_vfs);
511 ret = pdev->driver->sriov_configure(pdev, num_vfs);
516 dev_warn(&pdev->dev, "%d VFs requested; only %d enabled\n",
522 static struct device_attribute sriov_totalvfs_attr = __ATTR_RO(sriov_totalvfs);
523 static struct device_attribute sriov_numvfs_attr =
524 __ATTR(sriov_numvfs, (S_IRUGO|S_IWUSR|S_IWGRP),
525 sriov_numvfs_show, sriov_numvfs_store);
526 #endif /* CONFIG_PCI_IOV */
528 static ssize_t driver_override_store(struct device *dev,
529 struct device_attribute *attr,
530 const char *buf, size_t count)
532 struct pci_dev *pdev = to_pci_dev(dev);
533 char *driver_override, *old, *cp;
535 /* We need to keep extra room for a newline */
536 if (count >= (PAGE_SIZE - 1))
539 driver_override = kstrndup(buf, count, GFP_KERNEL);
540 if (!driver_override)
543 cp = strchr(driver_override, '\n');
548 old = pdev->driver_override;
549 if (strlen(driver_override)) {
550 pdev->driver_override = driver_override;
552 kfree(driver_override);
553 pdev->driver_override = NULL;
562 static ssize_t driver_override_show(struct device *dev,
563 struct device_attribute *attr, char *buf)
565 struct pci_dev *pdev = to_pci_dev(dev);
569 len = snprintf(buf, PAGE_SIZE, "%s\n", pdev->driver_override);
573 static DEVICE_ATTR_RW(driver_override);
575 static struct attribute *pci_dev_attrs[] = {
576 &dev_attr_resource.attr,
577 &dev_attr_vendor.attr,
578 &dev_attr_device.attr,
579 &dev_attr_subsystem_vendor.attr,
580 &dev_attr_subsystem_device.attr,
581 &dev_attr_class.attr,
583 &dev_attr_local_cpus.attr,
584 &dev_attr_local_cpulist.attr,
585 &dev_attr_modalias.attr,
587 &dev_attr_numa_node.attr,
589 &dev_attr_dma_mask_bits.attr,
590 &dev_attr_consistent_dma_mask_bits.attr,
591 &dev_attr_enable.attr,
592 &dev_attr_broken_parity_status.attr,
593 &dev_attr_msi_bus.attr,
594 #if defined(CONFIG_PM) && defined(CONFIG_ACPI)
595 &dev_attr_d3cold_allowed.attr,
598 &dev_attr_devspec.attr,
600 &dev_attr_driver_override.attr,
604 static const struct attribute_group pci_dev_group = {
605 .attrs = pci_dev_attrs,
608 const struct attribute_group *pci_dev_groups[] = {
613 static struct attribute *pcibus_attrs[] = {
614 &dev_attr_rescan.attr,
615 &dev_attr_cpuaffinity.attr,
616 &dev_attr_cpulistaffinity.attr,
620 static const struct attribute_group pcibus_group = {
621 .attrs = pcibus_attrs,
624 const struct attribute_group *pcibus_groups[] = {
629 static ssize_t boot_vga_show(struct device *dev, struct device_attribute *attr,
632 struct pci_dev *pdev = to_pci_dev(dev);
633 struct pci_dev *vga_dev = vga_default_device();
636 return sprintf(buf, "%u\n", (pdev == vga_dev));
638 return sprintf(buf, "%u\n",
639 !!(pdev->resource[PCI_ROM_RESOURCE].flags &
640 IORESOURCE_ROM_SHADOW));
642 static struct device_attribute vga_attr = __ATTR_RO(boot_vga);
644 static ssize_t pci_read_config(struct file *filp, struct kobject *kobj,
645 struct bin_attribute *bin_attr, char *buf,
646 loff_t off, size_t count)
648 struct pci_dev *dev = to_pci_dev(kobj_to_dev(kobj));
649 unsigned int size = 64;
650 loff_t init_off = off;
651 u8 *data = (u8 *) buf;
653 /* Several chips lock up trying to read undefined config space */
654 if (file_ns_capable(filp, &init_user_ns, CAP_SYS_ADMIN))
655 size = dev->cfg_size;
656 else if (dev->hdr_type == PCI_HEADER_TYPE_CARDBUS)
661 if (off + count > size) {
668 pci_config_pm_runtime_get(dev);
670 if ((off & 1) && size) {
672 pci_user_read_config_byte(dev, off, &val);
673 data[off - init_off] = val;
678 if ((off & 3) && size > 2) {
680 pci_user_read_config_word(dev, off, &val);
681 data[off - init_off] = val & 0xff;
682 data[off - init_off + 1] = (val >> 8) & 0xff;
689 pci_user_read_config_dword(dev, off, &val);
690 data[off - init_off] = val & 0xff;
691 data[off - init_off + 1] = (val >> 8) & 0xff;
692 data[off - init_off + 2] = (val >> 16) & 0xff;
693 data[off - init_off + 3] = (val >> 24) & 0xff;
700 pci_user_read_config_word(dev, off, &val);
701 data[off - init_off] = val & 0xff;
702 data[off - init_off + 1] = (val >> 8) & 0xff;
709 pci_user_read_config_byte(dev, off, &val);
710 data[off - init_off] = val;
715 pci_config_pm_runtime_put(dev);
720 static ssize_t pci_write_config(struct file *filp, struct kobject *kobj,
721 struct bin_attribute *bin_attr, char *buf,
722 loff_t off, size_t count)
724 struct pci_dev *dev = to_pci_dev(kobj_to_dev(kobj));
725 unsigned int size = count;
726 loff_t init_off = off;
727 u8 *data = (u8 *) buf;
729 if (off > dev->cfg_size)
731 if (off + count > dev->cfg_size) {
732 size = dev->cfg_size - off;
736 pci_config_pm_runtime_get(dev);
738 if ((off & 1) && size) {
739 pci_user_write_config_byte(dev, off, data[off - init_off]);
744 if ((off & 3) && size > 2) {
745 u16 val = data[off - init_off];
746 val |= (u16) data[off - init_off + 1] << 8;
747 pci_user_write_config_word(dev, off, val);
753 u32 val = data[off - init_off];
754 val |= (u32) data[off - init_off + 1] << 8;
755 val |= (u32) data[off - init_off + 2] << 16;
756 val |= (u32) data[off - init_off + 3] << 24;
757 pci_user_write_config_dword(dev, off, val);
763 u16 val = data[off - init_off];
764 val |= (u16) data[off - init_off + 1] << 8;
765 pci_user_write_config_word(dev, off, val);
771 pci_user_write_config_byte(dev, off, data[off - init_off]);
776 pci_config_pm_runtime_put(dev);
781 static ssize_t read_vpd_attr(struct file *filp, struct kobject *kobj,
782 struct bin_attribute *bin_attr, char *buf,
783 loff_t off, size_t count)
785 struct pci_dev *dev = to_pci_dev(kobj_to_dev(kobj));
787 if (bin_attr->size > 0) {
788 if (off > bin_attr->size)
790 else if (count > bin_attr->size - off)
791 count = bin_attr->size - off;
794 return pci_read_vpd(dev, off, count, buf);
797 static ssize_t write_vpd_attr(struct file *filp, struct kobject *kobj,
798 struct bin_attribute *bin_attr, char *buf,
799 loff_t off, size_t count)
801 struct pci_dev *dev = to_pci_dev(kobj_to_dev(kobj));
803 if (bin_attr->size > 0) {
804 if (off > bin_attr->size)
806 else if (count > bin_attr->size - off)
807 count = bin_attr->size - off;
810 return pci_write_vpd(dev, off, count, buf);
813 #ifdef HAVE_PCI_LEGACY
815 * pci_read_legacy_io - read byte(s) from legacy I/O port space
816 * @filp: open sysfs file
817 * @kobj: kobject corresponding to file to read from
818 * @bin_attr: struct bin_attribute for this file
819 * @buf: buffer to store results
820 * @off: offset into legacy I/O port space
821 * @count: number of bytes to read
823 * Reads 1, 2, or 4 bytes from legacy I/O port space using an arch specific
824 * callback routine (pci_legacy_read).
826 static ssize_t pci_read_legacy_io(struct file *filp, struct kobject *kobj,
827 struct bin_attribute *bin_attr, char *buf,
828 loff_t off, size_t count)
830 struct pci_bus *bus = to_pci_bus(kobj_to_dev(kobj));
832 /* Only support 1, 2 or 4 byte accesses */
833 if (count != 1 && count != 2 && count != 4)
836 return pci_legacy_read(bus, off, (u32 *)buf, count);
840 * pci_write_legacy_io - write byte(s) to legacy I/O port space
841 * @filp: open sysfs file
842 * @kobj: kobject corresponding to file to read from
843 * @bin_attr: struct bin_attribute for this file
844 * @buf: buffer containing value to be written
845 * @off: offset into legacy I/O port space
846 * @count: number of bytes to write
848 * Writes 1, 2, or 4 bytes from legacy I/O port space using an arch specific
849 * callback routine (pci_legacy_write).
851 static ssize_t pci_write_legacy_io(struct file *filp, struct kobject *kobj,
852 struct bin_attribute *bin_attr, char *buf,
853 loff_t off, size_t count)
855 struct pci_bus *bus = to_pci_bus(kobj_to_dev(kobj));
857 /* Only support 1, 2 or 4 byte accesses */
858 if (count != 1 && count != 2 && count != 4)
861 return pci_legacy_write(bus, off, *(u32 *)buf, count);
865 * pci_mmap_legacy_mem - map legacy PCI memory into user memory space
866 * @filp: open sysfs file
867 * @kobj: kobject corresponding to device to be mapped
868 * @attr: struct bin_attribute for this file
869 * @vma: struct vm_area_struct passed to mmap
871 * Uses an arch specific callback, pci_mmap_legacy_mem_page_range, to mmap
872 * legacy memory space (first meg of bus space) into application virtual
875 static int pci_mmap_legacy_mem(struct file *filp, struct kobject *kobj,
876 struct bin_attribute *attr,
877 struct vm_area_struct *vma)
879 struct pci_bus *bus = to_pci_bus(kobj_to_dev(kobj));
881 return pci_mmap_legacy_page_range(bus, vma, pci_mmap_mem);
885 * pci_mmap_legacy_io - map legacy PCI IO into user memory space
886 * @filp: open sysfs file
887 * @kobj: kobject corresponding to device to be mapped
888 * @attr: struct bin_attribute for this file
889 * @vma: struct vm_area_struct passed to mmap
891 * Uses an arch specific callback, pci_mmap_legacy_io_page_range, to mmap
892 * legacy IO space (first meg of bus space) into application virtual
893 * memory space. Returns -ENOSYS if the operation isn't supported
895 static int pci_mmap_legacy_io(struct file *filp, struct kobject *kobj,
896 struct bin_attribute *attr,
897 struct vm_area_struct *vma)
899 struct pci_bus *bus = to_pci_bus(kobj_to_dev(kobj));
901 return pci_mmap_legacy_page_range(bus, vma, pci_mmap_io);
905 * pci_adjust_legacy_attr - adjustment of legacy file attributes
906 * @b: bus to create files under
907 * @mmap_type: I/O port or memory
909 * Stub implementation. Can be overridden by arch if necessary.
911 void __weak pci_adjust_legacy_attr(struct pci_bus *b,
912 enum pci_mmap_state mmap_type)
917 * pci_create_legacy_files - create legacy I/O port and memory files
918 * @b: bus to create files under
920 * Some platforms allow access to legacy I/O port and ISA memory space on
921 * a per-bus basis. This routine creates the files and ties them into
922 * their associated read, write and mmap files from pci-sysfs.c
924 * On error unwind, but don't propagate the error to the caller
925 * as it is ok to set up the PCI bus without these files.
927 void pci_create_legacy_files(struct pci_bus *b)
931 b->legacy_io = kzalloc(sizeof(struct bin_attribute) * 2,
936 sysfs_bin_attr_init(b->legacy_io);
937 b->legacy_io->attr.name = "legacy_io";
938 b->legacy_io->size = 0xffff;
939 b->legacy_io->attr.mode = S_IRUSR | S_IWUSR;
940 b->legacy_io->read = pci_read_legacy_io;
941 b->legacy_io->write = pci_write_legacy_io;
942 b->legacy_io->mmap = pci_mmap_legacy_io;
943 pci_adjust_legacy_attr(b, pci_mmap_io);
944 error = device_create_bin_file(&b->dev, b->legacy_io);
948 /* Allocated above after the legacy_io struct */
949 b->legacy_mem = b->legacy_io + 1;
950 sysfs_bin_attr_init(b->legacy_mem);
951 b->legacy_mem->attr.name = "legacy_mem";
952 b->legacy_mem->size = 1024*1024;
953 b->legacy_mem->attr.mode = S_IRUSR | S_IWUSR;
954 b->legacy_mem->mmap = pci_mmap_legacy_mem;
955 pci_adjust_legacy_attr(b, pci_mmap_mem);
956 error = device_create_bin_file(&b->dev, b->legacy_mem);
963 device_remove_bin_file(&b->dev, b->legacy_io);
968 printk(KERN_WARNING "pci: warning: could not create legacy I/O port and ISA memory resources to sysfs\n");
972 void pci_remove_legacy_files(struct pci_bus *b)
975 device_remove_bin_file(&b->dev, b->legacy_io);
976 device_remove_bin_file(&b->dev, b->legacy_mem);
977 kfree(b->legacy_io); /* both are allocated here */
980 #endif /* HAVE_PCI_LEGACY */
984 int pci_mmap_fits(struct pci_dev *pdev, int resno, struct vm_area_struct *vma,
985 enum pci_mmap_api mmap_api)
987 unsigned long nr, start, size;
988 resource_size_t pci_start = 0, pci_end;
990 if (pci_resource_len(pdev, resno) == 0)
993 start = vma->vm_pgoff;
994 size = ((pci_resource_len(pdev, resno) - 1) >> PAGE_SHIFT) + 1;
995 if (mmap_api == PCI_MMAP_PROCFS) {
996 pci_resource_to_user(pdev, resno, &pdev->resource[resno],
997 &pci_start, &pci_end);
998 pci_start >>= PAGE_SHIFT;
1000 if (start >= pci_start && start < pci_start + size &&
1001 start + nr <= pci_start + size)
1007 * pci_mmap_resource - map a PCI resource into user memory space
1008 * @kobj: kobject for mapping
1009 * @attr: struct bin_attribute for the file being mapped
1010 * @vma: struct vm_area_struct passed into the mmap
1011 * @write_combine: 1 for write_combine mapping
1013 * Use the regular PCI mapping routines to map a PCI resource into userspace.
1015 static int pci_mmap_resource(struct kobject *kobj, struct bin_attribute *attr,
1016 struct vm_area_struct *vma, int write_combine)
1018 struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
1019 struct resource *res = attr->private;
1020 enum pci_mmap_state mmap_type;
1021 resource_size_t start, end;
1024 for (i = 0; i < PCI_ROM_RESOURCE; i++)
1025 if (res == &pdev->resource[i])
1027 if (i >= PCI_ROM_RESOURCE)
1030 if (res->flags & IORESOURCE_MEM && iomem_is_exclusive(res->start))
1033 if (!pci_mmap_fits(pdev, i, vma, PCI_MMAP_SYSFS)) {
1034 WARN(1, "process \"%s\" tried to map 0x%08lx bytes at page 0x%08lx on %s BAR %d (start 0x%16Lx, size 0x%16Lx)\n",
1035 current->comm, vma->vm_end-vma->vm_start, vma->vm_pgoff,
1037 (u64)pci_resource_start(pdev, i),
1038 (u64)pci_resource_len(pdev, i));
1042 /* pci_mmap_page_range() expects the same kind of entry as coming
1043 * from /proc/bus/pci/ which is a "user visible" value. If this is
1044 * different from the resource itself, arch will do necessary fixup.
1046 pci_resource_to_user(pdev, i, res, &start, &end);
1047 vma->vm_pgoff += start >> PAGE_SHIFT;
1048 mmap_type = res->flags & IORESOURCE_MEM ? pci_mmap_mem : pci_mmap_io;
1049 return pci_mmap_page_range(pdev, vma, mmap_type, write_combine);
1052 static int pci_mmap_resource_uc(struct file *filp, struct kobject *kobj,
1053 struct bin_attribute *attr,
1054 struct vm_area_struct *vma)
1056 return pci_mmap_resource(kobj, attr, vma, 0);
1059 static int pci_mmap_resource_wc(struct file *filp, struct kobject *kobj,
1060 struct bin_attribute *attr,
1061 struct vm_area_struct *vma)
1063 return pci_mmap_resource(kobj, attr, vma, 1);
1066 static ssize_t pci_resource_io(struct file *filp, struct kobject *kobj,
1067 struct bin_attribute *attr, char *buf,
1068 loff_t off, size_t count, bool write)
1070 struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
1071 struct resource *res = attr->private;
1072 unsigned long port = off;
1075 for (i = 0; i < PCI_ROM_RESOURCE; i++)
1076 if (res == &pdev->resource[i])
1078 if (i >= PCI_ROM_RESOURCE)
1081 port += pci_resource_start(pdev, i);
1083 if (port > pci_resource_end(pdev, i))
1086 if (port + count - 1 > pci_resource_end(pdev, i))
1092 outb(*(u8 *)buf, port);
1094 *(u8 *)buf = inb(port);
1098 outw(*(u16 *)buf, port);
1100 *(u16 *)buf = inw(port);
1104 outl(*(u32 *)buf, port);
1106 *(u32 *)buf = inl(port);
1112 static ssize_t pci_read_resource_io(struct file *filp, struct kobject *kobj,
1113 struct bin_attribute *attr, char *buf,
1114 loff_t off, size_t count)
1116 return pci_resource_io(filp, kobj, attr, buf, off, count, false);
1119 static ssize_t pci_write_resource_io(struct file *filp, struct kobject *kobj,
1120 struct bin_attribute *attr, char *buf,
1121 loff_t off, size_t count)
1123 return pci_resource_io(filp, kobj, attr, buf, off, count, true);
1127 * pci_remove_resource_files - cleanup resource files
1128 * @pdev: dev to cleanup
1130 * If we created resource files for @pdev, remove them from sysfs and
1131 * free their resources.
1133 static void pci_remove_resource_files(struct pci_dev *pdev)
1137 for (i = 0; i < PCI_ROM_RESOURCE; i++) {
1138 struct bin_attribute *res_attr;
1140 res_attr = pdev->res_attr[i];
1142 sysfs_remove_bin_file(&pdev->dev.kobj, res_attr);
1146 res_attr = pdev->res_attr_wc[i];
1148 sysfs_remove_bin_file(&pdev->dev.kobj, res_attr);
1154 static int pci_create_attr(struct pci_dev *pdev, int num, int write_combine)
1156 /* allocate attribute structure, piggyback attribute name */
1157 int name_len = write_combine ? 13 : 10;
1158 struct bin_attribute *res_attr;
1159 char *res_attr_name;
1162 res_attr = kzalloc(sizeof(*res_attr) + name_len, GFP_ATOMIC);
1166 res_attr_name = (char *)(res_attr + 1);
1168 sysfs_bin_attr_init(res_attr);
1169 if (write_combine) {
1170 pdev->res_attr_wc[num] = res_attr;
1171 sprintf(res_attr_name, "resource%d_wc", num);
1172 res_attr->mmap = pci_mmap_resource_wc;
1174 pdev->res_attr[num] = res_attr;
1175 sprintf(res_attr_name, "resource%d", num);
1176 res_attr->mmap = pci_mmap_resource_uc;
1178 if (pci_resource_flags(pdev, num) & IORESOURCE_IO) {
1179 res_attr->read = pci_read_resource_io;
1180 res_attr->write = pci_write_resource_io;
1182 res_attr->attr.name = res_attr_name;
1183 res_attr->attr.mode = S_IRUSR | S_IWUSR;
1184 res_attr->size = pci_resource_len(pdev, num);
1185 res_attr->private = &pdev->resource[num];
1186 retval = sysfs_create_bin_file(&pdev->dev.kobj, res_attr);
1194 * pci_create_resource_files - create resource files in sysfs for @dev
1195 * @pdev: dev in question
1197 * Walk the resources in @pdev creating files for each resource available.
1199 static int pci_create_resource_files(struct pci_dev *pdev)
1204 /* Expose the PCI resources from this device as files */
1205 for (i = 0; i < PCI_ROM_RESOURCE; i++) {
1207 /* skip empty resources */
1208 if (!pci_resource_len(pdev, i))
1211 retval = pci_create_attr(pdev, i, 0);
1212 /* for prefetchable resources, create a WC mappable file */
1213 if (!retval && pdev->resource[i].flags & IORESOURCE_PREFETCH)
1214 retval = pci_create_attr(pdev, i, 1);
1217 pci_remove_resource_files(pdev);
1223 #else /* !HAVE_PCI_MMAP */
1224 int __weak pci_create_resource_files(struct pci_dev *dev) { return 0; }
1225 void __weak pci_remove_resource_files(struct pci_dev *dev) { return; }
1226 #endif /* HAVE_PCI_MMAP */
1229 * pci_write_rom - used to enable access to the PCI ROM display
1231 * @kobj: kernel object handle
1232 * @bin_attr: struct bin_attribute for this file
1235 * @count: number of byte in input
1237 * writing anything except 0 enables it
1239 static ssize_t pci_write_rom(struct file *filp, struct kobject *kobj,
1240 struct bin_attribute *bin_attr, char *buf,
1241 loff_t off, size_t count)
1243 struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
1245 if ((off == 0) && (*buf == '0') && (count == 2))
1246 pdev->rom_attr_enabled = 0;
1248 pdev->rom_attr_enabled = 1;
1254 * pci_read_rom - read a PCI ROM
1256 * @kobj: kernel object handle
1257 * @bin_attr: struct bin_attribute for this file
1258 * @buf: where to put the data we read from the ROM
1260 * @count: number of bytes to read
1262 * Put @count bytes starting at @off into @buf from the ROM in the PCI
1263 * device corresponding to @kobj.
1265 static ssize_t pci_read_rom(struct file *filp, struct kobject *kobj,
1266 struct bin_attribute *bin_attr, char *buf,
1267 loff_t off, size_t count)
1269 struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
1273 if (!pdev->rom_attr_enabled)
1276 rom = pci_map_rom(pdev, &size); /* size starts out as PCI window size */
1283 if (off + count > size)
1286 memcpy_fromio(buf, rom + off, count);
1288 pci_unmap_rom(pdev, rom);
1293 static struct bin_attribute pci_config_attr = {
1296 .mode = S_IRUGO | S_IWUSR,
1298 .size = PCI_CFG_SPACE_SIZE,
1299 .read = pci_read_config,
1300 .write = pci_write_config,
1303 static struct bin_attribute pcie_config_attr = {
1306 .mode = S_IRUGO | S_IWUSR,
1308 .size = PCI_CFG_SPACE_EXP_SIZE,
1309 .read = pci_read_config,
1310 .write = pci_write_config,
1313 static ssize_t reset_store(struct device *dev, struct device_attribute *attr,
1314 const char *buf, size_t count)
1316 struct pci_dev *pdev = to_pci_dev(dev);
1318 ssize_t result = kstrtoul(buf, 0, &val);
1326 result = pci_reset_function(pdev);
1333 static struct device_attribute reset_attr = __ATTR(reset, 0200, NULL, reset_store);
1335 static int pci_create_capabilities_sysfs(struct pci_dev *dev)
1338 struct bin_attribute *attr;
1340 /* If the device has VPD, try to expose it in sysfs. */
1342 attr = kzalloc(sizeof(*attr), GFP_ATOMIC);
1346 sysfs_bin_attr_init(attr);
1348 attr->attr.name = "vpd";
1349 attr->attr.mode = S_IRUSR | S_IWUSR;
1350 attr->read = read_vpd_attr;
1351 attr->write = write_vpd_attr;
1352 retval = sysfs_create_bin_file(&dev->dev.kobj, attr);
1357 dev->vpd->attr = attr;
1360 /* Active State Power Management */
1361 pcie_aspm_create_sysfs_dev_files(dev);
1363 if (!pci_probe_reset_function(dev)) {
1364 retval = device_create_file(&dev->dev, &reset_attr);
1372 pcie_aspm_remove_sysfs_dev_files(dev);
1373 if (dev->vpd && dev->vpd->attr) {
1374 sysfs_remove_bin_file(&dev->dev.kobj, dev->vpd->attr);
1375 kfree(dev->vpd->attr);
1381 int __must_check pci_create_sysfs_dev_files(struct pci_dev *pdev)
1385 struct bin_attribute *attr;
1387 if (!sysfs_initialized)
1390 if (pdev->cfg_size > PCI_CFG_SPACE_SIZE)
1391 retval = sysfs_create_bin_file(&pdev->dev.kobj, &pcie_config_attr);
1393 retval = sysfs_create_bin_file(&pdev->dev.kobj, &pci_config_attr);
1397 retval = pci_create_resource_files(pdev);
1399 goto err_config_file;
1401 /* If the device has a ROM, try to expose it in sysfs. */
1402 rom_size = pci_resource_len(pdev, PCI_ROM_RESOURCE);
1404 attr = kzalloc(sizeof(*attr), GFP_ATOMIC);
1407 goto err_resource_files;
1409 sysfs_bin_attr_init(attr);
1410 attr->size = rom_size;
1411 attr->attr.name = "rom";
1412 attr->attr.mode = S_IRUSR | S_IWUSR;
1413 attr->read = pci_read_rom;
1414 attr->write = pci_write_rom;
1415 retval = sysfs_create_bin_file(&pdev->dev.kobj, attr);
1418 goto err_resource_files;
1420 pdev->rom_attr = attr;
1423 /* add sysfs entries for various capabilities */
1424 retval = pci_create_capabilities_sysfs(pdev);
1428 pci_create_firmware_label_files(pdev);
1433 if (pdev->rom_attr) {
1434 sysfs_remove_bin_file(&pdev->dev.kobj, pdev->rom_attr);
1435 kfree(pdev->rom_attr);
1436 pdev->rom_attr = NULL;
1439 pci_remove_resource_files(pdev);
1441 if (pdev->cfg_size > PCI_CFG_SPACE_SIZE)
1442 sysfs_remove_bin_file(&pdev->dev.kobj, &pcie_config_attr);
1444 sysfs_remove_bin_file(&pdev->dev.kobj, &pci_config_attr);
1449 static void pci_remove_capabilities_sysfs(struct pci_dev *dev)
1451 if (dev->vpd && dev->vpd->attr) {
1452 sysfs_remove_bin_file(&dev->dev.kobj, dev->vpd->attr);
1453 kfree(dev->vpd->attr);
1456 pcie_aspm_remove_sysfs_dev_files(dev);
1457 if (dev->reset_fn) {
1458 device_remove_file(&dev->dev, &reset_attr);
1464 * pci_remove_sysfs_dev_files - cleanup PCI specific sysfs files
1465 * @pdev: device whose entries we should free
1467 * Cleanup when @pdev is removed from sysfs.
1469 void pci_remove_sysfs_dev_files(struct pci_dev *pdev)
1471 if (!sysfs_initialized)
1474 pci_remove_capabilities_sysfs(pdev);
1476 if (pdev->cfg_size > PCI_CFG_SPACE_SIZE)
1477 sysfs_remove_bin_file(&pdev->dev.kobj, &pcie_config_attr);
1479 sysfs_remove_bin_file(&pdev->dev.kobj, &pci_config_attr);
1481 pci_remove_resource_files(pdev);
1483 if (pdev->rom_attr) {
1484 sysfs_remove_bin_file(&pdev->dev.kobj, pdev->rom_attr);
1485 kfree(pdev->rom_attr);
1486 pdev->rom_attr = NULL;
1489 pci_remove_firmware_label_files(pdev);
1492 static int __init pci_sysfs_init(void)
1494 struct pci_dev *pdev = NULL;
1497 sysfs_initialized = 1;
1498 for_each_pci_dev(pdev) {
1499 retval = pci_create_sysfs_dev_files(pdev);
1508 late_initcall(pci_sysfs_init);
1510 static struct attribute *pci_dev_dev_attrs[] = {
1515 static umode_t pci_dev_attrs_are_visible(struct kobject *kobj,
1516 struct attribute *a, int n)
1518 struct device *dev = kobj_to_dev(kobj);
1519 struct pci_dev *pdev = to_pci_dev(dev);
1521 if (a == &vga_attr.attr)
1522 if ((pdev->class >> 8) != PCI_CLASS_DISPLAY_VGA)
1528 static struct attribute *pci_dev_hp_attrs[] = {
1529 &dev_remove_attr.attr,
1530 &dev_rescan_attr.attr,
1534 static umode_t pci_dev_hp_attrs_are_visible(struct kobject *kobj,
1535 struct attribute *a, int n)
1537 struct device *dev = kobj_to_dev(kobj);
1538 struct pci_dev *pdev = to_pci_dev(dev);
1540 if (pdev->is_virtfn)
1546 static struct attribute_group pci_dev_hp_attr_group = {
1547 .attrs = pci_dev_hp_attrs,
1548 .is_visible = pci_dev_hp_attrs_are_visible,
1551 #ifdef CONFIG_PCI_IOV
1552 static struct attribute *sriov_dev_attrs[] = {
1553 &sriov_totalvfs_attr.attr,
1554 &sriov_numvfs_attr.attr,
1558 static umode_t sriov_attrs_are_visible(struct kobject *kobj,
1559 struct attribute *a, int n)
1561 struct device *dev = kobj_to_dev(kobj);
1563 if (!dev_is_pf(dev))
1569 static struct attribute_group sriov_dev_attr_group = {
1570 .attrs = sriov_dev_attrs,
1571 .is_visible = sriov_attrs_are_visible,
1573 #endif /* CONFIG_PCI_IOV */
1575 static struct attribute_group pci_dev_attr_group = {
1576 .attrs = pci_dev_dev_attrs,
1577 .is_visible = pci_dev_attrs_are_visible,
1580 static const struct attribute_group *pci_dev_attr_groups[] = {
1581 &pci_dev_attr_group,
1582 &pci_dev_hp_attr_group,
1583 #ifdef CONFIG_PCI_IOV
1584 &sriov_dev_attr_group,
1589 struct device_type pci_dev_type = {
1590 .groups = pci_dev_attr_groups,