X-Git-Url: http://ftp.safe.ca/?a=blobdiff_plain;f=Documentation%2Fsysfs-rules.txt;h=5d8bc2cd250c009ca69054d8a51139ca877dfaf3;hb=ea876441052c2cebc27d9bd2a6f6b9bce6add408;hp=80ef562160bba8697c5623ee3b5fa9b4c163ab4a;hpb=30b1b28001fef09ea31b1c87e8e8acb962d109e2;p=safe%2Fjmp%2Flinux-2.6 diff --git a/Documentation/sysfs-rules.txt b/Documentation/sysfs-rules.txt index 80ef562..5d8bc2c 100644 --- a/Documentation/sysfs-rules.txt +++ b/Documentation/sysfs-rules.txt @@ -3,9 +3,8 @@ Rules on how to access information in the Linux kernel sysfs The kernel-exported sysfs exports internal kernel implementation details and depends on internal kernel structures and layout. It is agreed upon by the kernel developers that the Linux kernel does not provide a stable -internal API. As sysfs is a direct export of kernel internal -structures, the sysfs interface cannot provide a stable interface either; -it may always change along with internal kernel changes. +internal API. Therefore, there are aspects of the sysfs interface that +may not be stable across kernel releases. To minimize the risk of breaking users of sysfs, which are in most cases low-level userspace applications, with a new kernel release, the users @@ -114,7 +113,7 @@ versions of the sysfs interface. "devices" directory at /sys/subsystem//devices. If /sys/subsystem exists, /sys/bus, /sys/class and /sys/block can be - ignored. If it does not exist, you have always to scan all three + ignored. If it does not exist, you always have to scan all three places, as the kernel is free to move a subsystem from one place to the other, as long as the devices are still reachable by the same subsystem name.