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(revision, "0x%02x\n");
54 pci_config_attr(class, "0x%06x\n");
55 pci_config_attr(irq, "%u\n");
57 static ssize_t broken_parity_status_show(struct device *dev,
58 struct device_attribute *attr,
61 struct pci_dev *pdev = to_pci_dev(dev);
62 return sprintf(buf, "%u\n", pdev->broken_parity_status);
65 static ssize_t broken_parity_status_store(struct device *dev,
66 struct device_attribute *attr,
67 const char *buf, size_t count)
69 struct pci_dev *pdev = to_pci_dev(dev);
72 if (kstrtoul(buf, 0, &val) < 0)
75 pdev->broken_parity_status = !!val;
79 static DEVICE_ATTR_RW(broken_parity_status);
81 static ssize_t pci_dev_show_local_cpu(struct device *dev, bool list,
82 struct device_attribute *attr, char *buf)
84 const struct cpumask *mask;
87 mask = (dev_to_node(dev) == -1) ? cpu_online_mask :
88 cpumask_of_node(dev_to_node(dev));
90 mask = cpumask_of_pcibus(to_pci_dev(dev)->bus);
92 return cpumap_print_to_pagebuf(list, buf, mask);
95 static ssize_t local_cpus_show(struct device *dev,
96 struct device_attribute *attr, char *buf)
98 return pci_dev_show_local_cpu(dev, false, attr, buf);
100 static DEVICE_ATTR_RO(local_cpus);
102 static ssize_t local_cpulist_show(struct device *dev,
103 struct device_attribute *attr, char *buf)
105 return pci_dev_show_local_cpu(dev, true, attr, buf);
107 static DEVICE_ATTR_RO(local_cpulist);
110 * PCI Bus Class Devices
112 static ssize_t cpuaffinity_show(struct device *dev,
113 struct device_attribute *attr, char *buf)
115 const struct cpumask *cpumask = cpumask_of_pcibus(to_pci_bus(dev));
117 return cpumap_print_to_pagebuf(false, buf, cpumask);
119 static DEVICE_ATTR_RO(cpuaffinity);
121 static ssize_t cpulistaffinity_show(struct device *dev,
122 struct device_attribute *attr, char *buf)
124 const struct cpumask *cpumask = cpumask_of_pcibus(to_pci_bus(dev));
126 return cpumap_print_to_pagebuf(true, buf, cpumask);
128 static DEVICE_ATTR_RO(cpulistaffinity);
131 static ssize_t resource_show(struct device *dev, struct device_attribute *attr,
134 struct pci_dev *pci_dev = to_pci_dev(dev);
138 resource_size_t start, end;
140 if (pci_dev->subordinate)
141 max = DEVICE_COUNT_RESOURCE;
143 max = PCI_BRIDGE_RESOURCES;
145 for (i = 0; i < max; i++) {
146 struct resource *res = &pci_dev->resource[i];
147 pci_resource_to_user(pci_dev, i, res, &start, &end);
148 str += sprintf(str, "0x%016llx 0x%016llx 0x%016llx\n",
149 (unsigned long long)start,
150 (unsigned long long)end,
151 (unsigned long long)res->flags);
155 static DEVICE_ATTR_RO(resource);
157 static ssize_t modalias_show(struct device *dev, struct device_attribute *attr,
160 struct pci_dev *pci_dev = to_pci_dev(dev);
162 return sprintf(buf, "pci:v%08Xd%08Xsv%08Xsd%08Xbc%02Xsc%02Xi%02X\n",
163 pci_dev->vendor, pci_dev->device,
164 pci_dev->subsystem_vendor, pci_dev->subsystem_device,
165 (u8)(pci_dev->class >> 16), (u8)(pci_dev->class >> 8),
166 (u8)(pci_dev->class));
168 static DEVICE_ATTR_RO(modalias);
170 static ssize_t enable_store(struct device *dev, struct device_attribute *attr,
171 const char *buf, size_t count)
173 struct pci_dev *pdev = to_pci_dev(dev);
175 ssize_t result = kstrtoul(buf, 0, &val);
180 /* this can crash the machine when done on the "wrong" device */
181 if (!capable(CAP_SYS_ADMIN))
185 if (pci_is_enabled(pdev))
186 pci_disable_device(pdev);
190 result = pci_enable_device(pdev);
192 return result < 0 ? result : count;
195 static ssize_t enable_show(struct device *dev, struct device_attribute *attr,
198 struct pci_dev *pdev;
200 pdev = to_pci_dev(dev);
201 return sprintf(buf, "%u\n", atomic_read(&pdev->enable_cnt));
203 static DEVICE_ATTR_RW(enable);
206 static ssize_t numa_node_store(struct device *dev,
207 struct device_attribute *attr, const char *buf,
210 struct pci_dev *pdev = to_pci_dev(dev);
213 if (!capable(CAP_SYS_ADMIN))
216 ret = kstrtoint(buf, 0, &node);
220 if ((node < 0 && node != NUMA_NO_NODE) || node >= MAX_NUMNODES)
223 if (node != NUMA_NO_NODE && !node_online(node))
226 add_taint(TAINT_FIRMWARE_WORKAROUND, LOCKDEP_STILL_OK);
227 dev_alert(&pdev->dev, FW_BUG "Overriding NUMA node to %d. Contact your vendor for updates.",
230 dev->numa_node = node;
234 static ssize_t numa_node_show(struct device *dev, struct device_attribute *attr,
237 return sprintf(buf, "%d\n", dev->numa_node);
239 static DEVICE_ATTR_RW(numa_node);
242 static ssize_t dma_mask_bits_show(struct device *dev,
243 struct device_attribute *attr, char *buf)
245 struct pci_dev *pdev = to_pci_dev(dev);
247 return sprintf(buf, "%d\n", fls64(pdev->dma_mask));
249 static DEVICE_ATTR_RO(dma_mask_bits);
251 static ssize_t consistent_dma_mask_bits_show(struct device *dev,
252 struct device_attribute *attr,
255 return sprintf(buf, "%d\n", fls64(dev->coherent_dma_mask));
257 static DEVICE_ATTR_RO(consistent_dma_mask_bits);
259 static ssize_t msi_bus_show(struct device *dev, struct device_attribute *attr,
262 struct pci_dev *pdev = to_pci_dev(dev);
263 struct pci_bus *subordinate = pdev->subordinate;
265 return sprintf(buf, "%u\n", subordinate ?
266 !(subordinate->bus_flags & PCI_BUS_FLAGS_NO_MSI)
270 static ssize_t msi_bus_store(struct device *dev, struct device_attribute *attr,
271 const char *buf, size_t count)
273 struct pci_dev *pdev = to_pci_dev(dev);
274 struct pci_bus *subordinate = pdev->subordinate;
277 if (kstrtoul(buf, 0, &val) < 0)
280 if (!capable(CAP_SYS_ADMIN))
284 * "no_msi" and "bus_flags" only affect what happens when a driver
285 * requests MSI or MSI-X. They don't affect any drivers that have
286 * already requested MSI or MSI-X.
290 dev_info(&pdev->dev, "MSI/MSI-X %s for future drivers\n",
291 val ? "allowed" : "disallowed");
296 subordinate->bus_flags &= ~PCI_BUS_FLAGS_NO_MSI;
298 subordinate->bus_flags |= PCI_BUS_FLAGS_NO_MSI;
300 dev_info(&subordinate->dev, "MSI/MSI-X %s for future drivers of devices on this bus\n",
301 val ? "allowed" : "disallowed");
304 static DEVICE_ATTR_RW(msi_bus);
306 static ssize_t bus_rescan_store(struct bus_type *bus, const char *buf,
310 struct pci_bus *b = NULL;
312 if (kstrtoul(buf, 0, &val) < 0)
316 pci_lock_rescan_remove();
317 while ((b = pci_find_next_bus(b)) != NULL)
319 pci_unlock_rescan_remove();
323 static BUS_ATTR(rescan, (S_IWUSR|S_IWGRP), NULL, bus_rescan_store);
325 static struct attribute *pci_bus_attrs[] = {
326 &bus_attr_rescan.attr,
330 static const struct attribute_group pci_bus_group = {
331 .attrs = pci_bus_attrs,
334 const struct attribute_group *pci_bus_groups[] = {
339 static ssize_t dev_rescan_store(struct device *dev,
340 struct device_attribute *attr, const char *buf,
344 struct pci_dev *pdev = to_pci_dev(dev);
346 if (kstrtoul(buf, 0, &val) < 0)
350 pci_lock_rescan_remove();
351 pci_rescan_bus(pdev->bus);
352 pci_unlock_rescan_remove();
356 static struct device_attribute dev_rescan_attr = __ATTR(rescan,
358 NULL, dev_rescan_store);
360 static ssize_t remove_store(struct device *dev, struct device_attribute *attr,
361 const char *buf, size_t count)
365 if (kstrtoul(buf, 0, &val) < 0)
368 if (val && device_remove_file_self(dev, attr))
369 pci_stop_and_remove_bus_device_locked(to_pci_dev(dev));
372 static struct device_attribute dev_remove_attr = __ATTR(remove,
376 static ssize_t dev_bus_rescan_store(struct device *dev,
377 struct device_attribute *attr,
378 const char *buf, size_t count)
381 struct pci_bus *bus = to_pci_bus(dev);
383 if (kstrtoul(buf, 0, &val) < 0)
387 pci_lock_rescan_remove();
388 if (!pci_is_root_bus(bus) && list_empty(&bus->devices))
389 pci_rescan_bus_bridge_resize(bus->self);
392 pci_unlock_rescan_remove();
396 static DEVICE_ATTR(rescan, (S_IWUSR|S_IWGRP), NULL, dev_bus_rescan_store);
398 #if defined(CONFIG_PM) && defined(CONFIG_ACPI)
399 static ssize_t d3cold_allowed_store(struct device *dev,
400 struct device_attribute *attr,
401 const char *buf, size_t count)
403 struct pci_dev *pdev = to_pci_dev(dev);
406 if (kstrtoul(buf, 0, &val) < 0)
409 pdev->d3cold_allowed = !!val;
410 if (pdev->d3cold_allowed)
411 pci_d3cold_enable(pdev);
413 pci_d3cold_disable(pdev);
415 pm_runtime_resume(dev);
420 static ssize_t d3cold_allowed_show(struct device *dev,
421 struct device_attribute *attr, char *buf)
423 struct pci_dev *pdev = to_pci_dev(dev);
424 return sprintf(buf, "%u\n", pdev->d3cold_allowed);
426 static DEVICE_ATTR_RW(d3cold_allowed);
430 static ssize_t devspec_show(struct device *dev,
431 struct device_attribute *attr, char *buf)
433 struct pci_dev *pdev = to_pci_dev(dev);
434 struct device_node *np = pci_device_to_OF_node(pdev);
436 if (np == NULL || np->full_name == NULL)
438 return sprintf(buf, "%s", np->full_name);
440 static DEVICE_ATTR_RO(devspec);
443 #ifdef CONFIG_PCI_IOV
444 static ssize_t sriov_totalvfs_show(struct device *dev,
445 struct device_attribute *attr,
448 struct pci_dev *pdev = to_pci_dev(dev);
450 return sprintf(buf, "%u\n", pci_sriov_get_totalvfs(pdev));
454 static ssize_t sriov_numvfs_show(struct device *dev,
455 struct device_attribute *attr,
458 struct pci_dev *pdev = to_pci_dev(dev);
460 return sprintf(buf, "%u\n", pdev->sriov->num_VFs);
464 * num_vfs > 0; number of VFs to enable
465 * num_vfs = 0; disable all VFs
467 * Note: SRIOV spec doesn't allow partial VF
468 * disable, so it's all or none.
470 static ssize_t sriov_numvfs_store(struct device *dev,
471 struct device_attribute *attr,
472 const char *buf, size_t count)
474 struct pci_dev *pdev = to_pci_dev(dev);
475 struct pci_sriov *iov = pdev->sriov;
479 ret = kstrtou16(buf, 0, &num_vfs);
483 if (num_vfs > pci_sriov_get_totalvfs(pdev))
486 mutex_lock(&iov->dev->sriov->lock);
488 if (num_vfs == pdev->sriov->num_VFs)
491 /* is PF driver loaded w/callback */
492 if (!pdev->driver || !pdev->driver->sriov_configure) {
493 dev_info(&pdev->dev, "Driver doesn't support SRIOV configuration via sysfs\n");
500 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);
512 ret = pdev->driver->sriov_configure(pdev, num_vfs);
517 dev_warn(&pdev->dev, "%d VFs requested; only %d enabled\n",
521 mutex_unlock(&iov->dev->sriov->lock);
529 static ssize_t sriov_drivers_autoprobe_show(struct device *dev,
530 struct device_attribute *attr,
533 struct pci_dev *pdev = to_pci_dev(dev);
535 return sprintf(buf, "%u\n", pdev->sriov->drivers_autoprobe);
538 static ssize_t sriov_drivers_autoprobe_store(struct device *dev,
539 struct device_attribute *attr,
540 const char *buf, size_t count)
542 struct pci_dev *pdev = to_pci_dev(dev);
543 bool drivers_autoprobe;
545 if (kstrtobool(buf, &drivers_autoprobe) < 0)
548 pdev->sriov->drivers_autoprobe = drivers_autoprobe;
553 static struct device_attribute sriov_totalvfs_attr = __ATTR_RO(sriov_totalvfs);
554 static struct device_attribute sriov_numvfs_attr =
555 __ATTR(sriov_numvfs, (S_IRUGO|S_IWUSR|S_IWGRP),
556 sriov_numvfs_show, sriov_numvfs_store);
557 static struct device_attribute sriov_drivers_autoprobe_attr =
558 __ATTR(sriov_drivers_autoprobe, (S_IRUGO|S_IWUSR|S_IWGRP),
559 sriov_drivers_autoprobe_show, sriov_drivers_autoprobe_store);
560 #endif /* CONFIG_PCI_IOV */
562 static ssize_t driver_override_store(struct device *dev,
563 struct device_attribute *attr,
564 const char *buf, size_t count)
566 struct pci_dev *pdev = to_pci_dev(dev);
567 char *driver_override, *old = pdev->driver_override, *cp;
569 /* We need to keep extra room for a newline */
570 if (count >= (PAGE_SIZE - 1))
573 driver_override = kstrndup(buf, count, GFP_KERNEL);
574 if (!driver_override)
577 cp = strchr(driver_override, '\n');
581 if (strlen(driver_override)) {
582 pdev->driver_override = driver_override;
584 kfree(driver_override);
585 pdev->driver_override = NULL;
593 static ssize_t driver_override_show(struct device *dev,
594 struct device_attribute *attr, char *buf)
596 struct pci_dev *pdev = to_pci_dev(dev);
598 return snprintf(buf, PAGE_SIZE, "%s\n", pdev->driver_override);
600 static DEVICE_ATTR_RW(driver_override);
602 static struct attribute *pci_dev_attrs[] = {
603 &dev_attr_resource.attr,
604 &dev_attr_vendor.attr,
605 &dev_attr_device.attr,
606 &dev_attr_subsystem_vendor.attr,
607 &dev_attr_subsystem_device.attr,
608 &dev_attr_revision.attr,
609 &dev_attr_class.attr,
611 &dev_attr_local_cpus.attr,
612 &dev_attr_local_cpulist.attr,
613 &dev_attr_modalias.attr,
615 &dev_attr_numa_node.attr,
617 &dev_attr_dma_mask_bits.attr,
618 &dev_attr_consistent_dma_mask_bits.attr,
619 &dev_attr_enable.attr,
620 &dev_attr_broken_parity_status.attr,
621 &dev_attr_msi_bus.attr,
622 #if defined(CONFIG_PM) && defined(CONFIG_ACPI)
623 &dev_attr_d3cold_allowed.attr,
626 &dev_attr_devspec.attr,
628 &dev_attr_driver_override.attr,
632 static const struct attribute_group pci_dev_group = {
633 .attrs = pci_dev_attrs,
636 const struct attribute_group *pci_dev_groups[] = {
641 static struct attribute *pcibus_attrs[] = {
642 &dev_attr_rescan.attr,
643 &dev_attr_cpuaffinity.attr,
644 &dev_attr_cpulistaffinity.attr,
648 static const struct attribute_group pcibus_group = {
649 .attrs = pcibus_attrs,
652 const struct attribute_group *pcibus_groups[] = {
657 static ssize_t boot_vga_show(struct device *dev, struct device_attribute *attr,
660 struct pci_dev *pdev = to_pci_dev(dev);
661 struct pci_dev *vga_dev = vga_default_device();
664 return sprintf(buf, "%u\n", (pdev == vga_dev));
666 return sprintf(buf, "%u\n",
667 !!(pdev->resource[PCI_ROM_RESOURCE].flags &
668 IORESOURCE_ROM_SHADOW));
670 static struct device_attribute vga_attr = __ATTR_RO(boot_vga);
672 static ssize_t pci_read_config(struct file *filp, struct kobject *kobj,
673 struct bin_attribute *bin_attr, char *buf,
674 loff_t off, size_t count)
676 struct pci_dev *dev = to_pci_dev(kobj_to_dev(kobj));
677 unsigned int size = 64;
678 loff_t init_off = off;
679 u8 *data = (u8 *) buf;
681 /* Several chips lock up trying to read undefined config space */
682 if (file_ns_capable(filp, &init_user_ns, CAP_SYS_ADMIN))
683 size = dev->cfg_size;
684 else if (dev->hdr_type == PCI_HEADER_TYPE_CARDBUS)
689 if (off + count > size) {
696 pci_config_pm_runtime_get(dev);
698 if ((off & 1) && size) {
700 pci_user_read_config_byte(dev, off, &val);
701 data[off - init_off] = val;
706 if ((off & 3) && size > 2) {
708 pci_user_read_config_word(dev, off, &val);
709 data[off - init_off] = val & 0xff;
710 data[off - init_off + 1] = (val >> 8) & 0xff;
717 pci_user_read_config_dword(dev, off, &val);
718 data[off - init_off] = val & 0xff;
719 data[off - init_off + 1] = (val >> 8) & 0xff;
720 data[off - init_off + 2] = (val >> 16) & 0xff;
721 data[off - init_off + 3] = (val >> 24) & 0xff;
728 pci_user_read_config_word(dev, off, &val);
729 data[off - init_off] = val & 0xff;
730 data[off - init_off + 1] = (val >> 8) & 0xff;
737 pci_user_read_config_byte(dev, off, &val);
738 data[off - init_off] = val;
743 pci_config_pm_runtime_put(dev);
748 static ssize_t pci_write_config(struct file *filp, struct kobject *kobj,
749 struct bin_attribute *bin_attr, char *buf,
750 loff_t off, size_t count)
752 struct pci_dev *dev = to_pci_dev(kobj_to_dev(kobj));
753 unsigned int size = count;
754 loff_t init_off = off;
755 u8 *data = (u8 *) buf;
757 if (off > dev->cfg_size)
759 if (off + count > dev->cfg_size) {
760 size = dev->cfg_size - off;
764 pci_config_pm_runtime_get(dev);
766 if ((off & 1) && size) {
767 pci_user_write_config_byte(dev, off, data[off - init_off]);
772 if ((off & 3) && size > 2) {
773 u16 val = data[off - init_off];
774 val |= (u16) data[off - init_off + 1] << 8;
775 pci_user_write_config_word(dev, off, val);
781 u32 val = data[off - init_off];
782 val |= (u32) data[off - init_off + 1] << 8;
783 val |= (u32) data[off - init_off + 2] << 16;
784 val |= (u32) data[off - init_off + 3] << 24;
785 pci_user_write_config_dword(dev, off, val);
791 u16 val = data[off - init_off];
792 val |= (u16) data[off - init_off + 1] << 8;
793 pci_user_write_config_word(dev, off, val);
799 pci_user_write_config_byte(dev, off, data[off - init_off]);
804 pci_config_pm_runtime_put(dev);
809 static ssize_t read_vpd_attr(struct file *filp, struct kobject *kobj,
810 struct bin_attribute *bin_attr, char *buf,
811 loff_t off, size_t count)
813 struct pci_dev *dev = to_pci_dev(kobj_to_dev(kobj));
815 if (bin_attr->size > 0) {
816 if (off > bin_attr->size)
818 else if (count > bin_attr->size - off)
819 count = bin_attr->size - off;
822 return pci_read_vpd(dev, off, count, buf);
825 static ssize_t write_vpd_attr(struct file *filp, struct kobject *kobj,
826 struct bin_attribute *bin_attr, char *buf,
827 loff_t off, size_t count)
829 struct pci_dev *dev = to_pci_dev(kobj_to_dev(kobj));
831 if (bin_attr->size > 0) {
832 if (off > bin_attr->size)
834 else if (count > bin_attr->size - off)
835 count = bin_attr->size - off;
838 return pci_write_vpd(dev, off, count, buf);
841 #ifdef HAVE_PCI_LEGACY
843 * pci_read_legacy_io - read byte(s) from legacy I/O port space
844 * @filp: open sysfs file
845 * @kobj: kobject corresponding to file to read from
846 * @bin_attr: struct bin_attribute for this file
847 * @buf: buffer to store results
848 * @off: offset into legacy I/O port space
849 * @count: number of bytes to read
851 * Reads 1, 2, or 4 bytes from legacy I/O port space using an arch specific
852 * callback routine (pci_legacy_read).
854 static ssize_t pci_read_legacy_io(struct file *filp, struct kobject *kobj,
855 struct bin_attribute *bin_attr, char *buf,
856 loff_t off, size_t count)
858 struct pci_bus *bus = to_pci_bus(kobj_to_dev(kobj));
860 /* Only support 1, 2 or 4 byte accesses */
861 if (count != 1 && count != 2 && count != 4)
864 return pci_legacy_read(bus, off, (u32 *)buf, count);
868 * pci_write_legacy_io - write byte(s) to legacy I/O port space
869 * @filp: open sysfs file
870 * @kobj: kobject corresponding to file to read from
871 * @bin_attr: struct bin_attribute for this file
872 * @buf: buffer containing value to be written
873 * @off: offset into legacy I/O port space
874 * @count: number of bytes to write
876 * Writes 1, 2, or 4 bytes from legacy I/O port space using an arch specific
877 * callback routine (pci_legacy_write).
879 static ssize_t pci_write_legacy_io(struct file *filp, struct kobject *kobj,
880 struct bin_attribute *bin_attr, char *buf,
881 loff_t off, size_t count)
883 struct pci_bus *bus = to_pci_bus(kobj_to_dev(kobj));
885 /* Only support 1, 2 or 4 byte accesses */
886 if (count != 1 && count != 2 && count != 4)
889 return pci_legacy_write(bus, off, *(u32 *)buf, count);
893 * pci_mmap_legacy_mem - map legacy PCI memory into user memory space
894 * @filp: open sysfs file
895 * @kobj: kobject corresponding to device to be mapped
896 * @attr: struct bin_attribute for this file
897 * @vma: struct vm_area_struct passed to mmap
899 * Uses an arch specific callback, pci_mmap_legacy_mem_page_range, to mmap
900 * legacy memory space (first meg of bus space) into application virtual
903 static int pci_mmap_legacy_mem(struct file *filp, struct kobject *kobj,
904 struct bin_attribute *attr,
905 struct vm_area_struct *vma)
907 struct pci_bus *bus = to_pci_bus(kobj_to_dev(kobj));
909 return pci_mmap_legacy_page_range(bus, vma, pci_mmap_mem);
913 * pci_mmap_legacy_io - map legacy PCI IO into user memory space
914 * @filp: open sysfs file
915 * @kobj: kobject corresponding to device to be mapped
916 * @attr: struct bin_attribute for this file
917 * @vma: struct vm_area_struct passed to mmap
919 * Uses an arch specific callback, pci_mmap_legacy_io_page_range, to mmap
920 * legacy IO space (first meg of bus space) into application virtual
921 * memory space. Returns -ENOSYS if the operation isn't supported
923 static int pci_mmap_legacy_io(struct file *filp, struct kobject *kobj,
924 struct bin_attribute *attr,
925 struct vm_area_struct *vma)
927 struct pci_bus *bus = to_pci_bus(kobj_to_dev(kobj));
929 return pci_mmap_legacy_page_range(bus, vma, pci_mmap_io);
933 * pci_adjust_legacy_attr - adjustment of legacy file attributes
934 * @b: bus to create files under
935 * @mmap_type: I/O port or memory
937 * Stub implementation. Can be overridden by arch if necessary.
939 void __weak pci_adjust_legacy_attr(struct pci_bus *b,
940 enum pci_mmap_state mmap_type)
945 * pci_create_legacy_files - create legacy I/O port and memory files
946 * @b: bus to create files under
948 * Some platforms allow access to legacy I/O port and ISA memory space on
949 * a per-bus basis. This routine creates the files and ties them into
950 * their associated read, write and mmap files from pci-sysfs.c
952 * On error unwind, but don't propagate the error to the caller
953 * as it is ok to set up the PCI bus without these files.
955 void pci_create_legacy_files(struct pci_bus *b)
959 b->legacy_io = kzalloc(sizeof(struct bin_attribute) * 2,
964 sysfs_bin_attr_init(b->legacy_io);
965 b->legacy_io->attr.name = "legacy_io";
966 b->legacy_io->size = 0xffff;
967 b->legacy_io->attr.mode = S_IRUSR | S_IWUSR;
968 b->legacy_io->read = pci_read_legacy_io;
969 b->legacy_io->write = pci_write_legacy_io;
970 b->legacy_io->mmap = pci_mmap_legacy_io;
971 pci_adjust_legacy_attr(b, pci_mmap_io);
972 error = device_create_bin_file(&b->dev, b->legacy_io);
976 /* Allocated above after the legacy_io struct */
977 b->legacy_mem = b->legacy_io + 1;
978 sysfs_bin_attr_init(b->legacy_mem);
979 b->legacy_mem->attr.name = "legacy_mem";
980 b->legacy_mem->size = 1024*1024;
981 b->legacy_mem->attr.mode = S_IRUSR | S_IWUSR;
982 b->legacy_mem->mmap = pci_mmap_legacy_mem;
983 pci_adjust_legacy_attr(b, pci_mmap_mem);
984 error = device_create_bin_file(&b->dev, b->legacy_mem);
991 device_remove_bin_file(&b->dev, b->legacy_io);
996 printk(KERN_WARNING "pci: warning: could not create legacy I/O port and ISA memory resources to sysfs\n");
1000 void pci_remove_legacy_files(struct pci_bus *b)
1003 device_remove_bin_file(&b->dev, b->legacy_io);
1004 device_remove_bin_file(&b->dev, b->legacy_mem);
1005 kfree(b->legacy_io); /* both are allocated here */
1008 #endif /* HAVE_PCI_LEGACY */
1010 #if defined(HAVE_PCI_MMAP) || defined(ARCH_GENERIC_PCI_MMAP_RESOURCE)
1012 int pci_mmap_fits(struct pci_dev *pdev, int resno, struct vm_area_struct *vma,
1013 enum pci_mmap_api mmap_api)
1015 unsigned long nr, start, size;
1016 resource_size_t pci_start = 0, pci_end;
1018 if (pci_resource_len(pdev, resno) == 0)
1020 nr = vma_pages(vma);
1021 start = vma->vm_pgoff;
1022 size = ((pci_resource_len(pdev, resno) - 1) >> PAGE_SHIFT) + 1;
1023 if (mmap_api == PCI_MMAP_PROCFS) {
1024 pci_resource_to_user(pdev, resno, &pdev->resource[resno],
1025 &pci_start, &pci_end);
1026 pci_start >>= PAGE_SHIFT;
1028 if (start >= pci_start && start < pci_start + size &&
1029 start + nr <= pci_start + size)
1035 * pci_mmap_resource - map a PCI resource into user memory space
1036 * @kobj: kobject for mapping
1037 * @attr: struct bin_attribute for the file being mapped
1038 * @vma: struct vm_area_struct passed into the mmap
1039 * @write_combine: 1 for write_combine mapping
1041 * Use the regular PCI mapping routines to map a PCI resource into userspace.
1043 static int pci_mmap_resource(struct kobject *kobj, struct bin_attribute *attr,
1044 struct vm_area_struct *vma, int write_combine)
1046 struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
1047 int bar = (unsigned long)attr->private;
1048 enum pci_mmap_state mmap_type;
1049 struct resource *res = &pdev->resource[bar];
1051 if (res->flags & IORESOURCE_MEM && iomem_is_exclusive(res->start))
1054 if (!pci_mmap_fits(pdev, bar, vma, PCI_MMAP_SYSFS)) {
1055 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",
1056 current->comm, vma->vm_end-vma->vm_start, vma->vm_pgoff,
1057 pci_name(pdev), bar,
1058 (u64)pci_resource_start(pdev, bar),
1059 (u64)pci_resource_len(pdev, bar));
1062 mmap_type = res->flags & IORESOURCE_MEM ? pci_mmap_mem : pci_mmap_io;
1064 return pci_mmap_resource_range(pdev, bar, vma, mmap_type, write_combine);
1067 static int pci_mmap_resource_uc(struct file *filp, struct kobject *kobj,
1068 struct bin_attribute *attr,
1069 struct vm_area_struct *vma)
1071 return pci_mmap_resource(kobj, attr, vma, 0);
1074 static int pci_mmap_resource_wc(struct file *filp, struct kobject *kobj,
1075 struct bin_attribute *attr,
1076 struct vm_area_struct *vma)
1078 return pci_mmap_resource(kobj, attr, vma, 1);
1081 static ssize_t pci_resource_io(struct file *filp, struct kobject *kobj,
1082 struct bin_attribute *attr, char *buf,
1083 loff_t off, size_t count, bool write)
1085 struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
1086 int bar = (unsigned long)attr->private;
1087 struct resource *res;
1088 unsigned long port = off;
1090 res = &pdev->resource[bar];
1092 port += pci_resource_start(pdev, bar);
1094 if (port > pci_resource_end(pdev, bar))
1097 if (port + count - 1 > pci_resource_end(pdev, bar))
1103 outb(*(u8 *)buf, port);
1105 *(u8 *)buf = inb(port);
1109 outw(*(u16 *)buf, port);
1111 *(u16 *)buf = inw(port);
1115 outl(*(u32 *)buf, port);
1117 *(u32 *)buf = inl(port);
1123 static ssize_t pci_read_resource_io(struct file *filp, struct kobject *kobj,
1124 struct bin_attribute *attr, char *buf,
1125 loff_t off, size_t count)
1127 return pci_resource_io(filp, kobj, attr, buf, off, count, false);
1130 static ssize_t pci_write_resource_io(struct file *filp, struct kobject *kobj,
1131 struct bin_attribute *attr, char *buf,
1132 loff_t off, size_t count)
1134 return pci_resource_io(filp, kobj, attr, buf, off, count, true);
1138 * pci_remove_resource_files - cleanup resource files
1139 * @pdev: dev to cleanup
1141 * If we created resource files for @pdev, remove them from sysfs and
1142 * free their resources.
1144 static void pci_remove_resource_files(struct pci_dev *pdev)
1148 for (i = 0; i < PCI_ROM_RESOURCE; i++) {
1149 struct bin_attribute *res_attr;
1151 res_attr = pdev->res_attr[i];
1153 sysfs_remove_bin_file(&pdev->dev.kobj, res_attr);
1157 res_attr = pdev->res_attr_wc[i];
1159 sysfs_remove_bin_file(&pdev->dev.kobj, res_attr);
1165 static int pci_create_attr(struct pci_dev *pdev, int num, int write_combine)
1167 /* allocate attribute structure, piggyback attribute name */
1168 int name_len = write_combine ? 13 : 10;
1169 struct bin_attribute *res_attr;
1170 char *res_attr_name;
1173 res_attr = kzalloc(sizeof(*res_attr) + name_len, GFP_ATOMIC);
1177 res_attr_name = (char *)(res_attr + 1);
1179 sysfs_bin_attr_init(res_attr);
1180 if (write_combine) {
1181 pdev->res_attr_wc[num] = res_attr;
1182 sprintf(res_attr_name, "resource%d_wc", num);
1183 res_attr->mmap = pci_mmap_resource_wc;
1185 pdev->res_attr[num] = res_attr;
1186 sprintf(res_attr_name, "resource%d", num);
1187 if (pci_resource_flags(pdev, num) & IORESOURCE_IO) {
1188 res_attr->read = pci_read_resource_io;
1189 res_attr->write = pci_write_resource_io;
1190 if (arch_can_pci_mmap_io())
1191 res_attr->mmap = pci_mmap_resource_uc;
1193 res_attr->mmap = pci_mmap_resource_uc;
1196 res_attr->attr.name = res_attr_name;
1197 res_attr->attr.mode = S_IRUSR | S_IWUSR;
1198 res_attr->size = pci_resource_len(pdev, num);
1199 res_attr->private = (void *)(unsigned long)num;
1200 retval = sysfs_create_bin_file(&pdev->dev.kobj, res_attr);
1208 * pci_create_resource_files - create resource files in sysfs for @dev
1209 * @pdev: dev in question
1211 * Walk the resources in @pdev creating files for each resource available.
1213 static int pci_create_resource_files(struct pci_dev *pdev)
1218 /* Expose the PCI resources from this device as files */
1219 for (i = 0; i < PCI_ROM_RESOURCE; i++) {
1221 /* skip empty resources */
1222 if (!pci_resource_len(pdev, i))
1225 retval = pci_create_attr(pdev, i, 0);
1226 /* for prefetchable resources, create a WC mappable file */
1227 if (!retval && arch_can_pci_mmap_wc() &&
1228 pdev->resource[i].flags & IORESOURCE_PREFETCH)
1229 retval = pci_create_attr(pdev, i, 1);
1231 pci_remove_resource_files(pdev);
1237 #else /* !HAVE_PCI_MMAP */
1238 int __weak pci_create_resource_files(struct pci_dev *dev) { return 0; }
1239 void __weak pci_remove_resource_files(struct pci_dev *dev) { return; }
1240 #endif /* HAVE_PCI_MMAP */
1243 * pci_write_rom - used to enable access to the PCI ROM display
1245 * @kobj: kernel object handle
1246 * @bin_attr: struct bin_attribute for this file
1249 * @count: number of byte in input
1251 * writing anything except 0 enables it
1253 static ssize_t pci_write_rom(struct file *filp, struct kobject *kobj,
1254 struct bin_attribute *bin_attr, char *buf,
1255 loff_t off, size_t count)
1257 struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
1259 if ((off == 0) && (*buf == '0') && (count == 2))
1260 pdev->rom_attr_enabled = 0;
1262 pdev->rom_attr_enabled = 1;
1268 * pci_read_rom - read a PCI ROM
1270 * @kobj: kernel object handle
1271 * @bin_attr: struct bin_attribute for this file
1272 * @buf: where to put the data we read from the ROM
1274 * @count: number of bytes to read
1276 * Put @count bytes starting at @off into @buf from the ROM in the PCI
1277 * device corresponding to @kobj.
1279 static ssize_t pci_read_rom(struct file *filp, struct kobject *kobj,
1280 struct bin_attribute *bin_attr, char *buf,
1281 loff_t off, size_t count)
1283 struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
1287 if (!pdev->rom_attr_enabled)
1290 rom = pci_map_rom(pdev, &size); /* size starts out as PCI window size */
1297 if (off + count > size)
1300 memcpy_fromio(buf, rom + off, count);
1302 pci_unmap_rom(pdev, rom);
1307 static struct bin_attribute pci_config_attr = {
1310 .mode = S_IRUGO | S_IWUSR,
1312 .size = PCI_CFG_SPACE_SIZE,
1313 .read = pci_read_config,
1314 .write = pci_write_config,
1317 static struct bin_attribute pcie_config_attr = {
1320 .mode = S_IRUGO | S_IWUSR,
1322 .size = PCI_CFG_SPACE_EXP_SIZE,
1323 .read = pci_read_config,
1324 .write = pci_write_config,
1327 static ssize_t reset_store(struct device *dev, struct device_attribute *attr,
1328 const char *buf, size_t count)
1330 struct pci_dev *pdev = to_pci_dev(dev);
1332 ssize_t result = kstrtoul(buf, 0, &val);
1340 result = pci_reset_function(pdev);
1347 static struct device_attribute reset_attr = __ATTR(reset, 0200, NULL, reset_store);
1349 static int pci_create_capabilities_sysfs(struct pci_dev *dev)
1352 struct bin_attribute *attr;
1354 /* If the device has VPD, try to expose it in sysfs. */
1356 attr = kzalloc(sizeof(*attr), GFP_ATOMIC);
1360 sysfs_bin_attr_init(attr);
1362 attr->attr.name = "vpd";
1363 attr->attr.mode = S_IRUSR | S_IWUSR;
1364 attr->read = read_vpd_attr;
1365 attr->write = write_vpd_attr;
1366 retval = sysfs_create_bin_file(&dev->dev.kobj, attr);
1371 dev->vpd->attr = attr;
1374 /* Active State Power Management */
1375 pcie_aspm_create_sysfs_dev_files(dev);
1377 if (!pci_probe_reset_function(dev)) {
1378 retval = device_create_file(&dev->dev, &reset_attr);
1386 pcie_aspm_remove_sysfs_dev_files(dev);
1387 if (dev->vpd && dev->vpd->attr) {
1388 sysfs_remove_bin_file(&dev->dev.kobj, dev->vpd->attr);
1389 kfree(dev->vpd->attr);
1395 int __must_check pci_create_sysfs_dev_files(struct pci_dev *pdev)
1399 struct bin_attribute *attr;
1401 if (!sysfs_initialized)
1404 if (pdev->cfg_size > PCI_CFG_SPACE_SIZE)
1405 retval = sysfs_create_bin_file(&pdev->dev.kobj, &pcie_config_attr);
1407 retval = sysfs_create_bin_file(&pdev->dev.kobj, &pci_config_attr);
1411 retval = pci_create_resource_files(pdev);
1413 goto err_config_file;
1415 /* If the device has a ROM, try to expose it in sysfs. */
1416 rom_size = pci_resource_len(pdev, PCI_ROM_RESOURCE);
1418 attr = kzalloc(sizeof(*attr), GFP_ATOMIC);
1421 goto err_resource_files;
1423 sysfs_bin_attr_init(attr);
1424 attr->size = rom_size;
1425 attr->attr.name = "rom";
1426 attr->attr.mode = S_IRUSR | S_IWUSR;
1427 attr->read = pci_read_rom;
1428 attr->write = pci_write_rom;
1429 retval = sysfs_create_bin_file(&pdev->dev.kobj, attr);
1432 goto err_resource_files;
1434 pdev->rom_attr = attr;
1437 /* add sysfs entries for various capabilities */
1438 retval = pci_create_capabilities_sysfs(pdev);
1442 pci_create_firmware_label_files(pdev);
1447 if (pdev->rom_attr) {
1448 sysfs_remove_bin_file(&pdev->dev.kobj, pdev->rom_attr);
1449 kfree(pdev->rom_attr);
1450 pdev->rom_attr = NULL;
1453 pci_remove_resource_files(pdev);
1455 if (pdev->cfg_size > PCI_CFG_SPACE_SIZE)
1456 sysfs_remove_bin_file(&pdev->dev.kobj, &pcie_config_attr);
1458 sysfs_remove_bin_file(&pdev->dev.kobj, &pci_config_attr);
1463 static void pci_remove_capabilities_sysfs(struct pci_dev *dev)
1465 if (dev->vpd && dev->vpd->attr) {
1466 sysfs_remove_bin_file(&dev->dev.kobj, dev->vpd->attr);
1467 kfree(dev->vpd->attr);
1470 pcie_aspm_remove_sysfs_dev_files(dev);
1471 if (dev->reset_fn) {
1472 device_remove_file(&dev->dev, &reset_attr);
1478 * pci_remove_sysfs_dev_files - cleanup PCI specific sysfs files
1479 * @pdev: device whose entries we should free
1481 * Cleanup when @pdev is removed from sysfs.
1483 void pci_remove_sysfs_dev_files(struct pci_dev *pdev)
1485 if (!sysfs_initialized)
1488 pci_remove_capabilities_sysfs(pdev);
1490 if (pdev->cfg_size > PCI_CFG_SPACE_SIZE)
1491 sysfs_remove_bin_file(&pdev->dev.kobj, &pcie_config_attr);
1493 sysfs_remove_bin_file(&pdev->dev.kobj, &pci_config_attr);
1495 pci_remove_resource_files(pdev);
1497 if (pdev->rom_attr) {
1498 sysfs_remove_bin_file(&pdev->dev.kobj, pdev->rom_attr);
1499 kfree(pdev->rom_attr);
1500 pdev->rom_attr = NULL;
1503 pci_remove_firmware_label_files(pdev);
1506 static int __init pci_sysfs_init(void)
1508 struct pci_dev *pdev = NULL;
1511 sysfs_initialized = 1;
1512 for_each_pci_dev(pdev) {
1513 retval = pci_create_sysfs_dev_files(pdev);
1522 late_initcall(pci_sysfs_init);
1524 static struct attribute *pci_dev_dev_attrs[] = {
1529 static umode_t pci_dev_attrs_are_visible(struct kobject *kobj,
1530 struct attribute *a, int n)
1532 struct device *dev = kobj_to_dev(kobj);
1533 struct pci_dev *pdev = to_pci_dev(dev);
1535 if (a == &vga_attr.attr)
1536 if ((pdev->class >> 8) != PCI_CLASS_DISPLAY_VGA)
1542 static struct attribute *pci_dev_hp_attrs[] = {
1543 &dev_remove_attr.attr,
1544 &dev_rescan_attr.attr,
1548 static umode_t pci_dev_hp_attrs_are_visible(struct kobject *kobj,
1549 struct attribute *a, int n)
1551 struct device *dev = kobj_to_dev(kobj);
1552 struct pci_dev *pdev = to_pci_dev(dev);
1554 if (pdev->is_virtfn)
1560 static struct attribute_group pci_dev_hp_attr_group = {
1561 .attrs = pci_dev_hp_attrs,
1562 .is_visible = pci_dev_hp_attrs_are_visible,
1565 #ifdef CONFIG_PCI_IOV
1566 static struct attribute *sriov_dev_attrs[] = {
1567 &sriov_totalvfs_attr.attr,
1568 &sriov_numvfs_attr.attr,
1569 &sriov_drivers_autoprobe_attr.attr,
1573 static umode_t sriov_attrs_are_visible(struct kobject *kobj,
1574 struct attribute *a, int n)
1576 struct device *dev = kobj_to_dev(kobj);
1578 if (!dev_is_pf(dev))
1584 static struct attribute_group sriov_dev_attr_group = {
1585 .attrs = sriov_dev_attrs,
1586 .is_visible = sriov_attrs_are_visible,
1588 #endif /* CONFIG_PCI_IOV */
1590 static struct attribute_group pci_dev_attr_group = {
1591 .attrs = pci_dev_dev_attrs,
1592 .is_visible = pci_dev_attrs_are_visible,
1595 static const struct attribute_group *pci_dev_attr_groups[] = {
1596 &pci_dev_attr_group,
1597 &pci_dev_hp_attr_group,
1598 #ifdef CONFIG_PCI_IOV
1599 &sriov_dev_attr_group,
1604 struct device_type pci_dev_type = {
1605 .groups = pci_dev_attr_groups,