'\" t
.\"     Title: ndctl-write-infoblock
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-30
.\"    Manual: ndctl Manual
.\"    Source: ndctl
.\"  Language: English
.\"
.TH "NDCTL\-WRITE\-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-write-infoblock \- تولید و نوشتن یک infoblock
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIndctl write\-infoblock\fP [<namespaceX.Y> | \-o <file> | \-\-stdout] [<options>]
.fi
.br
.SH "توضیحات (DESCRIPTION)"
.sp
همان‌طور که در بخش نحوه عملکرد ndctl\-create\-namespace(1) شرح داده شده است، گنجایش خام یک namespace می‌تواند دربرگیرنده یک هویت یا حالت عملکرد باشد. به طور مشخص، این حالت می‌تواند روی یکی از مقادیر \(lqsector\(rq، \(lqfsdax\(rq و \(lqdevdax\(rq تنظیم شود. هر یک از این حالت‌ها توسط ساختار یک info\-block که حالت عملکرد را به صورت منحصربه‌فردی مشخص می‌کند، تعریف می‌شوند. دستور write\-infoblock نحوه تولید یک info\-block از نوع \(lqfsdax\(rq یا \(lqdevdax\(rq را متناسب با اندازه تصویر (image size) مشخص‌شده می‌داند.
.sp
بلوک تولیدشده می‌تواند در یک namespace موجود نوشته شود (به شرطی که آن namespace در حال حاضر فعال نباشد)، در یک فایل نوشته شود یا به خروجی استاندارد (stdout) هدایت گردد.
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B هشدار
.ps -1
.br
.sp
این دستور یک امکان اشکال‌زدایی (debug) است که می‌تواند فایل‌های تصویری با infoblockهای معتبر، و همچنین infoblockهای نامعتبر را به منظور آزمایش هسته تولید کند. از گزینه‌های \-\-offset و \-\-align با احتیاط استفاده کنید. به ویژه اینکه \-\-offset باید دقیقاً با افست آدرس فیزیکی واقعی namespaceای که روی آن اعمال می‌شود مطابقت داشته باشد، و \-\-align باید یکی از اندازه‌های صفحه پشتیبانی‌شده در معماری باشد.
.sp .5v
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
.nf
ndctl write\-infoblock \-s 1T \-c | ndctl read\-infoblock \-j
wrote 1 infoblock
[
  {
    "file":"<stdin>",
    "signature":"NVDIMM_PFN_INFO",
    "uuid":"42e1d574\-76ac\-402c\-9132\-5436e31528c0",
    "parent_uuid":"ef83e49c\-4c4a\-4fae\-b908\-72e94675b1b7",
    "flags":0,
    "version":"1.4",
    "dataoff":17196646400,
    "npfns":264237056,
    "mode":2,
    "start_pad":0,
    "end_trunc":0,
    "align":16777216,
    "page_size":4096,
    "page_struct_size":64
  }
]
read 1 infoblock
.fi
.br
.SH "گزینه‌ها (OPTIONS)"
.sp
<namespace(s)>
.RS 4
یک یا چند نام دستگاه \fInamespaceX.Y\fP. کلیدواژه \fIall\fP می‌تواند برای اعمال روی تمام namespaceهای موجود در سیستم مشخص شود، و اختیاری است که بر اساس شناسه گذرگاه (گزینه \-\-bus= را ببینید) یا شناسه ناحیه (گزینه \-\-region= را ببینید) فیلتر شود.
.RE
.sp
\-c, \-\-stdout
.RS 4
نوشتن infoblock در خروجی استاندارد (stdout).
.RE
.sp
\-o, \-\-output=
.RS 4
نوشتن infoblock در فایل داده‌شده (مانعة‌الجمع با \-\-stdout).
.RE
.sp
\-m, \-\-mode=
.RS 4
انتخاب حالت infoblock میان \fIfsdax\fP و \fIdevdax\fP. برای جزئیات در مورد \-\-mode به ndctl\-create\-namespace(1) مراجعه کنید.
.RE
.sp
\-s, \-\-size=
.RS 4
بازنویسی اندازه پیش‌فرضی که از اندازه فایل داده‌شده به \-\-output تعیین می‌شود. در حالت \-\-stdout، مشخص کردن این گزینه الزامی است.
.RE
.sp
\-a, \-\-align=
.RS 4
مشخص کردن مقدار \(lqalign\(rq در infoblock. در حالت \-\-mode=devdax مقدار \(lqalign\(rq اندازه نگاشت صفحه را تعیین می‌کند. هیچ‌گونه اعتبارسنجی روی این مقدار نسبت به قابلیت‌های نگاشت صفحه در پلتفرم انجام نمی‌شود.
.RE
.sp
\-u, \-\-uuid=
.RS 4
جایگزینی مقدار پیش‌فرض UUID تولیدشده به صورت خودکار با مقدار داده‌شده.
.RE
.sp
\-M, \-\-map=
.RS 4
انتخاب اینکه آیا آرایه نگاشت صفحه از دستگاه تخصیص یابد یا از \(lqSystem RAM\(rq. پیش‌فرض، دستگاه است. برای جزئیات بیشتر به ndctl\-create\-namespace(1) مراجعه کنید.
.RE
.sp
\-p, \-\-parent\-uuid=
.RS 4
هنگامی که infoblock روی یک namespace برچسب‌دار (labelled) ذخیره می‌شود، UUID مربوط به namespace باید با صفت \(lqparent uuid\(rq در infoblock همخوانی داشته باشد. این گزینه در صورتی که از \-\-output و \-\-stdout استفاده نشود، به صورت پیش‌فرض برابر با UUID آن namespace خواهد بود؛ در غیر این صورت مقدار پیش‌فرض آن یک UUID تهی (NULL UUID، تمام صفرها) است.
.RE
.sp
\-O, \-\-offset=
.RS 4
به طور پیش‌فرض فرض بر این است که infoblock در یک namespace یا namespace\-image نوشته می‌شود که با اندازه خود هم‌تراز شده است. این گزینه تخصصی/اشکال‌زدایی (EXPERT/DEBUG) را برای آزمایش و ارزیابی نحوه مدیریت هسته در قبال namespaceهایی که این فرض را نقض می‌کنند، تعیین کنید.
.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" ""