diff options
author | Etienne Pierre-doray <etiennep@chromium.org> | 2021-10-28 21:16:04 +0000 |
---|---|---|
committer | Copybara-Service <copybara-worker@google.com> | 2021-10-28 14:31:23 -0700 |
commit | b90a947429fdce96b1d684b9a7af9683cb4a13c1 (patch) | |
tree | 333e034b74f5ec4cfb1be1600c4d1a061afbb3bc /README.md | |
parent | aff408603b3db5b7974c522db2ad8c5ce2a0f3c1 (diff) | |
download | zucchini-b90a947429fdce96b1d684b9a7af9683cb4a13c1.tar.gz |
[Zucchini]: Add patch version.
This is a breaking change to zucchini patch format:
Zucchini 1.0, see changelog.
Add major/minor patch-wide version, and element version.
Also add VerifyPatch() API and command line option to verify
patch compatibility.
Design: go/zucchini-versions
Bug: 1231882
Change-Id: I19f1fbe2ee866c23f0814ffe6a912fb72812edbc
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/3140224
Commit-Queue: Etienne Pierre-Doray <etiennep@chromium.org>
Reviewed-by: Samuel Huang <huangs@chromium.org>
Reviewed-by: Calder Kitagawa <ckitagawa@chromium.org>
Cr-Commit-Position: refs/heads/main@{#936096}
NOKEYCHECK=True
GitOrigin-RevId: 559d77a9741428a48add017d389d104e431e6de7
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 18 |
1 files changed, 17 insertions, 1 deletions
@@ -204,12 +204,14 @@ Position of elements in new file is ascending. Name | Format | Description --- | --- | --- magic | uint32 = kMagic | Magic value. +major_version | uint16 | Major version number indicating breaking changes. +minor_version | uint16 | Minor version number indicating possibly breaking changes. old_size | uint32 | Size of old file in bytes. old_crc | uint32 | CRC32 of old file. new_size | uint32 | Size of new file in bytes. new_crc | uint32 | CRC32 of new file. -**kMagic** == `'Z' | ('u' << 8) | ('c' << 16)` +**kMagic** == `'Z' | ('u' << 8) | ('c' << 16) | ('c' << 24)` **PatchElement** Contains all the information required to produce a single element in new file. @@ -235,6 +237,7 @@ old_length | uint32 | Length of the element in old file. new_offset | uint32 | Starting offset of the element in new file. new_length | uint32 | Length of the element in new file. exe_type | uint32 | Executable type for this unit, see `enum ExecutableType`. +version | uint16 | Version specific to the executable type for this unit. **EquivalenceList** Encodes a list of equivalences, where dst offsets (in new image) are ascending. @@ -278,3 +281,16 @@ Name | Format | Description --- | --- | --- size |uint32 | Size of content in bytes. content |T[] | List of integers. + +# Format Changelog +All breaking changes to zucchini patch format will be documented in this +section. + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). + +## [Unreleased] + +## [1.0] - 2021-10-27 +### Added +Major/Minor version is encoded in PatchHeader +Disassembler version associated with an element version is encoded in PatchElementHeader. |