نام (NAME)

nsm - کلاینت پایش همگام‌سازی شبکه (NetSync Monitor)

خلاصه دستور (SYNOPSIS)

nsm [ -f config ] [ -i interface ] [ long-options ] [ command ] ...

توضیحات (DESCRIPTION)

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

این برنامه دستورات را از ورودی استاندارد یا از خط فرمان می‌خواند.

دستورها (COMMANDS)

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

گزینه‌ها (OPTIONS)

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

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

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

--transportSpecific 1 --transportSpecific=1

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

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

فایل پیکربندی به چند بخش تقسیم می‌شود. هر بخش با خطی شامل نام آن بخش درون براکت‌ها آغاز می‌شود و در ادامه تنظیمات مربوطه می‌آیند. هر تنظیم در یک خط جداگانه قرار می‌گیرد و شامل نام گزینه و مقدار آن است که با نویسه‌های فاصله سفید از یکدیگر جدا شده‌اند. خطوط خالی و خطوطی که با # آغاز می‌شوند نادیده گرفته می‌شوند.

بخش سراسری (مشخص‌شده با [global]) هم گزینه‌های سراسری برنامه و هم گزینه‌های پیش‌فرض مربوط به درگاه‌ها را تنظیم می‌کند. سایر بخش‌ها به درگاه‌های خاص اختصاص دارند و گزینه‌های پیش‌فرض درگاه را بازنویسی می‌کنند. نام هر بخش برابر با نام درگاه پیکربندی‌شده است (برای نمونه [eth0]).

گزینه‌های درگاه (PORT OPTIONS)

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

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

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

هشدار (WARNING)

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

برای پیشگیری ایمن از این رفتارهای پیش‌بینی‌نشده، توصیه می‌شود از فایل‌های پیکربندی جداگانه برای ptp4l و nsm استفاده شود.

همچنین ببینید (SEE ALSO)

ptp4l(8)