xref: /linux/Documentation/ABI/testing/sysfs-bus-pci (revision 0c93ea4064a209cdc36de8a9a3003d43d08f46f7)
1What:		/sys/bus/pci/drivers/.../bind
2Date:		December 2003
3Contact:	linux-pci@vger.kernel.org
4Description:
5		Writing a device location to this file will cause
6		the driver to attempt to bind to the device found at
7		this location.	This is useful for overriding default
8		bindings.  The format for the location is: DDDD:BB:DD.F.
9		That is Domain:Bus:Device.Function and is the same as
10		found in /sys/bus/pci/devices/.  For example:
11		# echo 0000:00:19.0 > /sys/bus/pci/drivers/foo/bind
12		(Note: kernels before 2.6.28 may require echo -n).
13
14What:		/sys/bus/pci/drivers/.../unbind
15Date:		December 2003
16Contact:	linux-pci@vger.kernel.org
17Description:
18		Writing a device location to this file will cause the
19		driver to attempt to unbind from the device found at
20		this location.	This may be useful when overriding default
21		bindings.  The format for the location is: DDDD:BB:DD.F.
22		That is Domain:Bus:Device.Function and is the same as
23		found in /sys/bus/pci/devices/. For example:
24		# echo 0000:00:19.0 > /sys/bus/pci/drivers/foo/unbind
25		(Note: kernels before 2.6.28 may require echo -n).
26
27What:		/sys/bus/pci/drivers/.../new_id
28Date:		December 2003
29Contact:	linux-pci@vger.kernel.org
30Description:
31		Writing a device ID to this file will attempt to
32		dynamically add a new device ID to a PCI device driver.
33		This may allow the driver to support more hardware than
34		was included in the driver's static device ID support
35		table at compile time.  The format for the device ID is:
36		VVVV DDDD SVVV SDDD CCCC MMMM PPPP.  That is Vendor ID,
37		Device ID, Subsystem Vendor ID, Subsystem Device ID,
38		Class, Class Mask, and Private Driver Data.  The Vendor ID
39		and Device ID fields are required, the rest are optional.
40		Upon successfully adding an ID, the driver will probe
41		for the device and attempt to bind to it.  For example:
42		# echo "8086 10f5" > /sys/bus/pci/drivers/foo/new_id
43
44What:		/sys/bus/pci/devices/.../vpd
45Date:		February 2008
46Contact:	Ben Hutchings <bhutchings@solarflare.com>
47Description:
48		A file named vpd in a device directory will be a
49		binary file containing the Vital Product Data for the
50		device.  It should follow the VPD format defined in
51		PCI Specification 2.1 or 2.2, but users should consider
52		that some devices may have malformatted data.  If the
53		underlying VPD has a writable section then the
54		corresponding section of this file will be writable.
55