Skip to content

Documentation: document /sys/devices/system/cpu/

Alex Chiang lkml 1 version In review

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest7 patches 11 repliesIn review

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/7Documentation: ABI: rename sysfs-devices-cache_disable properlyDocumentation/ABI/testing/sysfs-devices-cache_disable Documentation/ABI/testing/sysfs-devices-system-cpu+18 -181 reply
2/7Documentation: ABI: document /sys/devices/system/cpu/Documentation/ABI/testing/sysfs-devices-system-cpu+12 -00 replies
3/7Documentation: ABI: /sys/devices/system/cpu/ topology filesDocumentation/ABI/testing/sysfs-devices-system-cpu+28 -03 replies
4/7Documentation: ABI: /sys/devices/system/cpu/cpu#/ topology filesDocumentation/ABI/testing/sysfs-devices-system-cpu Documentation/cputopology.txt+69 -170 replies
5/7Documentation: ABI: /sys/devices/system/cpu/sched_[mc|smt]_power_savingsDocumentation/ABI/testing/sysfs-devices-system-cpu+24 -00 replies
6/7Documentation: ABI: /sys/devices/system/cpu/cpuidle/Documentation/ABI/testing/sysfs-devices-system-cpu+20 -00 replies
7/7Documentation: ABI: /sys/devices/system/cpu/cpu#/cpufreq/Documentation/ABI/testing/sysfs-devices-system-cpu+18 -00 replies

Reviews trailers per patch

1 of 7 patches has a Reviewed-by or Acked-by.

PatchDavid Rientjes
1/7A-b
2/7
3/7
4/7
5/7
6/7
7/7

Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.

Read the v1 thread

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

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