perf data: Update documentation section on cpu topology
authorThomas Richter <[email protected]>
Mon, 28 May 2018 07:44:33 +0000 (09:44 +0200)
committerArnaldo Carvalho de Melo <[email protected]>
Wed, 30 May 2018 18:39:13 +0000 (15:39 -0300)
Add an explanation of each cpu's core and socket identifier to the
perf.data file format documentation.

Signed-off-by: Thomas Richter <[email protected]>
Cc: Heiko Carstens <[email protected]>
Cc: Hendrik Brueckner <[email protected]>
Cc: Martin Schwidefsky <[email protected]>
Link: http://lkml.kernel.org/r/[email protected]
Signed-off-by: Arnaldo Carvalho de Melo <[email protected]>
tools/perf/Documentation/perf.data-file-format.txt

index d00f0d51cab80e4a8ad35777045e09b6763b33ee..c57904a526ced09057651375ff841ce116578114 100644 (file)
@@ -153,10 +153,18 @@ struct {
        HEADER_CPU_TOPOLOGY = 13,
 
 String lists defining the core and CPU threads topology.
+The string lists are followed by a variable length array
+which contains core_id and socket_id of each cpu.
+The number of entries can be determined by the size of the
+section minus the sizes of both string lists.
 
 struct {
        struct perf_header_string_list cores; /* Variable length */
        struct perf_header_string_list threads; /* Variable length */
+       struct {
+             uint32_t core_id;
+             uint32_t socket_id;
+       } cpus[nr]; /* Variable length records */
 };
 
 Example: