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
);
478 ret
= kstrtou16(buf
, 0, &num_vfs
);
482 if (num_vfs
> pci_sriov_get_totalvfs(pdev
))
485 if (num_vfs
== pdev
->sriov
->num_VFs
)
486 return count
; /* no change */
488 /* is PF driver loaded w/callback */
489 if (!pdev
->driver
|| !pdev
->driver
->sriov_configure
) {
490 dev_info(&pdev
->dev
, "Driver doesn't support SRIOV configuration via sysfs\n");
496 ret
= pdev
->driver
->sriov_configure(pdev
, 0);
503 if (pdev
->sriov
->num_VFs
) {
504 dev_warn(&pdev
->dev
, "%d VFs already enabled. Disable before enabling %d VFs\n",
505 pdev
->sriov
->num_VFs
, num_vfs
);
509 ret
= pdev
->driver
->sriov_configure(pdev
, num_vfs
);
514 dev_warn(&pdev
->dev
, "%d VFs requested; only %d enabled\n",
520 static struct device_attribute sriov_totalvfs_attr
= __ATTR_RO(sriov_totalvfs
);
521 static struct device_attribute sriov_numvfs_attr
=
522 __ATTR(sriov_numvfs
, (S_IRUGO
|S_IWUSR
|S_IWGRP
),
523 sriov_numvfs_show
, sriov_numvfs_store
);
524 #endif /* CONFIG_PCI_IOV */
526 static ssize_t
driver_override_store(struct device
*dev
,
527 struct device_attribute
*attr
,
528 const char *buf
, size_t count
)
530 struct pci_dev
*pdev
= to_pci_dev(dev
);
531 char *driver_override
, *old
= pdev
->driver_override
, *cp
;
533 /* We need to keep extra room for a newline */
534 if (count
>= (PAGE_SIZE
- 1))
537 driver_override
= kstrndup(buf
, count
, GFP_KERNEL
);
538 if (!driver_override
)
541 cp
= strchr(driver_override
, '\n');
545 if (strlen(driver_override
)) {
546 pdev
->driver_override
= driver_override
;
548 kfree(driver_override
);
549 pdev
->driver_override
= NULL
;
557 static ssize_t
driver_override_show(struct device
*dev
,
558 struct device_attribute
*attr
, char *buf
)
560 struct pci_dev
*pdev
= to_pci_dev(dev
);
562 return snprintf(buf
, PAGE_SIZE
, "%s\n", pdev
->driver_override
);
564 static DEVICE_ATTR_RW(driver_override
);
566 static struct attribute
*pci_dev_attrs
[] = {
567 &dev_attr_resource
.attr
,
568 &dev_attr_vendor
.attr
,
569 &dev_attr_device
.attr
,
570 &dev_attr_subsystem_vendor
.attr
,
571 &dev_attr_subsystem_device
.attr
,
572 &dev_attr_revision
.attr
,
573 &dev_attr_class
.attr
,
575 &dev_attr_local_cpus
.attr
,
576 &dev_attr_local_cpulist
.attr
,
577 &dev_attr_modalias
.attr
,
579 &dev_attr_numa_node
.attr
,
581 &dev_attr_dma_mask_bits
.attr
,
582 &dev_attr_consistent_dma_mask_bits
.attr
,
583 &dev_attr_enable
.attr
,
584 &dev_attr_broken_parity_status
.attr
,
585 &dev_attr_msi_bus
.attr
,
586 #if defined(CONFIG_PM) && defined(CONFIG_ACPI)
587 &dev_attr_d3cold_allowed
.attr
,
590 &dev_attr_devspec
.attr
,
592 &dev_attr_driver_override
.attr
,
596 static const struct attribute_group pci_dev_group
= {
597 .attrs
= pci_dev_attrs
,
600 const struct attribute_group
*pci_dev_groups
[] = {
605 static struct attribute
*pcibus_attrs
[] = {
606 &dev_attr_rescan
.attr
,
607 &dev_attr_cpuaffinity
.attr
,
608 &dev_attr_cpulistaffinity
.attr
,
612 static const struct attribute_group pcibus_group
= {
613 .attrs
= pcibus_attrs
,
616 const struct attribute_group
*pcibus_groups
[] = {
621 static ssize_t
boot_vga_show(struct device
*dev
, struct device_attribute
*attr
,
624 struct pci_dev
*pdev
= to_pci_dev(dev
);
625 struct pci_dev
*vga_dev
= vga_default_device();
628 return sprintf(buf
, "%u\n", (pdev
== vga_dev
));
630 return sprintf(buf
, "%u\n",
631 !!(pdev
->resource
[PCI_ROM_RESOURCE
].flags
&
632 IORESOURCE_ROM_SHADOW
));
634 static struct device_attribute vga_attr
= __ATTR_RO(boot_vga
);
636 static ssize_t
pci_read_config(struct file
*filp
, struct kobject
*kobj
,
637 struct bin_attribute
*bin_attr
, char *buf
,
638 loff_t off
, size_t count
)
640 struct pci_dev
*dev
= to_pci_dev(kobj_to_dev(kobj
));
641 unsigned int size
= 64;
642 loff_t init_off
= off
;
643 u8
*data
= (u8
*) buf
;
645 /* Several chips lock up trying to read undefined config space */
646 if (file_ns_capable(filp
, &init_user_ns
, CAP_SYS_ADMIN
))
647 size
= dev
->cfg_size
;
648 else if (dev
->hdr_type
== PCI_HEADER_TYPE_CARDBUS
)
653 if (off
+ count
> size
) {
660 pci_config_pm_runtime_get(dev
);
662 if ((off
& 1) && size
) {
664 pci_user_read_config_byte(dev
, off
, &val
);
665 data
[off
- init_off
] = val
;
670 if ((off
& 3) && size
> 2) {
672 pci_user_read_config_word(dev
, off
, &val
);
673 data
[off
- init_off
] = val
& 0xff;
674 data
[off
- init_off
+ 1] = (val
>> 8) & 0xff;
681 pci_user_read_config_dword(dev
, off
, &val
);
682 data
[off
- init_off
] = val
& 0xff;
683 data
[off
- init_off
+ 1] = (val
>> 8) & 0xff;
684 data
[off
- init_off
+ 2] = (val
>> 16) & 0xff;
685 data
[off
- init_off
+ 3] = (val
>> 24) & 0xff;
692 pci_user_read_config_word(dev
, off
, &val
);
693 data
[off
- init_off
] = val
& 0xff;
694 data
[off
- init_off
+ 1] = (val
>> 8) & 0xff;
701 pci_user_read_config_byte(dev
, off
, &val
);
702 data
[off
- init_off
] = val
;
707 pci_config_pm_runtime_put(dev
);
712 static ssize_t
pci_write_config(struct file
*filp
, struct kobject
*kobj
,
713 struct bin_attribute
*bin_attr
, char *buf
,
714 loff_t off
, size_t count
)
716 struct pci_dev
*dev
= to_pci_dev(kobj_to_dev(kobj
));
717 unsigned int size
= count
;
718 loff_t init_off
= off
;
719 u8
*data
= (u8
*) buf
;
721 if (off
> dev
->cfg_size
)
723 if (off
+ count
> dev
->cfg_size
) {
724 size
= dev
->cfg_size
- off
;
728 pci_config_pm_runtime_get(dev
);
730 if ((off
& 1) && size
) {
731 pci_user_write_config_byte(dev
, off
, data
[off
- init_off
]);
736 if ((off
& 3) && size
> 2) {
737 u16 val
= data
[off
- init_off
];
738 val
|= (u16
) data
[off
- init_off
+ 1] << 8;
739 pci_user_write_config_word(dev
, off
, val
);
745 u32 val
= data
[off
- init_off
];
746 val
|= (u32
) data
[off
- init_off
+ 1] << 8;
747 val
|= (u32
) data
[off
- init_off
+ 2] << 16;
748 val
|= (u32
) data
[off
- init_off
+ 3] << 24;
749 pci_user_write_config_dword(dev
, off
, val
);
755 u16 val
= data
[off
- init_off
];
756 val
|= (u16
) data
[off
- init_off
+ 1] << 8;
757 pci_user_write_config_word(dev
, off
, val
);
763 pci_user_write_config_byte(dev
, off
, data
[off
- init_off
]);
768 pci_config_pm_runtime_put(dev
);
773 static ssize_t
read_vpd_attr(struct file
*filp
, struct kobject
*kobj
,
774 struct bin_attribute
*bin_attr
, char *buf
,
775 loff_t off
, size_t count
)
777 struct pci_dev
*dev
= to_pci_dev(kobj_to_dev(kobj
));
779 if (bin_attr
->size
> 0) {
780 if (off
> bin_attr
->size
)
782 else if (count
> bin_attr
->size
- off
)
783 count
= bin_attr
->size
- off
;
786 return pci_read_vpd(dev
, off
, count
, buf
);
789 static ssize_t
write_vpd_attr(struct file
*filp
, struct kobject
*kobj
,
790 struct bin_attribute
*bin_attr
, char *buf
,
791 loff_t off
, size_t count
)
793 struct pci_dev
*dev
= to_pci_dev(kobj_to_dev(kobj
));
795 if (bin_attr
->size
> 0) {
796 if (off
> bin_attr
->size
)
798 else if (count
> bin_attr
->size
- off
)
799 count
= bin_attr
->size
- off
;
802 return pci_write_vpd(dev
, off
, count
, buf
);
805 #ifdef HAVE_PCI_LEGACY
807 * pci_read_legacy_io - read byte(s) from legacy I/O port space
808 * @filp: open sysfs file
809 * @kobj: kobject corresponding to file to read from
810 * @bin_attr: struct bin_attribute for this file
811 * @buf: buffer to store results
812 * @off: offset into legacy I/O port space
813 * @count: number of bytes to read
815 * Reads 1, 2, or 4 bytes from legacy I/O port space using an arch specific
816 * callback routine (pci_legacy_read).
818 static ssize_t
pci_read_legacy_io(struct file
*filp
, struct kobject
*kobj
,
819 struct bin_attribute
*bin_attr
, char *buf
,
820 loff_t off
, size_t count
)
822 struct pci_bus
*bus
= to_pci_bus(kobj_to_dev(kobj
));
824 /* Only support 1, 2 or 4 byte accesses */
825 if (count
!= 1 && count
!= 2 && count
!= 4)
828 return pci_legacy_read(bus
, off
, (u32
*)buf
, count
);
832 * pci_write_legacy_io - write byte(s) to legacy I/O port space
833 * @filp: open sysfs file
834 * @kobj: kobject corresponding to file to read from
835 * @bin_attr: struct bin_attribute for this file
836 * @buf: buffer containing value to be written
837 * @off: offset into legacy I/O port space
838 * @count: number of bytes to write
840 * Writes 1, 2, or 4 bytes from legacy I/O port space using an arch specific
841 * callback routine (pci_legacy_write).
843 static ssize_t
pci_write_legacy_io(struct file
*filp
, struct kobject
*kobj
,
844 struct bin_attribute
*bin_attr
, char *buf
,
845 loff_t off
, size_t count
)
847 struct pci_bus
*bus
= to_pci_bus(kobj_to_dev(kobj
));
849 /* Only support 1, 2 or 4 byte accesses */
850 if (count
!= 1 && count
!= 2 && count
!= 4)
853 return pci_legacy_write(bus
, off
, *(u32
*)buf
, count
);
857 * pci_mmap_legacy_mem - map legacy PCI memory into user memory space
858 * @filp: open sysfs file
859 * @kobj: kobject corresponding to device to be mapped
860 * @attr: struct bin_attribute for this file
861 * @vma: struct vm_area_struct passed to mmap
863 * Uses an arch specific callback, pci_mmap_legacy_mem_page_range, to mmap
864 * legacy memory space (first meg of bus space) into application virtual
867 static int pci_mmap_legacy_mem(struct file
*filp
, struct kobject
*kobj
,
868 struct bin_attribute
*attr
,
869 struct vm_area_struct
*vma
)
871 struct pci_bus
*bus
= to_pci_bus(kobj_to_dev(kobj
));
873 return pci_mmap_legacy_page_range(bus
, vma
, pci_mmap_mem
);
877 * pci_mmap_legacy_io - map legacy PCI IO into user memory space
878 * @filp: open sysfs file
879 * @kobj: kobject corresponding to device to be mapped
880 * @attr: struct bin_attribute for this file
881 * @vma: struct vm_area_struct passed to mmap
883 * Uses an arch specific callback, pci_mmap_legacy_io_page_range, to mmap
884 * legacy IO space (first meg of bus space) into application virtual
885 * memory space. Returns -ENOSYS if the operation isn't supported
887 static int pci_mmap_legacy_io(struct file
*filp
, struct kobject
*kobj
,
888 struct bin_attribute
*attr
,
889 struct vm_area_struct
*vma
)
891 struct pci_bus
*bus
= to_pci_bus(kobj_to_dev(kobj
));
893 return pci_mmap_legacy_page_range(bus
, vma
, pci_mmap_io
);
897 * pci_adjust_legacy_attr - adjustment of legacy file attributes
898 * @b: bus to create files under
899 * @mmap_type: I/O port or memory
901 * Stub implementation. Can be overridden by arch if necessary.
903 void __weak
pci_adjust_legacy_attr(struct pci_bus
*b
,
904 enum pci_mmap_state mmap_type
)
909 * pci_create_legacy_files - create legacy I/O port and memory files
910 * @b: bus to create files under
912 * Some platforms allow access to legacy I/O port and ISA memory space on
913 * a per-bus basis. This routine creates the files and ties them into
914 * their associated read, write and mmap files from pci-sysfs.c
916 * On error unwind, but don't propagate the error to the caller
917 * as it is ok to set up the PCI bus without these files.
919 void pci_create_legacy_files(struct pci_bus
*b
)
923 b
->legacy_io
= kzalloc(sizeof(struct bin_attribute
) * 2,
928 sysfs_bin_attr_init(b
->legacy_io
);
929 b
->legacy_io
->attr
.name
= "legacy_io";
930 b
->legacy_io
->size
= 0xffff;
931 b
->legacy_io
->attr
.mode
= S_IRUSR
| S_IWUSR
;
932 b
->legacy_io
->read
= pci_read_legacy_io
;
933 b
->legacy_io
->write
= pci_write_legacy_io
;
934 b
->legacy_io
->mmap
= pci_mmap_legacy_io
;
935 pci_adjust_legacy_attr(b
, pci_mmap_io
);
936 error
= device_create_bin_file(&b
->dev
, b
->legacy_io
);
940 /* Allocated above after the legacy_io struct */
941 b
->legacy_mem
= b
->legacy_io
+ 1;
942 sysfs_bin_attr_init(b
->legacy_mem
);
943 b
->legacy_mem
->attr
.name
= "legacy_mem";
944 b
->legacy_mem
->size
= 1024*1024;
945 b
->legacy_mem
->attr
.mode
= S_IRUSR
| S_IWUSR
;
946 b
->legacy_mem
->mmap
= pci_mmap_legacy_mem
;
947 pci_adjust_legacy_attr(b
, pci_mmap_mem
);
948 error
= device_create_bin_file(&b
->dev
, b
->legacy_mem
);
955 device_remove_bin_file(&b
->dev
, b
->legacy_io
);
960 printk(KERN_WARNING
"pci: warning: could not create legacy I/O port and ISA memory resources to sysfs\n");
964 void pci_remove_legacy_files(struct pci_bus
*b
)
967 device_remove_bin_file(&b
->dev
, b
->legacy_io
);
968 device_remove_bin_file(&b
->dev
, b
->legacy_mem
);
969 kfree(b
->legacy_io
); /* both are allocated here */
972 #endif /* HAVE_PCI_LEGACY */
976 int pci_mmap_fits(struct pci_dev
*pdev
, int resno
, struct vm_area_struct
*vma
,
977 enum pci_mmap_api mmap_api
)
979 unsigned long nr
, start
, size
, pci_start
;
981 if (pci_resource_len(pdev
, resno
) == 0)
984 start
= vma
->vm_pgoff
;
985 size
= ((pci_resource_len(pdev
, resno
) - 1) >> PAGE_SHIFT
) + 1;
986 pci_start
= (mmap_api
== PCI_MMAP_PROCFS
) ?
987 pci_resource_start(pdev
, resno
) >> PAGE_SHIFT
: 0;
988 if (start
>= pci_start
&& start
< pci_start
+ size
&&
989 start
+ nr
<= pci_start
+ size
)
995 * pci_mmap_resource - map a PCI resource into user memory space
996 * @kobj: kobject for mapping
997 * @attr: struct bin_attribute for the file being mapped
998 * @vma: struct vm_area_struct passed into the mmap
999 * @write_combine: 1 for write_combine mapping
1001 * Use the regular PCI mapping routines to map a PCI resource into userspace.
1003 static int pci_mmap_resource(struct kobject
*kobj
, struct bin_attribute
*attr
,
1004 struct vm_area_struct
*vma
, int write_combine
)
1006 struct pci_dev
*pdev
= to_pci_dev(kobj_to_dev(kobj
));
1007 struct resource
*res
= attr
->private;
1008 enum pci_mmap_state mmap_type
;
1009 resource_size_t start
, end
;
1012 for (i
= 0; i
< PCI_ROM_RESOURCE
; i
++)
1013 if (res
== &pdev
->resource
[i
])
1015 if (i
>= PCI_ROM_RESOURCE
)
1018 if (res
->flags
& IORESOURCE_MEM
&& iomem_is_exclusive(res
->start
))
1021 if (!pci_mmap_fits(pdev
, i
, vma
, PCI_MMAP_SYSFS
)) {
1022 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",
1023 current
->comm
, vma
->vm_end
-vma
->vm_start
, vma
->vm_pgoff
,
1025 (u64
)pci_resource_start(pdev
, i
),
1026 (u64
)pci_resource_len(pdev
, i
));
1030 /* pci_mmap_page_range() expects the same kind of entry as coming
1031 * from /proc/bus/pci/ which is a "user visible" value. If this is
1032 * different from the resource itself, arch will do necessary fixup.
1034 pci_resource_to_user(pdev
, i
, res
, &start
, &end
);
1035 vma
->vm_pgoff
+= start
>> PAGE_SHIFT
;
1036 mmap_type
= res
->flags
& IORESOURCE_MEM
? pci_mmap_mem
: pci_mmap_io
;
1037 return pci_mmap_page_range(pdev
, vma
, mmap_type
, write_combine
);
1040 static int pci_mmap_resource_uc(struct file
*filp
, struct kobject
*kobj
,
1041 struct bin_attribute
*attr
,
1042 struct vm_area_struct
*vma
)
1044 return pci_mmap_resource(kobj
, attr
, vma
, 0);
1047 static int pci_mmap_resource_wc(struct file
*filp
, struct kobject
*kobj
,
1048 struct bin_attribute
*attr
,
1049 struct vm_area_struct
*vma
)
1051 return pci_mmap_resource(kobj
, attr
, vma
, 1);
1054 static ssize_t
pci_resource_io(struct file
*filp
, struct kobject
*kobj
,
1055 struct bin_attribute
*attr
, char *buf
,
1056 loff_t off
, size_t count
, bool write
)
1058 struct pci_dev
*pdev
= to_pci_dev(kobj_to_dev(kobj
));
1059 struct resource
*res
= attr
->private;
1060 unsigned long port
= off
;
1063 for (i
= 0; i
< PCI_ROM_RESOURCE
; i
++)
1064 if (res
== &pdev
->resource
[i
])
1066 if (i
>= PCI_ROM_RESOURCE
)
1069 port
+= pci_resource_start(pdev
, i
);
1071 if (port
> pci_resource_end(pdev
, i
))
1074 if (port
+ count
- 1 > pci_resource_end(pdev
, i
))
1080 outb(*(u8
*)buf
, port
);
1082 *(u8
*)buf
= inb(port
);
1086 outw(*(u16
*)buf
, port
);
1088 *(u16
*)buf
= inw(port
);
1092 outl(*(u32
*)buf
, port
);
1094 *(u32
*)buf
= inl(port
);
1100 static ssize_t
pci_read_resource_io(struct file
*filp
, struct kobject
*kobj
,
1101 struct bin_attribute
*attr
, char *buf
,
1102 loff_t off
, size_t count
)
1104 return pci_resource_io(filp
, kobj
, attr
, buf
, off
, count
, false);
1107 static ssize_t
pci_write_resource_io(struct file
*filp
, struct kobject
*kobj
,
1108 struct bin_attribute
*attr
, char *buf
,
1109 loff_t off
, size_t count
)
1111 return pci_resource_io(filp
, kobj
, attr
, buf
, off
, count
, true);
1115 * pci_remove_resource_files - cleanup resource files
1116 * @pdev: dev to cleanup
1118 * If we created resource files for @pdev, remove them from sysfs and
1119 * free their resources.
1121 static void pci_remove_resource_files(struct pci_dev
*pdev
)
1125 for (i
= 0; i
< PCI_ROM_RESOURCE
; i
++) {
1126 struct bin_attribute
*res_attr
;
1128 res_attr
= pdev
->res_attr
[i
];
1130 sysfs_remove_bin_file(&pdev
->dev
.kobj
, res_attr
);
1134 res_attr
= pdev
->res_attr_wc
[i
];
1136 sysfs_remove_bin_file(&pdev
->dev
.kobj
, res_attr
);
1142 static int pci_create_attr(struct pci_dev
*pdev
, int num
, int write_combine
)
1144 /* allocate attribute structure, piggyback attribute name */
1145 int name_len
= write_combine
? 13 : 10;
1146 struct bin_attribute
*res_attr
;
1147 char *res_attr_name
;
1150 res_attr
= kzalloc(sizeof(*res_attr
) + name_len
, GFP_ATOMIC
);
1154 res_attr_name
= (char *)(res_attr
+ 1);
1156 sysfs_bin_attr_init(res_attr
);
1157 if (write_combine
) {
1158 pdev
->res_attr_wc
[num
] = res_attr
;
1159 sprintf(res_attr_name
, "resource%d_wc", num
);
1160 res_attr
->mmap
= pci_mmap_resource_wc
;
1162 pdev
->res_attr
[num
] = res_attr
;
1163 sprintf(res_attr_name
, "resource%d", num
);
1164 res_attr
->mmap
= pci_mmap_resource_uc
;
1166 if (pci_resource_flags(pdev
, num
) & IORESOURCE_IO
) {
1167 res_attr
->read
= pci_read_resource_io
;
1168 res_attr
->write
= pci_write_resource_io
;
1170 res_attr
->attr
.name
= res_attr_name
;
1171 res_attr
->attr
.mode
= S_IRUSR
| S_IWUSR
;
1172 res_attr
->size
= pci_resource_len(pdev
, num
);
1173 res_attr
->private = &pdev
->resource
[num
];
1174 retval
= sysfs_create_bin_file(&pdev
->dev
.kobj
, res_attr
);
1182 * pci_create_resource_files - create resource files in sysfs for @dev
1183 * @pdev: dev in question
1185 * Walk the resources in @pdev creating files for each resource available.
1187 static int pci_create_resource_files(struct pci_dev
*pdev
)
1192 /* Expose the PCI resources from this device as files */
1193 for (i
= 0; i
< PCI_ROM_RESOURCE
; i
++) {
1195 /* skip empty resources */
1196 if (!pci_resource_len(pdev
, i
))
1199 retval
= pci_create_attr(pdev
, i
, 0);
1200 /* for prefetchable resources, create a WC mappable file */
1201 if (!retval
&& pdev
->resource
[i
].flags
& IORESOURCE_PREFETCH
)
1202 retval
= pci_create_attr(pdev
, i
, 1);
1205 pci_remove_resource_files(pdev
);
1211 #else /* !HAVE_PCI_MMAP */
1212 int __weak
pci_create_resource_files(struct pci_dev
*dev
) { return 0; }
1213 void __weak
pci_remove_resource_files(struct pci_dev
*dev
) { return; }
1214 #endif /* HAVE_PCI_MMAP */
1217 * pci_write_rom - used to enable access to the PCI ROM display
1219 * @kobj: kernel object handle
1220 * @bin_attr: struct bin_attribute for this file
1223 * @count: number of byte in input
1225 * writing anything except 0 enables it
1227 static ssize_t
pci_write_rom(struct file
*filp
, struct kobject
*kobj
,
1228 struct bin_attribute
*bin_attr
, char *buf
,
1229 loff_t off
, size_t count
)
1231 struct pci_dev
*pdev
= to_pci_dev(kobj_to_dev(kobj
));
1233 if ((off
== 0) && (*buf
== '0') && (count
== 2))
1234 pdev
->rom_attr_enabled
= 0;
1236 pdev
->rom_attr_enabled
= 1;
1242 * pci_read_rom - read a PCI ROM
1244 * @kobj: kernel object handle
1245 * @bin_attr: struct bin_attribute for this file
1246 * @buf: where to put the data we read from the ROM
1248 * @count: number of bytes to read
1250 * Put @count bytes starting at @off into @buf from the ROM in the PCI
1251 * device corresponding to @kobj.
1253 static ssize_t
pci_read_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
));
1261 if (!pdev
->rom_attr_enabled
)
1264 rom
= pci_map_rom(pdev
, &size
); /* size starts out as PCI window size */
1271 if (off
+ count
> size
)
1274 memcpy_fromio(buf
, rom
+ off
, count
);
1276 pci_unmap_rom(pdev
, rom
);
1281 static struct bin_attribute pci_config_attr
= {
1284 .mode
= S_IRUGO
| S_IWUSR
,
1286 .size
= PCI_CFG_SPACE_SIZE
,
1287 .read
= pci_read_config
,
1288 .write
= pci_write_config
,
1291 static struct bin_attribute pcie_config_attr
= {
1294 .mode
= S_IRUGO
| S_IWUSR
,
1296 .size
= PCI_CFG_SPACE_EXP_SIZE
,
1297 .read
= pci_read_config
,
1298 .write
= pci_write_config
,
1301 static ssize_t
reset_store(struct device
*dev
, struct device_attribute
*attr
,
1302 const char *buf
, size_t count
)
1304 struct pci_dev
*pdev
= to_pci_dev(dev
);
1306 ssize_t result
= kstrtoul(buf
, 0, &val
);
1314 result
= pci_reset_function(pdev
);
1321 static struct device_attribute reset_attr
= __ATTR(reset
, 0200, NULL
, reset_store
);
1323 static int pci_create_capabilities_sysfs(struct pci_dev
*dev
)
1326 struct bin_attribute
*attr
;
1328 /* If the device has VPD, try to expose it in sysfs. */
1330 attr
= kzalloc(sizeof(*attr
), GFP_ATOMIC
);
1334 sysfs_bin_attr_init(attr
);
1336 attr
->attr
.name
= "vpd";
1337 attr
->attr
.mode
= S_IRUSR
| S_IWUSR
;
1338 attr
->read
= read_vpd_attr
;
1339 attr
->write
= write_vpd_attr
;
1340 retval
= sysfs_create_bin_file(&dev
->dev
.kobj
, attr
);
1345 dev
->vpd
->attr
= attr
;
1348 /* Active State Power Management */
1349 pcie_aspm_create_sysfs_dev_files(dev
);
1351 if (!pci_probe_reset_function(dev
)) {
1352 retval
= device_create_file(&dev
->dev
, &reset_attr
);
1360 pcie_aspm_remove_sysfs_dev_files(dev
);
1361 if (dev
->vpd
&& dev
->vpd
->attr
) {
1362 sysfs_remove_bin_file(&dev
->dev
.kobj
, dev
->vpd
->attr
);
1363 kfree(dev
->vpd
->attr
);
1369 int __must_check
pci_create_sysfs_dev_files(struct pci_dev
*pdev
)
1373 struct bin_attribute
*attr
;
1375 if (!sysfs_initialized
)
1378 if (pdev
->cfg_size
> PCI_CFG_SPACE_SIZE
)
1379 retval
= sysfs_create_bin_file(&pdev
->dev
.kobj
, &pcie_config_attr
);
1381 retval
= sysfs_create_bin_file(&pdev
->dev
.kobj
, &pci_config_attr
);
1385 retval
= pci_create_resource_files(pdev
);
1387 goto err_config_file
;
1389 /* If the device has a ROM, try to expose it in sysfs. */
1390 rom_size
= pci_resource_len(pdev
, PCI_ROM_RESOURCE
);
1392 attr
= kzalloc(sizeof(*attr
), GFP_ATOMIC
);
1395 goto err_resource_files
;
1397 sysfs_bin_attr_init(attr
);
1398 attr
->size
= rom_size
;
1399 attr
->attr
.name
= "rom";
1400 attr
->attr
.mode
= S_IRUSR
| S_IWUSR
;
1401 attr
->read
= pci_read_rom
;
1402 attr
->write
= pci_write_rom
;
1403 retval
= sysfs_create_bin_file(&pdev
->dev
.kobj
, attr
);
1406 goto err_resource_files
;
1408 pdev
->rom_attr
= attr
;
1411 /* add sysfs entries for various capabilities */
1412 retval
= pci_create_capabilities_sysfs(pdev
);
1416 pci_create_firmware_label_files(pdev
);
1421 if (pdev
->rom_attr
) {
1422 sysfs_remove_bin_file(&pdev
->dev
.kobj
, pdev
->rom_attr
);
1423 kfree(pdev
->rom_attr
);
1424 pdev
->rom_attr
= NULL
;
1427 pci_remove_resource_files(pdev
);
1429 if (pdev
->cfg_size
> PCI_CFG_SPACE_SIZE
)
1430 sysfs_remove_bin_file(&pdev
->dev
.kobj
, &pcie_config_attr
);
1432 sysfs_remove_bin_file(&pdev
->dev
.kobj
, &pci_config_attr
);
1437 static void pci_remove_capabilities_sysfs(struct pci_dev
*dev
)
1439 if (dev
->vpd
&& dev
->vpd
->attr
) {
1440 sysfs_remove_bin_file(&dev
->dev
.kobj
, dev
->vpd
->attr
);
1441 kfree(dev
->vpd
->attr
);
1444 pcie_aspm_remove_sysfs_dev_files(dev
);
1445 if (dev
->reset_fn
) {
1446 device_remove_file(&dev
->dev
, &reset_attr
);
1452 * pci_remove_sysfs_dev_files - cleanup PCI specific sysfs files
1453 * @pdev: device whose entries we should free
1455 * Cleanup when @pdev is removed from sysfs.
1457 void pci_remove_sysfs_dev_files(struct pci_dev
*pdev
)
1459 if (!sysfs_initialized
)
1462 pci_remove_capabilities_sysfs(pdev
);
1464 if (pdev
->cfg_size
> PCI_CFG_SPACE_SIZE
)
1465 sysfs_remove_bin_file(&pdev
->dev
.kobj
, &pcie_config_attr
);
1467 sysfs_remove_bin_file(&pdev
->dev
.kobj
, &pci_config_attr
);
1469 pci_remove_resource_files(pdev
);
1471 if (pdev
->rom_attr
) {
1472 sysfs_remove_bin_file(&pdev
->dev
.kobj
, pdev
->rom_attr
);
1473 kfree(pdev
->rom_attr
);
1474 pdev
->rom_attr
= NULL
;
1477 pci_remove_firmware_label_files(pdev
);
1480 static int __init
pci_sysfs_init(void)
1482 struct pci_dev
*pdev
= NULL
;
1485 sysfs_initialized
= 1;
1486 for_each_pci_dev(pdev
) {
1487 retval
= pci_create_sysfs_dev_files(pdev
);
1496 late_initcall(pci_sysfs_init
);
1498 static struct attribute
*pci_dev_dev_attrs
[] = {
1503 static umode_t
pci_dev_attrs_are_visible(struct kobject
*kobj
,
1504 struct attribute
*a
, int n
)
1506 struct device
*dev
= kobj_to_dev(kobj
);
1507 struct pci_dev
*pdev
= to_pci_dev(dev
);
1509 if (a
== &vga_attr
.attr
)
1510 if ((pdev
->class >> 8) != PCI_CLASS_DISPLAY_VGA
)
1516 static struct attribute
*pci_dev_hp_attrs
[] = {
1517 &dev_remove_attr
.attr
,
1518 &dev_rescan_attr
.attr
,
1522 static umode_t
pci_dev_hp_attrs_are_visible(struct kobject
*kobj
,
1523 struct attribute
*a
, int n
)
1525 struct device
*dev
= kobj_to_dev(kobj
);
1526 struct pci_dev
*pdev
= to_pci_dev(dev
);
1528 if (pdev
->is_virtfn
)
1534 static struct attribute_group pci_dev_hp_attr_group
= {
1535 .attrs
= pci_dev_hp_attrs
,
1536 .is_visible
= pci_dev_hp_attrs_are_visible
,
1539 #ifdef CONFIG_PCI_IOV
1540 static struct attribute
*sriov_dev_attrs
[] = {
1541 &sriov_totalvfs_attr
.attr
,
1542 &sriov_numvfs_attr
.attr
,
1546 static umode_t
sriov_attrs_are_visible(struct kobject
*kobj
,
1547 struct attribute
*a
, int n
)
1549 struct device
*dev
= kobj_to_dev(kobj
);
1551 if (!dev_is_pf(dev
))
1557 static struct attribute_group sriov_dev_attr_group
= {
1558 .attrs
= sriov_dev_attrs
,
1559 .is_visible
= sriov_attrs_are_visible
,
1561 #endif /* CONFIG_PCI_IOV */
1563 static struct attribute_group pci_dev_attr_group
= {
1564 .attrs
= pci_dev_dev_attrs
,
1565 .is_visible
= pci_dev_attrs_are_visible
,
1568 static const struct attribute_group
*pci_dev_attr_groups
[] = {
1569 &pci_dev_attr_group
,
1570 &pci_dev_hp_attr_group
,
1571 #ifdef CONFIG_PCI_IOV
1572 &sriov_dev_attr_group
,
1577 struct device_type pci_dev_type
= {
1578 .groups
= pci_dev_attr_groups
,