'\" t
.\"     Title: cxl-clear-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\-CLEAR\-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-clear-media-poison \- پاکسازی داده‌های معیوب (poison) از حافظه CXL
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIcxl clear\-media\-poison\fP <memdev> [<options>]
.fi
.br
.sp
پاکسازی علامت خطای معیوب (poison) از حافظه یک دستگاه حافظه CXL. دستگاه‌های حافظه CXL (یا memdevها) می‌توانند بر اساس نام دستگاه (مانند "mem0")، شناسه دستگاه ("X" در "memX")، یا نام دستگاه میزبان ("0000:35:00.0") مشخص شوند.
.sp
برای بررسی اینکه آیا دستگاه دارای پویزن قابل پاکسازی است یا خیر، از دستور \fIcxl\-list\fP به همراه گزینه \fI\-L\fP/\fI\-\-media\-errors\fP استفاده کنید. نمونه‌ای از دستگاهی که داده معیوب (poison) در آدرس فیزیکی دستگاه (یا همان "offset") با مقدار 0x1000 به آن تزریق شده است:
.sp
.if n .RS 4
.nf
.fam C
# cxl list \-m mem0 \-L \-u
{
  "memdev":"mem0",
  "ram_size":"1024.00 MiB (1073.74 MB)",
  "ram_qos_class":42,
  "serial":"0x0",
  "numa_node:1,
  "host":"0000:35:00.0",
  "media_errors":[
    {
          "offset":"0x1000",
          "length":64,
          "source":"Injected"
        }
  ]
}
.fam
.fi
.if n .RE
.sp
برای پاکسازی پویزن از یک memdev در CXL، آدرس فیزیکی دستگاه الزامی است. گزینه \fI\-a\fP/\fI\-\-address\fP برای تعیین آدرسی که باید پویزن آن پاکسازی شود به کار می‌رود. آدرس را می‌توان به صورت ده‌دهی یا هگزادسیمال مشخص کرد. مثالی با استفاده از دستگاه نمونه بالا:
.sp
.if n .RS 4
.nf
.fam C
# cxl clear\-media\-poison mem0 \-a 0x1000
poison cleared at mem0:0x1000

# cxl list \-m mem0 \-L \-u
{
  "memdev":"mem0",
  "ram_size":"1024.00 MiB (1073.74 MB)",
  "ram_qos_class":42,
  "serial":"0x0",
  "numa_node:1,
  "host":"0000:35:00.0",
  "media_errors":[
  ]
}
.fam
.fi
.if n .RE
.sp
برای چگونگی تزریق پویزن به یک دستگاه حافظه CXL، دستور \fIinject\-media\-poison\fP را ببینید.
.sp
این دستور برای پاکسازی پویزن دستگاه به سیستم‌فایل اشکال‌زدایی CXL (که معمولاً در "/sys/kernel/debug/cxl" سوار می‌شود) وابسته است.
.SH "گزینه‌ها (OPTIONS)"
.sp
\-a, \-\-address
.RS 4
آدرس فیزیکی دستگاه (DPA) برای پاکسازی پویزن. آدرس می‌تواند به صورت هگزادسیمال یا ده‌دهی مشخص شود.
.RE
.sp
\-\-debug
.RS 4
فعال‌سازی خروجی اشکال‌زدایی (دیباگ).
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
cxl\-list(1)
cxl\-clear\-media\-poison(1)