.TH NSM 8 "March 2024" "linuxptp"
.SH "نام (NAME)"
nsm \- کلاینت پایش همگام‌سازی شبکه (NetSync Monitor)

.SH "خلاصه دستور (SYNOPSIS)"
.B nsm
[
.BI \-f " config"
] [
.BI \-i " interface"
] [
.I long-options
] [ command ] ...

.SH "توضیحات (DESCRIPTION)"
.B nsm
برنامه‌ای است که کلاینت NetSync Monitor (یا NSM) را پیاده‌سازی می‌کند. NSM افزونه‌ای برای پروتکل زمان دقیق (PTP) است که به کلاینت امکان می‌دهد اختلاف زمانی (offset) ساعت خود را در برابر هر ساعت PTP در شبکه که از NSM پشتیبانی می‌کند بسنجد. این ابزار از پیام‌های تک‌پخشی (unicast) استفاده می‌کند، اما بر خلاف PTP در حالت تک‌پخشی، نیازی ندارد که کارساز وضعیت خاصی از کلاینت را نگهداری کند. این قابلیت به‌ویژه برای نظارت و پایش کاربرد دارد.
.PP
این برنامه دستورات را از ورودی استاندارد یا از خط فرمان می‌خواند.

.SH "دستورها (COMMANDS)"

.TP
.BI NSM " address"
ارسال یک درخواست NetSync Monitor به نشانی شبکه مشخص‌شده (IPv4 یا MAC) و چاپ اختلاف زمانی سنجیده‌شده در پاسخ.
.TP
.B help
نمایش پیام راهنما.

.SH "گزینه‌ها (OPTIONS)"

.TP
.BI \-f " config"
خواندن پیکربندی از فایل مشخص‌شده. به‌طور پیش‌فرض هیچ فایل پیکربندی خوانده نمی‌شود.
.TP
.BI \-i " interface"
مشخص کردن رابط شبکه.
.TP
.B \-h
نمایش پیام راهنما.
.TP
.B \-v
چاپ نسخه نرم‌افزار و خروج.

.SH "گزینه‌های طولانی (LONG OPTIONS)"

تمام گزینه‌های فایل پیکربندی (بخش‌های
.B PORT OPTIONS
و
.B PROGRAM OPTIONS
در ادامه را ببینید) می‌توانند به عنوان آرگومان خط فرمان به سبک «طولانی» (long) نیز استفاده شوند. برای نمونه، گزینه
.B transportSpecific
را می‌توان با هر یک از این دو شکل تنظیم کرد:

.RS
\f(CW\-\-transportSpecific 1   \-\-transportSpecific=1\fP
.RE

مقادیر گزینه‌های ارائه‌شده در خط فرمان بر مقادیر بخش سراسری
.RB ( [global] )
در فایل پیکربندی اولویت دارند (که آن نیز به نوبه خود مقادیر پیش‌فرض را بازنویسی می‌کند).

.SH "فایل پیکربندی (CONFIGURATION FILE)"

فایل پیکربندی به چند بخش تقسیم می‌شود. هر بخش با خطی شامل نام آن بخش درون براکت‌ها آغاز می‌شود و در ادامه تنظیمات مربوطه می‌آیند. هر تنظیم در یک خط جداگانه قرار می‌گیرد و شامل نام گزینه و مقدار آن است که با نویسه‌های فاصله سفید از یکدیگر جدا شده‌اند. خطوط خالی و خطوطی که با # آغاز می‌شوند نادیده گرفته می‌شوند.
.PP
بخش سراسری (مشخص‌شده با
.BR [global] )
هم گزینه‌های سراسری برنامه و هم گزینه‌های پیش‌فرض مربوط به درگاه‌ها را تنظیم می‌کند. سایر بخش‌ها به درگاه‌های خاص اختصاص دارند و گزینه‌های پیش‌فرض درگاه را بازنویسی می‌کنند. نام هر بخش برابر با نام درگاه پیکربندی‌شده است (برای نمونه
.BR [eth0] ).

.SH "گزینه‌های درگاه (PORT OPTIONS)"
.TP
.B active_key_id
همراه با دستورالعمل‌های \fBspp\fR و \fBsa_file\fR برای تعیین این که کدام کلید از انجمن امنیتی (Security Association) تعریف‌شده توسط \fBspp\fR باید برای محاسبات icv خروجی استفاده شود، به کار می‌رود. تمام انجمن‌های امنیتی از فایل مشخص‌شده با \fBsa_file\fR خوانده می‌شوند. به دستورالعمل‌های \fBspp\fR و \fBsa_file\fR نیاز دارد. مقدار باید در محدوده ۱ تا 2^32\-1 (شامل هر دو) باشد. مقدار پیش‌فرض 0 (غیرفعال) است.
.TP
.B delayAsymmetry
تفاضل زمانی مسیرهای ارسال و دریافت بر حسب نانوثانیه. این مقدار هنگامی که زمان انتشار از اصلی به پیرو (master-to-slave) طولانی‌تر است باید مثبت، و هنگامی که زمان از پیرو به اصلی (slave-to-master) طولانی‌تر است باید منفی باشد. مقدار پیش‌فرض 0 نانوثانیه است.
.TP
.B network_transport
انتخاب بستر انتقال شبکه. مقادیر ممکن UDPv4 و L2 هستند. مقدار پیش‌فرض UDPv4 است.
.TP
.B spp
اشاره‌گر پارامترهای امنیتی (Security Parameters Pointer) مربوط به انجمن امنیتی مورد نظر را برای پشتیبانی از Authentication TLV در یک درگاه معین مشخص می‌کند. هر درگاهی با spp اختصاص‌یافته، Authentication TLV را به تمامی پیام‌های خروجی ضمیمه کرده و در تمام پیام‌های ورودی نیز مطابق با انجمن امنیتی مربوطه که از طریق دستورالعمل \fBsa_file\fR تعیین شده، وجود Authentication TLV را بررسی می‌کند. فیلدهای Authentication TLV خروجی با استفاده از کلید تعیین‌شده با \fBactive_key_id\fR تولید می‌شوند. با درگاه‌های تک‌گامی (one step) یا نسخه‌های اعلان‌شده کمتر از PTPv2.1 سازگار نیست. به دستورالعمل‌های \fBsa_file\fR و \fBactive_key_id\fR نیاز دارد. مقدار باید در محدوده 0 تا 255 (شامل هر دو) باشد. مقدار پیش‌فرض \-1 (غیرفعال) است.
.TP
.B transportSpecific
فیلد ویژه بستر انتقال. مقدار باید در محدوده 0 تا 255 باشد. مقدار پیش‌فرض 0 است.

.SH "گزینه‌های برنامه (PROGRAM OPTIONS)"

.TP
.B domainNumber
مشخصه دامنه (domain attribute) ساعت محلی. مقدار پیش‌فرض 0 است.
.TP
.B sa_file
مسیر فایل حاوی انجمن‌های امنیتی (Security Associations) را مشخص می‌کند که برای پردازش بلادرنگ امنیتی Authentication TLV در راستای پشتیبانی از سازوکار امنیتی اختیاری تعریف‌شده در استاندارد ieee1588-2019 بخش 14.16 استفاده می‌شود. برای اطلاعات بیشتر درباره نحوه قالب‌بندی این فایل، به بخش \fBSECURITY ASSOCIATION OPTIONS\fR در راهنمای ptp4l مراجعه کنید. گزینه‌های \fBspp\fR و \fBactive_key_id\fR باید برای هر درگاه مشخص شوند تا معلوم شود کدام انجمن امنیتی از \fBsa_file\fR باید استفاده گردد. مقدار پیش‌فرض یک رشته خالی است.
.TP
.B time_stamping
روش ثبت برچسب زمانی (time stamping). مقادیر مجاز عبارتند از hardware، software و legacy. مقدار پیش‌فرض hardware است.

.SH "هشدار (WARNING)"

هنگامی که از فایل پیکربندی یکسانی برای هر دو برنامه ptp4l و nsm استفاده می‌شود، احتیاط کنید. در نظر داشته باشید مقادیری که در فایل پیکربندی مشخص می‌شوند بر مقادیر پیش‌فرض آن‌ها اولویت دارند. اگر گزینه خاصی که بین ptp4l و nsm مشترک است در فایل پیکربندی با مقداری غیر از پیش‌فرض مشخص شود (برای نمونه برای ptp4l)، این مقدار غیرپیش‌فرض برای nsm نیز اعمال خواهد شد. این ممکن است رفتاری ناخواسته ایجاد کند.
.PP
برای پیشگیری ایمن از این رفتارهای پیش‌بینی‌نشده، توصیه می‌شود از فایل‌های پیکربندی جداگانه برای ptp4l و nsm استفاده شود.

.SH "همچنین ببینید (SEE ALSO)"
.BR ptp4l (8)