'\" t
.\"     Title: nvme-fw-commit
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 02/16/2026
.\"    Manual: NVMe Manual
.\"    Source: NVMe
.\"  Language: Persian
.\"
.TH "NVME\-FW\-COMMIT" "1" "02/16/2026" "NVMe" "راهنمای NVMe"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
nvme-fw-commit \- اعتبارسنجی و ثبت تصویر میان‌افزار
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fInvme fw\-commit\fR <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>]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
برای دستگاه NVMe مشخص‌شده، یک دستور مدیریتی (admin command) از نوع Firmware Commit ارسال کرده و نتایج را ارائه می‌دهد\&.
.sp
دستور Firmware Commit برای اعتبارسنجی اینکه آیا یک تصویر میان‌افزار (firmware image) معتبر بارگیری شده است یا خیر، و ثبت (commit) آن نسخه در یک اسلات میان‌افزار مشخص به کار می‌رود\&. میزبان (host) می‌تواند تصویر میان‌افزاری را انتخاب کند که در راه‌اندازی مجدد (reset) بعدی کنترلر (تغییر وضعیت CC\&.EN از \(oq1\(cq به \(oq0\(cq، یک بازنشانی در سطح تابع PCI یا سایر موارد بازنشانی کنترلر یا زیرسیستم NVM) به‌عنوان بخشی از این دستور اعمال شود\&. نسخه میان‌افزار در حال اجرای فعلی را می‌توان از فیلد Firmware Revision در ساختار داده Identify Controller، همان‌طور که در صفحه لاگ Firmware Slot Information مشخص شده است، به دست آورد\&.
.sp
هیچ اقدام دیگری به‌صورت خودکار برای بازنشانی دستگاه انجام نمی‌شود، در حالی که معمولاً برای تکمیل فرآیند فعال‌سازی به آن نیاز است\&. اگر هسته (kernel) و درایور شما به‌اندازه کافی جدید باشند، می‌توانید میان‌افزار را با ارسال دستور بازنشانی از طریق Linux sysfs اعمال کنید، به عنوان مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
 # echo 1 > /sys/class/nvme/nvme0/device/reset
.fi
.if n \{\
.RE
.\}
.sp
اگر هسته شما به‌اندازه کافی جدید نیست، باید دستگاه را به روش دیگری حذف کرده و مجدداً اضافه کنید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-a <action>, \-\-action=<action>
.RS 4
اقدام ثبت (Commit Action): این فیلد اقدامی را که قرار است روی تصویر بارگیری‌شده با دستور Firmware Image Download یا روی تصویری که قبلاً بارگیری و قرار داده شده انجام شود مشخص می‌کند\&.
.TS
allbox tab(:);
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt.
T{
مقدار
T}:T{
تعریف
T}
T{
0
T}:T{
تصویر بارگیری‌شده جایگزین تصویر مشخص‌شده توسط فیلد Firmware Slot می‌شود\&. این تصویر فعال نمی‌شود\&.
T}
T{
1
T}:T{
تصویر بارگیری‌شده جایگزین تصویر مشخص‌شده توسط فیلد Firmware Slot می‌شود\&. این تصویر در بازنشانی بعدی فعال می‌شود\&.
T}
T{
2
T}:T{
تصویر مشخص‌شده توسط فیلد Firmware Slot در بازنشانی بعدی فعال می‌شود\&.
T}
T{
3
T}:T{
درخواست می‌شود که تصویر مشخص‌شده توسط فیلد Firmware Slot فوراً و بدون نیاز به بازنشانی فعال شود\&.
T}
T{
6
T}:T{
تصویر بارگیری‌شده جایگزین پارتیشن بوت مشخص‌شده توسط فیلد Boot Partition ID می‌شود\&.
T}
T{
7
T}:T{
علامت‌گذاری پارتیشن بوت مشخص‌شده در فیلد BPID به‌عنوان فعال و به‌روزرسانی BPINFO\&.ABPID\&.
T}
.TE
.sp 1
.RE
.PP
\-s <slot>, \-\-slot=<slot>
.RS 4
اسلات میان‌افزار (Firmware Slot): در صورت کاربرد، اسلات میان‌افزاری را که باید برای اقدام ثبت (Commit Action) استفاده شود مشخص می‌کند\&. اگر مقدار تعیین‌شده 0h باشد، کنترلر باید اسلات میان‌افزار (اسلات ۱ \(en ۷) را برای استفاده در این عملیات انتخاب کند\&.
.RE
.PP
\-\-bpid=<boot\-partid>, \-b <boot\-partid>
.RS 4
در صورت کاربرد، پارتیشن بوتی را که باید برای اقدام ثبت (Commit Action) استفاده شود مشخص می‌کند (پیش‌فرض: 0)\&.
.RE
.PP
\-o <fmt>, \-\-output\-format=<fmt>
.RS 4
تنظیم قالب گزارش به
\fInormal\fR،
\fIjson\fR
یا
\fIbinary\fR\&. در هر لحظه تنها یک قالب خروجی قابل استفاده است\&.
.RE
.PP
\-v, \-\-verbose
.RS 4
افزایش جزئیات اطلاعات در خروجی\&.
.RE
.PP
\-t <timeout>, \-\-timeout=<timeout>
.RS 4
بازنویسی مقدار مهلت زمانی پیش‌فرض\&. بر حسب میلی‌ثانیه\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ثبت آخرین میان‌افزار بارگیری‌شده در اسلات شماره ۱:
.sp
.if n \{\
.RS 4
.\}
.nf
# nvme fw\-commit /dev/nvme0 \-\-slot=1 \-\-action=2
.fi
.if n \{\
.RE
.\}
.RE
.SH "نام‌های مستعار (ALIAS)"
.sp
fw\-activate
.SH "همچنین ببینید (SEE ALSO)"
.BR nvme (1)
.SH "NVME"
.sp
بخشی از مجموعهٔ nvme\-user