نام (NAME)

phc_ctl - کنترل مستقیم ساعت سخت‌افزاری دستگاه PTP

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

phc_ctl [ گزینه‌ها ] <دستگاه> [ دستورات ]

توضیحات (DESCRIPTION)

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

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

گزینه‌ها (OPTIONS)

-l print-level

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

-q

عدم ارسال پیام‌ها به syslog. به طور پیش‌فرض پیام‌ها ارسال خواهند شد.

-Q

عدم چاپ پیام‌ها در خروجی استاندارد. به طور پیش‌فرض پیام‌ها چاپ می‌شوند.

-h

نمایش پیام راهنما.

-v

چاپ نسخه نرم‌افزار و خروج.

دستورات (COMMANDS)

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

set seconds

تنظیم زمان ساعت PHC بر روی مقدار مشخص‌شده به ثانیه. در صورت ارائه نشدن مقدار، به طور پیش‌فرض زمان CLOCK_REALTIME خوانده می‌شود.

get

دریافت زمان کنونی دستگاه ساعت PHC.

adj seconds

تنظیم ساعت PHC به میزان ثانیه‌های ارائه‌شده. این آرگومان الزامی است.

freq ppb

تنظیم فرکانس ساعت PHC بر اساس بخش در میلیارد (ppb) مشخص‌شده. در صورت ارائه نشدن مقدار، تلاش می‌کند فرکانس فعلی را خوانده و گزارش دهد.

phase seconds

ارسال مقداری بر حسب ثانیه به کلیدواژه کنترل فاز ساعت PHC. این آرگومان الزامی است.

cmp

مقایسه دستگاه ساعت PHC با CLOCK_REALTIME با استفاده از بهترین روش موجود.

caps

نمایش قابلیت‌های دستگاه. این دستور پیش‌فرض در صورت وارد نکردن هیچ دستوری است.

wait seconds

متوقف کردن فرآیند برای مدت زمان مشخص‌شده و سپس بیدار شدن و ادامه کار. این دستور برای بررسی سلامت اولیه کارکرد مورد انتظار ساعت PHC مفید است.

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

مثال‌ها (EXAMPLES)

خواندن زمان فعلی ساعت از دستگاه:

تنظیم زمان ساعت PHC بر روی CLOCK_REALTIME:

تنظیم زمان ساعت PHC بر روی 0 (ثانیه‌های سپری‌شده از مبدا زمانی Epoch):

بررسی سریع سلامت تغییر فرکانس با افزایش ۱۰ درصدی فرکانس انحراف، بازنشانی ساعت به زمان 0.0، انتظار به مدت ۱۰ ثانیه، و سپس خواندن زمان. زمان بازخوانی‌شده باید (تقریباً) ۱۱ ثانیه باشد، زیرا ساعت ۱۰٪ سریع‌تر به جلو رانده شده است:

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

ptp4l(8) phc2sys(8)