Borehole · Project · free tier
cilium/pwru
Free reading: not for reliance
8f6c94a · 759 commits · 1,294 files
Read 2026-11-03

cilium/pwru: technical due diligence, read from its repository

What Borehole read in cilium/pwru's code and history at 8f6c94a: its licence, security advisories, releases, review practice, tests, dependencies and operations. Every finding cites the file and line it rests on. The full report also covers the team and asks the questions the code cannot answer.

DimensionRating
Architecture & Codebase — including AI provenanceadequate
Engineering Process & SDLC Maturityadequate
Product & Engineering Maturityadequate
Security & Reliability Postureadequate
Observability & Operationsadequate
Fit with the Acquirernot assessable

What the repository says

  • LICENSE: Relicensed: GPL-2.0 → Apache-2.0 (2023-07-06)
  • .github/pull_request_template.md:14: states a policy on AI-generated contributions
  • CONTRIBUTING.md:3: names CNCF

Architecture & Codebase — including AI provenance

adequate
01.6

libpcap/gencode.c is 10,406 lines, 83× this codebase's median file

adequate

The median source file here is 124 lines. 20 files exceed 1,240 lines, the largest being 10,406. Size is not a defect on its own — some problems genuinely live in one place — but these are where merge conflicts, review fatigue and single-owner knowledge concentrate, and they are the first thing that slows an inheriting engineer down.

Evidence
libpcap/gencode.c:1 — 10,406 lines (83× median)
libpcap/pcap-linux.c:1 — 6,200 lines (50× median)
libpcap/pcap.c:1 — 4,641 lines (37× median)
libpcap/pcap-bpf.c:1 — 3,702 lines (29× median)
libpcap/pcap-rpcap.c:1 — 3,632 lines (29× median)
01.25

1 base image floats: no version, or `latest`

adequate

1 of 2 `FROM` lines in product Dockerfiles name an image without a version, or with `latest`. Each build pulls whatever the registry serves that day, so the image that ships can change without a commit, and last month's build cannot be reproduced. Pin a version, or a digest.

Evidence
Dockerfile:15 — base image without a version

Engineering Process & SDLC Maturity

adequate
02.3

Tests cover a thin slice of the codebase

adequate

11 test files against 228 source files (4.8%). This does not measure whether the tests are good, only whether enough of them exist for the codebase to be changed safely by someone who did not write it — which is exactly the situation after an acquisition.

Evidence
11 test files / 228 source files

Product & Engineering Maturity

adequate
04.2

439 unresolved debt markers, 3.9 per thousand lines

adequate

The codebase carries 439 TODO, FIXME, HACK or XXX markers across 112,527 lines. These are the team's own notes about work they knew was unfinished. A high density is not automatically bad — it can mean an honest team — but every one of them is a decision deferred, and after an acquisition they are deferred onto someone who was not in the room.

Evidence
.github/pull_request_template.md:7 — description and a `Fixes: #XXX` line if the commit addresses a particular
bpf/kprobe_pwru.c:410 — tpl->l4_proto = BPF_CORE_READ(ip6, nexthdr); // TODO: ipv6 l4 protocol
libpcap/CMakeLists.txt:181 — # package for it to find. XXX - what do we do here?
libpcap/CMakeLists.txt:203 — # package for it to find. XXX - what do we do here?
libpcap/CMakeLists.txt:407 — # XXX - this just tests whether the option works, fails if it doesn't,
04.38

16 files still carry code deprecated more than two years ago

adequate

16 files were marked deprecated over two years ago and still are, the oldest since Oct 2021. A deprecation is a promise to remove. Ask what still depends on these, and whether removing them is scheduled.

Evidence
vendor/github.com/cilium/ebpf/prog.go — deprecated since Oct 2021
vendor/golang.org/x/sys/unix/zsysnum_darwin_amd64.go — deprecated since Oct 2021
vendor/golang.org/x/sys/unix/zsysnum_darwin_arm64.go — deprecated since Oct 2021
vendor/github.com/cilium/ebpf/asm/instruction.go — deprecated since May 2022
vendor/golang.org/x/sys/unix/zsysnum_openbsd_386.go — deprecated since Sep 2022

Security & Reliability Posture

adequate
05.6

1 Dockerfile runs the application as root

adequate

No USER instruction switches away from root, so the process runs with full privileges inside the container. It is a one-line fix and an ordinary expectation, which is why its absence is worth asking about: it usually says more about whether anyone has reviewed the deployment than about this container specifically.

Evidence
Dockerfile — runs as root
05.45

6 workload settings give a container the host

adequate

6 places in the deployment configuration run a container privileged or in the host's network, process or IPC namespace. A compromise of that container is a compromise of the machine, and most acquirers' security reviews block it. Node agents (network, storage, monitoring) are excluded.

Evidence
actions/pwru-run/action.yaml:44 — privileged or host namespace
actions/pwru-run/action.yaml:59 — privileged or host namespace
actions/pwru-run/action.yaml:60 — privileged or host namespace
05.60

Relicensed: GPL-2.0 → Apache-2.0 (2023-07-06)

adequate

The root licence changed 1 time(s). Code taken under earlier terms stays under them; check which terms any fork or customer relied on.

Evidence
LICENSE — GPL-2.0 from 2021-10-12
LICENSE — Apache-2.0 from 2023-07-06

Observability & Operations

adequate
06.1

No telemetry or error reporting is wired in anywhere

adequate

None of 292 readable files references an instrumentation, metrics or error-reporting library. If this system is in production, nobody learns that it broke from the system itself — they learn it from a customer. That is a reliability finding before it is an observability one.

Evidence
searched 292 tracked text files for 16 known instrumentation libraries; manifests for metrics, tracing and error-reporting families; locked dependencies for the packages that emit; 0 matched
06.8

One request cannot be followed through the logs

adequate

Nothing in the service carries a request or correlation id, and there is no tracing. When a customer reports a failure, the log lines that belong to their request cannot be picked out from everyone else's.

Evidence
no request id, correlation id or tracing found
06.9

No error reporter is wired in

adequate

Nothing in the service initialises an error reporter (Sentry, Rollbar, Bugsnag, Honeybadger or an APM agent). An exception in production reaches a person only if someone is reading the logs, which usually means a customer reports it first.

Evidence
no error reporter initialised

Fit with the Acquirer

not assessable

Not rated: structurally not assessable from a repository.

Read more, or read your own

The full report on cilium/pwru: every dimension, the questions for the room, and the audit log.

Survey a repository: free on public repositories. Private code is read on your own machine by a collector whose source you can read first.