OnCallReadyStart learning

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-bpfcc

trace all TCP accept()s

$ sudo tcpaccept-bpfcc -t

include timestamps

$ sudo tcpaccept-bpfcc -P 80,81

only trace port 80 and 81

$ sudo tcpaccept-bpfcc -p 181

only trace PID 181

$ sudo tcpaccept-bpfcc --cgroupmap mappath

only trace cgroups in this BPF map

$ sudo tcpaccept-bpfcc --mntnsmap mappath

only trace mount namespaces in the map

$ sudo tcpaccept-bpfcc -4

trace IPv4 family

$ sudo tcpaccept-bpfcc -6

trace IPv6 family

Gotchas

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.