File: openwrt.md

package info (click to toggle)
mimic 0.7.0%2Bds-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 11,204 kB
  • sloc: ansic: 484,549; sh: 490; makefile: 268
file content (7 lines) | stat: -rw-r--r-- 1,012 bytes parent folder | download
1
2
3
4
5
6
7
# OpenWrt Support

We are trying to bring Mimic to OpenWrt. The packaging effort is going on in the [`openwrt` branch](https://github.com/hack3ric/mimic/tree/openwrt), where one can download build artifacts from each commit's [GitHub Actions](https://github.com/hack3ric/mimic/actions/workflows/openwrt.yml), or build it locally according to [OpenWrt documentation](https://openwrt.org/docs/guide-developer/toolchain/single.package).

However, OpenWrt does not come with both kernel BTF and kprobe configuration enabled, and [checksum hacks](checksum-hacks.md) cannot be applied without recompiling the kernel.

As some of the scenarios [does not require checksum hack](checksum-hacks.md#when-is-checksum-hack-not-necessary), we build Mimic on OpenWrt with `CHECKSUM_HACK=kprobe`. You can use Mimic normally without the kernel module using prebuilts, but if you do need the checksum hacks, you have to [build the OpenWrt image manually](https://openwrt.org/docs/guide-developer/toolchain/beginners-build-guide).