Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 835fbf12 authored by Arnaldo Carvalho de Melo's avatar Arnaldo Carvalho de Melo
Browse files

perf data: Document memory topology header: HEADER_MEM_TOPOLOGY 

We forgot to update the perf.data file format document for the
HEADER_MEM_TOPOLOGY header, do it now from comments in the patch
introducing it.

Cc: Adrian Hunter <adrian.hunter@intel.com>
Cc: Andi Kleen <ak@linux.intel.com>
Cc: Chong Jiang <chongjiang@chromium.org>
Cc: Jiri Olsa <jolsa@kernel.org>
Cc: Namhyung Kim <namhyung@kernel.org>
Cc: Simon Que <sque@chromium.org>
Fixes: e2091ced ("perf tools: Add MEM_TOPOLOGY feature to perf data file")
Link: https://lkml.kernel.org/n/tip-h5lcm1nbe9ztxwm61gmadd56@git.kernel.org


Signed-off-by: default avatarArnaldo Carvalho de Melo <acme@redhat.com>
parent 8e21be4f

tools/perf/Documentation/perf.data-file-format.txt

+24 −0
Original line number Diff line number Diff line
@@ -272,6 +272,30 @@ struct { 


Two uint64_t for the time of first sample and the time of last sample.



	HEADER_SAMPLE_TOPOLOGY = 22,



Physical memory map and its node assignments.



The format of data in MEM_TOPOLOGY is as follows:



   0 - version          | for future changes

   8 - block_size_bytes | /sys/devices/system/memory/block_size_bytes

  16 - count            | number of nodes



For each node we store map of physical indexes:



  32 - node id          | node index

  40 - size             | size of bitmap

  48 - bitmap           | bitmap of memory indexes that belongs to node

                        | /sys/devices/system/node/node<NODE>/memory<INDEX>



The MEM_TOPOLOGY can be displayed with following command:



$ perf report --header-only -I

...

# memory nodes (nr 1, block size 0x8000000):

#    0 [7G]: 0-23,32-69



        HEADER_BPF_PROG_INFO = 25,



struct bpf_prog_info_linear, which contains detailed information about