From 16f504a9dca3fe3b70568f67b7d41241ae485288 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 18:49:04 +0200 Subject: Adding upstream version 7.0.6-dfsg. Signed-off-by: Daniel Baumann --- doc/manual/en_US/man_VBoxManage-modifynvram.xml | 241 ++++++++++++++++++++++++ 1 file changed, 241 insertions(+) create mode 100644 doc/manual/en_US/man_VBoxManage-modifynvram.xml (limited to 'doc/manual/en_US/man_VBoxManage-modifynvram.xml') diff --git a/doc/manual/en_US/man_VBoxManage-modifynvram.xml b/doc/manual/en_US/man_VBoxManage-modifynvram.xml new file mode 100644 index 00000000..9d4e02eb --- /dev/null +++ b/doc/manual/en_US/man_VBoxManage-modifynvram.xml @@ -0,0 +1,241 @@ + + + + +%all.entities; +]> + + + $Date: 2022-08-22 19:43:14 +0200 (Mon, 22 Aug 2022) $ + VBoxManage modifynvram + + + + VBoxManage-modifynvram + 1 + + + + VBoxManage-modifynvram + List and modify the NVRAM content of a virtual machine + &product-name; + + + + + VBoxManage modifynvram + uuid|vmname + inituefivarstore + + + VBoxManage modifynvram + uuid|vmname + enrollmssignatures + + + VBoxManage modifynvram + uuid|vmname + enrollorclpk + + + VBoxManage modifynvram + uuid|vmname + enrollpk + --platform-key=filename + --owner-uuid=uuid + + + VBoxManage modifynvram + uuid|vmname + listvars + + + VBoxManage modifynvram + uuid|vmname + queryvar + --name=name + --filename=filename + + + VBoxManage modifynvram + uuid|vmname + deletevar + --name=name + --owner-uuid=uuid + + + VBoxManage modifynvram + uuid|vmname + changevar + --name=name + --filename=filename + + + + + Description + + The "modifynvram" commands are for experts who want to inspect and modify the + UEFI variable store of a virtual machine. Any mistakes done here can bring the virtual + machine in a non working state. + + + Common options + + The subcommands of modifynvram all operate on a running virtual + machine: + + + uuid|vmname + Either the UUID or the name (case sensitive) of a VM. + + + + + + modifynvram inituefivarstore + + + Iniitalizes the UEFI variable store to a default state. Any previous existing variable + store is deleted. Use with extreme caution! + + + + + modifynvram enrollmssignatures + + + Enrolls the default Microsoft KEK and DB signatures required for UEFI secure boot. + + + + + modifynvram enrollorclpk + + + Enrolls the default platform key provided by Oracle required for UEFI secure boot. + + + + + modifynvram enrollpk + + + Enrolls a custom platform key provided by the user required for UEFI secure boot. + The following commands use openssl to generate a new platform key: + +$ openssl req -new -x509 -newkey rsa:2048 -keyout PK.key -out PK.crt +$ openssl x509 -in PK.crt -out PK.cer -outform DER + + + + The platform key provided as a DER encoded X.509 signature. + + + + + The UUID identifying the owner of the platform key. + + + + + + + modifynvram listvars + + + Lists all UEFI variables in the virtual machines's store along with their owner UUID. + + + + + modifynvram queryvar + + + Queries the content of a given UEFI variable identified by its name. + + + + + UEFI variable name to query. + + + + + + + Where to store the content of the variable upon success. This is optional, + if omitted the content will be dumped to the terminal as a hex dump. + + + + + + + + modifynvram deletevar + + + Deletes the given variable identified by its name and owner UUID. + + + + + UEFI variable name to delete. + + + + + The UUID identifying the owner of the variable to delete. + + + + + + + modifynvram changevar + + + Changes the UEFI variable content to the one form the given file. + + + + + UEFI variable name to change the data for. + + + + + + The file to read the data from. + + + + + + + -- cgit v1.2.3