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

[Randy Dunlap <randy.dunlap@oracle.com>]

On Wed, 21 Oct 2009 21:45:10 -0600 Alex Chiang wrote:

> 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/

Greg does, but he's in Japan or traveling this week...


> 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.

Thanks for doing this.

> 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


---
~Randy