extensions/libxt_bpf.man: clarify BPF code generation with tcpdump
PATCH 1/1 extensions/libxt_bpf.man: clarify BPF code generation with tcpdump
From: Willem de Bruijn <[email protected]>
The xt_bpf module applies BPF bytecode to the packet. Depending on where the module is invoked, the kernel may pass a packet with or without link layer header. Iptables has no such header.
A common tcpdump -ddd <string> compilation command may revert to a physical device that generates code for packets starting from the mac layer up (e.g., E10MB data link type: Ethernet).
Clarify in the man page that when using this tool for code generation, a suitable target device must be chosen.
Netfilter Bugzilla Bug #1048
--- extensions/libxt_bpf.man | 13 +++++++++++++ 1 file changed, 13 insertions(+)
extensions/libxt_bpf.man +13 -0
@@ -31,4 +31,17 @@ Or instead, you can invoke the nfbpf_compile utility. .IP iptables \-A OUTPUT \-m bpf \-\-bytecode "`nfbpf_compile RAW 'ip proto 6'`" \-j ACCEPT .PP +Or use tcpdump -ddd. In that case, generate BPF targeting a device with the +same data link type as the xtables match. Iptables passes packets from the +network layer up, without mac layer. Select a device with data link type RAW, +such as a tun device: +.IP +ip tuntap add tun0 mode tun +.br +ip link set tun0 up +.br +tcpdump -ddd -i tun0 ip proto 6 +.PP +See tcpdump -L -i $dev for a list of known data link types for a given device. +.PP You may want to learn more about BPF from FreeBSD's bpf(4) manpage.
Signature · 1 line
2.8.0.rc3.226.g39d4020
Quoted 6 lines · Willem de Bruijn
From: Willem de Bruijn <[email protected]>
The
xt_bpfmodule applies BPF bytecode to the packet. Depending on where the module is invoked, the kernel may pass a packet with or without link layer header. Iptables has no such header.
Quoted 8 lines
A common
tcpdump -ddd <string>compilation command may revert to a physical device that generates code for packets starting from the mac layer up (e.g., E10MB data link type: Ethernet).Clarify in the man page that when using this tool for code generation, a suitable target device must be chosen.
Netfilter Bugzilla Bug #1048
Applied, thanks.