xdrippi
| Crates.io | xdrippi |
| lib.rs | xdrippi |
| version | |
| source | src |
| created_at | 2024-12-03 20:52:49.157983 |
| updated_at | 2024-12-03 20:52:49.157983 |
| description | An easy to understand AF_XDP library |
| homepage | |
| repository | https://github.com/gabibbo97/xdrippi |
| max_upload_size | |
| id | 1470651 |
| Cargo.toml error: | TOML parse error at line 19, column 1 | 19 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include` |
| size | 0 |
Giacomo Longo (gabibbo97)
documentation
README
xdrippi
xdrippi is a Rust library focused on providing easy access to AF_XDP sockets and their goodies.
At the moment, this library is very experimental
Getting started
Requirements
This library requires:
clangto build the BPF programs found inside of thebpfdirectory.libbpfto be able to install the BPF trampoline.
Testing environment
On a Linux machine, run make test-net to assemble an 8-container configuration as follows:
| Container | IP Address | MAC Address | VETH name on host |
|---|---|---|---|
test1 |
10.42.0.10 |
54:00:00:00:00:10 |
test1 |
test2 |
10.42.0.20 |
54:00:00:00:00:20 |
test2 |
test3 |
10.42.0.30 |
54:00:00:00:00:30 |
test3 |
test4 |
10.42.0.40 |
54:00:00:00:00:40 |
test4 |
test5 |
10.42.0.50 |
54:00:00:00:00:50 |
test5 |
test6 |
10.42.0.60 |
54:00:00:00:00:60 |
test6 |
test7 |
10.42.0.70 |
54:00:00:00:00:70 |
test7 |
test8 |
10.42.0.80 |
54:00:00:00:00:80 |
test8 |
This environment is expected by the following examples
Example 1: recv
cargo build --example recv && sudo ./target/debug/recv
This sample will simply receive and print packets received from the first container, to send a ping run make test-ping-host
Example 2: fwd
cargo build --example fwd && sudo ./target/debug/fwd
This sample forwards packets between container 1 and container 2 in a dumb way, i.e. everything flowing in on one side ends up on the other.
To enter the first container run make shell-test1.
To enter the second container run make shell-test2.
Example 3: l2
cargo build --example l2 && sudo ./target/debug/l2
This sample builds a very simple L2 switch with all 8 containers attached to it.
To enter any container run make shell-test<x> where <x> is 1, ..., 8.
Licensing
GNU Affero General Public License version 3 or later.
Sorry, I have had my code stolen with it and I wouldn't want to risk it again.
Funding
The development of this library was indirectly sponsored by the University of Genova
Naming
Writing out the literal pronunciation of XDP in italian yields something like xdippí. Add in some brainrot about the drip meme and you can figure it out.