Merge git://oss.sgi.com:8090/xfs-2.6
[linux-2.6] / Documentation / ABI / testing / sysfs-devices
1 What:           /sys/devices
2 Date:           February 2006
3 Contact:        Greg Kroah-Hartman <gregkh@suse.de>
4 Description:
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
24 Users:
25         udev <linux-hotplug-devel@lists.sourceforge.net>