xref: /linux/Documentation/ABI/testing/ppc-memtrace (revision 8e07e0e3964ca4e23ce7b68e2096fe660a888942)
1What:		/sys/kernel/debug/powerpc/memtrace
2Date:		Aug 2017
3KernelVersion:	4.14
4Contact:	linuxppc-dev@lists.ozlabs.org
5Description:	This folder contains the relevant debugfs files for the
6		hardware trace macro to use. CONFIG_PPC64_HARDWARE_TRACING
7		must be set.
8
9What:		/sys/kernel/debug/powerpc/memtrace/enable
10Date:		Aug 2017
11KernelVersion:	4.14
12Contact:	linuxppc-dev@lists.ozlabs.org
13Description:	Write an integer containing the size in bytes of the memory
14		you want removed from each NUMA node to this file - it must be
15		aligned to the memblock size. This amount of RAM will be removed
16		from each NUMA node in the kernel mappings and the following
17		debugfs files will be created. Once memory is successfully
18		removed from each node, the following files are created. To
19		re-add memory to the kernel, echo 0 into this file (it will be
20		automatically onlined).
21
22What:		/sys/kernel/debug/powerpc/memtrace/<node-id>
23Date:		Aug 2017
24KernelVersion:	4.14
25Contact:	linuxppc-dev@lists.ozlabs.org
26Description:	This directory contains information about the removed memory
27		from the specific NUMA node.
28
29What:		/sys/kernel/debug/powerpc/memtrace/<node-id>/size
30Date:		Aug 2017
31KernelVersion:	4.14
32Contact:	linuxppc-dev@lists.ozlabs.org
33Description:	This contains the size of the memory removed from the node.
34
35What:		/sys/kernel/debug/powerpc/memtrace/<node-id>/start
36Date:		Aug 2017
37KernelVersion:	4.14
38Contact:	linuxppc-dev@lists.ozlabs.org
39Description:	This contains the start address of the removed memory.
40
41What:		/sys/kernel/debug/powerpc/memtrace/<node-id>/trace
42Date:		Aug 2017
43KernelVersion:	4.14
44Contact:	linuxppc-dev@lists.ozlabs.org
45Description:	This is where the hardware trace macro will output the trace
46		it generates.
47