'\" t
.\"     Title: ndctl-enable-namespace
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-30
.\"    Manual: ndctl Manual
.\"    Source: ndctl
.\"  Language: English
.\"
.TH "NDCTL\-ENABLE\-NAMESPACE" "1" "2026-06-30" "ndctl" "ndctl 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)"
ndctl-enable-namespace \- فعال‌سازی فضای نام (یا فضاهای نام) مشخص‌شده
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIndctl enable\-namespace\fP <namespace> [<options>]
.fi
.br
.SH "مبانی عملکرد (THEORY OF OPERATION)"
.sp
ظرفیت یک NVDIMM REGION (محدوده پیوسته‌ای از حافظه پایدار) از طریق یک یا چند دستگاه NAMESPACE در دسترس قرار می‌گیرد. REGION اصطلاح لینوکسی برای چیزی است که در ACPI و UEFI با عنوان DIMM\-interleave\-set یا یک system\-physical\-address\-range شناخته می‌شود که (توسط کنترل‌کننده حافظه) بین یک یا چند ماژول حافظه تقسیم (striped) شده است.
.sp
مشخصات UEFI، پروتکل \fINVDIMM Label Protocol\fP را به عنوان ترکیبی از روش‌های دسترسی به ناحیه برچسب و یک قالب داده برای تدارک یک یا چند شیء NAMESPACE از یک REGION تعریف می‌کند. توجه داشته باشید که پشتیبانی از برچسب اختیاری است و اگر لینوکس قابلیت برچسب را شناسایی نکند، به صورت خودکار یک فضای نام بدون برچسب (label\-less) به ازای هر ناحیه ایجاد می‌کند. نمونه‌هایی از فضاهای نام بدون برچسب مواردی هستند که توسط گزینه خط فرمان \fImemmap=ss!nn\fP هسته ایجاد شده‌اند (به ویکی nvdimm در kernel.org مراجعه کنید)، یا NVDIMMهایی که فاقد یک \fInamespace index\fP معتبر در ناحیه برچسب خود هستند.
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B نکته
.ps -1
.br
.sp
فضاهای نام بدون برچسب فاقد بسیاری از ویژگی‌های همتایان برچسب‌دار خود هستند. برای مثال، اندازه آن‌ها قابل تغییر نیست، یا نمی‌توان آن‌ها را به طور کامل تخریب کرد (\fIdestroy\fP، یعنی بازپس‌گیری فضا). یک عملیات destroy هرگونه فراداده مختص به حالت را صفر می‌کند. در نهایت، برای عملیات‌های create\-namespace روی فضاهای نام بدون برچسب، ndctl از بررسی‌های دسترسی‌پذیری ظرفیت ناحیه صرف‌نظر کرده و همواره درخواست را با استفاده از تمام ظرفیت ناحیه برآورده می‌سازد. تنها عملیات پیکربندی مجدد پشتیبانی‌شده در یک فضای نام بدون برچسب، تغییر \fImode\fP آن است.
.sp .5v
.RE
.sp
یک فضای نام می‌تواند طوری تدارک دیده شود که در یکی از ۴ حالت \fIfsdax\fP، \fIdevdax\fP، \fIsector\fP و \fIraw\fP کار کند. در ادامه مدل‌های کاربردی مورد انتظار برای این حالت‌ها آمده است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
fsdax: حالت Filesystem\-DAX حالت پیش‌فرض یک فضای نام هنگام اجرای \fIndctl create\-namespace\fP بدون هیچ گزینه‌ای است. این حالت یک دستگاه بلوکی (/dev/pmemX[.Y]) ایجاد می‌کند که از قابلیت‌های DAX در فایل‌سیستم‌های لینوکس (تاکنون xfs و ext4) پشتیبانی می‌کند. قابلیت DAX حافظه نهان صفحه (page cache) را از مسیر I/O حذف کرده و به mmap(2) اجازه می‌دهد نگاشت‌های مستقیمی به رسانه حافظه پایدار برقرار کند. قابلیت DAX به بارهای کاری / مجموعه‌های کاری (working\-sets) که فراتر از ظرفیت page cache هستند اجازه می‌دهد تا به اندازه ظرفیت حافظه پایدار مقیاس‌پذیر شوند. بارهای کاری که در page cache جا می‌شوند یا انتقال داده حجیم انجام می‌دهند ممکن است نفعی از DAX نبرند. در صورت تردید، این حالت را انتخاب کنید.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
devdax: حالت Device\-DAX قابلیت‌های نگاشت DAX مشابهی را از طریق mmap(2) مانند Filesystem\-DAX فراهم می‌کند. با این حال، به جای یک دستگاه بلوکی که بتواند از یک فایل‌سیستم دارای قابلیت DAX پشتیبانی کند، این حالت یک فایل دستگاه نویسه‌ای (character device) واحد به شکل (/dev/daxX.Y) ارائه می‌دهد. از این حالت برای اختصاص حافظه پایدار به یک ماشین مجازی، ثبت حافظه پایدار برای RDMA، یا در مواردی که نگاشت‌های بسیار عظیم نیاز است استفاده کنید.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
sector: از این حالت برای میزبانی فایل‌سیستم‌های قدیمی که فاقد چک‌سام فراداده هستند، یا برنامه‌هایی که پس از فروپاشی سیستم آمادگی مواجهه با سکتورهای ناقص (torn sectors) را ندارند، استفاده کنید. کاربرد مورد انتظار برای این حالت، درایوهای راه‌اندازی (boot volumes) کوچک است. این حالت با سیستم‌عامل‌های دیگر سازگار است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
raw: حالت خام (Raw) عملاً تنها یک دیسک حافظه‌ای است که از DAX پشتیبانی نمی‌کند. این حالت معمولاً نشان‌دهنده یک فضای نام است که توسط ابزارها یا سیستم‌عامل دیگری ایجاد شده که نحوه ساخت فضای نام لینوکسی در حالت \fIfsdax\fP یا \fIdevdax\fP را نمی‌دانسته است. این حالت با دیگر سیستم‌عامل‌ها سازگار است، اما بار دیگر تأکید می‌شود که از عملکرد DAX پشتیبانی نمی‌کند.
.RE
.SH "گزینه‌ها (OPTIONS)"
.sp
<namespace>
.RS 4
نام دستگاه \fInamespaceX.Y\fP. می‌توان از کلیدواژه \fIall\fP برای انجام عملیات روی تمام فضاهای نام موجود در سیستم استفاده کرد، که به صورت اختیاری بر اساس ناحیه فیلتر می‌شود (گزینه \-\-region= را ببینید).
.RE
.sp
\-r, \-\-region=
.RS 4
نام دستگاه \fIregionX\fP یا شماره شناسه (id) ناحیه. عملیات را به ناحیه(های) مشخص‌شده محدود می‌کند. کلیدواژه \fIall\fP می‌تواند برای نشان دادن عدم وجود هرگونه محدودیت مشخص شود، هرچند که این کار مشابه ارائه ندادن گزینه \-\-region= است.
.RE
.sp
\-b, \-\-bus=
.RS 4
شماره شناسه (id) گذرگاه، یا یک رشته ارائه‌دهنده (مانند "ACPI.NFIT"). عملیات را به گذرگاه(های) مشخص‌شده محدود می‌کند. کلیدواژه \fIall\fP می‌تواند برای نشان دادن عدم وجود هرگونه محدودیت مشخص شود، هرچند که این کار مشابه ارائه ندادن گزینه \-\-bus= است.
.RE
.sp
\-v, \-\-verbose
.RS 4
نمایش پیام‌های اشکال‌زدایی (debug) برای عملیات فضای نام.
.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
ndctl\-disable\-namespace(1)