aaru-dps/libaaruformat
1
0
Fork 0
mirror of https://github.com/aaru-dps/libaaruformat.git synced 2025-12-16 19:24:40 +00:00
Code Issues Packages Projects Releases Wiki Activity

[spec] Update deduplication table descriptions for clarity and accuracy

Browse Source
This commit is contained in:
Natalia Portillo
2025-08-01 04:24:16 +01:00
parent ac92c6d3d3
commit c78bbe7c88
2 changed files with 11 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
docs/spec/blocks/ddt2.adoc
View File

@@ -57,13 +57,18 @@ It starts with the following header.
|uint8_t |uint8_t
|1 byte |1 byte
|alignment |blockAlignmentShift
|Shift of alignment of all blocks in the image. This must be the same in all deduplication tables and subtables. |Determines block alignment boundaries using the formula 2 << blockAlignmentShift.
|uint8_t |uint8_t
|1 byte |1 byte
|shift |dataShift
|The shift used to calculate the position of a sector in a data block pointed by this table, or how many sectors are pointed by the next level. |Determines the maximum number of data items in a block using the formula 2 << dataShift.
|uint8_t
|1 byte
|tableShift
|Shift used to calculate the number of sectors in a deduplication table entry, using the formula 2 << tableShift.
|uint8_t |uint8_t
|1 byte |1 byte

2
docs/spec/blocks/header.adoc
View File

@@ -71,6 +71,8 @@ A bump indicates potential breaking changes.
Length is defined by `GUID_SIZE`. Length is defined by `GUID_SIZE`.
| blockAlignmentShift | uint8_t | Determines block alignment boundaries using the formula 2 << blockAlignmentShift. | blockAlignmentShift | uint8_t | Determines block alignment boundaries using the formula 2 << blockAlignmentShift.
| dataShift | uint8_t | Determines the maximum number of data items in a block using the formula 2 << dataShift.
| tableShift | uint8_t | Shift used to calculate the number of sectors in a deduplication table entry, using the formula 2 << tableShift.
| featureCompatible | uint64_t | Bitmask of features that, even if not implemented, still allow reading and writing the image. | featureCompatible | uint64_t | Bitmask of features that, even if not implemented, still allow reading and writing the image.
| featureCompatibleRo | uint64_t | Bitmask of features that allow read-only processing of the image if unsupported. | featureCompatibleRo | uint64_t | Bitmask of features that allow read-only processing of the image if unsupported.