نام (NAME)

tz2alt - پایش تغییرات ساعت تابستانی و انتشار آن‌ها به پشته PTP.

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

ts2alt [ -hmqv ] [ -f conf ] [ -k key ] [ -p period ] [ -w window ] [ -z timezone ] [ long-options ] ...

توضیحات (DESCRIPTION)

برنامه tz2alt از پایگاه داده منطقه زمانی محلی برای پایش تغییرات ساعت تابستانی (daylight savings time) استفاده می‌کند و تغییرات معلق را به پشته PTP منتشر می‌نماید.

گزینه‌ها (OPTIONS)

-f config

خواندن پیکربندی از پرونده مشخص‌شده. به‌طور پیش‌فرض هیچ پرونده پیکربندی خوانده نمی‌شود.

-h

نمایش خلاصه راهنمای خط فرمان.

-l print-level

تعیین حداکثر سطح syslog برای پیام‌هایی که باید چاپ شده یا به ثبت‌کننده رویداد سیستم ارسال شوند. مقدار پیش‌فرض 6 (LOG_INFO) است.

-m

پیام‌های گزارش را در خروجی استاندارد چاپ می‌کند.

-q

از ارسال پیام‌های گزارش به ثبت‌کننده رویداد سیستم جلوگیری می‌کند.

-v

نسخه نرم‌افزار را چاپ کرده و خارج می‌شود.

گزینه‌های بلند (LONG OPTIONS)

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

مقادیر گزینه‌های ارائه‌شده در خط فرمان، مقادیر بخش سراسری (global) پرونده پیکربندی را بازنویسی (override) می‌کنند.

پرونده پیکربندی (CONFIGURATION FILE)

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

گزینه‌های سراسری (GLOBAL OPTIONS)

active_key_id

در ترکیب با دستورالعمل‌های spp و sa_file برای مشخص کردن این که کدام کلید از انجمن امنیتی (Security Association) تعریف‌شده توسط spp باید برای محاسبات icv خروجی استفاده شود، به کار می‌رود. تمام انجمن‌های امنیتی از پرونده مشخص‌شده توسط sa_file خوانده می‌شوند. به دستورالعمل‌های spp و sa_file نیاز دارد. باید در محدوده 1 تا 2^32-1 (شامل هر دو) باشد. مقدار پیش‌فرض 0 (غیرفعال) است.

domainNumber

ویژگی دامنه (domain attribute) ساعت محلی. مقدار پیش‌فرض 0 است.

leapfile

مسیر پرونده فعلی تعاریف ثانیه‌های کبیسه (leap seconds). در یک سیستم دبیان، این پرونده توسط بسته tzdata ارائه می‌شود و می‌توان آن را در مسیر /usr/share/zoneinfo/leap-seconds.list یافت. اگر leapfile پیکربندی شده باشد، در صورت تغییر مجدداً بارگذاری خواهد شد. مقدار پیش‌فرض یک رشته خالی است که باعث می‌شود برنامه از یک جدول کدنویسی‌شده ثابت (hard-coded) استفاده کند که ثانیه‌های کبیسه شناخته‌شده در تاریخ انتشار نرم‌افزار را منعکس می‌نماید.

logging_level

حداکثر سطح ثبت گزارش (logging level) پیام‌هایی که باید چاپ شوند. مقدار پیش‌فرض 6 (LOG_INFO) است.

message_tag

برچسبی که به تمام پیام‌های چاپ‌شده در خروجی استاندارد یا گزارش سیستم افزوده می‌شود. اگر برچسب حاوی رشته "{level}" باشد، با سطح گزارش پیام به عنوان یک عدد جایگزین خواهد شد. مقدار پیش‌فرض یک رشته خالی است (که نمی‌توان آن را در پرونده پیکربندی تنظیم کرد زیرا این گزینه به یک آرگومان نیاز دارد).

sa_file

محل پرونده حاوی انجمن‌های امنیتی (Security Associations) مورد استفاده برای پردازش امنیتی فوری Authentication TLV در پشتیبانی از سازوکار امنیتی اختیاری تعریف‌شده در ieee1588-2019 فصل 14.16 را مشخص می‌کند. برای اطلاعات بیشتر درباره محتویات پرونده به گزینه‌های انجمن امنیتی (SECURITY ASSOCIATION OPTIONS) مراجعه کنید. مقدار پیش‌فرض یک رشته خالی است (غیرفعال).

spp

اشاره‌گر پارامترهای امنیتی (security parameters pointer) را برای انجمن امنیتی مورد نظر جهت استفاده در پشتیبانی از authentication tlv مشخص می‌کند. در صورت تعیین، درگاهی که مالک spp است تلاش خواهد کرد تا authentication tlvها را برای تمام پیام‌ها مطابق با انجمن امنیتی مربوطه که از طریق دستورالعمل sa_file تأمین شده است، پیوست (خروجی) و بررسی (ورودی) نماید. با درگاه‌های تک‌مرحله‌ای (one step) سازگار نیست. باید در محدوده -1 تا 255 (شامل هر دو) باشد. مقدار پیش‌فرض -1 (غیرفعال) است.

transportSpecific

فیلد ویژه انتقال (transport specific). باید در محدوده 0 تا 255 باشد. مقدار پیش‌فرض 0 است.

use_syslog

در صورت فعال بودن، پیام‌ها را در گزارش سیستم (syslog) چاپ می‌کند. مقدار پیش‌فرض 1 (فعال) است.

verbose

در صورت فعال بودن، پیام‌ها را در خروجی استاندارد چاپ می‌کند. مقدار پیش‌فرض 0 (غیرفعال) است.

هشدار (WARNING)

هنگام به اشتراک گذاشتن یک پرونده پیکربندی یکسان میان ptp4l، phc2sys و tz2alt محتاط باشید. در نظر داشته باشید که مقادیر مشخص‌شده در پرونده پیکربندی بر مقادیر پیش‌فرض اولویت دارند. اگر گزینه‌ای که میان برنامه‌های دیگر مشترک است در پرونده پیکربندی تنظیم شود، آن مقدار برای تمام برنامه‌هایی که از آن پرونده استفاده می‌کنند اعمال خواهد شد، و این ممکن است همان رفتاری نباشد که انتظار می‌رود.

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

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

ptp4l(8)