sysfs: clarify SYSFS_DEPRECATED help text
This should make the help text of SYSFS_DEPRECATED more clear, that this is _not_ about (what some people think it is) suppressing a few symlinks and variables, but a different sysfs _layout_ with new features. Signed-off-by: Kay Sievers <kay.sievers@vrfy.org> Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
This commit is contained in:
parent
1e0b2cf933
commit
fce3e804cf
40
init/Kconfig
40
init/Kconfig
|
@ -423,27 +423,37 @@ config SYSFS_DEPRECATED
|
||||||
bool
|
bool
|
||||||
|
|
||||||
config SYSFS_DEPRECATED_V2
|
config SYSFS_DEPRECATED_V2
|
||||||
bool "Create deprecated sysfs files"
|
bool "Create deprecated sysfs layout for older userspace tools"
|
||||||
depends on SYSFS
|
depends on SYSFS
|
||||||
default y
|
default y
|
||||||
select SYSFS_DEPRECATED
|
select SYSFS_DEPRECATED
|
||||||
help
|
help
|
||||||
This option creates deprecated symlinks such as the
|
This option switches the layout of sysfs to the deprecated
|
||||||
"device"-link, the <subsystem>:<name>-link, and the
|
version.
|
||||||
"bus"-link. It may also add deprecated key in the
|
|
||||||
uevent environment.
|
|
||||||
None of these features or values should be used today, as
|
|
||||||
they export driver core implementation details to userspace
|
|
||||||
or export properties which can't be kept stable across kernel
|
|
||||||
releases.
|
|
||||||
|
|
||||||
If enabled, this option will also move any device structures
|
The current sysfs layout features a unified device tree at
|
||||||
that belong to a class, back into the /sys/class hierarchy, in
|
/sys/devices/, which is able to express a hierarchy between
|
||||||
order to support older versions of udev and some userspace
|
class devices. If the deprecated option is set to Y, the
|
||||||
programs.
|
unified device tree is split into a bus device tree at
|
||||||
|
/sys/devices/ and several individual class device trees at
|
||||||
|
/sys/class/. The class and bus devices will be connected by
|
||||||
|
"<subsystem>:<name>" and the "device" links. The "block"
|
||||||
|
class devices, will not show up in /sys/class/block/. Some
|
||||||
|
subsystems will suppress the creation of some devices which
|
||||||
|
depend on the unified device tree.
|
||||||
|
|
||||||
If you are using a distro with the most recent userspace
|
This option is not a pure compatibility option that can
|
||||||
packages, it should be safe to say N here.
|
be safely enabled on newer distributions. It will change the
|
||||||
|
layout of sysfs to the non-extensible deprecated version,
|
||||||
|
and disable some features, which can not be exported without
|
||||||
|
confusing older userspace tools. Since 2007/2008 all major
|
||||||
|
distributions do not enable this option, and ship no tools which
|
||||||
|
depend on the deprecated layout or this option.
|
||||||
|
|
||||||
|
If you are using a new kernel on an older distribution, or use
|
||||||
|
older userspace tools, you might need to say Y here. Do not say Y,
|
||||||
|
if the original kernel, that came with your distribution, has
|
||||||
|
this option set to N.
|
||||||
|
|
||||||
config PROC_PID_CPUSET
|
config PROC_PID_CPUSET
|
||||||
bool "Include legacy /proc/<pid>/cpuset file"
|
bool "Include legacy /proc/<pid>/cpuset file"
|
||||||
|
|
Loading…
Reference in New Issue