نام (NAME)

virt-fw-vars - مدیریت متغیرهای فریم‌ور UEFI ماشین مجازی

خلاصه دستور (SYNOPSIS)

virt-fw-vars [-h] [-l LEVEL] [-i FILE] [--inplace FILE]

[--extract-certs] [-d VAR] [--set-true VAR]: [--set-false VAR] [--set-json FILE] [--set-boot-uri LINK] [--append-boot-filepath FILE] [--set-shim-debug] [--set-shim-verbose] [--set-fallback-verbose] [--set-fallback-no-reboot] [--set-sbat-level FILE] [--set-pk GUID FILE] [--add-kek GUID FILE] [--add-db GUID FILE] [--add-db-hash GUID HASH] [--set-dbx FILE] [--add-dbx FILE] [--add-dbx-cert GUID FILE] [--add-dbx-hash GUID HASH] [--add-mok GUID FILE] [--add-mok-hash GUID HASH] [--enroll-redhat] [--enroll-microsoft] [--enroll-cert CERT] [--enroll-generate CN] [--enroll-mgmt] [--no-microsoft] [--microsoft-db {none,win11,win23,win+rom23,uefi11,uefi23,uefi+rom23,redhat,redhat+rom,all}] [--microsoft-kek {none,2011,2023,all}] [--distro-keys DISTRO] [--distro-list] [--sb] [-p] [-v] [--hashes] [-x] [-o FILE] [--output-aws FILE] [--output-json FILE] [--output-auth DIR]

توضیحات (DESCRIPTION)

ابزار virt-fw-vars می‌تواند مخازن متغیرهای UEFI را چاپ و ویرایش کند. قالب‌های پشتیبانی‌شده عبارتند از edk2 استاندارد (همان‌طور که توسط ovmf و armvirt استفاده می‌شود) و aws.

گزینه‌ها (OPTIONS)

گزینه‌های عمومی:

-h, --help: نمایش پیام راهنما و خروج
-l, --loglevel LEVEL: تنظیم سطح ثبت وقایع روی LEVEL
-i, --input FILE: خواندن متغیرهای edk2 یا aws از FILE
--inplace, --in-place FILE: ویرایش درجا روی FILE
--extract-certs: استخراج تمام گواهی‌ها

گزینه‌های متغیرها:

-d, --delete VAR: حذف متغیر VAR؛ می‌تواند چند بار مشخص شود
--set-true VAR: تنظیم متغیر VAR روی true؛ می‌تواند چند بار مشخص شود
--set-false VAR: تنظیم متغیر VAR روی false؛ می‌تواند چند بار مشخص شود
--set-json FILE: تنظیم متغیرها از فایل دامپ json با نام FILE

پیکربندی راه‌اندازی:

--set-boot-uri LINK: تنظیم uri راه‌اندازی از شبکه روی LINK (یک‌باره، با استفاده از BootNext)
--append-boot-filepath FILE: افزودن مدخل راه‌اندازی برای FILE (دائمی، با استفاده از BootOrder)

پیکربندی shim.efi:

--set-shim-debug: فعال‌سازی اشکال‌زدایی shim.efi (توقف برای اتصال اشکال‌زدا)
--set-shim-verbose: فعال‌سازی پیام‌های پرجزئیات shim.efi
--set-fallback-verbose: فعال‌سازی پیام‌های پرجزئیات fallback.efi
--set-fallback-no-reboot: غیرفعال‌سازی راه‌اندازی مجدد برای fallback.efi
--set-sbat-level FILE: تنظیم متغیر SbatLevel

گزینه‌های برپایی راه‌اندازی امن (Secure Boot):

--set-pk, --set-pk-cert GUID FILE: تنظیم PK روی گواهی x509، بارگذاری‌شده در قالب pem یا der از FILE و با شناسه مالک GUID
--add-kek, --add-kek-cert GUID FILE: افزودن گواهی x509 به KEK، بارگذاری‌شده در قالب pem یا der از FILE و با شناسه مالک GUID؛ می‌تواند چند بار مشخص شود
--add-db, --add-db-cert GUID FILE: افزودن گواهی x509 به db، بارگذاری‌شده در قالب pem یا der از FILE و با شناسه مالک GUID؛ می‌تواند چند بار مشخص شود
--add-db-hash GUID HASH: افزودن هش sha256 با مقدار HASH به db، با شناسه مالک GUID؛ می‌تواند چند بار مشخص شود
--set-dbx FILE: مقداردهی اولیه dbx با به‌روزرسانی از FILE
--add-dbx FILE: افزودن به‌روزرسانی dbx از FILE
--add-dbx-cert GUID FILE: افزودن گواهی x509 به dbx، بارگذاری‌شده در قالب pem یا der از FILE و با شناسه مالک GUID؛ می‌تواند چند بار مشخص شود
--add-dbx-hash GUID HASH: افزودن هش sha256 با مقدار HASH به dbx، با شناسه مالک GUID؛ می‌تواند چند بار مشخص شود
--add-mok, --add-mok-cert GUID FILE: افزودن گواهی x509 به MokList، بارگذاری‌شده در قالب pem یا der از FILE و با شناسه مالک GUID؛ می‌تواند چند بار مشخص شود
--add-mok-hash GUID HASH: افزودن هش sha256 با مقدار HASH به MokList، با شناسه مالک GUID؛ می‌تواند چند بار مشخص شود

میانبرهای تسهیل راه‌اندازی امن:

--enroll-redhat: ثبت گواهی‌های پیش‌فرض برای پلتفرم redhat
--enroll-microsoft: ثبت گواهی‌های پیش‌فرض برای پلتفرم microsoft oem
--enroll-cert CERT: ثبت با استفاده از گواهی مشخص‌شده
--enroll-generate CN: ثبت با استفاده از گواهی تولیدشده با نام عمومی (CN) داده‌شده
--enroll-mgmt: ثبت با استفاده از guid مدیریت خارجی
--no-microsoft: معادل "--microsoft-db none";
--microsoft-db, --profile {none,win11,win23,win+rom23,uefi11,uefi23,uefi+rom23,redhat,redhat+rom,all}: انتخاب کلیدهای db مایکروسافت جهت ثبت
--microsoft-kek {none,2011,2023,all}: انتخاب کلیدهای KEK مایکروسافت جهت ثبت
--distro-keys DISTRO: افزودن کلیدهای CA برای DISTRO
--distro-list: فهرست کردن توزیع‌های شناخته‌شده
--sb, --secure-boot: فعال‌سازی حالت راه‌اندازی امن (Secure Boot)

گزینه‌های چاپ و نمایش:

-p, --print: چاپ مخزن متغیرها (varstore)
-v, --verbose: چاپ مخزن متغیرها با جزئیات کامل
--hashes: چاپ هش‌های sha256 پایگاه داده امضا
-x, --hexdump: چاپ دامپ هگزادسیمال متغیرها

گزینه‌های خروجی:

-o, --output FILE: نوشتن متغیرهای edk2 یا aws در FILE، با همان قالبی که در فایل ورودی --input استفاده شده است.
--output-aws FILE: نوشتن متغیرهای aws در FILE
--output-json FILE: نوشتن دامپ json در FILE
--output-auth DIR: نوشتن فایل‌های *.auth در پوشه DIR

مثال‌ها (EXAMPLES)

چاپ مخزن متغیرها:

virt-fw-vars --input ${guest}_VARS.fd \
             --print --verbose

ثبت گواهی‌های پیش‌فرض راه‌اندازی امن (مایکروسافت):

virt-fw-vars --input OVMF_VARS.fd \
             --output OVMF_VARS.secboot.fd \
             --enroll-redhat \
             --secure-boot

نویسنده (AUTHOR)

Gerd Hoffmann <kraxel@redhat.com>

September 2026

virt-fw-vars 26.9