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/pci.h>
20 #include <linux/stat.h>
21 #include <linux/topology.h>
26 static int sysfs_initialized
; /* = 0 */
28 /* show configuration fields */
29 #define pci_config_attr(field, format_string) \
31 field##_show(struct device *dev, struct device_attribute *attr, char *buf) \
33 struct pci_dev *pdev; \
35 pdev = to_pci_dev (dev); \
36 return sprintf (buf, format_string, pdev->field); \
39 pci_config_attr(vendor
, "0x%04x\n");
40 pci_config_attr(device
, "0x%04x\n");
41 pci_config_attr(subsystem_vendor
, "0x%04x\n");
42 pci_config_attr(subsystem_device
, "0x%04x\n");
43 pci_config_attr(class, "0x%06x\n");
44 pci_config_attr(irq
, "%u\n");
46 static ssize_t
broken_parity_status_show(struct device
*dev
,
47 struct device_attribute
*attr
,
50 struct pci_dev
*pdev
= to_pci_dev(dev
);
51 return sprintf (buf
, "%u\n", pdev
->broken_parity_status
);
54 static ssize_t
broken_parity_status_store(struct device
*dev
,
55 struct device_attribute
*attr
,
56 const char *buf
, size_t count
)
58 struct pci_dev
*pdev
= to_pci_dev(dev
);
59 ssize_t consumed
= -EINVAL
;
61 if ((count
> 0) && (*buf
== '0' || *buf
== '1')) {
62 pdev
->broken_parity_status
= *buf
== '1' ? 1 : 0;
68 static ssize_t
local_cpus_show(struct device
*dev
,
69 struct device_attribute
*attr
, char *buf
)
74 mask
= pcibus_to_cpumask(to_pci_dev(dev
)->bus
);
75 len
= cpumask_scnprintf(buf
, PAGE_SIZE
-2, mask
);
82 resource_show(struct device
* dev
, struct device_attribute
*attr
, char * buf
)
84 struct pci_dev
* pci_dev
= to_pci_dev(dev
);
88 resource_size_t start
, end
;
90 if (pci_dev
->subordinate
)
91 max
= DEVICE_COUNT_RESOURCE
;
93 for (i
= 0; i
< max
; i
++) {
94 struct resource
*res
= &pci_dev
->resource
[i
];
95 pci_resource_to_user(pci_dev
, i
, res
, &start
, &end
);
96 str
+= sprintf(str
,"0x%016llx 0x%016llx 0x%016llx\n",
97 (unsigned long long)start
,
98 (unsigned long long)end
,
99 (unsigned long long)res
->flags
);
104 static ssize_t
modalias_show(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
106 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
108 return sprintf(buf
, "pci:v%08Xd%08Xsv%08Xsd%08Xbc%02Xsc%02Xi%02x\n",
109 pci_dev
->vendor
, pci_dev
->device
,
110 pci_dev
->subsystem_vendor
, pci_dev
->subsystem_device
,
111 (u8
)(pci_dev
->class >> 16), (u8
)(pci_dev
->class >> 8),
112 (u8
)(pci_dev
->class));
115 static ssize_t
is_enabled_store(struct device
*dev
,
116 struct device_attribute
*attr
, const char *buf
,
119 ssize_t result
= -EINVAL
;
120 struct pci_dev
*pdev
= to_pci_dev(dev
);
122 /* this can crash the machine when done on the "wrong" device */
123 if (!capable(CAP_SYS_ADMIN
))
127 if (atomic_read(&pdev
->enable_cnt
) != 0)
128 pci_disable_device(pdev
);
131 } else if (*buf
== '1')
132 result
= pci_enable_device(pdev
);
134 return result
< 0 ? result
: count
;
137 static ssize_t
is_enabled_show(struct device
*dev
,
138 struct device_attribute
*attr
, char *buf
)
140 struct pci_dev
*pdev
;
142 pdev
= to_pci_dev (dev
);
143 return sprintf (buf
, "%u\n", atomic_read(&pdev
->enable_cnt
));
147 msi_bus_show(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
149 struct pci_dev
*pdev
= to_pci_dev(dev
);
151 if (!pdev
->subordinate
)
154 return sprintf (buf
, "%u\n",
155 !(pdev
->subordinate
->bus_flags
& PCI_BUS_FLAGS_NO_MSI
));
159 msi_bus_store(struct device
*dev
, struct device_attribute
*attr
,
160 const char *buf
, size_t count
)
162 struct pci_dev
*pdev
= to_pci_dev(dev
);
164 /* bad things may happen if the no_msi flag is changed
165 * while some drivers are loaded */
166 if (!capable(CAP_SYS_ADMIN
))
169 if (!pdev
->subordinate
)
173 pdev
->subordinate
->bus_flags
|= PCI_BUS_FLAGS_NO_MSI
;
174 dev_warn(&pdev
->dev
, "forced subordinate bus to not support MSI,"
175 " bad things could happen.\n");
179 pdev
->subordinate
->bus_flags
&= ~PCI_BUS_FLAGS_NO_MSI
;
180 dev_warn(&pdev
->dev
, "forced subordinate bus to support MSI,"
181 " bad things could happen.\n");
187 struct device_attribute pci_dev_attrs
[] = {
191 __ATTR_RO(subsystem_vendor
),
192 __ATTR_RO(subsystem_device
),
195 __ATTR_RO(local_cpus
),
197 __ATTR(enable
, 0600, is_enabled_show
, is_enabled_store
),
198 __ATTR(broken_parity_status
,(S_IRUGO
|S_IWUSR
),
199 broken_parity_status_show
,broken_parity_status_store
),
200 __ATTR(msi_bus
, 0644, msi_bus_show
, msi_bus_store
),
205 pci_read_config(struct kobject
*kobj
, char *buf
, loff_t off
, size_t count
)
207 struct pci_dev
*dev
= to_pci_dev(container_of(kobj
,struct device
,kobj
));
208 unsigned int size
= 64;
209 loff_t init_off
= off
;
210 u8
*data
= (u8
*) buf
;
212 /* Several chips lock up trying to read undefined config space */
213 if (capable(CAP_SYS_ADMIN
)) {
214 size
= dev
->cfg_size
;
215 } else if (dev
->hdr_type
== PCI_HEADER_TYPE_CARDBUS
) {
221 if (off
+ count
> size
) {
228 if ((off
& 1) && size
) {
230 pci_user_read_config_byte(dev
, off
, &val
);
231 data
[off
- init_off
] = val
;
236 if ((off
& 3) && size
> 2) {
238 pci_user_read_config_word(dev
, off
, &val
);
239 data
[off
- init_off
] = val
& 0xff;
240 data
[off
- init_off
+ 1] = (val
>> 8) & 0xff;
247 pci_user_read_config_dword(dev
, off
, &val
);
248 data
[off
- init_off
] = val
& 0xff;
249 data
[off
- init_off
+ 1] = (val
>> 8) & 0xff;
250 data
[off
- init_off
+ 2] = (val
>> 16) & 0xff;
251 data
[off
- init_off
+ 3] = (val
>> 24) & 0xff;
258 pci_user_read_config_word(dev
, off
, &val
);
259 data
[off
- init_off
] = val
& 0xff;
260 data
[off
- init_off
+ 1] = (val
>> 8) & 0xff;
267 pci_user_read_config_byte(dev
, off
, &val
);
268 data
[off
- init_off
] = val
;
277 pci_write_config(struct kobject
*kobj
, char *buf
, loff_t off
, size_t count
)
279 struct pci_dev
*dev
= to_pci_dev(container_of(kobj
,struct device
,kobj
));
280 unsigned int size
= count
;
281 loff_t init_off
= off
;
282 u8
*data
= (u8
*) buf
;
284 if (off
> dev
->cfg_size
)
286 if (off
+ count
> dev
->cfg_size
) {
287 size
= dev
->cfg_size
- off
;
291 if ((off
& 1) && size
) {
292 pci_user_write_config_byte(dev
, off
, data
[off
- init_off
]);
297 if ((off
& 3) && size
> 2) {
298 u16 val
= data
[off
- init_off
];
299 val
|= (u16
) data
[off
- init_off
+ 1] << 8;
300 pci_user_write_config_word(dev
, off
, val
);
306 u32 val
= data
[off
- init_off
];
307 val
|= (u32
) data
[off
- init_off
+ 1] << 8;
308 val
|= (u32
) data
[off
- init_off
+ 2] << 16;
309 val
|= (u32
) data
[off
- init_off
+ 3] << 24;
310 pci_user_write_config_dword(dev
, off
, val
);
316 u16 val
= data
[off
- init_off
];
317 val
|= (u16
) data
[off
- init_off
+ 1] << 8;
318 pci_user_write_config_word(dev
, off
, val
);
324 pci_user_write_config_byte(dev
, off
, data
[off
- init_off
]);
332 #ifdef HAVE_PCI_LEGACY
334 * pci_read_legacy_io - read byte(s) from legacy I/O port space
335 * @kobj: kobject corresponding to file to read from
336 * @buf: buffer to store results
337 * @off: offset into legacy I/O port space
338 * @count: number of bytes to read
340 * Reads 1, 2, or 4 bytes from legacy I/O port space using an arch specific
341 * callback routine (pci_legacy_read).
344 pci_read_legacy_io(struct kobject
*kobj
, char *buf
, loff_t off
, size_t count
)
346 struct pci_bus
*bus
= to_pci_bus(container_of(kobj
,
350 /* Only support 1, 2 or 4 byte accesses */
351 if (count
!= 1 && count
!= 2 && count
!= 4)
354 return pci_legacy_read(bus
, off
, (u32
*)buf
, count
);
358 * pci_write_legacy_io - write byte(s) to legacy I/O port space
359 * @kobj: kobject corresponding to file to read from
360 * @buf: buffer containing value to be written
361 * @off: offset into legacy I/O port space
362 * @count: number of bytes to write
364 * Writes 1, 2, or 4 bytes from legacy I/O port space using an arch specific
365 * callback routine (pci_legacy_write).
368 pci_write_legacy_io(struct kobject
*kobj
, char *buf
, loff_t off
, size_t count
)
370 struct pci_bus
*bus
= to_pci_bus(container_of(kobj
,
373 /* Only support 1, 2 or 4 byte accesses */
374 if (count
!= 1 && count
!= 2 && count
!= 4)
377 return pci_legacy_write(bus
, off
, *(u32
*)buf
, count
);
381 * pci_mmap_legacy_mem - map legacy PCI memory into user memory space
382 * @kobj: kobject corresponding to device to be mapped
383 * @attr: struct bin_attribute for this file
384 * @vma: struct vm_area_struct passed to mmap
386 * Uses an arch specific callback, pci_mmap_legacy_page_range, to mmap
387 * legacy memory space (first meg of bus space) into application virtual
391 pci_mmap_legacy_mem(struct kobject
*kobj
, struct bin_attribute
*attr
,
392 struct vm_area_struct
*vma
)
394 struct pci_bus
*bus
= to_pci_bus(container_of(kobj
,
398 return pci_mmap_legacy_page_range(bus
, vma
);
400 #endif /* HAVE_PCI_LEGACY */
404 * pci_mmap_resource - map a PCI resource into user memory space
405 * @kobj: kobject for mapping
406 * @attr: struct bin_attribute for the file being mapped
407 * @vma: struct vm_area_struct passed into the mmap
409 * Use the regular PCI mapping routines to map a PCI resource into userspace.
410 * FIXME: write combining? maybe automatic for prefetchable regions?
413 pci_mmap_resource(struct kobject
*kobj
, struct bin_attribute
*attr
,
414 struct vm_area_struct
*vma
)
416 struct pci_dev
*pdev
= to_pci_dev(container_of(kobj
,
417 struct device
, kobj
));
418 struct resource
*res
= (struct resource
*)attr
->private;
419 enum pci_mmap_state mmap_type
;
420 resource_size_t start
, end
;
423 for (i
= 0; i
< PCI_ROM_RESOURCE
; i
++)
424 if (res
== &pdev
->resource
[i
])
426 if (i
>= PCI_ROM_RESOURCE
)
429 /* pci_mmap_page_range() expects the same kind of entry as coming
430 * from /proc/bus/pci/ which is a "user visible" value. If this is
431 * different from the resource itself, arch will do necessary fixup.
433 pci_resource_to_user(pdev
, i
, res
, &start
, &end
);
434 vma
->vm_pgoff
+= start
>> PAGE_SHIFT
;
435 mmap_type
= res
->flags
& IORESOURCE_MEM
? pci_mmap_mem
: pci_mmap_io
;
437 return pci_mmap_page_range(pdev
, vma
, mmap_type
, 0);
441 * pci_remove_resource_files - cleanup resource files
442 * @dev: dev to cleanup
444 * If we created resource files for @dev, remove them from sysfs and
445 * free their resources.
448 pci_remove_resource_files(struct pci_dev
*pdev
)
452 for (i
= 0; i
< PCI_ROM_RESOURCE
; i
++) {
453 struct bin_attribute
*res_attr
;
455 res_attr
= pdev
->res_attr
[i
];
457 sysfs_remove_bin_file(&pdev
->dev
.kobj
, res_attr
);
464 * pci_create_resource_files - create resource files in sysfs for @dev
465 * @dev: dev in question
467 * Walk the resources in @dev creating files for each resource available.
469 static int pci_create_resource_files(struct pci_dev
*pdev
)
474 /* Expose the PCI resources from this device as files */
475 for (i
= 0; i
< PCI_ROM_RESOURCE
; i
++) {
476 struct bin_attribute
*res_attr
;
478 /* skip empty resources */
479 if (!pci_resource_len(pdev
, i
))
482 /* allocate attribute structure, piggyback attribute name */
483 res_attr
= kzalloc(sizeof(*res_attr
) + 10, GFP_ATOMIC
);
485 char *res_attr_name
= (char *)(res_attr
+ 1);
487 pdev
->res_attr
[i
] = res_attr
;
488 sprintf(res_attr_name
, "resource%d", i
);
489 res_attr
->attr
.name
= res_attr_name
;
490 res_attr
->attr
.mode
= S_IRUSR
| S_IWUSR
;
491 res_attr
->attr
.owner
= THIS_MODULE
;
492 res_attr
->size
= pci_resource_len(pdev
, i
);
493 res_attr
->mmap
= pci_mmap_resource
;
494 res_attr
->private = &pdev
->resource
[i
];
495 retval
= sysfs_create_bin_file(&pdev
->dev
.kobj
, res_attr
);
497 pci_remove_resource_files(pdev
);
506 #else /* !HAVE_PCI_MMAP */
507 static inline int pci_create_resource_files(struct pci_dev
*dev
) { return 0; }
508 static inline void pci_remove_resource_files(struct pci_dev
*dev
) { return; }
509 #endif /* HAVE_PCI_MMAP */
512 * pci_write_rom - used to enable access to the PCI ROM display
513 * @kobj: kernel object handle
516 * @count: number of byte in input
518 * writing anything except 0 enables it
521 pci_write_rom(struct kobject
*kobj
, char *buf
, loff_t off
, size_t count
)
523 struct pci_dev
*pdev
= to_pci_dev(container_of(kobj
, struct device
, kobj
));
525 if ((off
== 0) && (*buf
== '0') && (count
== 2))
526 pdev
->rom_attr_enabled
= 0;
528 pdev
->rom_attr_enabled
= 1;
534 * pci_read_rom - read a PCI ROM
535 * @kobj: kernel object handle
536 * @buf: where to put the data we read from the ROM
538 * @count: number of bytes to read
540 * Put @count bytes starting at @off into @buf from the ROM in the PCI
541 * device corresponding to @kobj.
544 pci_read_rom(struct kobject
*kobj
, char *buf
, loff_t off
, size_t count
)
546 struct pci_dev
*pdev
= to_pci_dev(container_of(kobj
, struct device
, kobj
));
550 if (!pdev
->rom_attr_enabled
)
553 rom
= pci_map_rom(pdev
, &size
); /* size starts out as PCI window size */
560 if (off
+ count
> size
)
563 memcpy_fromio(buf
, rom
+ off
, count
);
565 pci_unmap_rom(pdev
, rom
);
570 static struct bin_attribute pci_config_attr
= {
573 .mode
= S_IRUGO
| S_IWUSR
,
574 .owner
= THIS_MODULE
,
577 .read
= pci_read_config
,
578 .write
= pci_write_config
,
581 static struct bin_attribute pcie_config_attr
= {
584 .mode
= S_IRUGO
| S_IWUSR
,
585 .owner
= THIS_MODULE
,
588 .read
= pci_read_config
,
589 .write
= pci_write_config
,
592 int __must_check
pci_create_sysfs_dev_files (struct pci_dev
*pdev
)
594 struct bin_attribute
*rom_attr
= NULL
;
597 if (!sysfs_initialized
)
600 if (pdev
->cfg_size
< 4096)
601 retval
= sysfs_create_bin_file(&pdev
->dev
.kobj
, &pci_config_attr
);
603 retval
= sysfs_create_bin_file(&pdev
->dev
.kobj
, &pcie_config_attr
);
607 retval
= pci_create_resource_files(pdev
);
611 /* If the device has a ROM, try to expose it in sysfs. */
612 if (pci_resource_len(pdev
, PCI_ROM_RESOURCE
)) {
613 rom_attr
= kzalloc(sizeof(*rom_attr
), GFP_ATOMIC
);
615 pdev
->rom_attr
= rom_attr
;
616 rom_attr
->size
= pci_resource_len(pdev
, PCI_ROM_RESOURCE
);
617 rom_attr
->attr
.name
= "rom";
618 rom_attr
->attr
.mode
= S_IRUSR
;
619 rom_attr
->attr
.owner
= THIS_MODULE
;
620 rom_attr
->read
= pci_read_rom
;
621 rom_attr
->write
= pci_write_rom
;
622 retval
= sysfs_create_bin_file(&pdev
->dev
.kobj
, rom_attr
);
630 /* add platform-specific attributes */
631 pcibios_add_platform_entries(pdev
);
638 if (pdev
->cfg_size
< 4096)
639 sysfs_remove_bin_file(&pdev
->dev
.kobj
, &pci_config_attr
);
641 sysfs_remove_bin_file(&pdev
->dev
.kobj
, &pcie_config_attr
);
647 * pci_remove_sysfs_dev_files - cleanup PCI specific sysfs files
648 * @pdev: device whose entries we should free
650 * Cleanup when @pdev is removed from sysfs.
652 void pci_remove_sysfs_dev_files(struct pci_dev
*pdev
)
654 if (!sysfs_initialized
)
657 if (pdev
->cfg_size
< 4096)
658 sysfs_remove_bin_file(&pdev
->dev
.kobj
, &pci_config_attr
);
660 sysfs_remove_bin_file(&pdev
->dev
.kobj
, &pcie_config_attr
);
662 pci_remove_resource_files(pdev
);
664 if (pci_resource_len(pdev
, PCI_ROM_RESOURCE
)) {
665 if (pdev
->rom_attr
) {
666 sysfs_remove_bin_file(&pdev
->dev
.kobj
, pdev
->rom_attr
);
667 kfree(pdev
->rom_attr
);
672 static int __init
pci_sysfs_init(void)
674 struct pci_dev
*pdev
= NULL
;
677 sysfs_initialized
= 1;
678 for_each_pci_dev(pdev
) {
679 retval
= pci_create_sysfs_dev_files(pdev
);
687 __initcall(pci_sysfs_init
);