نام (NAME)

ndctl-init-labels - مقداردهی اولیه ناحیه داده‌های برچسب روی یک dimm یا مجموعه‌ای از dimmها

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

ndctl init-labels <nmem0> [<nmem1>..<nmemN>] [<options>]

توضیحات (DESCRIPTION)

ناحیه برچسب فضای‌نام (namespace label area) یک افراز ماندگار و کوچک از ظرفیت موجود روی برخی دستگاه‌های NVDIMM است. این ناحیه برچسب برای تدارک دیدن یک یا چند فضای‌نام از ناحیه‌ها (regions) استفاده می‌شود. از نسخه 4.10 به بعد، هسته (kernel) در صورتی برچسب‌ها را برای تقسیم‌بندی PMEM به رسمیت می‌شناسد که تمام DIMMهای موجود در یک مجموعه درهم‌تنیده (interleave set) یا ناحیه دارای یک بلوک نمایه فضای‌نام معتبر باشند.

این دستور می‌تواند برای مقداردهی اولیه بلوک نمایه فضای‌نام در صورت ناموجود بودن، یا مقداردهی مجدد آن در صورت آسیب‌دیدگی استفاده شود. توجه داشته باشید که مقداردهی مجدد عملاً تمامی برچسب‌های فضای‌نام موجود روی DIMM را از بین می‌برد.

مثال‌ها (EXAMPLES)

یافتن DIMMهایی که یک ناحیه معین را تشکیل می‌دهند:

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

غیرفعال کردن آن ناحیه تا ناحیه برچسب DIMM بتواند از فضای کاربری (userspace) نوشته شود:

# ndctl disable-region region1

مقداردهی اولیه برچسب‌ها:

# ndctl init-labels nmem0

فعال‌سازی مجدد ناحیه:

# ndctl enable-region region1

ایجاد یک فضای‌نام در آن ناحیه:

# ndctl create-namespace --region=region1

گزینه‌ها (OPTIONS)

یک نام دستگاه nmemX یا یک شماره شناسه dimm. عملیات را به dimm(های) مشخص‌شده محدود می‌کند. کلیدواژه all می‌تواند برای نشان دادن عدم وجود هرگونه محدودیت مشخص شود، هرچند این کار معادل عدم ارائه گزینه --dimm است.

-s, --size=

محدود کردن عملیات به تعداد بایت‌های داده‌شده. اندازه 0 نشان‌دهنده اعمال عملیات بر روی تمام ظرفیت برچسب است.

-O, --offset=

شروع عملیات در افست داده‌شده درون ناحیه برچسب.

-b, --bus=

یک شماره شناسه گذرگاه (bus)، یا یک رشته ارائه‌دهنده (مانند "ACPI.NFIT"). عملیات را به گذرگاه(های) مشخص‌شده محدود می‌کند. کلیدواژه all می‌تواند برای نشان دادن عدم وجود هرگونه محدودیت مشخص شود، هرچند این کار معادل عدم ارائه گزینه --bus است.

-v

فعال‌سازی پیام‌های اشکال‌زدایی پرگو (verbose) در کتابخانه (در صورتی که ndctl همراه با پشتیبانی از لاگ‌گیری و اشکال‌زدایی کامپایل شده باشد).

-f, --force

اجبار در مقداردهی اولیه فضای برچسب حتی اگر به نظر برسد یک نمایه فضای‌نام معتبر/موجود وجود دارد. هشدار: این کار تمام فضاهای‌نام تعریف‌شده روی dimm را از بین خواهد برد.

-V, --label-version

مقداردهی اولیه با نسخه‌ای خاص از برچسب‌ها طبق مشخصات برچسب فضای‌نام. پیش‌فرض 1.1 است.

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

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

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

ndctl-create-namespace(1), UEFI NVDIMM Label Protocol http://www.uefi.org/sites/default/files/resources/UEFI_Spec_2_7.pdf