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