Commit 35c0a81a authored by Andi Kleen's avatar Andi Kleen Committed by Arnaldo Carvalho de Melo
Browse files

perf tools: Document some missing perf.data headers 



Document STAT and CACHE header entries.

Signed-off-by: default avatarAndi Kleen <ak@linux.intel.com>
Acked-by: default avatarJiri Olsa <jolsa@kernel.org>
Link: http://lkml.kernel.org/r/20171109145528.23371-2-andi@firstfloor.org


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

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

+23 −0
Original line number Diff line number Diff line
@@ -238,6 +238,29 @@ struct auxtrace_index { 
	struct auxtrace_index_entry entries[PERF_AUXTRACE_INDEX_ENTRY_COUNT];

};



	HEADER_STAT = 19,



This is merely a flag signifying that the data section contains data

recorded from perf stat record.



	HEADER_CACHE = 20,



Description of the cache hierarchy. Based on the Linux sysfs format

in /sys/devices/system/cpu/cpu*/cache/



	u32 version	Currently always 1

	u32 number_of_cache_levels



struct {

	u32	level;

	u32	line_size;

	u32	sets;

	u32	ways;

	struct perf_header_string type;

	struct perf_header_string size;

	struct perf_header_string map;

}[number_of_cache_levels];



	other bits are reserved and should ignored for now

	HEADER_FEAT_BITS	= 256,