Repository navigation
Releases
rootfs-diff v0.1.2
v0.1.2 makes the README, reference guides, examples and Go package documentation easier to read. It explains archive paths, links, policy checks, growth calculations, limits and exit codes in plain English. The public API, report schema, CLI flags and comparison behavior are unchanged from v0.1.1.
Source: fef1075. Start with the README, installation guide or Go library guide.
To update a Go project, run go get github.com/Azhovan/rootfs-diff@v0.1.2 from your module. Read the versioned API documentation on pkg.go.dev.
Binary packages are available for Linux and macOS on amd64 and arm64. Choose the operating system and CPU architecture of the computer running rootfs-diff, regardless of the firmware's architecture. All packages were built with Go 1.27.4, CGO disabled, trimmed build paths and CLI version v0.1.2. They include the Apache-2.0 license, Go notices and updated documentation. macOS binaries are not Developer ID signed or notarized.
Download the matching archive and SHA256SUMS, then check the checksum before unpacking. For Linux x86-64:
asset=rootfs-diff_v0.1.2_linux_amd64.tar.gz
base=https://github.com/Azhovan/rootfs-diff/releases/download/v0.1.2
curl -fLO "$base/$asset"
curl -fLO "$base/SHA256SUMS"
awk -v file="$asset" '$2 == file' SHA256SUMS | sha256sum -c -
tar -xzf "$asset"
./rootfs-diff_v0.1.2_linux_amd64/rootfs-diff --versionOn macOS, choose a darwin archive and use shasum -a 256 -c - in the checksum step.
Offline verification passed on the exact source, and Linux and macOS CI passed. All four packages passed content, build-metadata and checksum checks. The packaged macOS arm64 binary passed help/version checks and the synthetic demonstration, including exit codes 0, 1 and 2. The other three binaries were cross-built and inspected; they were not executed during packaging.
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.
rootfs-diff v0.1.0
First release of the Go library and CLI for reviewing recorded rootfs changes. Source: 0f39dc8d42fe8aa6c8ff59b52ea33eee06c08f19.
- Stream tar and gzip-compressed tar without extraction or target execution. Compare SHA-256 content, numeric ownership, special mode bits, links and device metadata.
- Produce deterministic text, JSON schema v1 and Markdown reports, with literal path/prefix ignores and regular-payload growth totals.
- Enable explicit required-path/growth policies or
--fail-on-change. Exit 0 means checks passed, 1 means a configured gate failed with a complete report, and 2 means usage/input/operational failure.
Choose the OS and architecture of the host running the command; 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.0.
| Host | Asset |
|---|---|
| Linux x86-64 | rootfs-diff_v0.1.0_linux_amd64.tar.gz |
| Linux arm64 | rootfs-diff_v0.1.0_linux_arm64.tar.gz |
| macOS Intel | rootfs-diff_v0.1.0_darwin_amd64.tar.gz |
| macOS Apple Silicon | rootfs-diff_v0.1.0_darwin_arm64.tar.gz |
Download your matching asset and SHA256SUMS. For example, on Linux x86-64:
asset=rootfs-diff_v0.1.0_linux_amd64.tar.gz
base=https://github.com/Azhovan/rootfs-diff/releases/download/v0.1.0
curl -fLO "$base/$asset"
curl -fLO "$base/SHA256SUMS"
awk -v file="$asset" '$2 == file' SHA256SUMS | sha256sum -c -
tar -xzf "$asset"
./rootfs-diff_v0.1.0_linux_amd64/rootfs-diff --version
./rootfs-diff_v0.1.0_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 archive paths. Each package includes a binary, release README, existing reference documentation/schema and Go notices. GitHub provides the tagged source archives. These prebuilt instructions supersede the tagged installation guide's earlier binary-availability statement. macOS binaries are not Developer ID signed or notarized; this release adds no project license.
Inputs are local regular tar/tar.gz files. Stdin, URLs, input symlinks, directories, sparse archives and other filesystem/archive formats are unsupported. Reports declare excluded timestamps, user/group names, directory sizes, xattrs, ACLs, capabilities, SELinux labels and unrecognized PAX metadata; encountered uncompared metadata produces warnings. Defaults cap entries at 100,000, decoded bytes at 8 GiB, individual regular payloads at 2 GiB and paths/targets at 4,096 bytes. Positive overrides are available. A writer failure may leave partial output; always inspect the exit code. Cancellation cannot interrupt a reader or writer already blocked in a call.
Release preparation passed offline verification from clean source (./scripts/verify.sh), architecture/build-metadata and package/checksum checks. The macOS arm64 release binary passed --version, --help and the synthetic comparison with independent expected findings and exits 0/1/2. The other three binaries were cross-built and inspected, not executed during release preparation. Prior accepted evidence includes green CI on this exact source and the executed, independently checked Buildroot 2025.02.19 proof, which recorded one removal, four modifications and net growth of 2 bytes. Buildroot was not rebuilt for packaging.
See the tagged CLI reference, archive semantics, 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.