tcpaccept-bpfcc: Trace TCP accepts
tcpaccept-bpfcc [-h] [-T] [-t] [-p PID] [-P PORT] [-4 | -6] [--cgroupmap CGROUPMAP] [--mntnsmap MNTNSMAP]
What it does
Trace TCP accepts. Part of the bcc tools (bpfcc-tools 0.35.0 on Ubuntu, installed as /usr/sbin/tcpaccept-bpfcc; upstream and other distributions call it tcpaccept). It loads an eBPF program, so it needs root.
Options you will use
-T, --time- include time column on output (HH:MM:SS)
-t, --timestamp- include timestamp on output
-p, --pid PID- trace this PID only
-P, --port PORT- comma-separated list of local ports to trace
-4, --ipv4- trace IPv4 family only
-6, --ipv6- trace IPv6 family only
--cgroupmap CGROUPMAP- trace cgroups in this BPF map only
--mntnsmap MNTNSMAP- trace mount namespaces in this BPF map only
Examples
$ sudo tcpaccept-bpfcctrace all TCP accept()s
$ sudo tcpaccept-bpfcc -tinclude timestamps
$ sudo tcpaccept-bpfcc -P 80,81only trace port 80 and 81
$ sudo tcpaccept-bpfcc -p 181only trace PID 181
$ sudo tcpaccept-bpfcc --cgroupmap mappathonly trace cgroups in this BPF map
$ sudo tcpaccept-bpfcc --mntnsmap mappathonly trace mount namespaces in the map
$ sudo tcpaccept-bpfcc -4trace IPv4 family
$ sudo tcpaccept-bpfcc -6trace IPv6 family
Gotchas
- Passive TCP connections (accept()).
- As a normal user it fails with "could not open bpf map: ..., error: Operation not permitted" (unprivileged BPF is off on Ubuntu).
Try tcpaccept-bpfcc in a real terminal Free, in your browser - a real Ubuntu terminal to try it in, with missions that check your work.