.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH VIRT-FW-VARS "1" "September 2026" "virt-fw-vars 26.9" "دستورات کاربری (User Commands)"
.SH "نام (NAME)"
virt-fw-vars \- مدیریت متغیرهای فریم‌ور UEFI ماشین مجازی
.SH "خلاصه دستور (SYNOPSIS)"
.B virt\-fw\-vars
[\fB\-h\fR] [\fB\-l\fR \fILEVEL\fR] [\fB\-i\fR \fIFILE\fR] [\fB\-\-inplace\fR \fIFILE\fR]
.TP
[\fB\-\-extract\-certs\fR] [\fB\-d\fR \fIVAR\fR] [\fB\-\-set\-true\fR \fIVAR\fR]
[\fB\-\-set\-false\fR \fIVAR\fR] [\fB\-\-set\-json\fR \fIFILE\fR] [\fB\-\-set\-boot\-uri\fR \fILINK\fR]
[\fB\-\-append\-boot\-filepath\fR \fIFILE\fR] [\fB\-\-set\-shim\-debug\fR]
[\fB\-\-set\-shim\-verbose\fR] [\fB\-\-set\-fallback\-verbose\fR]
[\fB\-\-set\-fallback\-no\-reboot\fR] [\fB\-\-set\-sbat\-level\fR \fIFILE\fR]
[\fB\-\-set\-pk\fR \fIGUID\fR \fIFILE\fR] [\fB\-\-add\-kek\fR \fIGUID\fR \fIFILE\fR]
[\fB\-\-add\-db\fR \fIGUID\fR \fIFILE\fR] [\fB\-\-add\-db\-hash\fR \fIGUID\fR \fIHASH\fR]
[\fB\-\-set\-dbx\fR \fIFILE\fR] [\fB\-\-add\-dbx\fR \fIFILE\fR]
[\fB\-\-add\-dbx\-cert\fR \fIGUID\fR \fIFILE\fR] [\fB\-\-add\-dbx\-hash\fR \fIGUID\fR \fIHASH\fR]
[\fB\-\-add\-mok\fR \fIGUID\fR \fIFILE\fR] [\fB\-\-add\-mok\-hash\fR \fIGUID\fR \fIHASH\fR]
[\fB\-\-enroll\-redhat\fR] [\fB\-\-enroll\-microsoft\fR]
[\fB\-\-enroll\-cert\fR \fICERT\fR] [\fB\-\-enroll\-generate\fR \fICN\fR]
[\fB\-\-enroll\-mgmt\fR] [\fB\-\-no\-microsoft\fR]
[\fB\-\-microsoft\-db\fR {\fBnone\fR,\fBwin11\fR,\fBwin23\fR,\fBwin+rom23\fR,\fBuefi11\fR,\fBuefi23\fR,\fBuefi+rom23\fR,\fBredhat\fR,\fBredhat+rom\fR,\fBall\fR}]
[\fB\-\-microsoft\-kek\fR {\fBnone\fR,\fB2011\fR,\fB2023\fR,\fBall\fR}]
[\fB\-\-distro\-keys\fR \fIDISTRO\fR] [\fB\-\-distro\-list\fR] [\fB\-\-sb\fR] [\fB\-p\fR] [\fB\-v\fR]
[\fB\-\-hashes\fR] [\fB\-x\fR] [\fB\-o\fR \fIFILE\fR] [\fB\-\-output\-aws\fR \fIFILE\fR]
[\fB\-\-output\-json\fR \fIFILE\fR] [\fB\-\-output\-auth\fR \fIDIR\fR]
.SH "توضیحات (DESCRIPTION)"
ابزار
.B virt\-fw\-vars
می‌تواند مخازن متغیرهای UEFI را چاپ و ویرایش کند.
قالب‌های پشتیبانی‌شده عبارتند از edk2 استاندارد (همان‌طور که توسط ovmf و armvirt استفاده می‌شود) و aws.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های عمومی:"
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش پیام راهنما و خروج
.TP
\fB\-l\fR, \fB\-\-loglevel\fR \fILEVEL\fR
تنظیم سطح ثبت وقایع روی \fILEVEL\fR
.TP
\fB\-i\fR, \fB\-\-input\fR \fIFILE\fR
خواندن متغیرهای edk2 یا aws از \fIFILE\fR
.TP
\fB\-\-inplace\fR, \fB\-\-in\-place\fR \fIFILE\fR
ویرایش درجا روی \fIFILE\fR
.TP
\fB\-\-extract\-certs\fR
استخراج تمام گواهی‌ها
.SS "گزینه‌های متغیرها:"
.TP
\fB\-d\fR, \fB\-\-delete\fR \fIVAR\fR
حذف متغیر \fIVAR\fR؛ می‌تواند چند بار مشخص شود
.TP
\fB\-\-set\-true\fR \fIVAR\fR
تنظیم متغیر \fIVAR\fR روی true؛ می‌تواند چند بار مشخص شود
.TP
\fB\-\-set\-false\fR \fIVAR\fR
تنظیم متغیر \fIVAR\fR روی false؛ می‌تواند چند بار مشخص شود
.TP
\fB\-\-set\-json\fR \fIFILE\fR
تنظیم متغیرها از فایل دامپ json با نام \fIFILE\fR
.SS "پیکربندی راه‌اندازی:"
.TP
\fB\-\-set\-boot\-uri\fR \fILINK\fR
تنظیم uri راه‌اندازی از شبکه روی \fILINK\fR (یک‌باره، با استفاده از BootNext)
.TP
\fB\-\-append\-boot\-filepath\fR \fIFILE\fR
افزودن مدخل راه‌اندازی برای \fIFILE\fR (دائمی، با استفاده از BootOrder)
.SS "پیکربندی shim.efi:"
.TP
\fB\-\-set\-shim\-debug\fR
فعال‌سازی اشکال‌زدایی shim.efi (توقف برای اتصال اشکال‌زدا)
.TP
\fB\-\-set\-shim\-verbose\fR
فعال‌سازی پیام‌های پرجزئیات shim.efi
.TP
\fB\-\-set\-fallback\-verbose\fR
فعال‌سازی پیام‌های پرجزئیات fallback.efi
.TP
\fB\-\-set\-fallback\-no\-reboot\fR
غیرفعال‌سازی راه‌اندازی مجدد برای fallback.efi
.TP
\fB\-\-set\-sbat\-level\fR \fIFILE\fR
تنظیم متغیر SbatLevel
.SS "گزینه‌های برپایی راه‌اندازی امن (Secure Boot):"
.TP
\fB\-\-set\-pk\fR, \fB\-\-set\-pk\-cert\fR \fIGUID\fR \fIFILE\fR
تنظیم PK روی گواهی x509، بارگذاری‌شده در قالب pem یا der از \fIFILE\fR و با شناسه مالک \fIGUID\fR
.TP
\fB\-\-add\-kek\fR, \fB\-\-add\-kek\-cert\fR \fIGUID\fR \fIFILE\fR
افزودن گواهی x509 به KEK، بارگذاری‌شده در قالب pem یا der از \fIFILE\fR و با شناسه مالک \fIGUID\fR؛ می‌تواند چند بار مشخص شود
.TP
\fB\-\-add\-db\fR, \fB\-\-add\-db\-cert\fR \fIGUID\fR \fIFILE\fR
افزودن گواهی x509 به db، بارگذاری‌شده در قالب pem یا der از \fIFILE\fR و با شناسه مالک \fIGUID\fR؛ می‌تواند چند بار مشخص شود
.TP
\fB\-\-add\-db\-hash\fR \fIGUID\fR \fIHASH\fR
افزودن هش sha256 با مقدار \fIHASH\fR به db، با شناسه مالک \fIGUID\fR؛ می‌تواند چند بار مشخص شود
.TP
\fB\-\-set\-dbx\fR \fIFILE\fR
مقداردهی اولیه dbx با به‌روزرسانی از \fIFILE\fR
.TP
\fB\-\-add\-dbx\fR \fIFILE\fR
افزودن به‌روزرسانی dbx از \fIFILE\fR
.TP
\fB\-\-add\-dbx\-cert\fR \fIGUID\fR \fIFILE\fR
افزودن گواهی x509 به dbx، بارگذاری‌شده در قالب pem یا der از \fIFILE\fR و با شناسه مالک \fIGUID\fR؛ می‌تواند چند بار مشخص شود
.TP
\fB\-\-add\-dbx\-hash\fR \fIGUID\fR \fIHASH\fR
افزودن هش sha256 با مقدار \fIHASH\fR به dbx، با شناسه مالک \fIGUID\fR؛ می‌تواند چند بار مشخص شود
.TP
\fB\-\-add\-mok\fR, \fB\-\-add\-mok\-cert\fR \fIGUID\fR \fIFILE\fR
افزودن گواهی x509 به MokList، بارگذاری‌شده در قالب pem یا der از \fIFILE\fR و با شناسه مالک \fIGUID\fR؛ می‌تواند چند بار مشخص شود
.TP
\fB\-\-add\-mok\-hash\fR \fIGUID\fR \fIHASH\fR
افزودن هش sha256 با مقدار \fIHASH\fR به MokList، با شناسه مالک \fIGUID\fR؛ می‌تواند چند بار مشخص شود
.SS "میانبرهای تسهیل راه‌اندازی امن:"
.TP
\fB\-\-enroll\-redhat\fR
ثبت گواهی‌های پیش‌فرض برای پلتفرم redhat
.TP
\fB\-\-enroll\-microsoft\fR
ثبت گواهی‌های پیش‌فرض برای پلتفرم microsoft oem
.TP
\fB\-\-enroll\-cert\fR \fICERT\fR
ثبت با استفاده از گواهی مشخص‌شده
.TP
\fB\-\-enroll\-generate\fR \fICN\fR
ثبت با استفاده از گواهی تولیدشده با نام عمومی (CN) داده‌شده
.TP
\fB\-\-enroll\-mgmt\fR
ثبت با استفاده از guid مدیریت خارجی
.TP
\fB\-\-no\-microsoft\fR
معادل "\-\-microsoft\-db none"
.TP
\fB\-\-microsoft\-db\fR, \fB\-\-profile\fR {\fBnone\fR,\fBwin11\fR,\fBwin23\fR,\fBwin+rom23\fR,\fBuefi11\fR,\fBuefi23\fR,\fBuefi+rom23\fR,\fBredhat\fR,\fBredhat+rom\fR,\fBall\fR}
انتخاب کلیدهای db مایکروسافت جهت ثبت
.TP
\fB\-\-microsoft\-kek\fR {\fBnone\fR,\fB2011\fR,\fB2023\fR,\fBall\fR}
انتخاب کلیدهای KEK مایکروسافت جهت ثبت
.TP
\fB\-\-distro\-keys\fR \fIDISTRO\fR
افزودن کلیدهای CA برای \fIDISTRO\fR
.TP
\fB\-\-distro\-list\fR
فهرست کردن توزیع‌های شناخته‌شده
.TP
\fB\-\-sb\fR, \fB\-\-secure\-boot\fR
فعال‌سازی حالت راه‌اندازی امن (Secure Boot)
.SS "گزینه‌های چاپ و نمایش:"
.TP
\fB\-p\fR, \fB\-\-print\fR
چاپ مخزن متغیرها (varstore)
.TP
\fB\-v\fR, \fB\-\-verbose\fR
چاپ مخزن متغیرها با جزئیات کامل
.TP
\fB\-\-hashes\fR
چاپ هش‌های sha256 پایگاه داده امضا
.TP
\fB\-x\fR, \fB\-\-hexdump\fR
چاپ دامپ هگزادسیمال متغیرها
.SS "گزینه‌های خروجی:"
.TP
\fB\-o\fR, \fB\-\-output\fR \fIFILE\fR
نوشتن متغیرهای edk2 یا aws در \fIFILE\fR، با همان قالبی که در فایل ورودی \fB\-\-input\fR استفاده شده است.
.TP
\fB\-\-output\-aws\fR \fIFILE\fR
نوشتن متغیرهای aws در \fIFILE\fR
.TP
\fB\-\-output\-json\fR \fIFILE\fR
نوشتن دامپ json در \fIFILE\fR
.TP
\fB\-\-output\-auth\fR \fIDIR\fR
نوشتن فایل‌های *.auth در پوشه \fIDIR\fR
.SH "مثال‌ها (EXAMPLES)"
.PP
چاپ مخزن متغیرها:
.PP
.nf
virt-fw-vars --input ${guest}_VARS.fd \\
             --print --verbose
.fi
.PP
ثبت گواهی‌های پیش‌فرض راه‌اندازی امن (مایکروسافت):
.PP
.nf
virt-fw-vars --input OVMF_VARS.fd \\
             --output OVMF_VARS.secboot.fd \\
             --enroll-redhat \\
             --secure-boot
.fi
.SH "نویسنده (AUTHOR)"
Gerd Hoffmann <kraxel@redhat.com>