Mimoja / python-uefivars

Python package and helper tool to analyze, convert and modify UEFI variable stores.

uefivars

This is a set of Python modules and a helper application "uefivars" to introspect and modify UEFI variable stores.

Why do I need this?

UEFI variable stores are typically opaque to users. You access them using UEFI runtime services as function calls. However, the data is then stored in a binary data format. When running virtual machines or extracting UEFI variable stores directly from Flash storage, you can receive and write that binary data and thus modify variables directly.

This is useful in situations where you have incorrect UEFI variable data and need to modify variables without runtime service access. It can also be useful to analyze and introspect the variable store and check what data is stored inside.

How do I use it?

You can convert a variable store into human readable format by setting the output type to json. This will show you all variables that are currently present in the variable store.

$ uefivars -i edk2 -o json -I OVMF_VARS.secboot.fd
[
    {
        "name": "SecureBootEnable",
        "data": "AQ==",
        "guid": "f0a30bc7-af08-4556-99c4-001009c93a44",
        "attr": 3
    },
    [...]
]

In addition, you can convert from the human readable json representation back into edk2 format:

$ uefivars -i json -o edk2 -I vars.json -O OVMF_VARS.fd

Given any variable store (including an empty one) the --PK , --KEK , --db and --dbx switches can be used to (over-)write the four SecureBoot variables from input files. (Usually .esl files). For a general rundown of the key generation process the ArchLinux wiki has proven itself as a first point of guidance.

You can also use the tool to convert between the AWS EC2 uefi-data format and edk2 to import and export UEFI variable stores between an EC2 instance and QEMU:

$ uefivars -i edk2 -o aws -I OVMF_VARS.fd -O uefi-data.aws

$ uefivars -i aws -o edk2 -I uefi-data.aws -O OVMF_VARS.fd

What formats are supported?

This package currently supports the aws, edk2 and json file formats.