^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) What: /sys/devices/system/memory/soft_offline_page
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) Date: Sep 2009
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) KernelVersion: 2.6.33
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) Contact: andi@firstfloor.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) Soft-offline the memory page containing the physical address
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) written into this file. Input is a hex number specifying the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) physical address of the page. The kernel will then attempt
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) to soft-offline it, by moving the contents elsewhere or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) dropping it if possible. The kernel will then be placed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) on the bad page list and never be reused.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) The offlining is done in kernel specific granuality.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) Normally it's the base page size of the kernel, but
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) this might change.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) The page must be still accessible, not poisoned. The
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) kernel will never kill anything for this, but rather
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) fail the offline. Return value is the size of the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) number, or a error when the offlining failed. Reading
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) the file is not allowed.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) What: /sys/devices/system/memory/hard_offline_page
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) Date: Sep 2009
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) KernelVersion: 2.6.33
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) Contact: andi@firstfloor.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) Hard-offline the memory page containing the physical
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) address written into this file. Input is a hex number
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) specifying the physical address of the page. The
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) kernel will then attempt to hard-offline the page, by
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) trying to drop the page or killing any owner or
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) triggering IO errors if needed. Note this may kill
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) any processes owning the page. The kernel will avoid
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) to access this page assuming it's poisoned by the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) hardware.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) The offlining is done in kernel specific granuality.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) Normally it's the base page size of the kernel, but
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) this might change.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) Return value is the size of the number, or a error when
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) the offlining failed.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) Reading the file is not allowed.