'\" t
.\"     Title: cxl-set-alert-config
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-30
.\"    Manual: cxl Manual
.\"    Source: cxl
.\"  Language: English
.\"
.TH "CXL\-SET\-ALERT\-CONFIG" "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-set-alert-config \- تنظیم آستانه هشدار اخطار در یک memdev از CXL
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIcxl set\-alert\-config <mem0> [<mem1>..<memN>] [<options>]\fP
.fi
.br
.SH "توضیحات (DESCRIPTION)"
.sp
یک دستگاه CXL هنگامی که وضعیت سلامت آن تغییر کند، یک هشدار صادر می‌کند. هشدارهای بحرانی (critical alert) پس از راه‌اندازی مجدد دستگاه، به‌صورت خودکار توسط دستگاه پیکربندی می‌شوند. در صورت پشتیبانی، آستانه‌های هشدار اخطار (warning alert) قابل‌برنامه‌ریزی نیز طبق مقادیر پیش‌فرض توصیه‌شده توسط سازنده مقداردهی اولیه می‌شوند و سپس کاربر می‌تواند آن‌ها را پیکربندی کند.
.sp
از این دستور برای پیکربندی آستانه‌های هشدار اخطار در یک دستگاه استفاده کنید. با اجرای این دستور، آستانه‌های هشدار درخواست‌شده جدید جایگزین آستانه‌های هشدار برنامه‌ریزی‌شده قبلی خواهند شد.
.sp
برای فعال‌سازی هشدار اخطار، هر دو مقدار \fIthreshold=value\fP و \fIalert=on\fP را تنظیم کنید. برای غیرفعال‌سازی هشدار اخطار، تنها \fIalert=off\fP را مشخص نمایید. حالات دیگر منجر به بروز خطا خواهند شد.
.sp
برای بررسی قابلیت‌های آستانه هشدار قابل‌برنامه‌ریزی یک دستگاه، از دستور «cxl list \-m <memdev> \-A» استفاده کنید.
.SH "مثال‌ها (EXAMPLES)"
.sp
تنظیم آستانه هشدار اخطار روی ۳۰ و فعال‌سازی هشدار برای طول عمر مصرف‌شده (life used).
.sp
.if n .RS 4
.nf
.fam C
# cxl set\-alert\-config mem0 \-\-life\-used\-threshold=30 \-\-life\-used\-alert=on
{
  "memdev":"mem0",
  "ram_size":"1024.00 MiB (1073.74 MB)",
  "alert_config":{
    "life_used_prog_warn_threshold_valid":true,
    "dev_over_temperature_prog_warn_threshold_valid":false,
    "dev_under_temperature_prog_warn_threshold_valid":false,
    "corrected_volatile_mem_err_prog_warn_threshold_valid":false,
    "corrected_pmem_err_prog_warn_threshold_valid":false,
    "life_used_prog_warn_threshold_writable":true,
    "dev_over_temperature_prog_warn_threshold_writable":true,
    "dev_under_temperature_prog_warn_threshold_writable":true,
    "corrected_volatile_mem_err_prog_warn_threshold_writable":true,
    "corrected_pmem_err_prog_warn_threshold_writable":true,
    "life_used_crit_alert_threshold":75,
    "life_used_prog_warn_threshold":30,
    "dev_over_temperature_crit_alert_threshold":0,
    "dev_under_temperature_crit_alert_threshold":0,
    "dev_over_temperature_prog_warn_threshold":0,
    "dev_under_temperature_prog_warn_threshold":0,
    "corrected_volatile_mem_err_prog_warn_threshold":0,
    "corrected_pmem_err_prog_warn_threshold":0
  },
  "serial":"0",
  "host":"0000:0d:00.0"
}
cxl memdev: cmd_set_alert_config: set alert configuration 1 mem
.fam
.fi
.if n .RE
.sp
غیرفعال‌سازی هشدار اخطار برای life_used.
.sp
.if n .RS 4
.nf
.fam C
# cxl set\-alert\-config mem0 \-\-life\-used\-alert=off
{
  "memdev":"mem0",
  "ram_size":"1024.00 MiB (1073.74 MB)",
  "alert_config":{
    "life_used_prog_warn_threshold_valid":false,
    "dev_over_temperature_prog_warn_threshold_valid":false,
    "dev_under_temperature_prog_warn_threshold_valid":false,
    "corrected_volatile_mem_err_prog_warn_threshold_valid":false,
    "corrected_pmem_err_prog_warn_threshold_valid":false,
    "life_used_prog_warn_threshold_writable":true,
    "dev_over_temperature_prog_warn_threshold_writable":true,
    "dev_under_temperature_prog_warn_threshold_writable":true,
    "corrected_volatile_mem_err_prog_warn_threshold_writable":true,
    "corrected_pmem_err_prog_warn_threshold_writable":true,
    "life_used_crit_alert_threshold":75,
    "life_used_prog_warn_threshold":30,
    "dev_over_temperature_crit_alert_threshold":0,
    "dev_under_temperature_crit_alert_threshold":0,
    "dev_over_temperature_prog_warn_threshold":0,
    "dev_under_temperature_prog_warn_threshold":0,
    "corrected_volatile_mem_err_prog_warn_threshold":0,
    "corrected_pmem_err_prog_warn_threshold":0
  },
  "serial":"0",
  "host":"0000:0d:00.0"
}
cxl memdev: cmd_set_alert_config: set alert configuration 1 mem
.fam
.fi
.if n .RE
.SH "گزینه‌ها (OPTIONS)"
.sp
<memory device(s)>
.RS 4
نام یک دستگاه \fImemX\fP یا شماره شناسه memdev. عملیات را به memdev (یا memdevهای) مشخص‌شده محدود می‌کند. کلمه کلیدی \fIall\fP می‌تواند برای نشان دادن عدم وجود هیچ‌گونه محدودیتی مشخص شود.
.RE
.sp
\-S, \-\-serial
.RS 4
به‌جای شماره شناسه memdev، آرگومان(های) <memdev> را به‌عنوان فهرستی از شماره‌های سریال تفسیر می‌کند.
.RE
.sp
\-L, \-\-life\-used\-threshold=
.RS 4
تنظیم <value> برای آستانه هشدار اخطار طول عمر مصرف‌شده (life used).
.RE
.sp
\-\-life\-used\-alert=
.RS 4
فعال یا غیرفعال کردن هشدار اخطار طول عمر مصرف‌شده. گزینه‌ها \fIon\fP یا \fIoff\fP هستند.
.RE
.sp
\-O, \-\-over\-temperature\-threshold=
.RS 4
تنظیم <value> برای آستانه هشدار اخطار دمای بیش از حد دستگاه (over temperature).
.RE
.sp
\-\-over\-temperature\-alert=
.RS 4
فعال یا غیرفعال کردن هشدار اخطار دمای بیش از حد دستگاه. گزینه‌ها \fIon\fP یا \fIoff\fP هستند.
.RE
.sp
\-U, \-\-under\-temperature\-threshold=
.RS 4
تنظیم <value> برای آستانه هشدار اخطار دمای کمتر از حد دستگاه (under temperature).
.RE
.sp
\-\-under\-temperature\-alert=
.RS 4
فعال یا غیرفعال کردن هشدار اخطار دمای کمتر از حد دستگاه. گزینه‌ها \fIon\fP یا \fIoff\fP هستند.
.RE
.sp
\-V, \-\-volatile\-mem\-err\-threshold=
.RS 4
تنظیم <value> برای آستانه هشدار اخطار خطای تصحیح‌شده حافظه فرار (corrected volatile memory error).
.RE
.sp
\-\-volatile\-mem\-err\-alert=
.RS 4
فعال یا غیرفعال کردن هشدار اخطار خطای تصحیح‌شده حافظه فرار. گزینه‌ها \fIon\fP یا \fIoff\fP هستند.
.RE
.sp
\-P, \-\-pmem\-err\-threshold=
.RS 4
تنظیم <value> برای آستانه هشدار اخطار خطای تصحیح‌شده حافظه پایدار (corrected persistent memory error).
.RE
.sp
\-\-pmem\-err\-alert=
.RS 4
فعال یا غیرفعال کردن هشدار اخطار خطای تصحیح‌شده حافظه پایدار. گزینه‌ها \fIon\fP یا \fIoff\fP هستند.
.RE
.sp
\-v, \-\-verbose
.RS 4
فعال‌سازی پیام‌های اشکال‌زدایی پرجزئیات در کتابخانه (در صورتی که libcxl با قابلیت ثبت گزارش و اشکال‌زدایی کامپایل شده باشد).
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
CXL\-3.0 8.2.9.8.3.3