Here’s how to handle it manually on a Linux system:
download one binary r12456-home.tar.md5 or download one binary -build-ver-- -home.tar.md5
# 1. Download both files (if the .md5 is separate content) wget http://example.com/firmware/myrouter-v2.1.3-home.tar wget http://example.com/firmware/myrouter-v2.1.3-home.tar.md5 md5sum -c myrouter-v2.1.3-home.tar.md5 3. If the .md5 file contains only the hash (no filename), do this: EXPECTED=$(cat myrouter-v2.1.3-home.tar.md5) ACTUAL=$(md5sum myrouter-v2.1.3-home.tar | cut -d' ' -f1) if [ "$EXPECTED" = "$ACTUAL" ]; then echo "OK" else echo "CORRUPTED" fi 4. Extract if verified tar -xf myrouter-v2.1.3-home.tar Here’s how to handle it manually on a
build_job: script: - make download_one_binary BUILD_VER=$CI_COMMIT_SHORT_SHA - ./verify.sh -build-ver-$CI_COMMIT_SHORT_SHA-home.tar.md5 - tar -xf *-home.tar - ./flash_firmware.sh The placeholder -build-ver-- is replaced at runtime, ensuring each build has unique, traceable binaries. | Pattern | Pros | Cons | |-----------------------------|---------------------------------------|----------------------------------| | .tar.md5 (old) | Simple, low overhead | MD5 weak, extra download step | | .tar.sha256 | Secure, still simple | Slightly larger hash size | | .tar.sig (GPG) | Cryptographically signed | Requires key management | | .tar + checksums.txt | Batch verification for many files | More complex parsing | | Container image (OCI/Docker)| Isolated, reproducible | Overkill for small embedded | Extract if verified tar -xf myrouter-v2
This article will dissect each component of that template, explain why such patterns exist, how they improve security and reproducibility, and provide real-world examples. Let’s break down the string into meaningful parts:
download one binary -build-ver-- -home.tar.md5 might look like nonsense at first glance. However, it is highly representative of how build systems (like , Buildroot , Yocto , or LEDE ) handle downloading, verifying, and deploying a single binary package.
| Component | Meaning | |----------------------|-------------------------------------------------------------------------| | download one binary | Action: retrieve a single executable or firmware image from a server. | | -build-ver-- | Placeholder for build version (e.g., r12345 , 19.07.7 , v1.2.3 ). | | -home.tar.md5 | A tarball of a home directory or root filesystem, plus an MD5 checksum. |