summaryrefslogtreecommitdiffstats
path: root/samples/bpf/tcp_bpf.readme
diff options
context:
space:
mode:
authorLawrence Brakmo <brakmo@fb.com>2017-11-06 03:44:10 +0100
committerDavid S. Miller <davem@davemloft.net>2017-11-08 04:13:41 +0100
commitaaf151b9e68101b03ba42d581e8a424bdd0110fe (patch)
tree05f6c2509d33d29a76333a120eb564878c1eda63 /samples/bpf/tcp_bpf.readme
parentMerge branch 'ila-make-identifier-format-optional-and-other-fixes' (diff)
downloadlinux-aaf151b9e68101b03ba42d581e8a424bdd0110fe.tar.xz
linux-aaf151b9e68101b03ba42d581e8a424bdd0110fe.zip
bpf: Rename tcp_bbf.readme to tcp_bpf.readme
The original patch had the wrong filename. Fixes: bfdf75693875 ("bpf: create samples/bpf/tcp_bpf.readme") Signed-off-by: Lawrence Brakmo <brakmo@fb.com> Acked-by: Alexei Starovoitov <ast@kernel.org> Acked-by: Daniel Borkmann <daniel@iogearbox.net> Signed-off-by: David S. Miller <davem@davemloft.net>
Diffstat (limited to 'samples/bpf/tcp_bpf.readme')
-rw-r--r--samples/bpf/tcp_bpf.readme26
1 files changed, 26 insertions, 0 deletions
diff --git a/samples/bpf/tcp_bpf.readme b/samples/bpf/tcp_bpf.readme
new file mode 100644
index 000000000000..831fb601e3c9
--- /dev/null
+++ b/samples/bpf/tcp_bpf.readme
@@ -0,0 +1,26 @@
+This file describes how to run the tcp_*_kern.o tcp_bpf (or socket_ops)
+programs. These programs attach to a cgroupv2. The following commands create
+a cgroupv2 and attach a bash shell to the group.
+
+ mkdir -p /tmp/cgroupv2
+ mount -t cgroup2 none /tmp/cgroupv2
+ mkdir -p /tmp/cgroupv2/foo
+ bash
+ echo $$ >> /tmp/cgroupv2/foo/cgroup.procs
+
+Anything that runs under this shell belongs to the foo cgroupv2 To load
+(attach) one of the tcp_*_kern.o programs:
+
+ ./load_sock_ops -l /tmp/cgroupv2/foo tcp_basertt_kern.o
+
+If the "-l" flag is used, the load_sock_ops program will continue to run
+printing the BPF log buffer. The tcp_*_kern.o programs use special print
+functions to print logging information (if enabled by the ifdef).
+
+If using netperf/netserver to create traffic, you need to run them under the
+cgroupv2 to which the BPF programs are attached (i.e. under bash shell
+attached to the cgroupv2).
+
+To remove (unattach) a socket_ops BPF program from a cgroupv2:
+
+ ./load_sock_ops -r /tmp/cgroupv2/foo