'\" t
.\"     Title: ndctl-monitor
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-30
.\"    Manual: ndctl Manual
.\"    Source: ndctl
.\"  Language: English
.\"
.TH "NDCTL\-MONITOR" "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-monitor \- پایش رویدادهای هوشمند (SMART) اشیاء nvdimm
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIndctl monitor\fP [<options>]
.fi
.br
.SH "توضیحات (DESCRIPTION)"
.sp
دستور ndctl monitor برای پایش رویدادهای SMART مربوط به اشیاء nvdimm و ارسال اعلان‌ها در قالب json به syslog، خروجی استاندارد یا یک فایل گزارش (logfile) استفاده می‌شود.
.sp
اشیاء مورد نظر برای پایش و رویدادهای SMART جهت اعلان را می‌توان با تنظیم گزینه‌ها و/یا پرونده‌های پیکربندی با پسوند .conf در مسیر /etc/ndctl.conf.d انتخاب کرد.
.sp
هر دو مقدار مشخص‌شده در فایل پیکربندی و گزینه‌ها اعمال خواهند شد. در صورت بروز تعارض، مقادیر گزینه‌های خط فرمان اولویت داشته و بر مقادیر فایل پیکربندی بازنویسی می‌شوند. هرگونه تغییر در مقادیر فایل پیکربندی تنها پس از راه‌اندازی مجدد فرایند پایشگر (monitor) اعمال خواهد شد.
.SH "مثال‌ها (EXAMPLES)"
.sp
اجرای پایشگر به‌صورت دیمون (daemon) برای پایش DIMMها روی گذرگاه «nfit_test.1»
.sp
.nf
ndctl monitor \-\-bus=nfit_test.1 \-\-daemon
.fi
.br
.sp
اجرای پایشگر به‌صورت یک دستور تک‌باره (one\-shot) و هدایت اعلان‌ها به /var/log/ndctl.log
.sp
.nf
ndctl monitor \-\-log=/var/log/ndctl.log
.fi
.br
.sp
اجرای دیمون پایشگر به‌عنوان یک سرویس سیستمی
.sp
.nf
systemctl start ndctl\-monitor.service
.fi
.br
.SH "گزینه‌ها (OPTIONS)"
.sp
\-b, \-\-bus=
.RS 4
شماره شناسه bus یا یک رشته ارائه‌دهنده (مانند "ACPI.NFIT"). عملیات را به bus (یا busهای) مشخص‌شده محدود می‌کند. کلمه کلیدی \fIall\fP می‌تواند برای مشخص کردن عدم وجود هرگونه محدودیت استفاده شود، هرچند این کار معادل عدم ارائه گزینه \-\-bus است.
.RE
.sp
\-d, \-\-dimm=
.RS 4
نام دستگاه \fInmemX\fP یا شماره شناسه dimm. عملیات را به dimm (یا dimmهای) مشخص‌شده محدود می‌کند. کلمه کلیدی \fIall\fP می‌تواند برای مشخص کردن عدم وجود هرگونه محدودیت استفاده شود، هرچند این کار معادل عدم ارائه گزینه \-\-dimm است.
.RE
.sp
\-r, \-\-region=
.RS 4
نام دستگاه \fIregionX\fP یا شماره شناسه region. عملیات را به region (یا regionهای) مشخص‌شده محدود می‌کند. کلمه کلیدی \fIall\fP می‌تواند برای مشخص کردن عدم وجود هرگونه محدودیت تعیین شود، هرچند این کار معادل عدم ارائه گزینه \-\-region است.
.RE
.sp
\-n, \-\-namespace=
.RS 4
نام دستگاه \fInamespaceX.Y\fP یا تاپل شناسه به همراه ناحیه فضای نام \fIX.Y\fP.
.RE
.sp
\-l, \-\-log=
.RS 4
ارسال پیام‌های گزارش به مقصد مشخص‌شده.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"<file>":
ارسال پیام‌های گزارش به پرونده <file> مشخص‌شده. چنانچه fopen() قادر به باز کردن <file> نباشد، پیام‌های گزارش به syslog ارسال خواهند شد.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"syslog":
ارسال پیام‌ها به syslog.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"standard":
ارسال پیام‌ها به خروجی استاندارد.
.RE
.RE
.sp
در صورت تعیین «\-\-daemon»، مقصد پیش‌فرض گزارش \fIsyslog\fP است، در غیر این صورت \fIstandard\fP خواهد بود. توجه داشته باشید که در صورت مشخص کردن «\-\-daemon»، مسیرهای نسبی برای <file> و حالت standard کار نخواهند کرد.
.sp
\-c, \-\-config\-file=
.RS 4
ارائه پرونده(های) پیکربندی برای استفاده. این گزینه تنظیمات پیش‌فرضی را که معمولاً در /etc/ndctl.conf.d یافت می‌شوند بازنویسی می‌کند.
.RE
.sp
\-\-daemon
.RS 4
اجرای پایشگر به‌صورت دیمون (سرویس پس‌زمینه).
.RE
.sp
\-D, \-\-dimm\-event=
.RS 4
نام یکی از رویدادهای سلامت SMART از موارد زیر:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"dimm\-spares\-remaining": مقدار بلوک‌های یدکی باقی‌مانده (Spare Blocks Remaining) از آستانهٔ از پیش برنامه‌ریزی‌شده کمتر شده است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"dimm\-media\-temperature": دمای رسانه NVDIMM از آستانهٔ از پیش برنامه‌ریزی‌شده فراتر رفته است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"dimm\-controller\-temperature": دمای کنترل‌کننده NVDIMM از آستانهٔ از پیش برنامه‌ریزی‌شده فراتر رفته است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"dimm\-health\-state": وضعیت سلامت عادی NVDIMM تغییر کرده است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"dimm\-unclean\-shutdown": وضعیت آخرین خاموش شدن NVDIMM یک خاموشی ناگهانی یا ناقص (unclean) بوده است.
.RE
.RE
.sp
پایشگر تلاش خواهد کرد بیت‌های کنترل هشدار را برای تمام رویدادهای مشخص‌شده فعال کند.
.sp
\-p, \-\-poll=
.RS 4
نظرسنجی (poll) و گزارش وضعیت/رویداد در هر <n> ثانیه.
.RE
.sp
\-u, \-\-human
.RS 4
چاپ اعلان پایشگر در قالب json خوانا برای انسان، به‌جای قالب پیش‌فرض بهینه‌شده برای ماشین.
.RE
.sp
\-v, \-\-verbose
.RS 4
ارسال پیام‌های اشکال‌زدایی اضافی به گزارش (log).
.RE
.SH "حق نشر (COPYRIGHT)"
.sp
حق نشر (c) 2018، شرکت FUJITSU LIMITED. مجوز GPLv2: گنو GPL نسخه ۲ \c
.URL "http://gnu.org/licenses/gpl.html" "" "."
این نرم‌افزار آزاد است: شما برای تغییر و بازتوزیع آن آزاد هستید. هیچ‌گونه ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.
.SH "همچنین ببینید (SEE ALSO)"
.sp
ndctl\-list(1), ndctl\-inject\-smart(1)