Repository navigation
rootfs-diff v0.1.1
v0.1.1 adds the Apache License, Version 2.0 for rootfs-diff, updates installation documentation, and refreshes the executed Buildroot release-review example. The public Go API and comparison/CLI semantics are unchanged from v0.1.0. Every binary package includes the project LICENSE and the separate Go/third-party notices. Source: 68589a3fb3e5786fc1ad6f1d31d55ecce64eb978.
The refreshed Buildroot proof independently checks four controlled changes in two real Buildroot-generated rootfs archives:
| Path | Recorded change |
|---|---|
etc/init.d/S40network |
Removed 17-byte startup stub |
etc/device.conf |
Mode 0640 to 0666 |
usr/bin/device-agent |
Symlink target agent-v1 to agent-v2 |
usr/lib/libexample.so |
Payload grows by 430,080 bytes (420 KiB) |
There is one removal, three modifications, no additions and no metadata warnings. Net regular-payload growth is 430,063 bytes, after subtracting the removed startup stub. The library-named file is deliberately zero-filled data, and the startup/agent endpoints are stubs. This demonstrates recorded archive findings, not ELF/ABI compatibility or target runtime behavior. The example's explicit policy fails for the missing startup path and growth above its 409,600-byte budget; ordinary differences still succeed without a gate.
Choose the OS and architecture of the host running rootfs-diff. Firmware CPU architecture does not select the binary. All four assets were built with Go 1.27.4, CGO_ENABLED=0, trimmed build paths and CLI version v0.1.1.
| Host | Asset |
|---|---|
| Linux x86-64 | rootfs-diff_v0.1.1_linux_amd64.tar.gz |
| Linux arm64 | rootfs-diff_v0.1.1_linux_arm64.tar.gz |
| macOS Intel | rootfs-diff_v0.1.1_darwin_amd64.tar.gz |
| macOS Apple Silicon | rootfs-diff_v0.1.1_darwin_arm64.tar.gz |
Download the matching asset and SHA256SUMS. For example, on Linux x86-64:
asset=rootfs-diff_v0.1.1_linux_amd64.tar.gz
base=https://github.com/Azhovan/rootfs-diff/releases/download/v0.1.1
curl -fLO "$base/$asset"
curl -fLO "$base/SHA256SUMS"
awk -v file="$asset" '$2 == file' SHA256SUMS | sha256sum -c -
tar -xzf "$asset"
./rootfs-diff_v0.1.1_linux_amd64/rootfs-diff --version
./rootfs-diff_v0.1.1_linux_amd64/rootfs-diff --format json before.tar after.tar.gz > report.jsonOn macOS, select its asset and use shasum -a 256 -c - for the checksum step. Put all flags before the two input paths. Exit 0 means checks passed, 1 means a configured gate failed with a complete report, and 2 means usage/input/operational failure. A writer failure may leave partial output; inspect the exit status. macOS binaries are not Developer ID signed or notarized. GitHub provides the tagged source archives.
Runtime scope remains two local regular tar/tar.gz files, deterministic text/JSON/Markdown reports, literal ignores, and explicit required-path/net-growth policies. Sparse archives, stdin, URLs, input symlinks and extracted directories are unsupported. Reports declare uncompared metadata and preserve warnings. Cancellation cannot interrupt an already-blocked reader or writer.
Release preparation passed offline ./scripts/verify.sh from clean source, target architecture/build-metadata checks, explicit package-content checks and checksum validation. The macOS arm64 release binary passed --version, --help, synthetic checks including exits 0/1/2, and the independent checker against the retained real Buildroot archive pair. Its normal, same-image and policy reports match the recorded proof byte for byte. Firmware was not rebuilt for packaging. The other three binaries were cross-built and inspected, not executed during preparation. CI passed on this exact source.
See the tagged Apache-2.0 license, CLI reference, semantics and limits, Go library guide, JSON schema and synthetic example. This release reviews recorded archive data; it does not establish bootability, runtime correctness, OTA compatibility, CVE applicability, compliance or complete security equivalence.