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