xref: /OK3568_Linux_fs/kernel/Documentation/ABI/testing/sysfs-devices (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunWhat:		/sys/devices
2*4882a593SmuzhiyunDate:		February 2006
3*4882a593SmuzhiyunContact:	Greg Kroah-Hartman <gregkh@linuxfoundation.org>
4*4882a593SmuzhiyunDescription:
5*4882a593Smuzhiyun		The /sys/devices tree contains a snapshot of the
6*4882a593Smuzhiyun		internal state of the kernel device tree.  Devices will
7*4882a593Smuzhiyun		be added and removed dynamically as the machine runs,
8*4882a593Smuzhiyun		and between different kernel versions, the layout of the
9*4882a593Smuzhiyun		devices within this tree will change.
10*4882a593Smuzhiyun
11*4882a593Smuzhiyun		Please do not rely on the format of this tree because of
12*4882a593Smuzhiyun		this.  If a program wishes to find different things in
13*4882a593Smuzhiyun		the tree, please use the /sys/class structure and rely
14*4882a593Smuzhiyun		on the symlinks there to point to the proper location
15*4882a593Smuzhiyun		within the /sys/devices tree of the individual devices.
16*4882a593Smuzhiyun		Or rely on the uevent messages to notify programs of
17*4882a593Smuzhiyun		devices being added and removed from this tree to find
18*4882a593Smuzhiyun		the location of those devices.
19*4882a593Smuzhiyun
20*4882a593Smuzhiyun		Note that sometimes not all devices along the directory
21*4882a593Smuzhiyun		chain will have emitted uevent messages, so userspace
22*4882a593Smuzhiyun		programs must be able to handle such occurrences.
23*4882a593Smuzhiyun
24*4882a593SmuzhiyunUsers:
25*4882a593Smuzhiyun	udev <linux-hotplug-devel@lists.sourceforge.net>
26