2015-07-23 17:03:43

by Vince Weaver

[permalink] [raw]
Subject: [patch 03/11] perf_event_open.2: 4.1 PERF_EVENT_IOC_SET_BPF support


This manpage patch relates to the addition of the
PERF_EVENT_IOC_SET_BPF ioctl in the following commit:

commit 2541517c32be2531e0da59dfd7efc1ce844644f5
Author: Alexei Starovoitov <[email protected]>

tracing, perf: Implement BPF programs attached to kprobes

Signed-off-by: Alexei Starovoitov <[email protected]>
Reviewed-by: Steven Rostedt <[email protected]>
Reviewed-by: Masami Hiramatsu <[email protected]>
Cc: Andrew Morton <[email protected]>
Cc: Arnaldo Carvalho de Melo <[email protected]>
Cc: Arnaldo Carvalho de Melo <[email protected]>
Cc: Daniel Borkmann <[email protected]>
Cc: David S. Miller <[email protected]>
Cc: Jiri Olsa <[email protected]>
Cc: Linus Torvalds <[email protected]>
Cc: Namhyung Kim <[email protected]>
Cc: Peter Zijlstra <[email protected]>
Cc: Peter Zijlstra <[email protected]>
Link: http://lkml.kernel.org/r/[email protected]
Signed-off-by: Ingo Molnar <[email protected]>


Signed-off-by: Vince Weaver <[email protected]>

diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2
index a6b90ec..09eda9a 100644
--- a/man2/perf_event_open.2
+++ b/man2/perf_event_open.2
@@ -2570,6 +2570,19 @@ This returns the event ID value for the given event file descriptor.

The argument is a pointer to a 64-bit unsigned integer
to hold the result.
+.TP
+.BR PERF_EVENT_IOC_SET_BPF " (since Linux 4.1)"
+.\" commit 2541517c32be2531e0da59dfd7efc1ce844644f5
+This allows attaching a Berkeley Packet Filter (BPF)
+program to an existing kprobe tracepoint event.
+You need
+.B CAP_SYS_ADMIN
+privileges to use this ioctl.
+
+The argument is a BPF program file descriptor that was created by
+a previous
+.BR bpf (2)
+system call.
.SS Using prctl
A process can enable or disable all the event groups that are
attached to it using the