نام (NAME)

daxctl-create-device - ایجاد یک دستگاه devdax

خلاصه دستور (SYNOPSIS)

daxctl create-device [<options>]

مثال‌ها (EXAMPLES)

•ایجاد dax0.1 با اندازهٔ 4G

# daxctl create-device -s 4G
[
  {
    "chardev":"dax0.1",
    "size":4294967296,
    "target_node":0,
    "mode":"devdax"
  }
]

•ایجاد دستگاه‌هایی با تمام اندازهٔ دردسترس روی همهٔ ناحیه‌ها

# 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"
  }
]

•ایجاد dax0.1 با تمام اندازهٔ دردسترس روی ناحیه با شناسهٔ 0

# daxctl create-device -r 0 -u
{
  "chardev":"dax0.1",
  "size":"15.63 GiB (16.78 GB)",
  "target_node":0,
  "mode":"devdax"
}

توضیحات (DESCRIPTION)

یک دستگاه dax را در حالت devdax در ناحیه‌های پویا ایجاد می‌کند. نتیجه همچنین می‌تواند به حالت system-ram تبدیل شود که ترتیبی می‌دهد تا محدودهٔ dax به عنوان حافظهٔ معمولی به صورت اتصال گرم (hot-plug) وارد سیستم شود.

دستور daxctl create-device انتظار دارد که BIOS یا کرنل محدوده‌ای را در نقشهٔ حافظهٔ EFI با EFI_MEMORY_SP مشخص کند. محدوده‌های حاصل به این معنی هستند که ۱۰۰٪ ظرفیت آن برای برنامه‌ها رزرو شده است.

گزینه‌ها (OPTIONS)

-r, --region=

عملیات را به دستگاه‌های متعلق به ناحیه(های) مشخص‌شده محدود می‌کند. یک ناحیهٔ device-dax محدودهٔ پیوسته‌ای از حافظه است که از یک یا چند دستگاه /dev/daxX.Y میزبانی می‌کند، که در آن X شناسهٔ ناحیه و Y شناسهٔ نمونهٔ دستگاه است.

-s, --size=

برای ناحیه‌هایی که از ایجاد دستگاه dax پشتیبانی می‌کنند، اندازهٔ دستگاه را بر حسب بایت تعیین می‌کند. در غیر این صورت، مقدار پیش‌فرض بیشترین اندازهٔ مشخص‌شده توسط ناحیه خواهد بود. این گزینه از پسوندهای "k" یا "K" برای KiB، "m" یا "M" برای MiB، "g" یا "G" برای GiB و "t" یا "T" برای TiB پشتیبانی می‌کند.

اندازه باید مضربی از هم‌ترازی ناحیه باشد.

-a, --align

برنامه‌هایی که مایل به برقراری نگاشت‌های حافظهٔ dax با مدخل‌های جدول صفحه بزرگ‌تر از اندازهٔ صفحهٔ پایهٔ سیستم (4K در x86) هستند، به دستگاهی نیاز دارند که به اندازهٔ کافی هم‌تراز باشد. مقدار پیش‌فرض 2M است. توجه داشته باشید که حالت "devdax" همهٔ نگاشت‌ها را ملزم به هم‌ترازی با این مقدار می‌کند؛ یعنی تلاش‌ها برای نگاشت ناهم‌تراز با شکست مواجه می‌شوند.

--input

برنامه‌هایی که می‌خواهند محدوده‌های اختصاص‌یافته به یک نمونهٔ device-dax را انتخاب کنند، یا مایل به برقراری دستگاه‌های از پیش ایجادشده هستند، می‌توانند یک فایل JSON ورودی ارسال کنند. این گزینه به کاربر اجازه می‌دهد تا یک شیء JSON مشابه نمونهٔ فهرست‌شده با "daxctl list" را ارسال کند.

نام دستگاه از نو ایجاد نمی‌شود، اما اگر یک "chardev" در فایل JSON ارسال شود،
از آن برای دریافت شناسهٔ ناحیه استفاده خواهد شد.

توجه داشته باشید که محتوای JSON در فایل نمی‌تواند آرایه‌ای از اشیاء JSON باشد،
بلکه باید یک شیء تکی JSON یعنی بدون براکت‌های محصورکنندهٔ آرایه باشد.

-u, --human

به طور پیش‌فرض این دستور داده‌ها را به صورت اعداد صحیح خام و ماشین‌پسند خروجی می‌دهد. در عوض، با استفاده از این پرچم، اعداد نشان‌دهندهٔ اندازهٔ ذخیره‌سازی به صورت رشته‌هایی خوانا برای انسان به همراه واحد قالب‌بندی می‌شوند و سایر فیلدها به رشته‌های هگزادسیمال تبدیل می‌گردند.

-v, --verbose

پیام‌های اشکال‌زدایی بیشتری را نمایش می‌دهد

کپی‌رایت و تکثیر (COPYRIGHT)

کپی‌رایت © 2016 - 2022، شرکت Intel Corporation. مجوز GPLv2: گنو GPL نسخهٔ 2 http://gnu.org/licenses/gpl.html. این نرم‌افزار آزاد است: شما مجاز به تغییر و بازتوزیع آن هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز دانسته است.

همچنین ببینید (SEE ALSO)

daxctl-list(1),daxctl-reconfigure-device[1],daxctl-destroy-device[1]

2026-06-30

daxctl