113 lines
		
	
	
		
			4.3 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			113 lines
		
	
	
		
			4.3 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
What:		/sys/devices/system/memory
 | 
						|
Date:		June 2008
 | 
						|
Contact:	Badari Pulavarty <pbadari@us.ibm.com>
 | 
						|
Description:
 | 
						|
		The /sys/devices/system/memory contains a snapshot of the
 | 
						|
		internal state of the kernel memory blocks. Files could be
 | 
						|
		added or removed dynamically to represent hot-add/remove
 | 
						|
		operations.
 | 
						|
Users:		hotplug memory add/remove tools
 | 
						|
		http://www.ibm.com/developerworks/wikis/display/LinuxP/powerpc-utils
 | 
						|
 | 
						|
What:		/sys/devices/system/memory/memoryX/removable
 | 
						|
Date:		June 2008
 | 
						|
Contact:	Badari Pulavarty <pbadari@us.ibm.com>
 | 
						|
Description:
 | 
						|
		The file /sys/devices/system/memory/memoryX/removable is a
 | 
						|
		legacy interface used to indicated whether a memory block is
 | 
						|
		likely to be offlineable or not.  Newer kernel versions return
 | 
						|
		"1" if and only if the kernel supports memory offlining.
 | 
						|
Users:		hotplug memory remove tools
 | 
						|
		http://www.ibm.com/developerworks/wikis/display/LinuxP/powerpc-utils
 | 
						|
		lsmem/chmem part of util-linux
 | 
						|
 | 
						|
What:		/sys/devices/system/memory/memoryX/phys_device
 | 
						|
Date:		September 2008
 | 
						|
Contact:	Badari Pulavarty <pbadari@us.ibm.com>
 | 
						|
Description:
 | 
						|
		The file /sys/devices/system/memory/memoryX/phys_device
 | 
						|
		is read-only;  it is a legacy interface only ever used on s390x
 | 
						|
		to expose the covered storage increment.
 | 
						|
Users:		Legacy s390-tools lsmem/chmem
 | 
						|
 | 
						|
What:		/sys/devices/system/memory/memoryX/phys_index
 | 
						|
Date:		September 2008
 | 
						|
Contact:	Badari Pulavarty <pbadari@us.ibm.com>
 | 
						|
Description:
 | 
						|
		The file /sys/devices/system/memory/memoryX/phys_index
 | 
						|
		is read-only and contains the section ID in hexadecimal
 | 
						|
		which is equivalent to decimal X contained in the
 | 
						|
		memory section directory name.
 | 
						|
 | 
						|
What:		/sys/devices/system/memory/memoryX/state
 | 
						|
Date:		September 2008
 | 
						|
Contact:	Badari Pulavarty <pbadari@us.ibm.com>
 | 
						|
Description:
 | 
						|
		The file /sys/devices/system/memory/memoryX/state
 | 
						|
		is read-write.  When read, it returns the online/offline
 | 
						|
		state of the memory block.  When written, root can toggle
 | 
						|
		the online/offline state of a memory block using the following
 | 
						|
		commands::
 | 
						|
 | 
						|
		  # echo online > /sys/devices/system/memory/memoryX/state
 | 
						|
		  # echo offline > /sys/devices/system/memory/memoryX/state
 | 
						|
 | 
						|
		On newer kernel versions, advanced states can be specified
 | 
						|
		when onlining to select a target zone: "online_movable"
 | 
						|
		selects the movable zone.  "online_kernel" selects the
 | 
						|
		applicable kernel zone (DMA, DMA32, or Normal).  However,
 | 
						|
		after successfully setting one of the advanced states,
 | 
						|
		reading the file will return "online"; the zone information
 | 
						|
		can be obtained via "valid_zones" instead.
 | 
						|
 | 
						|
		While onlining is unlikely to fail, there are no guarantees
 | 
						|
		that offlining will succeed.  Offlining is more likely to
 | 
						|
		succeed if "valid_zones" indicates "Movable".
 | 
						|
Users:		hotplug memory remove tools
 | 
						|
		http://www.ibm.com/developerworks/wikis/display/LinuxP/powerpc-utils
 | 
						|
 | 
						|
 | 
						|
What:           /sys/devices/system/memory/memoryX/valid_zones
 | 
						|
Date:           July 2014
 | 
						|
Contact:	Zhang Zhen <zhenzhang.zhang@huawei.com>
 | 
						|
Description:
 | 
						|
		The file /sys/devices/system/memory/memoryX/valid_zones	is
 | 
						|
		read-only.
 | 
						|
 | 
						|
		For online memory blocks, it returns in which zone memory
 | 
						|
		provided by a memory block is managed.  If multiple zones
 | 
						|
		apply (not applicable for hotplugged memory), "None" is returned
 | 
						|
		and the memory block cannot be offlined.
 | 
						|
 | 
						|
		For offline memory blocks, it returns by which zone memory
 | 
						|
		provided by a memory block can be managed when onlining.
 | 
						|
		The first returned zone ("default") will be used when setting
 | 
						|
		the state of an offline memory block to "online".  Only one of
 | 
						|
		the kernel zones (DMA, DMA32, Normal) is applicable for a single
 | 
						|
		memory block.
 | 
						|
 | 
						|
What:		/sys/devices/system/memoryX/nodeY
 | 
						|
Date:		October 2009
 | 
						|
Contact:	Linux Memory Management list <linux-mm@kvack.org>
 | 
						|
Description:
 | 
						|
		When CONFIG_NUMA is enabled, a symbolic link that
 | 
						|
		points to the corresponding NUMA node directory.
 | 
						|
 | 
						|
		For example, the following symbolic link is created for
 | 
						|
		memory section 9 on node0:
 | 
						|
 | 
						|
		/sys/devices/system/memory/memory9/node0 -> ../../node/node0
 | 
						|
 | 
						|
 | 
						|
What:		/sys/devices/system/node/nodeX/memoryY
 | 
						|
Date:		September 2008
 | 
						|
Contact:	Gary Hade <garyhade@us.ibm.com>
 | 
						|
Description:
 | 
						|
		When CONFIG_NUMA is enabled
 | 
						|
		/sys/devices/system/node/nodeX/memoryY is a symbolic link that
 | 
						|
		points to the corresponding /sys/devices/system/memory/memoryY
 | 
						|
		memory section directory.  For example, the following symbolic
 | 
						|
		link is created for memory section 9 on node0.
 | 
						|
 | 
						|
		/sys/devices/system/node/node0/memory9 -> ../../memory/memory9
 |