.TH TS2ALT 8 "March 2024" "linuxptp"
.SH "نام (NAME)"
tz2alt \- پایش تغییرات ساعت تابستانی و انتشار آن‌ها به پشته PTP.

.SH "خلاصه دستور (SYNOPSIS)"
.B ts2alt
[
.B \-hmqv
] [
.BI \-f " conf"
] [
.BI \-k " key"
] [
.BI \-p " period"
] [
.BI \-w " window"
] [
.BI \-z " timezone"
] [
.I long-options
]
.I .\|.\|.

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

.SH "گزینه‌ها (OPTIONS)"
.TP
.BI \-f " config"
خواندن پیکربندی از پرونده مشخص‌شده.
به‌طور پیش‌فرض هیچ پرونده پیکربندی خوانده نمی‌شود.
.TP
.BI \-h
نمایش خلاصه راهنمای خط فرمان.
.TP
.BI \-l " print-level"
تعیین حداکثر سطح syslog برای پیام‌هایی که باید چاپ شده یا به ثبت‌کننده رویداد سیستم ارسال شوند. مقدار پیش‌فرض 6 (LOG_INFO) است.
.TP
.B \-m
پیام‌های گزارش را در خروجی استاندارد چاپ می‌کند.
.TP
.B \-q
از ارسال پیام‌های گزارش به ثبت‌کننده رویداد سیستم جلوگیری می‌کند.
.TP
.B \-v
نسخه نرم‌افزار را چاپ کرده و خارج می‌شود.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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