Skip to content

Commit 3941bd0

Browse files
committed
ddi-spec: document which suffix, mime type and sector sizes to use for DDIs
1 parent f60b49b commit 3941bd0

File tree

1 file changed

+12
-1
lines changed

1 file changed

+12
-1
lines changed

specs/discoverable_disk_image.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,18 @@ into one. They are designed to be composable and stackable, and provide securit
1717
The images use the GPT partition table verbatim, so it will not be redefined here. Each partition contains
1818
a standard Linux filesystem (e.g.: `erofs`), so again this will not be redefined here.
1919
The [DPS](discoverable_partitions_specification.md) defines the GUIDs to use and the format of the
20-
dm-verity signature partition's JSON content.
20+
`dm-verity` signature partition's JSON content.
21+
22+
It is recommended to use a sector size of 512 bytes or 4096 for DDIs. Software operating with DDIs should
23+
automatically derive the sector size used for a DDI by looking for the "EFI PART" magic string at offsets 512
24+
or 4096, as per GPT specification.
25+
26+
## Naming
27+
DDIs should use `.raw` as file suffix. A secondary suffix may be used to clarify the specific usage class of
28+
a DDI. For now the two secondary suffixes `.sysext.raw` and `.confext.raw` are defined (for system extension
29+
DDIs and configuration extension DDIs).
30+
31+
The MIME type for DDIs is `application/vnd.efi.img`.
2132

2233
## Image Version
2334
If the DDI is versioned, the version format described in the

0 commit comments

Comments
 (0)