'\" t
.\"     Title: cxl-inject-media-poison
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-30
.\"    Manual: cxl Manual
.\"    Source: cxl
.\"  Language: English
.\"
.TH "CXL\-INJECT\-MEDIA\-POISON" "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-inject-media-poison \- تزریق داده‌های مسموم (poison) به حافظه CXL
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIcxl inject\-media\-poison\fP <memdev> [<گزینه‌ها>]
.fi
.br
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B هشدار
.ps -1
.br
.sp
تزریق پویزن می‌تواند باعث ناپایداری سیستم شود و تنها باید برای اشکال‌زدایی روندهای بازیابی خطای سخت‌افزاری و نرم‌افزاری استفاده شود. با مسئولیت خودتان استفاده کنید!
.sp .5v
.RE
.sp
تزریق پویزن به حافظهٔ دستگاه حافظه CXL. دستگاه‌های حافظه CXL را می‌توان بر اساس نام دستگاه (مانند "mem0")، شناسه دستگاه ("X" در "memX") یا نام دستگاه میزبان ("0000:35:00.0") مشخص کرد.
.sp
پویزن را تنها می‌توان برای دستگاه‌های حافظه CXL که از تزریق پویزن پشتیبانی می‌کنند استفاده کرد. برای مشاهده اینکه کدام دستگاه‌های CXL از تزریق پویزن پشتیبانی می‌کنند، ویژگی "poison_injectable" را در زیر دستگاه در \fIcxl\-list\fP بررسی کنید. نمونه‌ای از دستگاهی که از تزریق پویزن پشتیبانی می‌کند:
.sp
.if n .RS 4
.nf
.fam C
# cxl list \-u \-m mem0
{
        "memdev":"mem0",
        "ram_size":"256.00 MiB (268.44 MB)",
        "serial":"0",
        "host":"0000:0d:00.0",
        "firmware_version":"BWFW VERSION 00",
        "poison_injectable":true
}
.fam
.fi
.if n .RE
.sp
برای تزریق پویزن، آدرس فیزیکی دستگاه (DPA) الزامی است. گزینهٔ \fI\-a\fP/\fI\-\-address\fP برای مشخص کردن آدرس فیزیکی دستگاه جهت تزریق پویزن استفاده می‌شود. آدرس را می‌توان در مبنای ده‌دهی یا شانزده‌شانزدهی مشخص کرد. برای نمونه:
.sp
.if n .RS 4
.nf
.fam C
# cxl inject\-media\-poison mem0 \-a 0x1000
poison inject at mem0:0x1000
# cxl list \-m mem0 \-u \-\-media\-errors
{
  "memdev":"mem0",
  "ram_size":"256.00 MiB (268.44 MB)",
  "serial":"0",
  "host":"0000:0d:00.0",
  "firmware_version":"BWFW VERSION 00",
  "media_errors":[
    {
      "offset":"0x1000",
      "length":64,
      "source":"Injected"
    }
  ]
}
.fam
.fi
.if n .RE
.sp
برای آگاهی از نحوه پاک‌سازی پویزن از یک دستگاه حافظه CXL، دستور \fIclear\-media\-poison\fP را ببینید.
.sp
این دستور برای تزریق پویزن به CXL debugfs (که معمولاً در "/sys/kernel/debug/cxl" متصل می‌شود) وابسته است. اگر CXL debugfs غیرقابل دسترس باشد، ویژگی "poison_injectable" همیشه روی "false" تنظیم خواهد بود.
.SH "گزینه‌ها (OPTIONS)"
.sp
\-a, \-\-address
.RS 4
آدرس فیزیکی دستگاه (DPA) جهت استفاده برای تزریق پویزن. آدرس می‌تواند در مبنای شانزده‌شانزدهی (hex) یا ده‌دهی (decimal) مشخص شود. برای تزریق پویزن الزامی است.
.RE
.sp
\-\-debug
.RS 4
فعال‌سازی خروجی اشکال‌زدایی (debug)
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
cxl\-list(1)
cxl\-clear\-media\-poison(1)