.TH PHC_CTL 8 "June 2014" "linuxptp"
.SH "نام (NAME)"
phc_ctl \- کنترل مستقیم ساعت سخت‌افزاری دستگاه PTP
.SH "خلاصه دستور (SYNOPSIS)"
.B phc_ctl
[ گزینه‌ها ] <دستگاه> [ دستورات ]

.SH "توضیحات (DESCRIPTION)"
.B phc_ctl
برنامه‌ای است که می‌تواند برای کنترل مستقیم یک دستگاه ساعت سخت‌افزاری PTP (موسوم به PHC) استفاده شود\&.
به طور معمول، این ابزار برای اهداف اشکال‌زدایی به کار می‌رود و کاربرد چندانی برای کنترل عمومی دستگاه ندارد\&. برای کنترل عمومی دستگاه‌های ساعت PHC، استفاده از
.B phc2sys (8)
توصیه می‌شود\&.

<دستگاه> می‌تواند CLOCK_REALTIME، هر دستگاه /dev/ptpX، یا هر دستگاه اترنت باشد که از فراخوانی get_ts_info در ابزار ethtool پشتیبانی می‌کند\&.

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

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

.B phc_ctl
با دریافت دستوراتی کنترل می‌شود که پارامترهای اختیاری یا اجباری می‌گیرند\&. این دستورات (که در زیر شرح داده شده‌اند) جنبه‌های مختلف دستگاه ساعت PHC را کنترل می‌کنند\&. این دستورات برای بازرسی یا اشکال‌زدایی درایور PHC مفید هستند، اما ممکن است عوارض جانبی نامطلوبی بر نمونه‌های در حال اجرای
.B ptp4l (8)
یا
.B phc2sys (8)
داشته باشند\&.

.TP
.BI set " seconds"
تنظیم زمان ساعت PHC بر روی مقدار مشخص‌شده به ثانیه\&. در صورت ارائه نشدن مقدار، به طور پیش‌فرض زمان CLOCK_REALTIME خوانده می‌شود\&.
.TP
.BI get
دریافت زمان کنونی دستگاه ساعت PHC\&.
.TP
.BI adj " seconds"
تنظیم ساعت PHC به میزان ثانیه‌های ارائه‌شده\&. این آرگومان الزامی است\&.
.TP
.BI freq " ppb"
تنظیم فرکانس ساعت PHC بر اساس بخش در میلیارد (ppb) مشخص‌شده\&. در صورت ارائه نشدن مقدار، تلاش می‌کند فرکانس فعلی را خوانده و گزارش دهد\&.
.TP
.BI phase " seconds"
ارسال مقداری بر حسب ثانیه به کلیدواژه کنترل فاز ساعت PHC\&. این آرگومان الزامی است\&.
.TP
.BI cmp
مقایسه دستگاه ساعت PHC با CLOCK_REALTIME با استفاده از بهترین روش موجود\&.
.TP
.BI caps
نمایش قابلیت‌های دستگاه\&. این دستور پیش‌فرض در صورت وارد نکردن هیچ دستوری است\&.
.TP
.BI wait " seconds"
متوقف کردن فرآیند برای مدت زمان مشخص‌شده و سپس بیدار شدن و ادامه کار\&. این دستور برای بررسی سلامت اولیه کارکرد مورد انتظار ساعت PHC مفید است\&.

آرگومان‌های مشخص‌شده بر حسب ثانیه به عنوان مقادیر اعشاری با دقت مضاعف خوانده می‌شوند و تا نانوثانیه مقیاس می‌یابند\&. این بدان معناست که ارائه مقدار 5.5 به معنی ۵ و نیم ثانیه است و امکان تعیین مقادیر بسیار دقیق برای زمان را فراهم می‌کند\&.

.SH "مثال‌ها (EXAMPLES)"

خواندن زمان فعلی ساعت از دستگاه:
.RS
\f(CWphc_ctl /dev/ptp0 get\fP
.RE

تنظیم زمان ساعت PHC بر روی CLOCK_REALTIME:
.RS
\f(CWphc_ctl /dev/ptp0 set\fP
.RE

تنظیم زمان ساعت PHC بر روی 0 (ثانیه‌های سپری‌شده از مبدا زمانی Epoch):
.RS
\f(CWphc_ctl /dev/ptp0 set 0.0\fP
.RE

بررسی سریع سلامت تغییر فرکانس با افزایش ۱۰ درصدی فرکانس انحراف، بازنشانی ساعت به زمان 0.0، انتظار به مدت ۱۰ ثانیه، و سپس خواندن زمان\&. زمان بازخوانی‌شده باید (تقریباً) ۱۱ ثانیه باشد، زیرا ساعت ۱۰٪ سریع‌تر به جلو رانده شده است:
.RS
\f(CWphc_ctl /dev/ptp0 freq 100000000 set 0.0 wait 10.0 get\fP
.RE

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