'\" t
.\"     Title: cxl-create-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\-CREATE\-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-create-region \- ایجاد ناحیه حافظه تعبیه‌شده CXL با پیکربندی ویژگی‌های دستگاه‌های حافظه CXL تشکیل‌دهنده
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIcxl create\-region [<options>]\fP
.fi
.br
.SH "توضیحات (DESCRIPTION)"
.sp
یک ناحیه CXL از یک یا چند قطعه (slice) از memdevهای CXL تشکیل شده است، همراه با تنظیمات درهم‌تنیدگی (interleave) قابل‌پیکربندی \- هم تعداد مسیرهای درهم‌تنیدگی (interleave ways) و هم دانه‌بندی درهم‌تنیدگی (interleave granularity).
.sp
برای create\-region، می‌توان اندازه را به صورت اختیاری مشخص کرد، اما در صورت عدم تعیین، حداکثر اندازه ممکن برای هر memdev تا سقف ظرفیت رمزگشایی (decode capacity) موجود در سیستم برای نوع حافظه داده‌شده استفاده خواهد شد. برای نواحی پایدار (persistent regions)، می‌توان یک UUID به صورت اختیاری مشخص کرد، اما در صورت مشخص نشدن، یکی به طور خودکار تولید خواهد شد.
.sp
اگر عملیات ایجاد ناحیه موفقیت‌آمیز باشد، یک شیء ناحیه در قالب JSON در خروجی استاندارد (stdout) صادر می‌شود (به بخش مثال مراجعه کنید). اگر آرگومان‌های مشخص‌شده با یک پیکربندی معتبر برآورده نشوند، خطای مناسبی در خروجی خطای استاندارد (stderr) صادر خواهد شد.
.SH "مثال (EXAMPLE)"
.sp
.if n .RS 4
.nf
.fam C
#cxl create\-region \-m \-d decoder0.1 \-w 2 \-g 1024 mem0 mem1
{
  "region":"region0",
  "resource":"0xc90000000",
  "size":"512.00 MiB (536.87 MB)",
  "interleave_ways":2,
  "interleave_granularity":1024,
  "mappings":[
    {
      "position":1,
      "decoder":"decoder4.0"
    },
    {
      "position":0,
      "decoder":"decoder3.0"
    }
  ]
}
created 1 region
.fam
.fi
.if n .RE
.SH "گزینه‌ها (OPTIONS)"
.sp
<target(s)>
.RS 4
هدف‌های CXL که باید برای تشکیل ناحیه استفاده شوند. تعداد آرگومان‌های \fItarget\fP باید با گزینه \fI\-\-ways\fP (در صورت ارائه) مطابقت داشته باشد.
.RE
.sp
\-b, \-\-bus=
.RS 4
محدود کردن عملیات به گذرگاه (bus) مشخص‌شده.
.RE
.sp
\-m, \-\-memdevs
.RS 4
نشان می‌دهد که آرگومان‌های غیرگزینه‌ای برای \fItarget(s)\fP به نام‌های دستگاه‌های memdev اشاره دارند. اگر این گزینه حذف شود و هیچ هدفی مشخص نگردد، create\-region به طور داخلی از معادل \fIcxl list \-M \-d $decoder\fP به عنوان فهرست هدف استفاده می‌کند. توجه داشته باشید که بسته به توپولوژی، برای مثال در حضور سوییچ‌ها، ترتیب خودکار فهرست هدف ممکن است معتبر نباشد و تعیین دستی فهرست هدف الزامی است.
.RE
.sp
\-s, \-\-size=
.RS 4
مشخص کردن اندازه کل برای ناحیه جدید. این گزینه اختیاری است و به طور پیش‌فرض، حداکثر اندازه ممکن استفاده خواهد شد. حداکثر اندازه ممکن توسط فضای خالی و پیوسته HPA باقی‌مانده در دکودر ریشه (root decoder) و همچنین فضای DPA در دسترس در memdevهای تشکیل‌دهنده محدود می‌شود.
.RE
.sp
\-t, \-\-type=
.RS 4
مشخص کردن نوع ناحیه \- \fIpmem\fP یا \fIram\fP. مقدار پیش‌فرض به قابلیت دکودر ریشه بستگی دارد و در صورت ابهام، مقدار پیش‌فرض \fIpmem\fP خواهد بود.
.RE
.sp
\-U, \-\-uuid=
.RS 4
مشخص کردن یک شناسه یکتا (UUID) برای ناحیه جدید. معمولاً نیازی به مشخص کردن آن نیست، چرا که به طور پیش‌فرض یکی تولید خواهد شد. این گزینه تنها برای نواحی pmem کاربرد دارد.
.RE
.sp
\-w, \-\-ways=
.RS 4
تعداد مسیرهای درهم‌تنیدگی برای درهم‌تنیدگی ناحیه جدید. در صورت ارائه \-\-memdevs، این مقدار باید برابر با تعداد memdevهای مشخص‌شده در \-\-memdevs باشد. اگر \-\-ways مشخص نشود، بر اساس تعداد هدف‌های memdev ارائه‌شده تعیین خواهد شد.
.RE
.sp
\-g, \-\-granularity=
.RS 4
دانه‌بندی درهم‌تنیدگی (interleave granularity) برای ناحیه جدید. باید با دانه‌بندی دکودر ریشه انتخاب‌شده (در صورت ارائه) مطابقت داشته باشد. اگر دکودر ریشه در بیش از یک پل میزبان (host-bridge) درهم‌تنیده باشد، این مقدار باید با آن دانه‌بندی مطابقت داشته باشد. در غیر این صورت، برای پنجره‌های رمزگشایی غیردرهم‌تنیده، هر دانه‌بندی‌ای را می‌توان مشخص کرد به شرطی که تمام دستگاه‌ها از آن تنظیم پشتیبانی کنند.
.RE
.sp
\-d, \-\-decoder=
.RS 4
دکودر ریشه‌ای که ناحیه باید تحت آن ایجاد شود. در صورت عدم ارائه، نخستین دکودر پل بین‌میزبانی (cross-host bridge) در صورت وجود، که از بزرگ‌ترین درهم‌تنیدگی پشتیبانی می‌کند، انتخاب خواهد شد.
.RE
.sp
\-Q, \-\-enforce\-qos
.RS 4
پارامتری برای اعمال شکست در صورت عدم تطابق qos_class. اگر qos_class دکودر ریشه و یکی از memdevهای پشتیبان ناحیه یکسان نباشد، عملیات ایجاد ناحیه با شکست مواجه می‌شود.
.RE
.sp
\-u, \-\-human
.RS 4
به طور پیش‌فرض این دستور داده‌های عددی خام و مناسب ماشین تولید می‌کند. در عوض با این فلگ، اعداد نشان‌دهنده اندازه ذخیره‌سازی به صورت رشته‌های خوانا برای انسان همراه با واحدها قالب‌بندی می‌شوند و سایر فیلدها به رشته‌های هگزادسیمال تبدیل خواهند شد.
.RE
.sp
\-\-debug
.RS 4
فعال کردن پیام‌های اشکال‌زدایی بیشتر شامل اشکال‌زدایی کتابخانه.
.RE
.SH "حق نشر (COPYRIGHT)"
.sp
Copyright \(co 2016 \- 2022, Intel Corporation. License GPLv2: GNU GPL
version 2 \c
.URL "http://gnu.org/licenses/gpl.html" "" "."
این یک نرم‌افزار آزاد است:
شما مجاز به تغییر و توزیع مجدد آن هستید. هیچ ضمانتی وجود ندارد، تا
حدی که قانون اجازه می‌دهد.
.SH "همچنین ببینید (SEE ALSO)"
.sp
cxl\-list(1)