نام (NAME)

efi-updatevar - ابزاری برای به‌روزرسانی متغیرهای امن

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

efi-updatevar: [-a] [-e] [-d <list>[-<entry>]] [-k <key>] [-g <guid>] [-b <file>|-f <file>|-c file] <var>

توضیحات (DESCRIPTION)

فایل‌های ورودی گوناگونی را می‌گیرد و آن‌ها را به یکی از پایگاه‌های دادهٔ کلید یا امضای بوت امن UEFI اضافه می‌کند.

توجه داشته باشید که سیستم‌فایل efivarfs باید در جایی از سامانه سوار (mount) شده باشد و efi-updatevar باید دسترسی نوشتن روی فایل‌ها را داشته باشد (این مورد معمولاً بدان معناست که باید به عنوان کاربر ریشه (root) اجرا شود).

دستکاری پایگاه دادهٔ کلید UEFI از طریق سیستم‌فایل efivarfs

گزینه‌ها (OPTIONS)

-a: الحاق یک مقدار به انتهای متغیر به‌جای جایگزین کردن آن
-e: استفاده از EFI Signature List به‌جای به‌روزرسانی امضاشده (تنها در Setup Mode کار می‌کند)
-b <binfile>: افزودن درهم‌ساز (hash) فایل <binfile> به فهرست امضا
-f <file>: افزودن یا جایگزینی فایل کلید (.esl یا .auth) در <var>
-c <file>: افزودن یا جایگزینی گواهی x509 در <var> (همراه با <guid> در صورت ارائه)
-g <guid>: شناسهٔ <guid> اختیاری برای گواهی X509
-k <key>: فایل کلید امن (Secret key) برای مجاز کردن به‌روزرسانی‌های User Mode
-d <list>[-<entry>]: حذف فهرست امضای <list> (یا صرفاً یک <entry> منفرد در داخل فهرست)
--engine <eng>: استفاده از موتور (engine) <eng> برای کلید خصوصی

مثال‌ها (EXAMPLES)

با فرض اینکه کلید پلتفرم (Platform Key) مختص خود را در اختیار دارید و فایل‌های PK.auth و noPK.auth متناظر با آن را نیز دارید، می‌توانید با اجرای دستور زیر سامانه را به‌صورت برنامه‌ریزی‌شده از حالت User Mode خارج کنید:

efi-updatevar -f noPK.auth PK

و با دستور زیر آن را مجدداً بازگردانید:

efi-updatevar -f PK.auth PK

برای افزودن درهم‌ساز یک باینری efi به نام bin.efi به db در حالت Setup Mode:

efi-updatevar -b bin.efi db

و برای الحاق یک فهرست امضای EFI با نام append.esl به db در حالت Setup Mode:

efi-updatevar -a -e append.esl db

برای افزودن کلید خود (KEK.crt) به کلید تبادل کلید (Key Exchange Key یا KEK) در حالت User Mode، با این فرض که بخش خصوصی کلید پلتفرم در PK.key قرار دارد:

efi-updatevar -a -c KEK.crt -k PK.key KEK

برای افزودن گواهی DB.crt به db در حالت User Mode، با این فرض که بخش خصوصیِ کلید تبادل کلید (KEK) در KEK.key قرار دارد:

efi-updatevar -a -c DB.crt -k KEK.key db

برای جایگزین کردن کلید پلتفرم قدیمی (PK) با کلیدی جدید در newPK.crt در حالت User Mode، با فرض اینکه بخش خصوصی کلید پلتفرم قدیمی در PK.key است:

efi-updatevar -c newPK.crt -k PK.key db

برای حذف کلید خصوصی و در نتیجه تغییر وضعیت پلتفرم از User Mode به Setup Mode:

efi-updatevar -d 0 -k PK.key PK

و برای بازگرداندن دوبارهٔ کلید خصوصی (در حالت Setup Mode):

efi-updatevar -c PK.crt -k PK.key PK