.de1 NOP
.  it 1 an-trap
.  if \\n[.$] \,\\$*\/
..
.ie t \
.ds B-Font [CB]
.ds I-Font [CI]
.ds R-Font [CR]
.el \
.ds B-Font B
.ds I-Font I
.ds R-Font R
.TH ntptrace 1 "25 May 2024" "ntp (4.2.8p18)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
.\" It has been AutoGen-ed May 25, 2024 at 12:05:50 AM by AutoGen 5.18.16
.\" From the definitions ntptrace-opts.def
.\" and the template file agman-cmd.tpl
.SH "نام (NAME)"
ntptrace \- ردیابی سرورهای همتا (peers) در یک سرور NTP
.SH "خلاصه دستور (SYNOPSIS)"
\f\*[B-Font]ntptrace\fP
.\" Mixture of short (flag) options and long options
[\f\*[B-Font]\-flags\f[]]
[\f\*[B-Font]\-flag\f[] [\f\*[I-Font]value\f[]]]
[\f\*[B-Font]\-\-option-name\f[][[=| ]\f\*[I-Font]value\f[]]]
[host]
.sp \n(Ppu
.ne 2

.SH "توضیحات (DESCRIPTION)"
دستور
\fBntptrace\fP
یک اسکریپت پرل است که از ابزار ntpq برای دنبال کردن زنجیره سرورهای NTP از یک هاست مشخص تا منبع زمان اولیه استفاده می‌کند. برای کارکرد درست ntptrace، هر یک از این سرورها باید پروتکل کنترل و نظارت NTP مشخص‌شده در RFC 1305 را پیاده‌سازی کرده و بسته‌های حالت ۶ (Mode 6) پروتکل NTP را فعال کرده باشند.
.sp
اگر هیچ آرگومانی ارائه نشود، ntptrace با localhost آغاز می‌کند. در زیر نمونه‌ای از خروجی ntptrace آورده شده است:
.sp
.br
.in +4
.nf
% ntptrace localhost: stratum 4, offset 0.0019529, synch distance 0.144135
server2ozo.com: stratum 2, offset 0.0124263, synch distance 0.115784 usndh.edu:
stratum 1, offset 0.0019298, synch distance 0.011993, refid 'WWVB'
.in -4
.fi
.sp
در هر خط، فیلدها عبارتند از (از چپ به راست): نام هاست، لایه (stratum) هاست، اختلاف زمانی (time offset) بین آن هاست و هاست محلی (همان‌طور که توسط
\fBntptrace\fP
اندازه‌گیری شده است؛ به همین دلیل است که برای "localhost" همیشه صفر نیست)، فاصله همگام‌سازی (synchronization distance) هاست، و (تنها برای سرورهای stratum\-1) شناسه ساعت مرجع (reference clock ID). تمامی زمان‌ها بر حسب ثانیه داده شده‌اند. توجه داشته باشید که stratum تعداد جهش‌های سرور تا منبع اصلی است، ولی در عین حال synchronization distance میزان خطای تخمینی نسبت به منبع اصلی می‌باشد. این اصطلاحات به طور دقیق در RFC\-1305 تعریف شده‌اند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.NOP \f\*[B-Font]\-n\f[], \f\*[B-Font]\-\-numeric\f[]
چاپ آدرس‌های IP به جای نام‌های میزبان (hostnames).
.sp
نمایش خروجی میزبان‌ها در قالب عددی چهاربخشی با نقطه (dotted-quad) به جای تبدیل آنها به نام‌های میزبان رسمی.
.TP
.NOP \f\*[B-Font]\-m\f[] \f\*[I-Font]number\f[], \f\*[B-Font]\-\-max\-hosts\f[]=\f\*[I-Font]number\f[]
حداکثر تعداد سرورهای همتا برای ردیابی.
این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند.
مقدار پیش‌فرض
\f\*[I-Font]number\f[]
برای این گزینه برابر است با:
.ti +4
 99
.sp
این گزینه به طور کامل مستندسازی نشده است.
.TP
.NOP \f\*[B-Font]\-r\f[] \f\*[I-Font]string\f[], \f\*[B-Font]\-\-host\f[]=\f\*[I-Font]string\f[]
میزبان راه دور منفرد.
مقدار پیش‌فرض
\f\*[I-Font]string\f[]
برای این گزینه برابر است با:
.ti +4
 127.0.0.1
.sp
این گزینه به طور کامل مستندسازی نشده است.
.TP
.NOP \f\*[B-Font]\-\&?\f[], \f\*[B-Font]\-\-help\f[]
نمایش اطلاعات نحوه استفاده و خروج.
.TP
.NOP \f\*[B-Font]\-\&!\f[], \f\*[B-Font]\-\-more-help\f[]
ارسال اطلاعات مفصل نحوه استفاده به یک صفحه‌بند (pager).
.TP
.NOP \f\*[B-Font]\-v\f[] [{\f\*[I-Font]v|c|n\f[] \f\*[B-Font]\-\-version\f[] [{\f\*[I-Font]v|c|n\f[]}]}]
نمایش نسخه برنامه و خروج. حالت پیش‌فرض `v` است که نسخه ساده را نمایش می‌دهد. حالت `c` اطلاعات حق نشر و `n` کل اعلامیه حق نشر را چاپ می‌کند.
.PP
.SH "وضعیت خروج (EXIT STATUS)"
یکی از مقادیر خروج زیر بازگردانده می‌شود:
.TP
.NOP 0 " (EXIT_SUCCESS)"
اجرای موفقیت‌آمیز برنامه.
.TP
.NOP 1 " (EXIT_FAILURE)"
عملیات ناموفق بود یا ساختار دستور نامعتبر بود.
.TP
.NOP 70 " (EX_SOFTWARE)"
کتابخانه libopts با یک خطای عملیاتی داخلی مواجه شد. لطفاً آن را به autogen-users@lists.sourceforge.net گزارش دهید. با تشکر.
.PP
.SH "نکات (NOTES)"
این صفحه راهنما توسط \fIAutoGen\fP از روی تعاریف گزینه‌های \fBntptrace\fP تولید شده است.