VIRT-FW-VARS(1)         دستورات کاربری (User Commands)         VIRT-FW-VARS(1)

نام (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>

virt-fw-vars 26.9               September 2026                 VIRT-FW-VARS(1)