[PATCH 0/7] Documentation: document /sys/devices/system/cpu/

From: Alex Chiang
Date: Wed Oct 21 2009 - 23:45:20 EST


Hi Greg, Randy,

Not sure who actually maintains Documentation/ABI/; if it's not either of
y'all then please point me at the correct maintainer.

Anyhow, I was proposing some patches to enhance the NUMA sysfs interface:

http://thread.gmane.org/gmane.linux.kernel.mm/40084/

I documented my changes, but David Rientjes suggested that I take this
as an opportunity to do a more thorough job, so here is an attempt at
doing so by documenting at least the files that I saw on my system. Maybe
there are more that I didn't configure in, but I think this series covers
a good amount.

One thing David suggested was following the sysfs hierarchy a bit more
strictly wrt to the file name in Documentation/ABI. I renamed one existing
file, and then stuck all the new stuff into the result.

I made the decision to keep the granularity at the top level sysfs
CPU interface rather than break out each subdirectory into a separate
file. If that's not ok or preferred, let me know and I can split it out
(but I hope to avoid having to do that).

I split out each group of files into a separate patch, with my best
guess at interested parties cc'ed. That way, they can each bike-shed
me individually. ;)

Thanks,
/ac

---

Alex Chiang (7):
Documentation: ABI: rename sysfs-devices-cache_disable properly
Documentation: ABI: document /sys/devices/system/cpu/
Documentation: ABI: /sys/devices/system/cpu/ topology files
Documentation: ABI: /sys/devices/system/cpu/cpu#/ topology files
Documentation: ABI: /sys/devices/system/cpu/sched_[mc|smt]_power_savings
Documentation: ABI: /sys/devices/system/cpu/cpuidle/
Documentation: ABI: /sys/devices/system/cpu/cpu#/cpufreq/


.../ABI/testing/sysfs-devices-cache_disable | 18 --
Documentation/ABI/testing/sysfs-devices-system-cpu | 159 ++++++++++++++++++++
Documentation/cputopology.txt | 47 ++++--
3 files changed, 189 insertions(+), 35 deletions(-)
delete mode 100644 Documentation/ABI/testing/sysfs-devices-cache_disable
create mode 100644 Documentation/ABI/testing/sysfs-devices-system-cpu

--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/