From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "identification" |
|---|
| subject | "Format:OpenWrt sysupgrade tar" |
|---|
| claim | "An OpenWrt NAND sysupgrade tar (optionally gzip-compressed) contains a directory sysupgrade-<board> with a non-empty CONTROL file ('BOARD=<board>') plus kernel and/or root images (sysupgrade-tar.sh accepts a build with only one of them) and optionally dtb; the NAND upgrader uses the first sysupgrade-*/ directory (it fails if there is more than one) and accepts the board name with commas or underscores in the directory name; only the length of CONTROL is checked there, not its content." |
|---|
| scope | | level | "format" |
|---|
| applies_to | "Format:OpenWrt sysupgrade tar" |
|---|
| observed_in | |
|---|
|
|---|
| data | | method | "tar listing" |
|---|
| indicator | "sysupgrade-*/CONTROL (non-empty), plus sysupgrade-*/kernel and/or sysupgrade-*/root, optional dtb; may be gzip-compressed" |
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "sysupgrade-tar.sh creates sysupgrade-${board}/ with CONTROL (BOARD=), root, kernel, dtb and tars it" |
|---|
| repo | "https://github.com/openwrt/openwrt" |
|---|
| commit | "c4fbb6337a693864f422c018b7bf470d2ea7cfff" |
|---|
| path | "scripts/sysupgrade-tar.sh" |
|---|
| lines | "63-83" |
|---|
|
| type | "source" |
|---|
| detail | "nand_do_platform_check checks sysupgrade-<board>/CONTROL (commas to underscores and back); nand_upgrade_tar takes the first sysupgrade-*/ dir" |
|---|
| repo | "https://github.com/openwrt/openwrt" |
|---|
| commit | "c4fbb6337a693864f422c018b7bf470d2ea7cfff" |
|---|
| path | "package/base-files/files/lib/upgrade/nand.sh" |
|---|
| lines | "312-319, 480-501" |
|---|
|
|
|---|
| confidence | "high" |
|---|
| related | |
|---|
| key | "sysupgrade tar recognition" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-19T06:50:48.042Z" |
|---|
| verifications | | operator | "PatientStepper99" |
|---|
| date | "2026-10-19T09:27:48.390Z" |
|---|
| result | "confirmed" |
|---|
| method | "Downloaded sysupgrade-tar.sh and lib/upgrade/nand.sh at c4fbb633: script needs a readable kernel or rootfs, writes sysupgrade-${board}/CONTROL, root, kernel, dtb; nand_do_platform_check uses identify_if_gzip, tries board name with commas then underscores and tests only CONTROL length; nand_upgrade_tar takes the first sysupgrade-*/ with a warning about more than one." |
|---|
|
|
|---|
| revisions | | by | "PatientStepper99" |
|---|
| date | "2026-10-19T09:11:52.322Z" |
|---|
| summary | "sysupgrade-tar.sh needs only a readable kernel OR rootfs (both optional), dtb optional; nand_do_platform_check reads the tar through identify_if_gzip so a gzip-compressed tar also passes…" |
|---|
| changed | |
|---|
|
|
|---|