bpftools

BPF Tools - packet analyst toolkit

  • Owner: cloudflare/bpftools
  • Platform:
  • License:: BSD 3-Clause "New" or "Revised" License
  • Category::
  • Topic:
  • Like:
    0
      Compare:

Github stars Tracking Chart

BPF Tools

Introductory blog posts:

Here you can find a set of tool for analyzing and processing of pcap
traffic dumps. The aim of this tool is to help creating BPF rules that
will match (and drop) malicious traffic.

To run these scripts you will need:

  • Kernel headers (ideally from a 3.10+ kernel):

     $ sudo apt-get install linux-headers-generic
    
  • Installed dependencies:

     $ sudo apt-get install python-setuptools libpcap-dev \
                            libreadline-dev binutils-dev bison flex
     $ sudo easy_install pcappy
    
  • Build the binary tools in linux_tools directory:

     $ make
    

BPF Tools repository contains a number simple Python scripts, some of
them focus on analyzing pcap files, others focus more on the BPF:

  • pcap2hex, hex2pcap
  • parsedns
  • bpfgen
  • filter
  • iptables_bpf, iptables_bpf_chain

bpfgen

The core script is bpfgen which generates the BPF bytecode. For more
information please read:

$ ./bpfgen --help
$ ./bpfgen dns -- --help
$ ./bpfgen dns_validate -- --help
$ ./bpfgen suffix -- --help

iptables_bpf

This script generates a simple bash script that contains iptables
rules that drop traffic based on selected parameters.

For example, to generate a script dropping packets exactly to a domain
"example.com" you can run:

$ ./iptables_bpf dns -- example.com
Generated file 'bpf_dns_ip4_example_com.sh'

If you want commands for IPv6 use -6 flag:

$ ./iptables_bpf -6 dns -- example.com
Generated file 'bpf_dns_ip6_example_com.sh'

The rule can match any from a number listed domains:

$ ./iptables_bpf dns -- example.com example1.com example2.com
Generated file 'bpf_dns_ip4_example_com_example1_com_example2_com.sh'

If you want to match any subdomain you can use a star '*'. This will
only work if star is the only character in a domain part. Valid
examples:

$ ./iptables_bpf dns -- *.example.com
Generated file 'bpf_dns_ip4_any_example_com.sh'

$ ./iptables_bpf dns -- *.example.*.gov.de
Generated file 'bpf_dns_ip4_any_example_any_gov_de.sh'

You can run the generated script to apply the rule and match it
against one or more flooded ip addresses:

$ sudo ./bpf_dns_ip4_example_com.sh 1.2.3.4/32

To remove the iptable rule simply specify --delete:

$ sudo ./bpf_dns_ip4_example_com.sh --delete

Main metrics

Overview
Name With Ownercloudflare/bpftools
Primary LanguagePython
Program languageMakefile (Language Count: 5)
Platform
License:BSD 3-Clause "New" or "Revised" License
所有者活动
Created At2014-05-07 15:49:19
Pushed At2024-09-25 04:23:00
Last Commit At2024-09-16 10:06:29
Release Count0
用户参与
Stargazers Count1.2k
Watchers Count72
Fork Count143
Commits Count126
Has Issues Enabled
Issues Count6
Issue Open Count4
Pull Requests Count11
Pull Requests Open Count3
Pull Requests Close Count6
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private