Skip to content

Commit

Permalink
ddi-spec: document which suffix, mime type and sector sizes to use fo…
Browse files Browse the repository at this point in the history
…r DDIs
  • Loading branch information
poettering committed Nov 16, 2023
1 parent f60b49b commit 3941bd0
Showing 1 changed file with 12 additions and 1 deletion.
13 changes: 12 additions & 1 deletion specs/discoverable_disk_image.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,18 @@ into one. They are designed to be composable and stackable, and provide securit
The images use the GPT partition table verbatim, so it will not be redefined here. Each partition contains
a standard Linux filesystem (e.g.: `erofs`), so again this will not be redefined here.
The [DPS](discoverable_partitions_specification.md) defines the GUIDs to use and the format of the
dm-verity signature partition's JSON content.
`dm-verity` signature partition's JSON content.

It is recommended to use a sector size of 512 bytes or 4096 for DDIs. Software operating with DDIs should
automatically derive the sector size used for a DDI by looking for the "EFI PART" magic string at offsets 512
or 4096, as per GPT specification.

## Naming
DDIs should use `.raw` as file suffix. A secondary suffix may be used to clarify the specific usage class of
a DDI. For now the two secondary suffixes `.sysext.raw` and `.confext.raw` are defined (for system extension
DDIs and configuration extension DDIs).

The MIME type for DDIs is `application/vnd.efi.img`.

## Image Version
If the DDI is versioned, the version format described in the
Expand Down

0 comments on commit 3941bd0

Please sign in to comment.