mirror of
https://github.com/morluto/rea.git
synced 2026-11-21 14:05:49 +00:00
50 lines
2.5 KiB
Markdown
50 lines
2.5 KiB
Markdown
# Android OTA payload inspection
|
|
|
|
This specification records an implementation increment and its original
|
|
problem statement. For current behavior and limitations, see
|
|
[Android OTA update payloads](../../../guides/firmware/android-ota-payload.md).
|
|
|
|
## Problem and outcome
|
|
|
|
REA has no reader for Android A/B OTA `payload.bin` files (update_engine,
|
|
magic `CrAU`). An analyst holding a payload cannot ask which partitions it
|
|
writes, what sizes and hashes the manifest declares, whether the payload is
|
|
full or delta, or which operations are present. Add a read-only inspector
|
|
that inventories the header and `DeltaArchiveManifest` and, when cheap,
|
|
reconstructs REPLACE/ZERO/REPLACE_ZSTD partition images.
|
|
|
|
## Requirements
|
|
|
|
- Recognize CrAU v2 from leading bytes under any file name. Report a
|
|
readable major version other than 2 as an unsupported-version refusal.
|
|
- Decode the v2 header and the manifest fields listed in the product guide:
|
|
block size, minor version, timestamps, partial update, security patch,
|
|
per-partition identities, operation counts, Virtual A/B groups and
|
|
apex_info.
|
|
- Count metadata and payload signature blobs without verifying them.
|
|
- Reconstruct a partition only when every operation is REPLACE, ZERO or
|
|
REPLACE_ZSTD, the new size is known and within the extract ceiling, and
|
|
needed blob extents are present. Bound REPLACE_ZSTD decode to destination
|
|
extent bytes, never above the extract ceiling, and refuse a partition
|
|
open when distinct operation blob bytes exceed the operation-data
|
|
budget. Verify the image against the declared hash when present. Other
|
|
operation types stay inventoried and refuse content reads.
|
|
- Keep a complete manifest inventory when the blob is truncated. Refuse
|
|
malformed magic, truncated headers or manifests, oversize counts, and
|
|
operation extents that overrun the blob, without inventing zeros.
|
|
|
|
## Acceptance
|
|
|
|
Synthesized fixtures cover a full payload with REPLACE and ZERO operations,
|
|
dynamic groups and apex_info; a delta payload with SOURCE_COPY and
|
|
BROTLI_BSDIFF; an unknown operation type; v1 refusal; truncated blob with
|
|
complete manifest; oversize manifest; malformed protobuf; and hash
|
|
match/mismatch. Reader, CLI and MCP tests use those fixtures. Nested zip
|
|
`payload.bin` members classify by magic.
|
|
|
|
## Non-goals
|
|
|
|
Signature verification, applying delta or compressed operations other than
|
|
REPLACE_ZSTD, reading `payload_properties.txt` or zip metadata, recursive
|
|
zip inventory of partitions, and device-side update_engine execution.
|