'\" t
.\"     Title: cxl-reserve-dpa
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-30
.\"    Manual: cxl Manual
.\"    Source: cxl
.\"  Language: Persian
.\"
.TH "CXL\-RESERVE\-DPA" "1" "2026-06-30" "cxl" "راهنمای cxl"
.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-reserve-dpa \- تخصیص فضای آدرس فیزیکی دستگاه (DPA)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIcxl reserve\-dpa\fP <mem0> [<mem1>..<memN>] [<گزینه‌ها>]
.fi
.br
.sp
فرایند آماده‌سازی ناحیه (region) CXL در چندین مرحله انجام می‌شود. یکی از این مراحل، شناسایی و رزرو بازه DPA است که هر عضو از مجموعه درهم‌تنیده (ناحیه) پیش از پیوست شدن به آن تخصیص اختصاص می‌دهد. برای اهداف توسعه، آزمایش و اشکال‌زدایی، این دستور ابزاری کمکی برای یافتن رمزگشای (decoder) در دسترس بعدی روی نقطه پایانی (memdev) و علامت‌گذاری یک بازه DPA به عنوان مشغول (busy) است.
.SH "گزینه‌ها (OPTIONS)"
.sp
<دستگاه(های) حافظه>
.RS 4
یک نام دستگاه \fImemX\fP یا شماره شناسه memdev. عملیات را به memdev(های) مشخص‌شده محدود می‌کند. کلیدواژه \fIall\fP می‌تواند برای نشان دادن عدم وجود هرگونه محدودیت مشخص شود.
.RE
.sp
\-S, \-\-serial
.RS 4
به جای شماره شناسه memdev، آرگومان(های) <memdev> را به عنوان فهرستی از شماره‌های سریال تفسیر می‌کند.
.RE
.sp
\-b, \-\-bus=
.RS 4
عملیات را به گذرگاه (bus) مشخص‌شده محدود می‌کند.
.RE
.sp
\-d, \-\-decoder
.RS 4
رمزگشایی (decoder) را برای تلاش جهت تخصیص مشخص می‌کند. مشخصات CXL الزام می‌کند که تخصیص‌ها باید بر اساس DPA و نمونه رمزگشا مرتب شوند؛ بدین معنی که کمترین تخصیص DPA روی دستگاه توسط decoder0 پوشش داده می‌شود و آخرین/بالاترین تخصیص DPA توسط آخرین رمزگشا پوشش داده می‌شود. این ترتیب‌بندی توسط هسته اعمال می‌شود. به طور پیش‌فرض این ابزار \fIرمزگشای در دسترس بعدی\fP را انتخاب می‌کند.
.RE
.sp
\-t, \-\-type
.RS 4
پارتیشن را برای تخصیص انتخاب می‌کند. دستگاه‌های CXL پارتیشنی را پیاده‌سازی می‌کنند که ظرفیت \fIram\fP و \fIpmem\fP را تقسیم می‌کند، جایی که ظرفیت \fIpmem\fP ظرفیت DPA بالاتر بالای مرز پارتیشن را مصرف می‌کند. نوع به طور پیش‌فرض \fIpmem\fP است. توجه داشته باشید که با توجه به محدودیت‌های تخصیص DPA در CXL، به محض ایجاد هرگونه تخصیص \fIpmem\fP، تمام ظرفیت باقی‌مانده \fIram\fP رزروشده (ردشده) می‌شود.
.RE
.sp
\-f, \-\-force
.RS 4
هسته محدودیت‌های ترتیب‌بندی تخصیص DPA در CXL را اعمال می‌کند و این ابزار آن‌ها را پیش‌بینی کرده و عملیاتی را که انتظار می‌رود با شکست مواجه شوند بدون ارسال به هسته با خطا متوقف می‌کند. برای اهداف آزمایشی، جهت به‌کارگیری درایور به تلاش برای اجرای عملیات‌هایی که «انتظار شکست دارند» ادامه می‌دهد.
.RE
.sp
\-s, \-\-size
.RS 4
اندازه تخصیص را مشخص می‌کند. این گزینه از پسوندهای "k" یا "K" برای KiB، "m" یا "M" برای MiB، "g" یا "G" برای GiB و "t" یا "T" برای TiB پشتیبانی می‌کند. مقدار پیش‌فرض "تمام ظرفیت موجود از نوع مشخص‌شده" است.
.RE
.sp
\-v
.RS 4
پیام‌های اشکال‌زدایی پرجزئیات را در کتابخانه فعال می‌کند (اگر libcxl با گزارش‌گیری و اشکال‌زدایی فعال کامپایل شده باشد).
.RE
.SH "حق نشر (COPYRIGHT)"
.sp
Copyright \(co 2016 \- 2022, Intel Corporation. مجوز GPLv2: گنو GPL نسخه 2 \c
.URL "http://gnu.org/licenses/gpl.html" "" "."
این یک نرم‌افزار آزاد است: شما برای تغییر و توزیع مجدد آن آزاد هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.
.SH "همچنین ببینید (SEE ALSO)"
.sp
cxl\-free\-dpa(1)