Skip to contentSkip to conversation

perf/docu: Update header documentation on BPF_PROG_INFO

PATCH Applied Thomas Richter 3 participants 3 messages Aug 5, 2025 – Sep 16, 2025

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 perf/docu: Update header documentation on BPF_PROG_INFO

Update the perf.data file format description on header section HEADER_BPF_PROG_INFO.
The information is taken from process_bpf_prog_info() and write_bpf_prog_info() from file util/header.c.

---
 tools/perf/Documentation/perf.data-file-format.txt | 10 ++++++++++
 1 file changed, 10 insertions(+)
tools/perf/Documentation/perf.data-file-format.txt +10 -0
index cd95ba09f727..0437eb5d9188 100644
@@ -348,6 +348,16 @@ to special needs.
 
 struct perf_bpil, which contains detailed information about
 a BPF program, including type, id, tag, jited/xlated instructions, etc.
+The format of data in HEADER_BPF_PROG_INFO is as follows:
+	u32 count
+
+	struct perf_bpil {
+		u32 info_len;	/* size of struct bpf_prog_info, when the tool is compiled */
+		u32 data_len;	/* total bytes allocated for data, round up to 8 bytes */
+		u64 arrays;	/* which arrays are included in data */
+		struct bpf_prog_info info;
+		u8  data[];
+	}[count];
 
         HEADER_BPF_BTF = 26,
 
Signature · 1 line
2.48.1
maintainer Acked-by on v1 1/1
#1 lore raw

Hello,

Quoted 8 lines · Thomas Richter

Update the perf.data file format description on header section HEADER_BPF_PROG_INFO.
The information is taken from process_bpf_prog_info() and write_bpf_prog_info() from file util/header.c.

Thanks,
Namhyung

Quoted 28 lines
---
 tools/perf/Documentation/perf.data-file-format.txt | 10 ++++++++++
 1 file changed, 10 insertions(+)
tools/perf/Documentation/perf.data-file-format.txt +10 -0
index cd95ba09f727..0437eb5d9188 100644
@@ -348,6 +348,16 @@ to special needs.
 
 struct perf_bpil, which contains detailed information about
 a BPF program, including type, id, tag, jited/xlated instructions, etc.
+The format of data in HEADER_BPF_PROG_INFO is as follows:
+	u32 count
+
+	struct perf_bpil {
+		u32 info_len;	/* size of struct bpf_prog_info, when the tool is compiled */
+		u32 data_len;	/* total bytes allocated for data, round up to 8 bytes */
+		u64 arrays;	/* which arrays are included in data */
+		struct bpf_prog_info info;
+		u8  data[];
+	}[count];
 
         HEADER_BPF_BTF = 26,
 
Signature · 1 line
2.48.1
maintainer Applied
#2 lore raw
Quoted 11 lines · Namhyung Kim
Quoted 8 lines · Thomas Richter

Update the perf.data file format description on header section HEADER_BPF_PROG_INFO.
The information is taken from process_bpf_prog_info() and write_bpf_prog_info() from file util/header.c.

Thanks, applied to perf-tools-next,

- Arnaldo