public inbox for linux-kernel@vger.kernel.org
 help / color / mirror / Atom feed
From: Alex Chiang <achiang@hp.com>
To: randy.dunlap@oracle.com, greg@kroah.com
Cc: akpm@linux-foundation.org, linux-kernel@vger.kernel.org,
	rientjes@google.com
Subject: [PATCH 0/7] Documentation: document /sys/devices/system/cpu/
Date: Wed, 21 Oct 2009 21:45:10 -0600	[thread overview]
Message-ID: <20091022033506.13399.90799.stgit@bob.kio> (raw)

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


             reply	other threads:[~2009-10-22  3:45 UTC|newest]

Thread overview: 19+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2009-10-22  3:45 Alex Chiang [this message]
2009-10-22  3:45 ` [PATCH 1/7] Documentation: ABI: rename sysfs-devices-cache_disable properly Alex Chiang
2009-10-22  8:45   ` David Rientjes
2009-10-22  3:45 ` [PATCH 2/7] Documentation: ABI: document /sys/devices/system/cpu/ Alex Chiang
2009-10-22  3:45 ` [PATCH 3/7] Documentation: ABI: /sys/devices/system/cpu/ topology files Alex Chiang
2009-10-28 21:15   ` David Rientjes
2009-10-28 21:23     ` Alex Chiang
2009-10-29  8:44       ` David Rientjes
2009-10-22  3:45 ` [PATCH 4/7] Documentation: ABI: /sys/devices/system/cpu/cpu#/ " Alex Chiang
2009-10-22  3:45 ` [PATCH 5/7] Documentation: ABI: /sys/devices/system/cpu/sched_[mc|smt]_power_savings Alex Chiang
2009-10-22  3:45 ` [PATCH 6/7] Documentation: ABI: /sys/devices/system/cpu/cpuidle/ Alex Chiang
2009-10-22  3:45 ` [PATCH 7/7] Documentation: ABI: /sys/devices/system/cpu/cpu#/cpufreq/ Alex Chiang
2009-10-22  8:42 ` [PATCH 0/7] Documentation: document /sys/devices/system/cpu/ David Rientjes
2009-10-22 17:15   ` Alex Chiang
2009-10-22 19:15     ` David Rientjes
2009-10-23  4:29   ` Greg KH
2009-10-23  9:28     ` David Rientjes
2009-10-22 21:45 ` Randy Dunlap
2009-10-23  4:29   ` Greg KH

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20091022033506.13399.90799.stgit@bob.kio \
    --to=achiang@hp.com \
    --cc=akpm@linux-foundation.org \
    --cc=greg@kroah.com \
    --cc=linux-kernel@vger.kernel.org \
    --cc=randy.dunlap@oracle.com \
    --cc=rientjes@google.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox