'\" t
.\"     Title: cxl-update-firmware
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-30
.\"    Manual: cxl Manual
.\"    Source: cxl
.\"  Language: English
.\"
.TH "CXL\-UPDATE\-FIRMWARE" "1" "2026-06-30" "cxl" "cxl 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)"
cxl-update-firmware \- به‌روزرسانی سفت‌افزار روی یک memdev در CXL
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIcxl update\-firmware <mem0> [<mem1>..<memN>] [<options>]\fP
.fi
.br
.SH "توضیحات (DESCRIPTION)"
.sp
سفت‌افزار را روی یک یا چند دستگاه حافظه CXL به‌روزرسانی می‌کند. این دستگاه‌های حافظه باید از مجموعه دستورهای میل‌باکس (mailbox commands) مرتبط با سفت‌افزار پشتیبانی کنند.
.sp
این دستور مستقیماً دستورهای میل‌باکس انتقال / فعال‌سازی سفت‌افزار را صادر نمی‌کند. در عوض، از سازوکار بارگذار سفت‌افزار هسته (firmware loader) برای ارائه داده‌ها به هسته استفاده می‌شود؛ و هسته وظیفه انجام به‌روزرسانی واقعی و همچنین مدیریت برش زمانی (time slicing) انتقال را با توجه به سایر دستورهای پس‌زمینه بر عهده می‌گیرد.
.SH "مثال‌ها (EXAMPLES)"
.sp
.if n .RS 4
.nf
.fam C
# cxl update\-firmware mem0 \-F firmware.bin \-w
[
  {
    "memdev":"mem0",
    "pmem_size":1073741824,
    "ram_size":1073741824,
    "serial":0,
    "numa_node":0,
    "host":"cxl_mem.0",
    "firmware":{
      "num_slots":3,
      "active_slot":2,
      "online_activate_capable":false,
      "slot_1_version":"cxl_test_fw_001",
      "slot_2_version":"cxl_test_fw_002",
      "slot_3_version":"cxl_test_new_fw",
      "fw_update_in_progress":false
    }
  }
]
firmware update completed on 1 mem device
.fam
.fi
.if n .RE
.SH "گزینه‌ها (OPTIONS)"
.sp
\-b, \-\-bus=
.RS 4
محدود کردن عملیات به گذرگاه (bus) مشخص‌شده.
.RE
.sp
\-F, \-\-firmware\-file
.RS 4
فایل ایمیج سفت‌افزار مورد استفاده برای به‌روزرسانی.
.RE
.sp
\-c, \-\-cancel
.RS 4
تلاش برای لغو یک به‌روزرسانی سفت‌افزارِ در حال انجام. این عمل ممکن است بسته به این که فرایند به‌روزرسانی در چه مرحله‌ای قرار دارد، با شکست مواجه شود.
.RE
.sp
\-w, \-\-wait
.RS 4
به‌طور پیش‌فرض، دستور update\-firmware تنها به‌روزرسانی سفت‌افزار را آغاز کرده و بازمی‌گردد، در حالی که عملیات به‌روزرسانی به‌صورت ناهمگام در پس‌زمینه انجام می‌شود. این گزینه با منتظر ماندن برای تکمیل فرایند پیش از بازگشت، اجرای دستور به‌روزرسانی سفت‌افزار را همگام می‌سازد.
.sp
.if n .RS 4
.nf
.fam C
اگر \-\-wait بدون یک firmware\-file همراه مشخص شود،
انتظاری را روی تمام به‌روزرسانی‌های سفت‌افزارِ
در حال انجام فعلی آغاز کرده و سپس بازمی‌گردد.
.fam
.fi
.if n .RE
.RE
.sp
\-v, \-\-verbose
.RS 4
نمایش پیام‌های اشکال‌زدایی بیشتر.
.RE
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.sp
حق نشر \(co 2016 \- 2022, Intel Corporation. مجوز GPLv2: گنو GPL نسخه ۲ \c
.URL "http://gnu.org/licenses/gpl.html" "" "."
این یک نرم‌افزار آزاد است: شما برای تغییر و توزیع مجدد آن آزاد هستید. هیچ ضمانتی وجود ندارد، تا جایی که قانون اجازه می‌دهد.
.SH "همچنین ببینید (SEE ALSO)"
.sp
cxl\-list(1)