'\" t
.\"     Title: cxl-disable-region
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-30
.\"    Manual: cxl Manual
.\"    Source: cxl
.\"  Language: Persian
.\"
.TH "CXL\-DISABLE\-REGION" "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-disable-region \- غیرفعال‌سازی ناحیه(های) مشخص‌شده
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIcxl disable\-region <region> [<options>]\fP
.fi
.br
.SH "توضیحات (DESCRIPTION)"
.sp
یک ناحیهٔ (region) CXL از یک یا چند برش از memdevهای CXL با تنظیمات درهم‌تنیدگی (interleave) قابل‌پیکربندی تشکیل شده است \- هم تعداد مسیرهای درهم‌تنیدگی (interleave ways) و هم دانه‌بندی درهم‌تنیدگی (interleave granularity).
.sp
اگر بلوک‌های حافظه‌ای وجود داشته باشند که هنوز برخط (online) هستند، عملیات تلاش خواهد کرد بلوک‌های مربوطه را برون‌خط (offline) کند. چنانچه برون‌خط‌سازی با شکست مواجه شود، در صورت عدم استفاده از پارامتر \-f (اجبار)، عملیات با خطا مواجه خواهد شد.
.SH "مثال‌ها (EXAMPLES)"
.sp
.if n .RS 4
.nf
.fam C
# cxl disable\-region all
disabled 2 regions
.fam
.fi
.if n .RE
.sp
در هر دستور فعال‌سازی (enable) یا غیرفعال‌سازی (disable)، چنانچه عملیات به‌دلیل وضعیت فعلی هدف یک عملیات بی‌اثر (no\-op) باشد (یعنی از پیش فعال یا غیرفعال باشد)، اجرای آن حتی در صورتی که هیچ عملیات واقعی انجام نشود نیز موفقیت‌آمیز تلقی می‌شود. هدف می‌تواند یک bus، decoder، memdev یا region باشد. عملیات همچنان با موفقیت به پایان می‌رسد و تعداد bus/decoder/memdev/region پردازش‌شده را گزارش می‌دهد، حتی اگر عملیات یک no\-op باشد.
.SH "گزینه‌ها (OPTIONS)"
.sp
\-b, \-\-bus=
.RS 4
محدود کردن عملیات به گذرگاه (bus) مشخص‌شده.
.RE
.sp
\-f, \-\-force
.RS 4
تلاش برای disable\-region حتی در صورتی که حافظه نتواند با موفقیت برون‌خط (offline) شود. هشداری صادر خواهد شد مبنی بر اینکه عملیات باعث نشت دائمی فضای آدرس فیزیکی می‌شود و تا زمان راه‌اندازی مجدد سیستم (reboot) قابل‌بازیابی نخواهد بود.
.RE
.sp
\-d, \-\-decoder=
.RS 4
دکودر ریشه (root decoder) برای محدود کردن عملیات به آن. تنها بر روی ناحیه‌هایی (regions) اقدام خواهد شد که فرزندان دکودر مشخص‌شده باشند.
.RE
.sp
\-\-debug
.RS 4
فعال‌سازی پیام‌های اشکال‌زدایی اضافی شامل اشکال‌زدایی کتابخانه.
.RE
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.sp
حق نشر \(co 2016 \- 2022، شرکت Intel Corporation. مجوز GPLv2: نسخه ۲ از GNU GPL \c
.URL "http://gnu.org/licenses/gpl.html" "" "."
این نرم‌افزار آزاد است:
شما مجاز به تغییر و بازتوزیع آن هستید. هیچ‌گونه ضمانتی وجود ندارد،
تا حدی که قانون اجازه می‌دهد.
.SH "همچنین ببینید (SEE ALSO)"
.sp
cxl\-list(1), cxl\-enable\-region(1)