https://github.com/gregschmit/dtuninit
https://github.com/gregschmit/dtuninit
Last synced: 8 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/gregschmit/dtuninit
- Owner: gregschmit
- License: mit
- Created: 2025-09-02T16:26:53.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2025-11-02T07:46:41.000Z (8 months ago)
- Last Synced: 2026-05-22T21:48:17.749Z (about 1 month ago)
- Language: C
- Size: 185 KB
- Stars: 0
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# dtuninit (Dynamic Tunnel Initiator)
This project implements a tunnel initiator using a userspace daemon and a set of BPF programs. The
daemon mounts the BPF programs to the configured interfaces (should at minimum be mounted to the
WLAN interface and the interface that wires the AP into the network). The BPF program then manages
the encapsulation and decapsulation of packets between the client and the peer (responder).
## TODO
- Fix cross compiling with ubox/ubus libs.
- Fix static building on Debian: `undefined symbol: eu_search_tree_init`.
- Implement GRE over UDP to support NAT.
- Implement VXLAN.
- Implement L2TPv3.
- Integrate some static analysis tools (clang static analysis, ubsan, cppcheck, etc).
- Add support for IPv6 endpoints.
## Development
Ensure you clone using the `--recurse-submodules` flag, or initialize the submodules afterwards:
```sh
git submodule update --init --recursive
```
### Coding Guidelines
- Adhere to the style defined in the `.clang-format` file.
- Use types from `stdbool.h` and `stdint.h` rather than vaguely-sized types. If a standard/external
library takes or returns specific types, then use those types.
- Use `bool` for function returns where only success/failure is needed (rather than `int`).
- Validate input pointers are not `NULL` with `check_ptr` to hopefully ensure production segfaults
are paired with a useful log message to help debugging.
- Use the logging facilities provided by `log.h` rather than `printf` or `fprintf`.
- Use `snprintf` rather than `strncpy` to avoid forgetting to null-terminate strings.
- Use typedef structs for brevity.