'\" t
.\"     Title: daxctl-create-device
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-30
.\"    Manual: daxctl Manual
.\"    Source: daxctl
.\"  Language: Persian
.\"
.TH "DAXCTL\-CREATE\-DEVICE" "1" "2026-06-30" "daxctl" "daxctl 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)"
daxctl-create-device \- ایجاد یک دستگاه devdax
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIdaxctl create\-device\fP [<options>]
.fi
.br
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
ایجاد dax0.1 با اندازهٔ 4G
.RE
.sp
.if n .RS 4
.nf
.fam C
# daxctl create\-device \-s 4G
[
  {
    "chardev":"dax0.1",
    "size":4294967296,
    "target_node":0,
    "mode":"devdax"
  }
]
.fam
.fi
.if n .RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
ایجاد دستگاه‌هایی با تمام اندازهٔ دردسترس روی همهٔ ناحیه‌ها
.RE
.sp
.if n .RS 4
.nf
.fam C
# daxctl create\-device \-u
[
  {
    "chardev":"dax0.1",
    "size":"15.63 GiB (16.78 GB)",
    "target_node":0,
    "mode":"devdax"
  },
  {
    "chardev":"dax1.1",
    "size":"15.63 GiB (16.78 GB)",
    "target_node":1,
    "mode":"devdax"
  }
]
.fam
.fi
.if n .RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
ایجاد dax0.1 با تمام اندازهٔ دردسترس روی ناحیه با شناسهٔ 0
.RE
.sp
.if n .RS 4
.nf
.fam C
# daxctl create\-device \-r 0 \-u
{
  "chardev":"dax0.1",
  "size":"15.63 GiB (16.78 GB)",
  "target_node":0,
  "mode":"devdax"
}
.fam
.fi
.if n .RE
.SH "توضیحات (DESCRIPTION)"
.sp
یک دستگاه dax را در حالت \fIdevdax\fP در ناحیه‌های پویا ایجاد می‌کند. نتیجه همچنین می‌تواند
به حالت \fIsystem\-ram\fP تبدیل شود که ترتیبی می‌دهد تا محدودهٔ dax به عنوان حافظهٔ معمولی
به صورت اتصال گرم (hot\-plug) وارد سیستم شود.
.sp
دستور \fIdaxctl create\-device\fP انتظار دارد که BIOS یا کرنل محدوده‌ای را در
نقشهٔ حافظهٔ EFI با EFI_MEMORY_SP مشخص کند. محدوده‌های حاصل به این معنی هستند که
۱۰۰٪ ظرفیت آن برای برنامه‌ها رزرو شده است.
.SH "گزینه‌ها (OPTIONS)"
.sp
\-r, \-\-region=
.RS 4
عملیات را به دستگاه‌های متعلق به ناحیه(های) مشخص‌شده محدود می‌کند.
یک ناحیهٔ device\-dax محدودهٔ پیوسته‌ای از حافظه است که از یک یا
چند دستگاه /dev/daxX.Y میزبانی می‌کند، که در آن X شناسهٔ ناحیه و Y
شناسهٔ نمونهٔ دستگاه است.
.RE
.sp
\-s, \-\-size=
.RS 4
برای ناحیه‌هایی که از ایجاد دستگاه dax پشتیبانی می‌کنند، اندازهٔ دستگاه را بر
حسب بایت تعیین می‌کند. در غیر این صورت، مقدار پیش‌فرض بیشترین اندازهٔ مشخص‌شده توسط
ناحیه خواهد بود. این گزینه از پسوندهای "k" یا "K" برای KiB، "m" یا "M" برای MiB،
"g" یا "G" برای GiB و "t" یا "T" برای TiB پشتیبانی می‌کند.
.sp
.if n .RS 4
.nf
.fam C
اندازه باید مضربی از هم‌ترازی ناحیه باشد.
.fam
.fi
.if n .RE
.RE
.sp
\-a, \-\-align
.RS 4
برنامه‌هایی که مایل به برقراری نگاشت‌های حافظهٔ dax با مدخل‌های جدول صفحه
بزرگ‌تر از اندازهٔ صفحهٔ پایهٔ سیستم (4K در x86) هستند، به دستگاهی نیاز دارند
که به اندازهٔ کافی هم‌تراز باشد. مقدار پیش‌فرض 2M است. توجه داشته باشید که حالت
"devdax" همهٔ نگاشت‌ها را ملزم به هم‌ترازی با این مقدار می‌کند؛ یعنی تلاش‌ها برای
نگاشت ناهم‌تراز با شکست مواجه می‌شوند.
.RE
.sp
\-\-input
.RS 4
برنامه‌هایی که می‌خواهند محدوده‌های اختصاص‌یافته به یک نمونهٔ device\-dax را انتخاب کنند،
یا مایل به برقراری دستگاه‌های از پیش ایجادشده هستند، می‌توانند یک فایل JSON ورودی
ارسال کنند. این گزینه به کاربر اجازه می‌دهد تا یک شیء JSON مشابه نمونهٔ فهرست‌شده با
"daxctl list" را ارسال کند.
.sp
.if n .RS 4
.nf
.fam C
نام دستگاه از نو ایجاد نمی‌شود، اما اگر یک "chardev" در فایل JSON ارسال شود،
از آن برای دریافت شناسهٔ ناحیه استفاده خواهد شد.
.fam
.fi
.if n .RE
.sp
.if n .RS 4
.nf
.fam C
توجه داشته باشید که محتوای JSON در فایل نمی‌تواند آرایه‌ای از اشیاء JSON باشد،
بلکه باید یک شیء تکی JSON یعنی بدون براکت‌های محصورکنندهٔ آرایه باشد.
.fam
.fi
.if n .RE
.RE
.sp
\-u, \-\-human
.RS 4
به طور پیش‌فرض این دستور داده‌ها را به صورت اعداد صحیح خام و ماشین‌پسند خروجی می‌دهد.
در عوض، با استفاده از این پرچم، اعداد نشان‌دهندهٔ اندازهٔ ذخیره‌سازی به صورت رشته‌هایی
خوانا برای انسان به همراه واحد قالب‌بندی می‌شوند و سایر فیلدها به رشته‌های هگزادسیمال
تبدیل می‌گردند.
.RE
.sp
\-v, \-\-verbose
.RS 4
پیام‌های اشکال‌زدایی بیشتری را نمایش می‌دهد
.RE
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.sp
کپی‌رایت \(co 2016 \- 2022، شرکت Intel Corporation. مجوز GPLv2: گنو GPL
نسخهٔ 2 \c
.URL "http://gnu.org/licenses/gpl.html" "" "."
این نرم‌افزار آزاد است:
شما مجاز به تغییر و بازتوزیع آن هستید. هیچ ضمانتی وجود ندارد،
تا حدی که قانون مجاز دانسته است.
.SH "همچنین ببینید (SEE ALSO)"
.sp
daxctl\-list(1),daxctl\-reconfigure\-device[1],daxctl\-destroy\-device[1]