Skip to main content

Extension

Data about an extension image (sysext or confext) to merge onto the target OS.

Extension image must be a Discoverable Disk Image.

CharacteristicValue
Typeobject

Properties​

sha384 (required)​

The Sha384 of the entire extension image file.

CharacteristicValue
Typestring
Format[a-fA-F0-9]{96}

url (required)​

The path to the extension image file, which must be a Discoverable Disk Image.

URLs may have one of the following four schemes: http://, https://, file://, or oci://. Extension image files stored in OCI registries must allow for anonymous pulls.

CharacteristicValue
Typestring
Formaturi

path (optional)​

The absolute path of the extension image in the target OS.

Filename must be of the form {name}.raw, where {name} matches the extension-release filename suffix. For example, extension-release.my-tool requires the path to end with my-tool.raw.

By default, sysexts are placed in /var/lib/extensions/. Trident supports placing sysexts in:

  • /etc/extensions/

  • /var/lib/extensions/

  • /.extra/sysext/

By default, confexts are placed in /var/lib/confexts/. Trident supports placing confexts in:

  • /var/lib/confexts/

  • /usr/lib/confexts/

  • /usr/local/lib/confexts/

/run/sysexts/ and /run/confexts/ are not supported.

CharacteristicValue
Typestring