diff options
Diffstat (limited to 'Documentation/ABI/testing/sysfs-bus-pci')
| -rw-r--r-- | Documentation/ABI/testing/sysfs-bus-pci | 212 |
1 files changed, 0 insertions, 212 deletions
diff --git a/Documentation/ABI/testing/sysfs-bus-pci b/Documentation/ABI/testing/sysfs-bus-pci deleted file mode 100644 index 34f51100f02..00000000000 --- a/Documentation/ABI/testing/sysfs-bus-pci +++ /dev/null @@ -1,212 +0,0 @@ -What: /sys/bus/pci/drivers/.../bind -Date: December 2003 -Contact: linux-pci@vger.kernel.org -Description: - Writing a device location to this file will cause - the driver to attempt to bind to the device found at - this location. This is useful for overriding default - bindings. The format for the location is: DDDD:BB:DD.F. - That is Domain:Bus:Device.Function and is the same as - found in /sys/bus/pci/devices/. For example: - # echo 0000:00:19.0 > /sys/bus/pci/drivers/foo/bind - (Note: kernels before 2.6.28 may require echo -n). - -What: /sys/bus/pci/drivers/.../unbind -Date: December 2003 -Contact: linux-pci@vger.kernel.org -Description: - Writing a device location to this file will cause the - driver to attempt to unbind from the device found at - this location. This may be useful when overriding default - bindings. The format for the location is: DDDD:BB:DD.F. - That is Domain:Bus:Device.Function and is the same as - found in /sys/bus/pci/devices/. For example: - # echo 0000:00:19.0 > /sys/bus/pci/drivers/foo/unbind - (Note: kernels before 2.6.28 may require echo -n). - -What: /sys/bus/pci/drivers/.../new_id -Date: December 2003 -Contact: linux-pci@vger.kernel.org -Description: - Writing a device ID to this file will attempt to - dynamically add a new device ID to a PCI device driver. - This may allow the driver to support more hardware than - was included in the driver's static device ID support - table at compile time. The format for the device ID is: - VVVV DDDD SVVV SDDD CCCC MMMM PPPP. That is Vendor ID, - Device ID, Subsystem Vendor ID, Subsystem Device ID, - Class, Class Mask, and Private Driver Data. The Vendor ID - and Device ID fields are required, the rest are optional. - Upon successfully adding an ID, the driver will probe - for the device and attempt to bind to it. For example: - # echo "8086 10f5" > /sys/bus/pci/drivers/foo/new_id - -What: /sys/bus/pci/drivers/.../remove_id -Date: February 2009 -Contact: Chris Wright <chrisw@sous-sol.org> -Description: - Writing a device ID to this file will remove an ID - that was dynamically added via the new_id sysfs entry. - The format for the device ID is: - VVVV DDDD SVVV SDDD CCCC MMMM. That is Vendor ID, Device - ID, Subsystem Vendor ID, Subsystem Device ID, Class, - and Class Mask. The Vendor ID and Device ID fields are - required, the rest are optional. After successfully - removing an ID, the driver will no longer support the - device. This is useful to ensure auto probing won't - match the driver to the device. For example: - # echo "8086 10f5" > /sys/bus/pci/drivers/foo/remove_id - -What: /sys/bus/pci/rescan -Date: January 2009 -Contact: Linux PCI developers <linux-pci@vger.kernel.org> -Description: - Writing a non-zero value to this attribute will - force a rescan of all PCI buses in the system, and - re-discover previously removed devices. - Depends on CONFIG_HOTPLUG. - -What: /sys/bus/pci/devices/.../msi_irqs/ -Date: September, 2011 -Contact: Neil Horman <nhorman@tuxdriver.com> -Description: - The /sys/devices/.../msi_irqs directory contains a variable set - of sub-directories, with each sub-directory being named after a - corresponding msi irq vector allocated to that device. Each - numbered sub-directory N contains attributes of that irq. - Note that this directory is not created for device drivers which - do not support msi irqs - -What: /sys/bus/pci/devices/.../msi_irqs/<N>/mode -Date: September 2011 -Contact: Neil Horman <nhorman@tuxdriver.com> -Description: - This attribute indicates the mode that the irq vector named by - the parent directory is in (msi vs. msix) - -What: /sys/bus/pci/devices/.../remove -Date: January 2009 -Contact: Linux PCI developers <linux-pci@vger.kernel.org> -Description: - Writing a non-zero value to this attribute will - hot-remove the PCI device and any of its children. - Depends on CONFIG_HOTPLUG. - -What: /sys/bus/pci/devices/.../pci_bus/.../rescan -Date: May 2011 -Contact: Linux PCI developers <linux-pci@vger.kernel.org> -Description: - Writing a non-zero value to this attribute will - force a rescan of the bus and all child buses, - and re-discover devices removed earlier from this - part of the device tree. Depends on CONFIG_HOTPLUG. - -What: /sys/bus/pci/devices/.../rescan -Date: January 2009 -Contact: Linux PCI developers <linux-pci@vger.kernel.org> -Description: - Writing a non-zero value to this attribute will - force a rescan of the device's parent bus and all - child buses, and re-discover devices removed earlier - from this part of the device tree. - Depends on CONFIG_HOTPLUG. - -What: /sys/bus/pci/devices/.../reset -Date: July 2009 -Contact: Michael S. Tsirkin <mst@redhat.com> -Description: - Some devices allow an individual function to be reset - without affecting other functions in the same device. - For devices that have this support, a file named reset - will be present in sysfs. Writing 1 to this file - will perform reset. - -What: /sys/bus/pci/devices/.../vpd -Date: February 2008 -Contact: Ben Hutchings <bhutchings@solarflare.com> -Description: - A file named vpd in a device directory will be a - binary file containing the Vital Product Data for the - device. It should follow the VPD format defined in - PCI Specification 2.1 or 2.2, but users should consider - that some devices may have malformatted data. If the - underlying VPD has a writable section then the - corresponding section of this file will be writable. - -What: /sys/bus/pci/devices/.../virtfnN -Date: March 2009 -Contact: Yu Zhao <yu.zhao@intel.com> -Description: - This symbolic link appears when hardware supports the SR-IOV - capability and the Physical Function driver has enabled it. - The symbolic link points to the PCI device sysfs entry of the - Virtual Function whose index is N (0...MaxVFs-1). - -What: /sys/bus/pci/devices/.../dep_link -Date: March 2009 -Contact: Yu Zhao <yu.zhao@intel.com> -Description: - This symbolic link appears when hardware supports the SR-IOV - capability and the Physical Function driver has enabled it, - and this device has vendor specific dependencies with others. - The symbolic link points to the PCI device sysfs entry of - Physical Function this device depends on. - -What: /sys/bus/pci/devices/.../physfn -Date: March 2009 -Contact: Yu Zhao <yu.zhao@intel.com> -Description: - This symbolic link appears when a device is a Virtual Function. - The symbolic link points to the PCI device sysfs entry of the - Physical Function this device associates with. - -What: /sys/bus/pci/slots/.../module -Date: June 2009 -Contact: linux-pci@vger.kernel.org -Description: - This symbolic link points to the PCI hotplug controller driver - module that manages the hotplug slot. - -What: /sys/bus/pci/devices/.../label -Date: July 2010 -Contact: Narendra K <narendra_k@dell.com>, linux-bugs@dell.com -Description: - Reading this attribute will provide the firmware - given name (SMBIOS type 41 string or ACPI _DSM string) of - the PCI device. The attribute will be created only - if the firmware has given a name to the PCI device. - ACPI _DSM string name will be given priority if the - system firmware provides SMBIOS type 41 string also. -Users: - Userspace applications interested in knowing the - firmware assigned name of the PCI device. - -What: /sys/bus/pci/devices/.../index -Date: July 2010 -Contact: Narendra K <narendra_k@dell.com>, linux-bugs@dell.com -Description: - Reading this attribute will provide the firmware - given instance (SMBIOS type 41 device type instance) of the - PCI device. The attribute will be created only if the firmware - has given an instance number to the PCI device. -Users: - Userspace applications interested in knowing the - firmware assigned device type instance of the PCI - device that can help in understanding the firmware - intended order of the PCI device. - -What: /sys/bus/pci/devices/.../acpi_index -Date: July 2010 -Contact: Narendra K <narendra_k@dell.com>, linux-bugs@dell.com -Description: - Reading this attribute will provide the firmware - given instance (ACPI _DSM instance number) of the PCI device. - The attribute will be created only if the firmware has given - an instance number to the PCI device. ACPI _DSM instance number - will be given priority if the system firmware provides SMBIOS - type 41 device type instance also. -Users: - Userspace applications interested in knowing the - firmware assigned instance number of the PCI - device that can help in understanding the firmware - intended order of the PCI device. |