'\" t
.\"     Title: ndctl-read-labels
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-30
.\"    Manual: ndctl Manual
.\"    Source: ndctl
.\"  Language: Persian
.\"
.TH "NDCTL\-READ\-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-read-labels \- خواندن ناحیه برچسب (label area) روی یک dimm یا مجموعه‌ای از dimmها
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIndctl read\-labels\fP <nmem0> [<nmem1>..<nmemN>] [<options>]
.fi
.br
.SH "توضیحات (DESCRIPTION)"
.sp
ناحیه برچسب فضای نام (namespace label area) یک افراز ماندگار کوچک از ظرفیت
موجود روی برخی از دستگاه‌های NVDIMM است. از ناحیه برچسب برای تدارک
یک یا چند namespace از regionها استفاده می‌شود.
این دستور داده‌های باینری خام موجود در ناحیه برچسب یک dimm را به stdout یا یک
فایل تخلیه (dump) می‌کند. در صورت وجود چند dimm، داده‌ها به یکدیگر الحاق می‌شوند.
.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"). عملیات را به
bus(های) مشخص‌شده محدود می‌کند. کلمه کلیدی \fIall\fP را می‌توان برای نشان دادن
نبود هیچ‌گونه محدودیتی مشخص کرد، با این حال این کار مشابه تعیین نکردن
گزینه \-\-bus است.
.RE
.sp
\-v
.RS 4
فعال کردن پیام‌های اشکال‌زدایی پرگو (verbose debug) در کتابخانه (در صورتی که ndctl با
قابلیت ثبت وقایع و اشکال‌زدایی ساخته شده باشد).
.RE
.sp
\-I, \-\-index
.RS 4
محدود کردن بازه عملیات برچسب به تنهایی به ناحیه index\-block.
این گزینه برای تعیین اینکه آیا ناحیه برچسب dimm مقداردهی اولیه شده است
یا خیر مفید است. توجه داشته باشید که این گزینه و \-\-size/\-\-offset
مانعة‌الجمع هستند.
.RE
.sp
\-o, \-\-output
.RS 4
فایل خروجی
.RE
.sp
\-j, \-\-json
.RS 4
تجزیه داده‌های برچسب به json با فرض قالب \fINVDIMM Namespace
Specification\fP.
.RE
.sp
\-u, \-\-human
.RS 4
فعال کردن خروجی json و تبدیل قالب‌های عددی به رشته‌های خوانا برای
انسان؛ به عنوان مثال نمایش اندازه بر حسب "KB" ،"MB" ،"GB" و غیره
به جای اعداد ۶۴ بیتی علامت‌دار مطابق با قالب تبادل JSON (مستلزم \-\-json است).
.RE
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.sp
Copyright \(co 2016 \- 2022, Intel Corporation. License GPLv2: GNU GPL
نسخه 2 \c
.URL "http://gnu.org/licenses/gpl.html" "" "."
این نرم‌افزار آزاد است:
شما مجاز به تغییر و توزیع مجدد آن هستید. هیچ‌گونه ضمانتی وجود ندارد، تا
حدی که قانون اجازه می‌دهد.
.SH "همچنین ببینید (SEE ALSO)"
.sp
.URL "http://www.uefi.org/sites/default/files/resources/UEFI_Spec_2_7.pdf" "UEFI NVDIMM Label Protocol" ""