Skip to content

rootfs-diff v0.1.0

Choose a tag to compare

@Azhovan Azhovan released this 15 Nov 09:04
0f39dc8

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.json

On 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.