This repository contains the material for the eBPF tutorial at the TMA PhD School.
In particular, the tutorial is divided into the following sections:
Before starting the tutorial, please make sure to have the following requirements installed. You can find the installation instructions in the Installation section.
To follow the tutorial, you can manually install the required dependencies or use the provided VMs.
To manually install the required dependencies, you need to have a Linux machine with a kernel version >= 5.15. All the commands are tested on Ubuntu 22.04.
You can install the required dependencies by running the following commands:
$ sudo apt update
$ sudo apt install -y git clang llvm llvm-dev libelf-dev linux-headers-generic build-essential libc6-dev-i386 make
$ sudo apt install -y libbfd-dev libcap-dev libpcap-dev pkg-config net-toolsAt this point, you can start building the tutorial, following the instructions in the Build section.
To make it easier for you to follow the tutorial, we provide two VMs with all the required dependencies installed.
Depending on your machine's hardware architecture, the instructions and the VM you need to download will vary. We offer two distinct VMs tailored for x86_64 and ARM64 architectures.
You can download the VirtualBox nc-labs-x86.ova image at the following URL:
Before deploying the VM, you must install VirtualBox, compatible with Windows, Linux, and macOS.
Download the VirtualBox binaries at the following URL:
https://www.virtualbox.org/wiki/Downloads
Once installed, open the nc-labs-x86.ova file to boot the VM and access the lab environment.
You can download the VM nc-labs-arm64.zip image at the following URL:
In this case, you need to install VMwareFusion, available at the following URL:
https://www.vmware.com/products/fusion.html
Note: A VMware Customer Connect account is necessary for the installation. You can register using your school address or a personal email. The VMware Fusion Player license is free for personal and student use. After installation, enter your account's license key.
After downloading the nc-labs-arm64.zip, extract it to find the nc-labs-arm64.vmwarevm file.
Open VMware Fusion, navigate to File -> Open, select the nc-labs-arm64.vmwarevm file and start the VM.
When prompted whether the machine was moved or copied, choose I copied it.
Log into the lab VM using the following credentials:
- Username: nc-labs
- Password: ncforever
To build the tutorial material, you can clone the repository and run the following commands:
git clone https://github.com/sebymiano/tma-ebpf-tutorial.git --recurse-submodules
cd tma-ebpf-tutorial
make