نام (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)

نام یک دستگاه 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