'\" t
.\"     Title: ndctl-init-labels
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-30
.\"    Manual: ndctl Manual
.\"    Source: ndctl
.\"  Language: English
.\"
.TH "NDCTL\-INIT\-LABELS" "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-init-labels \- مقداردهی اولیه ناحیه داده‌های برچسب روی یک dimm یا مجموعه‌ای از dimmها
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIndctl init\-labels\fP <nmem0> [<nmem1>..<nmemN>] [<options>]
.fi
.br
.SH "توضیحات (DESCRIPTION)"
.sp
ناحیه برچسب فضای‌نام (namespace label area) یک افراز ماندگار و کوچک از ظرفیت موجود روی برخی دستگاه‌های NVDIMM است. این ناحیه برچسب برای تدارک دیدن یک یا چند فضای‌نام از ناحیه‌ها (regions) استفاده می‌شود.
از نسخه 4.10 به بعد، هسته (kernel) در صورتی برچسب‌ها را برای تقسیم‌بندی PMEM به رسمیت می‌شناسد که تمام DIMMهای موجود در یک مجموعه درهم‌تنیده (interleave set) یا ناحیه دارای یک بلوک نمایه فضای‌نام معتبر باشند.
.sp
این دستور می‌تواند برای مقداردهی اولیه بلوک نمایه فضای‌نام در صورت ناموجود بودن، یا مقداردهی مجدد آن در صورت آسیب‌دیدگی استفاده شود. توجه داشته باشید که مقداردهی مجدد عملاً تمامی برچسب‌های فضای‌نام موجود روی DIMM را از بین می‌برد.
.SH "مثال‌ها (EXAMPLES)"
.sp
یافتن DIMMهایی که یک ناحیه معین را تشکیل می‌دهند:
.sp
.if n .RS 4
.nf
.fam C
# ndctl list \-RD \-\-region=region1
{
  "dimms":[
    {
      "dev":"nmem0",
      "id":"8680\-56341200"
    }
  ],
  "regions":[
    {
      "dev":"region1",
      "size":268435456,
      "available_size":0,
      "type":"pmem",
      "mappings":[
        {
          "dimm":"nmem0",
          "offset":13958643712,
          "length":268435456
        }
      ]
    }
  ]
}
.fam
.fi
.if n .RE
.sp
غیرفعال کردن آن ناحیه تا ناحیه برچسب DIMM بتواند از فضای کاربری (userspace) نوشته شود:
.sp
.if n .RS 4
.nf
.fam C
# ndctl disable\-region region1
.fam
.fi
.if n .RE
.sp
مقداردهی اولیه برچسب‌ها:
.sp
.if n .RS 4
.nf
.fam C
# ndctl init\-labels nmem0
.fam
.fi
.if n .RE
.sp
فعال‌سازی مجدد ناحیه:
.sp
.if n .RS 4
.nf
.fam C
# ndctl enable\-region region1
.fam
.fi
.if n .RE
.sp
ایجاد یک فضای‌نام در آن ناحیه:
.sp
.if n .RS 4
.nf
.fam C
# ndctl create\-namespace \-\-region=region1
.fam
.fi
.if n .RE
.SH "گزینه‌ها (OPTIONS)"
.sp
<memory device(s)>
.RS 4
یک نام دستگاه \fInmemX\fP یا یک شماره شناسه dimm. عملیات را به dimm(های) مشخص‌شده محدود می‌کند. کلیدواژه \fIall\fP می‌تواند برای نشان دادن عدم وجود هرگونه محدودیت مشخص شود، هرچند این کار معادل عدم ارائه گزینه \-\-dimm است.
.RE
.sp
\-s, \-\-size=
.RS 4
محدود کردن عملیات به تعداد بایت‌های داده‌شده. اندازه 0 نشان‌دهنده اعمال عملیات بر روی تمام ظرفیت برچسب است.
.RE
.sp
\-O, \-\-offset=
.RS 4
شروع عملیات در افست داده‌شده درون ناحیه برچسب.
.RE
.sp
\-b, \-\-bus=
.RS 4
یک شماره شناسه گذرگاه (bus)، یا یک رشته ارائه‌دهنده (مانند "ACPI.NFIT"). عملیات را به گذرگاه(های) مشخص‌شده محدود می‌کند. کلیدواژه \fIall\fP می‌تواند برای نشان دادن عدم وجود هرگونه محدودیت مشخص شود، هرچند این کار معادل عدم ارائه گزینه \-\-bus است.
.RE
.sp
\-v
.RS 4
فعال‌سازی پیام‌های اشکال‌زدایی پرگو (verbose) در کتابخانه (در صورتی که ndctl همراه با پشتیبانی از لاگ‌گیری و اشکال‌زدایی کامپایل شده باشد).
.RE
.sp
\-f, \-\-force
.RS 4
اجبار در مقداردهی اولیه فضای برچسب حتی اگر به نظر برسد یک نمایه فضای‌نام معتبر/موجود وجود دارد. هشدار: این کار تمام فضاهای‌نام تعریف‌شده روی dimm را از بین خواهد برد.
.RE
.sp
\-V, \-\-label\-version
.RS 4
مقداردهی اولیه با نسخه‌ای خاص از برچسب‌ها طبق مشخصات برچسب فضای‌نام. پیش‌فرض 1.1 است.
.RE
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.sp
حق نشر \(co 2016 \- 2022، شرکت Intel Corporation. مجوز GPLv2: گنو GPL نسخه 2 \c
.URL "http://gnu.org/licenses/gpl.html" "" "."
این نرم‌افزار آزاد است:
شما مجاز به تغییر و بازتوزیع آن هستید. تا حد مجاز قانون، هیچ ضمانتی وجود ندارد.
.SH "همچنین ببینید (SEE ALSO)"
.sp
ndctl\-create\-namespace(1),
.URL "http://www.uefi.org/sites/default/files/resources/UEFI_Spec_2_7.pdf" "UEFI NVDIMM Label Protocol" ""