UAPI Group Specifications#

The following specifications have been accepted by the UAPI group:

Work in Progress#

See open PRs on github.

License#

All specifications are licensed under CC-BY-4.0.

Versioning#

All specifications are versioned.

The versioning format is MAJOR.MINOR. Compatible changes increment the MINOR version. Incompatible changes increment the MAJOR version and reset the MINOR version to 0.

Work in progress specifications have a MAJOR version of 0.

A filename/MAJOR.MINOR git tag will be created when a new version of a given spec is released.

Glossary#

This section clarifies on terms and abbreviations used in specs and other documents.

General terms and abbreviations#

  • ELF – Executable and Linkable Format (Linux executable binary format)
  • MOK – Machine Owner Key (shim)
  • PCR – TPM Platform Configuration Registers
  • PE – Portable Executable (UEFI executable binary format)
  • SBAT – UEFI Secure Boot Advanced Targeting
  • TPM – Trusted Platform Module (security chip)

Terms and abbreviations specific to UAPI group specifications#

  • BLS - Boot Loader Specification
  • confext – Configuration Extension Image (type of DDI that is overlayed on top of /etc/ via overlayfs and can extend the underlying OS’ configuration in a composable, immutable fashion)
  • DDI - Discoverable Disk Image
  • DPS - Discovery Partition Specification
  • sysext – System Extension Image (type of DDI that is overlayed on top of /usr/ and /opt/ via overlayfs and can extend the underlying OS vendor resources in a composable, immutable fashion)
  • UKI - Unified Kernel Images (UEFI boot stub + kernel + initrd + more)
  • VOA – Verification of OS Artifacts

Participate#

Please use the specifications issue tracker to engage with the project.