'\" t
.\"     Title: ndctl-read-infoblock
.\"    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\-INFOBLOCK" "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-infoblock \- خواندن و واکشی بلوک اطلاعاتی فضای نام NVDIMM
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIndctl read\-infoblock\fP <namespace0.0> [<namespace1.0>..<namespaceN.Y>] [<options>]
.fi
.br
.SH "توضیحات (DESCRIPTION)"
.sp
همان‌طور که در بخش تئوری عملکرد
ndctl\-create\-namespace(1)
شرح داده شده است، ظرفیت خام یک فضای نام ممکن است یک ساختار هویتی یا حالت عملیاتی را در بر بگیرد. به‌طور مشخص، این حالت می‌تواند روی یکی از مقادیر
"sector" ،"fsdax"
یا
"devdax"
تنظیم شود. هر یک از این حالت‌ها با یک قالب بلوک اطلاعاتی (info\-block) تعریف می‌شوند که حالت عملیاتی را به‌طور منحصربه‌فرد مشخص می‌کند. دستور
read\-infoblock
محل قرارگیری (نسبت به ابتدای فضای نام) و تعریف فیلدهای این ساختارهای داده را می‌شناسد.
.sp
توجه داشته باشید که برخلاف جدول پارتیشن، بلوک اطلاعاتی به‌طور پیش‌فرض در دسترس قرار نمی‌گیرد، بنابراین پیش از دسترسی به بلوک اطلاعاتی، فضای نام باید غیرفعال شود.
.SH "مثال (EXAMPLE)"
.sp
.nf
ndctl disable\-namespace namespace0.0
disabled 1 namespace
ndctl read\-infoblock \-j namespace0.0
[
  {
    "dev":"namespace0.0",
    "signature":"NVDIMM_PFN_INFO",
    "uuid":"56b11990\-66b1\-4d91\-9cac\-ca084c051259",
    "parent_uuid":"00000000\-0000\-0000\-0000\-000000000000",
    "flags":0,
    "version":"1.3",
    "dataoff":69206016,
    "npfns":1031680,
    "mode":2,
    "start_pad":0,
    "end_trunc":0,
    "align":2097152
  }
]
.fi
.br
.SH "گزینه‌ها (OPTIONS)"
.sp
<namespace(s)>
.RS 4
یک یا چند نام دستگاه به‌صورت
\fInamespaceX.Y\fP.
می‌توان از کلیدواژه
\fIall\fP
برای اعمال عملیات روی تمام فضاهای نام موجود در سیستم استفاده کرد، که می‌توان آن‌ها را بر اساس شناسه گذرگاه (گزینه
\-\-bus=
را ببینید) یا شناسه ناحیه (گزینه
\-\-region=
را ببینید) فیلتر کرد.
.RE
.sp
\-V, \-\-verify
.RS 4
تلاش برای بررسی خودسازگاری و صحت بلوک اطلاعاتی با اعتبارسنجی جمع‌آزمایی (checksum) داخلی آن، و بررسی اینکه قالب‌های بلوک اطلاعاتی حاوی ویژگی
\fIparent\-uuid\fP
با
base\-uuid
فضای نام نیز مطابقت داشته باشند.
.RE
.sp
\-o, \-\-output
.RS 4
فایل خروجی.
.RE
.sp
\-j, \-\-json
.RS 4
تجزیه داده‌های بلوک اطلاعاتی در قالب json.
.RE
.sp
\-u, \-\-human
.RS 4
فعال‌سازی خروجی json و تبدیل قالب اعداد به رشته‌های خوانا برای انسان، برای مثال نمایش اندازه بر حسب "KB" ،"MB" ،"GB" و غیره به‌جای اعداد ۶۴\-بیتی علامت‌دار طبق قالب تبادل JSON (شامل
\-\-json
نیز می‌شود).
.RE
.sp
\-r, \-\-region=
.RS 4
نام دستگاه به‌صورت
\fIregionX\fP
یا شماره شناسه ناحیه. محدود کردن عملیات به ناحیه(های) مشخص‌شده. می‌توان از کلیدواژه
\fIall\fP
برای مشخص کردن عدم وجود هرگونه محدودیت استفاده کرد، هرچند این کار معادل مشخص نکردن گزینه
\-\-region
است.
.RE
.SH "حق نشر (COPYRIGHT)"
.sp
Copyright \(co 2016 \- 2022, Intel Corporation. License GPLv2: GNU GPL
version 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" ""