Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1757271Ab0HEFJH (ORCPT ); Thu, 5 Aug 2010 01:09:07 -0400 Received: from fgwmail6.fujitsu.co.jp ([192.51.44.36]:40249 "EHLO fgwmail6.fujitsu.co.jp" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751033Ab0HEFJF (ORCPT ); Thu, 5 Aug 2010 01:09:05 -0400 X-SecurityPolicyCheck-FJ: OK by FujitsuOutboundMailChecker v1.3.1 Date: Thu, 5 Aug 2010 14:04:12 +0900 From: KAMEZAWA Hiroyuki To: Nathan Fontenot Cc: linux-kernel@vger.kernel.org, linux-mm@kvack.org, linuxppc-dev@ozlabs.org, Greg KH , Dave Hansen Subject: Re: [PATCH 9/9] v4 Update memory-hotplug documentation Message-Id: <20100805140412.ade72a01.kamezawa.hiroyu@jp.fujitsu.com> In-Reply-To: <4C581D30.60300@austin.ibm.com> References: <4C581A6D.9030908@austin.ibm.com> <4C581D30.60300@austin.ibm.com> Organization: FUJITSU Co. LTD. X-Mailer: Sylpheed 3.0.3 (GTK+ 2.10.14; i686-pc-mingw32) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 4552 Lines: 102 On Tue, 03 Aug 2010 08:44:16 -0500 Nathan Fontenot wrote: > Update the memory hotplug documentation to reflect the new behaviors of > memory blocks reflected in sysfs. > > Signed-off-by: Nathan Fontenot Acked-by: KAMEZAWA Hiroyuki A request from me: Could you clarify what happens if there are memory hole in [start end)_phys_index. in Documentation ? (Or add TODO list.) Thanks, -Kame > --- > Documentation/memory-hotplug.txt | 40 +++++++++++++++++++++++---------------- > 1 file changed, 24 insertions(+), 16 deletions(-) > > Index: linux-2.6/Documentation/memory-hotplug.txt > =================================================================== > --- linux-2.6.orig/Documentation/memory-hotplug.txt 2010-08-02 14:09:28.000000000 -0500 > +++ linux-2.6/Documentation/memory-hotplug.txt 2010-08-02 14:10:36.000000000 -0500 > @@ -126,36 +126,44 @@ config options. > -------------------------------- > 4 sysfs files for memory hotplug > -------------------------------- > -All sections have their device information under /sys/devices/system/memory as > +All sections have their device information in sysfs. Each section is part of > +a memory block under /sys/devices/system/memory as > > /sys/devices/system/memory/memoryXXX > -(XXX is section id.) > +(XXX is the section id.) > > -Now, XXX is defined as start_address_of_section / section_size. > +Now, XXX is defined as (start_address_of_section / section_size) of the first > +section contained in the memory block. > > For example, assume 1GiB section size. A device for a memory starting at > 0x100000000 is /sys/device/system/memory/memory4 > (0x100000000 / 1Gib = 4) > This device covers address range [0x100000000 ... 0x140000000) > > -Under each section, you can see 4 files. > +Under each section, you can see 5 files. > > -/sys/devices/system/memory/memoryXXX/phys_index > +/sys/devices/system/memory/memoryXXX/start_phys_index > +/sys/devices/system/memory/memoryXXX/end_phys_index > /sys/devices/system/memory/memoryXXX/phys_device > /sys/devices/system/memory/memoryXXX/state > /sys/devices/system/memory/memoryXXX/removable > > -'phys_index' : read-only and contains section id, same as XXX. > -'state' : read-write > - at read: contains online/offline state of memory. > - at write: user can specify "online", "offline" command > -'phys_device': read-only: designed to show the name of physical memory device. > - This is not well implemented now. > -'removable' : read-only: contains an integer value indicating > - whether the memory section is removable or not > - removable. A value of 1 indicates that the memory > - section is removable and a value of 0 indicates that > - it is not removable. > +'phys_index' : read-only and contains section id of the first section > + in the memory block, same as XXX. > +'end_phys_index' : read-only and contains section id of the last section > + in the memory block. > +'state' : read-write > + at read: contains online/offline state of memory. > + at write: user can specify "online", "offline" command > + which will be performed on al sections in the block. > +'phys_device' : read-only: designed to show the name of physical memory > + device. This is not well implemented now. > +'removable' : read-only: contains an integer value indicating > + whether the memory block is removable or not > + removable. A value of 1 indicates that the memory > + block is removable and a value of 0 indicates that > + it is not removable. A memory block is removable only if > + every section in the block is removable. > > NOTE: > These directories/files appear after physical memory hotplug phase. > > > -- > To unsubscribe from this list: send the line "unsubscribe linux-kernel" in > the body of a message to majordomo@vger.kernel.org > More majordomo info at http://vger.kernel.org/majordomo-info.html > Please read the FAQ at http://www.tux.org/lkml/ > -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/