'\" t
.\"     Title: ndctl-update-firmware
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-30
.\"    Manual: ndctl Manual
.\"    Source: ndctl
.\"  Language: English
.\"
.TH "NDCTL\-UPDATE\-FIRMWARE" "1" "2026-06-30" "ndctl" "ndctl Manual"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
ndctl-update-firmware \- به‌روزرسانی سفت‌افزار دستگاه مشخص‌شده
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIndctl update\-firmware\fP <dimm> [<options>]
.fi
.br
.SH "توضیحات (DESCRIPTION)"
.sp
یک رابط عمومی برای به‌روزرسانی سفت‌افزار NVDIMM ارائه می‌دهد. استفاده از این دستور به پشتیبانی از "خانواده" NVDIMM در libndctl بستگی دارد؛ هسته باید آن مجموعه دستورات را فعال کرده باشد و خود دستگاه نیز باید دستور را پیاده‌سازی کرده باشد. برای بررسی فعال بودن امکان به‌روزرسانی سفت‌افزار، از "ndctl list \-DF" استفاده کنید. به عنوان مثال:
.sp
.nf
ndctl list \-DFu \-d nmem1
{
  "dev":"nmem1",
  "id":"cdab\-0a\-07e0\-ffffffff",
  "handle":"0",
  "phys_id":"0",
  "security":"disabled",
  "firmware":{
    "current_version":"0",
    "can_update":true
  }
}
.fi
.br
.SH "گزینه‌ها (OPTIONS)"
.sp
<dimm>
.RS 4
یک نام دستگاه \fInmemX\fP یا شماره شناسه dimm. عملیات را به dimm(های) مشخص‌شده محدود می‌کند. کلیدواژه \fIall\fP می‌تواند برای نشان دادن عدم وجود محدودیت مشخص شود، هرچند این کار معادل عدم ارائه گزینه \-\-dimm است.
.RE
.sp
\-b, \-\-bus=
.RS 4
شماره شناسه گذرگاه، یا یک رشته ارائه‌دهنده (مانند "ACPI.NFIT"). عملیات را به گذرگاه(های) مشخص‌شده محدود می‌کند. کلیدواژه \fIall\fP می‌تواند برای نشان دادن عدم وجود هرگونه محدودیت مشخص شود، هرچند این کار معادل عدم ارائه گزینه \-\-bus است.
.RE
.sp
\-f, \-\-firmware
.RS 4
فایل سفت‌افزار مورد استفاده برای انجام به‌روزرسانی.
.RE
.sp
\-i, \-\-force
.RS 4
نادیده گرفتن عملیات در حال انجام Address Range Scrub و تلاش برای ثبت به‌روزرسانی سفت‌افزار، یا نادیده گرفتن سرریزهای مسلح‌سازی فعال‌سازی سفت‌افزار و مسلح‌سازی اجباری دستگاه‌ها.
.RE
.sp
\-A, \-\-arm
.RS 4
مسلح کردن (آماده‌باش) یک دستگاه برای فعال‌سازی سفت‌افزار. هنگامی که یک ایمیج سفت‌افزار مشخص شده باشد، این گزینه به صورت پیش‌فرض فعال است. برای غیرفعال کردن این حالت پیش‌فرض، \-\-no\-arm را مشخص کنید. در غیر این صورت، بدون مشخص کردن ایمیج سفت‌افزار، این گزینه می‌تواند برای مسلح کردن دستی یک دستگاه جهت فعال‌سازی سفت‌افزار استفاده شود. هنگامی که یک دستگاه از حالت غیرمسلح به مسلح تغییر وضعیت می‌دهد، پلتفرم زمان فعال‌سازی سفت‌افزار را دوباره محاسبه کرده و آن را با حداکثر زمان پشتیبانی‌شده پلتفرم مقایسه می‌کند. اگر زمان فعال‌سازی از حداکثر زمان پلتفرم فراتر رود، تلاش مسلح‌سازی لغو می‌شود:
.RE
.sp
.nf
ndctl update\-firmware \-\-arm \-\-bus=nfit_test.0 all
  Error: update firmware: nmem4: arm aborted, tripped overflow
[
  {
    "dev":"nmem1",
    "id":"cdab\-0a\-07e0\-ffffffff",
    "handle":"0",
    "phys_id":"0",
    "security":"disabled",
    "firmware":{
      "current_version":"0",
      "can_update":true
    }
  },
  {
    "dev":"nmem3",
    "id":"cdab\-0a\-07e0\-fffeffff",
    "handle":"0x100",
    "phys_id":"0x2",
    "security":"disabled",
    "firmware":{
      "current_version":"0",
      "can_update":true
    }
  },
  {
    "dev":"nmem2",
    "id":"cdab\-0a\-07e0\-feffffff",
    "handle":"0x1",
    "phys_id":"0x1",
    "security":"disabled",
    "firmware":{
      "current_version":"0",
      "can_update":true
    }
  }
]
updated 3 nmems.
.fi
.br
.sp
.if n .RS 4
.nf
.fam C
نادیده گرفتن سرریزهای مهلت زمانی با گزینه \-\-force امکان‌پذیر است اما توصیه نمی‌شود. در هر زمان برای مشاهده وضعیت \*(Aqمسلح\*(Aq (armed) گذرگاه دستور زیر را اجرا کنید:
.fam
.fi
.if n .RE
.sp
.nf
ndctl list \-BF \-b nfit_test.0
[
  {
    "provider":"nfit_test.0",
    "dev":"ndbus2",
    "scrub_state":"idle",
    "firmware":{
      "activate_method":"suspend",
      "activate_state":"overflow"
    }
  }
]
.fi
.br
.sp
\-D, \-\-disarm
.RS 4
غیرمسلح کردن دستگاه‌ها پس از بارگذاری فایل سفت‌افزار، یا غیرمسلح کردن دستی دستگاه‌ها در صورتی که ایمیج سفت‌افزاری مشخص نشده باشد. گزینه \-\-no\-disarm پذیرفته نیست.
.RE
.sp
\-v, \-\-verbose
.RS 4
ارسال پیام‌های اشکال‌زدایی برای فرآیند بررسی فضای نام (namespace).
.RE
.SH "حق نشر (COPYRIGHT)"
.sp
حق نشر \(co 2016 \- 2022، شرکت اینتل (Intel Corporation). مجوز GPLv2: گنو GPL
نسخه ۲ \c
.URL "http://gnu.org/licenses/gpl.html" "" "."
این یک نرم‌افزار آزاد است:
شما در تغییر و بازتوزیع آن آزاد هستید. تا حد مجاز طبق قانون، هیچ ضمانتی وجود ندارد.