pwru Files

Major Changes

• Users can now select which SKB/XDP fields to output using --output-{skb,xdp}-metadata [#509]. For example: pwru --filter-trace-xdp --output-xdp-metadata 'xdp->rxq->dev->ifindex' host 1.1.1.1 ... 1.1.1.1:0->192.168.241.133:0(icmp) bpf_prog_3b185187f1855c4c_dummy[bpf](xdp) ifindex=2
• Added support for tunnel traffic filtering and output [#494]. For example: pwru --filter-func=udp_queue_rcv_skb 'port 8472' --output-tunnel --filter-tunnel-pcap-l3 'port 8080' --output-tcp-flags ... 172.18.0.5:54806->172.18.0.2:8472(udp) udp_queue_rcv_skb 52:2e:36:8d:11:23 -> ba:44:d8:6c:66:5a 10.244.1.205:36739->10.244.3.122:8080(tcp:SYN)
• pwru now accepts an SKB mark mask via --filter-mark mark[/mask] [#471]. For example, you can run pwru --filter-mask 0xa00/0xf00.
• The fast kprobe-multi backend is now supported for tracing kernel modules [#470]. For example: pwru --all-kmods ... Attaching kprobes (via kprobe-multi)...
• TCP flags can now be displayed when --output-tcp-flags is set [#466]. For example: pwru --output-tcp-flags 'host 1.1.1.1' ... ... 192.168.1.165:44884->1.1.1.1:80(tcp:SYN) ip_local_out
• In addition to amd64, pwru is now published for arm64 in the Docker container image [#569].
• pwru is now tested in CI tested on both amd64, but also arm64 [#576].
• pwru can now run on the LoongArch architecture [#337].

Full Changelog

• README: Mention that debugfs is optional by @brb in https://github.com/cilium/pwru/pull/447
• build(deps): bump golang.org/x/net from 0.28.0 to 0.30.0 by @dependabot[bot] in https://github.com/cilium/pwru/pull/443
• Dockerfile: build arm64 variants by @akerouanton in https://github.com/cilium/pwru/pull/449
• build(deps): bump golang.org/x/sync from 0.8.0 to 0.9.0 by @dependabot[bot] in https://github.com/cilium/pwru/pull/454
• build(deps): bump golang.org/x/sys from 0.26.0 to 0.27.0 by @dependabot[bot] in https://github.com/cilium/pwru/pull/456
• build(deps): bump actions/checkout from 4.2.1 to 4.2.2 by @dependabot[bot] in https://github.com/cilium/pwru/pull/446
• bpf: Remove OUTPUT_SKB&HAS_KPROBE_MULTI macros by @Asphaltt in https://github.com/cilium/pwru/pull/455
• Ensure fentry and kprobe programs share the maps by @jschwinger233 in https://github.com/cilium/pwru/pull/459
• Fix tracing tc-bpf with --filter-track-skb-by-stackid by @Asphaltt in https://github.com/cilium/pwru/pull/452
• Collect and output skb->cb when --filter-trace-tc by @jschwinger233 in https://github.com/cilium/pwru/pull/461
• Add --output-skb-cb by @brb in https://github.com/cilium/pwru/pull/465
• build(deps): bump golang.org/x/net from 0.30.0 to 0.32.0 by @dependabot[bot] in https://github.com/cilium/pwru/pull/463
• build(deps): bump actions/setup-go from 5.0.2 to 5.2.0 by @dependabot[bot] in https://github.com/cilium/pwru/pull/467
• build(deps): bump golang.org/x/sync from 0.9.0 to 0.10.0 by @dependabot[bot] in https://github.com/cilium/pwru/pull/473
• build(deps): bump actions/upload-artifact from 4.4.3 to 4.5.0 by @dependabot[bot] in https://github.com/cilium/pwru/pull/472
• Support --filter-mark mark/[/mask] by @rgo3 in https://github.com/cilium/pwru/pull/471
• build(deps): bump golang.org/x/net from 0.32.0 to 0.33.0 by @dependabot[bot] in https://github.com/cilium/pwru/pull/474
• Enable kprobe-multi for kmods by default by @rgo3 in https://github.com/cilium/pwru/pull/470
• build(deps): bump github.com/vishvananda/netns from 0.0.4 to 0.0.5 by @dependabot[bot] in https://github.com/cilium/pwru/pull/475
• build(deps): bump golang.org/x/arch from 0.11.0 to 0.13.0 by @dependabot[bot] in https://github.com/cilium/pwru/pull/478
• build(deps): bump golang.org/x/net from 0.33.0 to 0.34.0 by @dependabot[bot] in https://github.com/cilium/pwru/pull/479
• gh/workflows: Fix fetching pwru logs by @brb in https://github.com/cilium/pwru/pull/375
• gh/workflows: Bump LVH images by @brb in https://github.com/cilium/pwru/pull/440
• Bump cilium/ebpf to 0.17.1 by @brb in https://github.com/cilium/pwru/pull/481
• Events from kprobe.multi have eventTypeKprobeMulti set in .type by @jschwinger233 in https://github.com/cilium/pwru/pull/477
• gh/workflows: Add --backend=kprobe-multi test by @brb in https://github.com/cilium/pwru/pull/482
• cleanup: setting LogSize is deprecated/unused. by @tommyp1ckles in https://github.com/cilium/pwru/pull/487
• build(deps): bump github.com/cheggaaa/pb/v3 from 3.1.5 to 3.1.6 by @dependabot[bot] in https://github.com/cilium/pwru/pull/490
• Output TCP flags alongside tuple by @Asphaltt in https://github.com/cilium/pwru/pull/466
• gh/workflows: Set up traffic before running pwru by @brb in https://github.com/cilium/pwru/pull/493
• build(deps): bump github.com/cilium/ebpf from 0.17.1 to 0.17.2 by @dependabot[bot] in https://github.com/cilium/pwru/pull/495
• Fix broken --filter-trace-xdp caused by go-ebpf v0.17.1 by @Asphaltt in https://github.com/cilium/pwru/pull/484
• Add dummy --filter-track-{tc,xdp} tests by @brb in https://github.com/cilium/pwru/pull/492
• build(deps): bump github.com/spf13/pflag from 1.0.5 to 1.0.6 by @dependabot[bot] in https://github.com/cilium/pwru/pull/496
• build(deps): bump golang.org/x/sync from 0.10.0 to 0.11.0 by @dependabot[bot] in https://github.com/cilium/pwru/pull/500
• build(deps): bump golang.org/x/sys from 0.29.0 to 0.30.0 by @dependabot[bot] in https://github.com/cilium/pwru/pull/501
• build(deps): bump golang.org/x/arch from 0.13.0 to 0.14.0 by @dependabot[bot] in https://github.com/cilium/pwru/pull/504
• build(deps): bump golang.org/x/net from 0.34.0 to 0.35.0 by @dependabot[bot] in https://github.com/cilium/pwru/pull/505
• build(deps): bump github.com/cilium/ebpf from 0.17.2 to 0.17.3 by @dependabot[bot] in https://github.com/cilium/pwru/pull/506
• Add LoongArch support by @chenhengqi in https://github.com/cilium/pwru/pull/337
• CI: Fix Failures: Bump LVM action version to latest release. by @tommyp1ckles in https://github.com/cilium/pwru/pull/511
• Support outputting and filtering by vxlan/geneve tunnel data by @tommyp1ckles in https://github.com/cilium/pwru/pull/494
• deps: Bump github.com/cheggaaa/pb/v3 from 3.1.6 to 3.1.7 by @brb in https://github.com/cilium/pwru/pull/512
• Move static variables of big size to percpu array by @jschwinger233 in https://github.com/cilium/pwru/pull/503
• chore: Configure Renovate by @renovate[bot] in https://github.com/cilium/pwru/pull/515
• chore(deps): update actions/download-artifact digest to 95815c3 by @renovate[bot] in https://github.com/cilium/pwru/pull/521
• chore(deps): update actions/checkout digest to 85e6279 by @renovate[bot] in https://github.com/cilium/pwru/pull/517
• chore(deps): update actions/create-release digest to 4c11c9f - autoclosed by @renovate[bot] in https://github.com/cilium/pwru/pull/520
• renovate: Run go mod tidy by @brb in https://github.com/cilium/pwru/pull/524
• fix(deps): update github.com/cloudflare/cbpfc digest to ff978e9 by @renovate[bot] in https://github.com/cilium/pwru/pull/526
• chore(deps): update actions/setup-go digest to dca8468 by @renovate[bot] in https://github.com/cilium/pwru/pull/522
• fix(deps): update module golang.org/x/net to v0.36.0 [security] by @renovate[bot] in https://github.com/cilium/pwru/pull/516
• fix(deps): update module golang.org/x/sys to v0.31.0 by @renovate[bot] in https://github.com/cilium/pwru/pull/532
• chore(deps): update dependency go to v1.24.2 by @renovate[bot] in https://github.com/cilium/pwru/pull/528
• chore(deps): update docker.io/library/golang docker tag to v1.24.2 by @renovate[bot] in https://github.com/cilium/pwru/pull/529
• renovate: Run on Fri and group all deps by @brb in https://github.com/cilium/pwru/pull/535
• Remove dependabot.yml by @brb in https://github.com/cilium/pwru/pull/536
• Introduce two enhancements for func IP by @Asphaltt in https://github.com/cilium/pwru/pull/468
• go.mod: Bump to 1.24.1 by @brb in https://github.com/cilium/pwru/pull/538
• fix(deps): update all dependencies by @renovate[bot] in https://github.com/cilium/pwru/pull/537
• pwru: Add --output-skb-metadata and --output-xdp-metadata by @Asphaltt in https://github.com/cilium/pwru/pull/509
• fix(deps): update all dependencies by @renovate[bot] in https://github.com/cilium/pwru/pull/542
• Support output tuple for 802.1Q by @chenhengqi in https://github.com/cilium/pwru/pull/544
• fix(deps): update all dependencies by @renovate[bot] in https://github.com/cilium/pwru/pull/547
• fix(deps): update all dependencies by @renovate[bot] in https://github.com/cilium/pwru/pull/550
• Move Contributing to a separate file by @xmulligan in https://github.com/cilium/pwru/pull/510
• renovate: Try to fix go mod tidy issues by @brb in https://github.com/cilium/pwru/pull/553
• renovate: Fix syntax by @brb in https://github.com/cilium/pwru/pull/555
• Compile libpcap with --disable-protochain by @jschwinger233 in https://github.com/cilium/pwru/pull/558
• Add percpu buffer flag by @AdvH039 in https://github.com/cilium/pwru/pull/552
• chore(deps): update all dependencies by @renovate[bot] in https://github.com/cilium/pwru/pull/556
• renovate: Run go mod vendor by @brb in https://github.com/cilium/pwru/pull/561
• renovate: Fix syntax error by @brb in https://github.com/cilium/pwru/pull/563
• ci: add workflow to validate renovate config by @tklauser in https://github.com/cilium/pwru/pull/564
• renovate: Try go mod vendor/tidy for the group by @brb in https://github.com/cilium/pwru/pull/565
• renovate: Allow go.sum updates by @brb in https://github.com/cilium/pwru/pull/567
• vendor: Switch to rtnetlink@v2 by @brb in https://github.com/cilium/pwru/pull/568
• fix(deps): update all go dependencies main by @renovate[bot] in https://github.com/cilium/pwru/pull/566
• ci: release workflow improvements by @tklauser in https://github.com/cilium/pwru/pull/570
• ci: add workflow to build and push release multi-arch Docker images by @tklauser in https://github.com/cilium/pwru/pull/569
• Release Docker images only when v* tag is pushed by @brb in https://github.com/cilium/pwru/pull/572
• chore(deps): update docker/setup-buildx-action action to v3.11.1 by @renovate[bot] in https://github.com/cilium/pwru/pull/571
• gh/workflows: Build images per each PR by @brb in https://github.com/cilium/pwru/pull/573
• fix(deps): update all dependencies by @renovate[bot] in https://github.com/cilium/pwru/pull/574
• fix(deps): update all go dependencies main by @renovate[bot] in https://github.com/cilium/pwru/pull/575
• chore(deps): update cilium/little-vm-helper action to v0.0.25 by @renovate[bot] in https://github.com/cilium/pwru/pull/577
• fix(deps): update all go dependencies main by @renovate[bot] in https://github.com/cilium/pwru/pull/579
• chore(deps): update all dependencies by @renovate[bot] in https://github.com/cilium/pwru/pull/578
• fix: pwru build error on LoongArch by @vincentmli in https://github.com/cilium/pwru/pull/580
• fix(deps): update module github.com/spf13/pflag to v1.0.7 by @renovate[bot] in https://github.com/cilium/pwru/pull/582
• chore(deps): update actions/setup-go digest to 8e57b58 - autoclosed by @renovate[bot] in https://github.com/cilium/pwru/pull/581
• gh/workflow: Run tests on arm64 by @brb in https://github.com/cilium/pwru/pull/576
• chore(deps): update actions/checkout digest to 8edcb1b by @renovate[bot] in https://github.com/cilium/pwru/pull/584
• bice: update to v0.1.3 for Loongarch64 support by @vincentmli in https://github.com/cilium/pwru/pull/587
• Fix ARM build - BUILDPLATFORM arg is defined after use by @nmbradford in https://github.com/cilium/pwru/pull/585
• fix(deps): update all go dependencies main by @renovate[bot] in https://github.com/cilium/pwru/pull/589
• chore(deps): update all dependencies by @renovate[bot] in https://github.com/cilium/pwru/pull/588
• Bump clang to 19 by @brb in https://github.com/cilium/pwru/pull/591

New Contributors

• @akerouanton made their first contribution in https://github.com/cilium/pwru/pull/449
• @rgo3 made their first contribution in https://github.com/cilium/pwru/pull/471
• @tommyp1ckles made their first contribution in https://github.com/cilium/pwru/pull/487
• @chenhengqi made their first contribution in https://github.com/cilium/pwru/pull/337
• @renovate[bot] made their first contribution in https://github.com/cilium/pwru/pull/515
• @xmulligan made their first contribution in https://github.com/cilium/pwru/pull/510
• @AdvH039 made their first contribution in https://github.com/cilium/pwru/pull/552
• @vincentmli made their first contribution in https://github.com/cilium/pwru/pull/580
• @nmbradford made their first contribution in https://github.com/cilium/pwru/pull/585

Full Changelog: https://github.com/cilium/pwru/compare/v1.0.9...v1.0.10