NDCTL-READ-LABELS(1)             ndctl Manual             NDCTL-READ-LABELS(1)

نام (NAME)
       ndctl-read-labels - خواندن ناحیه برچسب (label area) روی یک dimm یا
       مجموعه‌ای از dimmها

خلاصه دستور (SYNOPSIS)
       ndctl read-labels <nmem0> [<nmem1>..<nmemN>] [<options>]

توضیحات (DESCRIPTION)
       ناحیه برچسب فضای نام (namespace label area) یک افراز ماندگار کوچک از
       ظرفیت موجود روی برخی از دستگاه‌های NVDIMM است. از ناحیه برچسب برای تدارک
       یک یا چند namespace از regionها استفاده می‌شود.  این دستور داده‌های
       باینری خام موجود در ناحیه برچسب یک dimm را به stdout یا یک فایل تخلیه
       (dump) می‌کند. در صورت وجود چند dimm، داده‌ها به یکدیگر الحاق می‌شوند.

گزینه‌ها (OPTIONS)
       <memory device(s)>
           نام یک دستگاه nmemX یا شماره شناسه dimm. عملیات را به dimm(های)
           مشخص‌شده محدود می‌کند. کلمه کلیدی all را می‌توان برای نشان دادن نبود
           هیچ‌گونه محدودیتی مشخص کرد، با این حال این کار مشابه تعیین نکردن
           گزینه --dimm است.

       -s, --size=
           محدود کردن عملیات به تعداد بایت‌های داده‌شده. اندازه 0 نشان‌دهنده
           انجام عملیات روی کل ظرفیت برچسب است.

       -O, --offset=
           شروع عملیات از آفست داده‌شده در ناحیه برچسب.

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

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

       -I, --index
           محدود کردن بازه عملیات برچسب به تنهایی به ناحیه index-block.  این
           گزینه برای تعیین اینکه آیا ناحیه برچسب dimm مقداردهی اولیه شده است
           یا خیر مفید است. توجه داشته باشید که این گزینه و --size/--offset
           مانعة‌الجمع هستند.

       -o, --output
           فایل خروجی

       -j, --json
           تجزیه داده‌های برچسب به json با فرض قالب NVDIMM Namespace
           Specification.

       -u, --human
           فعال کردن خروجی json و تبدیل قالب‌های عددی به رشته‌های خوانا برای
           انسان؛ به عنوان مثال نمایش اندازه بر حسب "KB" ،"MB" ،"GB" و غیره به
           جای اعداد ۶۴ بیتی علامت‌دار مطابق با قالب تبادل JSON (مستلزم --json
           است).

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

همچنین ببینید (SEE ALSO)
       UEFI NVDIMM Label Protocol
       <http://www.uefi.org/sites/default/files/resources/UEFI_Spec_2_7.pdf>

ndctl                             2026-06-30              NDCTL-READ-LABELS(1)