^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) What: /sys/devices/system/memory
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) Date: June 2008
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) Contact: Badari Pulavarty <pbadari@us.ibm.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) The /sys/devices/system/memory contains a snapshot of the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) internal state of the kernel memory blocks. Files could be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) added or removed dynamically to represent hot-add/remove
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) operations.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) Users: hotplug memory add/remove tools
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) http://www.ibm.com/developerworks/wikis/display/LinuxP/powerpc-utils
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) What: /sys/devices/system/memory/memoryX/removable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) Date: June 2008
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) Contact: Badari Pulavarty <pbadari@us.ibm.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) The file /sys/devices/system/memory/memoryX/removable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) indicates whether this memory block is removable or not.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) This is useful for a user-level agent to determine
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) identify removable sections of the memory before attempting
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) potentially expensive hot-remove memory operation
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) Users: hotplug memory remove tools
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) http://www.ibm.com/developerworks/wikis/display/LinuxP/powerpc-utils
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) What: /sys/devices/system/memory/memoryX/phys_device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) Date: September 2008
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) Contact: Badari Pulavarty <pbadari@us.ibm.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) The file /sys/devices/system/memory/memoryX/phys_device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) is read-only; it is a legacy interface only ever used on s390x
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) to expose the covered storage increment.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) Users: Legacy s390-tools lsmem/chmem
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) What: /sys/devices/system/memory/memoryX/phys_index
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) Date: September 2008
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) Contact: Badari Pulavarty <pbadari@us.ibm.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) The file /sys/devices/system/memory/memoryX/phys_index
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) is read-only and contains the section ID in hexadecimal
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) which is equivalent to decimal X contained in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) memory section directory name.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) What: /sys/devices/system/memory/memoryX/state
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) Date: September 2008
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) Contact: Badari Pulavarty <pbadari@us.ibm.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) The file /sys/devices/system/memory/memoryX/state
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) is read-write. When read, its contents show the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) online/offline state of the memory section. When written,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) root can toggle the the online/offline state of a removable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) memory section (see removable file description above)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) using the following commands::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) # echo online > /sys/devices/system/memory/memoryX/state
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) # echo offline > /sys/devices/system/memory/memoryX/state
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) For example, if /sys/devices/system/memory/memory22/removable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) contains a value of 1 and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) /sys/devices/system/memory/memory22/state contains the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) string "online" the following command can be executed by
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) by root to offline that section::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) # echo offline > /sys/devices/system/memory/memory22/state
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) Users: hotplug memory remove tools
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) http://www.ibm.com/developerworks/wikis/display/LinuxP/powerpc-utils
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) What: /sys/devices/system/memory/memoryX/valid_zones
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) Date: July 2014
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) Contact: Zhang Zhen <zhenzhang.zhang@huawei.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) The file /sys/devices/system/memory/memoryX/valid_zones is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) read-only and is designed to show which zone this memory
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) block can be onlined to.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) What: /sys/devices/system/memoryX/nodeY
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) Date: October 2009
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) Contact: Linux Memory Management list <linux-mm@kvack.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) When CONFIG_NUMA is enabled, a symbolic link that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) points to the corresponding NUMA node directory.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) For example, the following symbolic link is created for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) memory section 9 on node0:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) /sys/devices/system/memory/memory9/node0 -> ../../node/node0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) What: /sys/devices/system/node/nodeX/memoryY
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) Date: September 2008
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) Contact: Gary Hade <garyhade@us.ibm.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) When CONFIG_NUMA is enabled
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) /sys/devices/system/node/nodeX/memoryY is a symbolic link that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) points to the corresponding /sys/devices/system/memory/memoryY
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) memory section directory. For example, the following symbolic
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) link is created for memory section 9 on node0.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) /sys/devices/system/node/node0/memory9 -> ../../memory/memory9