NVME-FW-COMMIT(1) راهنمای NVMe NVME-FW-COMMIT(1)

nvme-fw-commit - اعتبارسنجی و ثبت تصویر میان‌افزار

nvme fw-commit <device> [--slot=<slot> | -s <slot>]
                        [--action=<action> | -a <action>]
                        [--bpid=<boot-partid> | -b <boot-partid>]
                        [--output-format=<fmt> | -o <fmt>] [--verbose | -v]
                        [--timeout=<timeout> | -t <timeout>]

برای دستگاه NVMe مشخص‌شده، یک دستور مدیریتی (admin command) از نوع Firmware Commit ارسال کرده و نتایج را ارائه می‌دهد.

دستور Firmware Commit برای اعتبارسنجی اینکه آیا یک تصویر میان‌افزار (firmware image) معتبر بارگیری شده است یا خیر، و ثبت (commit) آن نسخه در یک اسلات میان‌افزار مشخص به کار می‌رود. میزبان (host) می‌تواند تصویر میان‌افزاری را انتخاب کند که در راه‌اندازی مجدد (reset) بعدی کنترلر (تغییر وضعیت CC.EN از ‘1’ به ‘0’، یک بازنشانی در سطح تابع PCI یا سایر موارد بازنشانی کنترلر یا زیرسیستم NVM) به‌عنوان بخشی از این دستور اعمال شود. نسخه میان‌افزار در حال اجرای فعلی را می‌توان از فیلد Firmware Revision در ساختار داده Identify Controller، همان‌طور که در صفحه لاگ Firmware Slot Information مشخص شده است، به دست آورد.

هیچ اقدام دیگری به‌صورت خودکار برای بازنشانی دستگاه انجام نمی‌شود، در حالی که معمولاً برای تکمیل فرآیند فعال‌سازی به آن نیاز است. اگر هسته (kernel) و درایور شما به‌اندازه کافی جدید باشند، می‌توانید میان‌افزار را با ارسال دستور بازنشانی از طریق Linux sysfs اعمال کنید، به عنوان مثال:

# echo 1 > /sys/class/nvme/nvme0/device/reset

اگر هسته شما به‌اندازه کافی جدید نیست، باید دستگاه را به روش دیگری حذف کرده و مجدداً اضافه کنید.

-a <action>, --action=<action>

اقدام ثبت (Commit Action): این فیلد اقدامی را که قرار است روی تصویر بارگیری‌شده با دستور Firmware Image Download یا روی تصویری که قبلاً بارگیری و قرار داده شده انجام شود مشخص می‌کند.
مقدار تعریف
0 تصویر بارگیری‌شده جایگزین تصویر مشخص‌شده توسط فیلد Firmware Slot می‌شود. این تصویر فعال نمی‌شود.
1 تصویر بارگیری‌شده جایگزین تصویر مشخص‌شده توسط فیلد Firmware Slot می‌شود. این تصویر در بازنشانی بعدی فعال می‌شود.
2 تصویر مشخص‌شده توسط فیلد Firmware Slot در بازنشانی بعدی فعال می‌شود.
3 درخواست می‌شود که تصویر مشخص‌شده توسط فیلد Firmware Slot فوراً و بدون نیاز به بازنشانی فعال شود.
6 تصویر بارگیری‌شده جایگزین پارتیشن بوت مشخص‌شده توسط فیلد Boot Partition ID می‌شود.
7 علامت‌گذاری پارتیشن بوت مشخص‌شده در فیلد BPID به‌عنوان فعال و به‌روزرسانی BPINFO.ABPID.

-s <slot>, --slot=<slot>

اسلات میان‌افزار (Firmware Slot): در صورت کاربرد، اسلات میان‌افزاری را که باید برای اقدام ثبت (Commit Action) استفاده شود مشخص می‌کند. اگر مقدار تعیین‌شده 0h باشد، کنترلر باید اسلات میان‌افزار (اسلات ۱ – ۷) را برای استفاده در این عملیات انتخاب کند.

--bpid=<boot-partid>, -b <boot-partid>

در صورت کاربرد، پارتیشن بوتی را که باید برای اقدام ثبت (Commit Action) استفاده شود مشخص می‌کند (پیش‌فرض: 0).

-o <fmt>, --output-format=<fmt>

تنظیم قالب گزارش به normal، json یا binary. در هر لحظه تنها یک قالب خروجی قابل استفاده است.

-v, --verbose

افزایش جزئیات اطلاعات در خروجی.

-t <timeout>, --timeout=<timeout>

بازنویسی مقدار مهلت زمانی پیش‌فرض. بر حسب میلی‌ثانیه.

•ثبت آخرین میان‌افزار بارگیری‌شده در اسلات شماره ۱: 
# nvme fw-commit /dev/nvme0 --slot=1 --action=2

fw-activate

nvme(1)

بخشی از مجموعهٔ nvme-user

02/16/2026 NVMe