.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 ntpdc 1 "25 May 2024" "4.2.8p18" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
.\" It has been AutoGen-ed May 25, 2024 at 12:04:19 AM by AutoGen 5.18.16
.\" From the definitions ntpdc-opts.def
.\" and the template file agman-cmd.tpl
.SH "نام (NAME)"
\f\*[B-Font]ntpdc\fP
\- برنامه کنترل اختصاصی NTPD
.SH "خلاصه دستور (SYNOPSIS)"
\f\*[B-Font]ntpdc\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)"
\f\*[B-Font]ntpdc\fP
منسوخ شده است.
لطفاً به جای آن از
\fCntpq\f[]\fR(1)\f[] استفاده کنید \- این ابزار می‌تواند تمام کارهایی را که
\f\*[B-Font]ntpdc\fP
انجام می‌داد انجام دهد، و این کار را با رابطی بسیار منطقی‌تر انجام می‌دهد.
.sp \n(Ppu
.ne 2

\f\*[B-Font]ntpdc\fP
یک برنامه سودمند است که برای پرس‌وجو از
\fCntpd\f[]\fR(1)\f[]
درباره وضعیت جاری آن و درخواست اعمال تغییرات در آن وضعیت به کار می‌رود.
این برنامه از قالب‌های پیام کنترلی NTP mode 7 که در کد منبع توصیف شده‌اند، استفاده می‌کند.
این برنامه می‌تواند در حالت تعاملی اجرا شود یا با استفاده از آرگومان‌های خط فرمان کنترل گردد.
اطلاعات گسترده وضعیت و آمار از طریق رابط
\f\*[B-Font]ntpdc\fP
در دسترس است.
علاوه بر این، تقریباً تمامی گزینه‌های پیکربندی که در زمان راه‌اندازی با فایل پیکربندی ntpd تعیین می‌شوند، می‌توانند در زمان اجرا نیز با استفاده از
\f\*[B-Font]ntpdc\fP
مشخص گردند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.NOP \f\*[B-Font]\-4\f[], \f\*[B-Font]\-\-ipv4\f[]
تحلیل اجباری نام‌های DNS با IPv4.
این گزینه نباید در ترکیب با هیچ‌یک از گزینه‌های زیر بیاید:
ipv6.
.sp
تحلیل DNS برای نام‌های میزبان بعدی در خط فرمان را به فضای نام IPv4 اجبار می‌کند.
.TP
.NOP \f\*[B-Font]\-6\f[], \f\*[B-Font]\-\-ipv6\f[]
تحلیل اجباری نام‌های DNS با IPv6.
این گزینه نباید در ترکیب با هیچ‌یک از گزینه‌های زیر بیاید:
ipv4.
.sp
تحلیل DNS برای نام‌های میزبان بعدی در خط فرمان را به فضای نام IPv6 اجبار می‌کند.
.TP
.NOP \f\*[B-Font]\-c\f[] \f\*[I-Font]cmd\f[], \f\*[B-Font]\-\-command\f[]=\f\*[I-Font]cmd\f[]
اجرای یک دستور و خروج.
این گزینه می‌تواند به تعداد نامحدود تکرار شود.
.sp
آرگومان بعدی به عنوان دستوری با قالب تعاملی تفسیر شده و به فهرست دستورهای قابل اجرا در میزبان(های) مشخص‌شده اضافه می‌شود.
.TP
.NOP \f\*[B-Font]\-d\f[], \f\*[B-Font]\-\-debug\-level\f[]
افزایش سطح پرگویی اشکال‌زدایی.
این گزینه می‌تواند به تعداد نامحدود تکرار شود.
.sp
.TP
.NOP \f\*[B-Font]\-D\f[] \f\*[I-Font]number\f[], \f\*[B-Font]\-\-set\-debug\-level\f[]=\f\*[I-Font]number\f[]
تنظیم سطح پرگویی اشکال‌زدایی.
این گزینه می‌تواند به تعداد نامحدود تکرار شود.
این گزینه یک عدد صحیح را به عنوان آرگومان خود دریافت می‌کند.
.sp
.TP
.NOP \f\*[B-Font]\-i\f[], \f\*[B-Font]\-\-interactive\f[]
اجبار ntpq به کارکرد در حالت تعاملی.
این گزینه نباید در ترکیب با هیچ‌یک از گزینه‌های زیر بیاید:
command، listpeers، peers، showpeers.
.sp
اجبار ntpq به کارکرد در حالت تعاملی. اعلان‌ها در خروجی استاندارد نوشته شده و دستورها از ورودی استاندارد خوانده می‌شوند.
.TP
.NOP \f\*[B-Font]\-l\f[], \f\*[B-Font]\-\-listpeers\f[]
چاپ فهرستی از همتایان.
این گزینه نباید در ترکیب با هیچ‌یک از گزینه‌های زیر بیاید:
command.
.sp
چاپ فهرستی از همتایان شناخته‌شده برای سرور به همراه خلاصه‌ای از وضعیت آن‌ها. این گزینه معادل دستور تعاملی 'listpeers' است.
.TP
.NOP \f\*[B-Font]\-n\f[], \f\*[B-Font]\-\-numeric\f[]
نشانی‌های عددی میزبان.
.sp
نمایش تمام نشانی‌های میزبان در قالب عددی چهاربخشی نقطه‌دار (dotted-quad) به جای تبدیل آن‌ها به نام‌های رسمی میزبان.
.TP
.NOP \f\*[B-Font]\-p\f[], \f\*[B-Font]\-\-peers\f[]
چاپ فهرستی از همتایان.
این گزینه نباید در ترکیب با هیچ‌یک از گزینه‌های زیر بیاید:
command.
.sp
چاپ فهرستی از همتایان شناخته‌شده برای سرور به همراه خلاصه‌ای از وضعیت آن‌ها. این گزینه معادل دستور تعاملی 'peers' است.
.TP
.NOP \f\*[B-Font]\-s\f[], \f\*[B-Font]\-\-showpeers\f[]
نمایش فهرستی از همتایان.
این گزینه نباید در ترکیب با هیچ‌یک از گزینه‌های زیر بیاید:
command.
.sp
چاپ فهرستی از همتایان شناخته‌شده برای سرور به همراه خلاصه‌ای از وضعیت آن‌ها. این گزینه معادل دستور تعاملی 'dmpeers' است.
.TP
.NOP \f\*[B-Font]\-u\f[], \f\*[B-Font]\-\-unconnected\f[]
استفاده از UDP متصل‌نشده (unconnected) برای ارتباط با ntpd (پیش‌فرض در Windows).
.sp
ایجاد یک ارتباط UDP متصل‌نشده با ntpd (پیش‌فرض در Windows).
.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]\->\f[] [\f\*[I-Font]cfgfile\f[]], \f\*[B-Font]\-\-save-opts\f[] [=\f\*[I-Font]cfgfile\f[]]
ذخیره وضعیت گزینه‌ها در \fIcfgfile\fP. مقدار پیش‌فرض، \fIآخرین\fP فایل پیکربندی فهرست‌شده در بخش \fBOPTION PRESETS\fP در ادامه است. این دستور پس از به‌روزرسانی فایل پیکربندی خارج خواهد شد.
.TP
.NOP \f\*[B-Font]\-<\f[] \f\*[I-Font]cfgfile\f[], \f\*[B-Font]\-\-load-opts\f[]=\f\*[I-Font]cfgfile\f[], \f\*[B-Font]\-\-no-load-opts\f[]
بارگذاری گزینه‌ها از \fIcfgfile\fP.
حالت \fIno-load-opts\fP بارگذاری فایل‌های config/rc/ini پیشین را غیرفعال می‌کند. گزینه \fI\-\-no-load-opts\fP زودهنگام و خارج از نوبت پردازش می‌شود.
.TP
.NOP \f\*[B-Font]\-\-version\f[] [{\f\*[I-Font]v|c|n\f[]}]
نمایش نسخه برنامه و خروج. حالت پیش‌فرض `v' (نسخه ساده) است. حالت `c' اطلاعات حق نشر و `n' متن کامل حق نشر را چاپ می‌کند.
.PP.SH "پیش‌تنظیم‌های گزینه (OPTION PRESETS)"
هر گزینه‌ای که به عنوان \fInot presettable\fP علامت‌گذاری نشده باشد، می‌تواند با بارگذاری مقادیر از فایل(های) پیکربندی («RC» یا «.INI») و مقادیر حاصل از متغیرهای محیطی زیر پیش‌تنظیم شود:
.nf
  \fBNTPDC_<option-name>\fP یا \fBNTPDC\fP
.fi
.ad
پیش‌تنظیم‌های متغیرهای محیطی بر فایل‌های پیکربندی اولویت دارند (دیرتر از آن‌ها پردازش می‌شوند).
فایل‌های \fIhomerc\fP عبارت‌اند از «\fI$HOME\fP» و «\fI.\fP».
اگر هر یک از این موارد دایرکتوری باشند، فایل \fI.ntprc\fP درون آن دایرکتوری‌ها جستجو می‌شود.
.SH "نحوه استفاده (USAGE)"
اگر هنگام اجرای
\f\*[B-Font]ntpdc\fP
یک یا چند گزینهٔ درخواست در خط فرمان گنجانده شود، هر یک از درخواست‌ها به سرورهای NTP در حال اجرا روی هر کدام از میزبان‌های ارائه‌شده به عنوان آرگومان‌های خط فرمان، یا در حالت پیش‌فرض به localhost ارسال خواهند شد.
اگر هیچ گزینهٔ درخواستی داده نشود،
\f\*[B-Font]ntpdc\fP
تلاش خواهد کرد تا دستورها را از ورودی استاندارد بخواند و آن‌ها را روی سرور NTP در حال اجرا بر روی نخستین میزبان مشخص‌شده در خط فرمان اجرا کند، که در صورت تعیین نشدن میزبان دیگری، مجدداً پیش‌فرض localhost خواهد بود.
ابزار
\f\*[B-Font]ntpdc\fP
در صورتی که ورودی استاندارد یک دستگاه ترمینال باشد، اعلان دریافت دستورها را نمایش می‌دهد.
.sp \n(Ppu
.ne 2

ابزار
\f\*[B-Font]ntpdc\fP
از بسته‌های حالت ۷ (mode 7) پروتکل NTP برای ارتباط با سرور NTP استفاده می‌کند و بنابراین می‌تواند برای پرس‌وجو از هر سرور سازگاری در شبکه که اجازهٔ این کار را بدهد مورد استفاده قرار گیرد.
توجه داشته باشید از آنجا که NTP یک پروتکل UDP است، این ارتباط تا حدی غیرقابل‌اعتماد خواهد بود، به‌ویژه در فواصل طولانی از نظر توپولوژی شبکه.
ابزار
\f\*[B-Font]ntpdc\fP
هیچ تلاشی برای ارسال مجدد درخواست‌ها نمی‌کند و در صورتی که پاسخی در مدت‌زمان مجاز (timeout) از میزبان راه دور دریافت نشود، زمان درخواست به پایان می‌رسد.
.sp \n(Ppu
.ne 2

عملکرد
\f\*[B-Font]ntpdc\fP
مختص پیاده‌سازی خاص دیمن
\fCntpd\f[]\fR(1)\f[]
است و انتظار می‌رود تنها با این نسخه و احتمالاً برخی از نسخه‌های قبلی این دیمن کار کند.
درخواست‌هایی از ابزار راه دور
\f\*[B-Font]ntpdc\fP
که بر وضعیت سرور محلی تأثیر می‌گذارند باید احراز هویت شوند، که این امر مستلزم آن است که برنامه راه دور و سرور محلی هر دو از یک کلید و شناسه کلید مشترک استفاده کنند.
.sp \n(Ppu
.ne 2

توجه داشته باشید در مواردی که نام میزبان مورد انتظار است، توصیف‌کنندهٔ
\f\*[B-Font]\-4\f[]
پیش از نام میزبان، تحلیل نام DNS را به فضای نام IPv4 محدود می‌کند، در حالی که توصیف‌کنندهٔ
\f\*[B-Font]\-6\f[]
تحلیل نام DNS را به فضای نام IPv6 وادار می‌سازد.
مشخص کردن گزینه‌ای در خط فرمان به غیر از
\f\*[B-Font]\-i\f[]
یا
\f\*[B-Font]\-n\f[]
باعث ارسال فوری پرس‌وجو(های) مشخص‌شده به میزبان(های) تعیین‌شده می‌شود.
در غیر این صورت،
\f\*[B-Font]ntpdc\fP
تلاش خواهد کرد تا دستورها را با قالب تعاملی از ورودی استاندارد بخواند..SS "دستورهای تعاملی (Interactive Commands)"
دستورهای قالب تعاملی از یک کلمه کلیدی تشکیل شده‌اند که در ادامه آن صفر
تا چهار آرگومان قرار می‌گیرد.
تنها تایپ کردن تعداد نویسه‌هایی از کلمه کلیدی کامل
که دستور را به طور یکتا مشخص کند، کافی است.
خروجی یک دستور به طور معمول به خروجی استاندارد فرستاده می‌شود،
اما به دلخواه می‌توان خروجی هر دستور را با افزودن یک
\[oq]\&>\[cq]
به همراه یک نام فایل به خط فرمان، به یک فایل ارسال کرد.
.sp \n(Ppu
.ne 2

تعدادی از دستورهای قالب تعاملی کاملاً درون خود ابزار
\f\*[B-Font]ntpdc\fP
اجرا می‌شوند و منجر به ارسال درخواست‌های NTP حالت ۷ (mode 7) به سرور
نمی‌گردند.
این دستورها در ادامه شرح داده شده‌اند.
.TP 7
.NOP \f\*[B-Font]\&?\f[] \f\*[I-Font]command_keyword\f[]
.TP 7
.NOP \f\*[B-Font]help\f[] \f\*[I-Font]command_keyword\f[]
یک
\[oq]\f\*[B-Font]\&?\f[]\[cq]
فهرستی از تمام کلمات کلیدی دستورهایی را که برای این نسخه از
\f\*[B-Font]ntpdc\fP
شناخته‌شده است، چاپ می‌کند.
یک
\[oq]\f\*[B-Font]\&?\f[]\[cq]
به همراه یک کلمه کلیدی دستور، اطلاعات مربوط به عملکرد و نحوه استفاده
از آن دستور را چاپ خواهد کرد.
این دستور احتمالاً منبع اطلاعاتی بهتری نسبت به این صفحه راهنما برای
\fCntpq\f[]\fR(1)\f[]
است.
.TP 7
.NOP \f\*[B-Font]delay\f[] \f\*[I-Font]milliseconds\f[]
یک بازه زمانی را برای افزوده شدن به برچسب‌های زمانی موجود در درخواست‌هایی که
نیاز به احراز هویت دارند، مشخص می‌کند.
این دستور برای فعال‌سازی پیکربندی مجدد (غیرقابل‌اطمینان) سرور در مسیرهای شبکه‌ای با
تأخیر زیاد، یا بین رایانه‌هایی با ساعت‌های ناهمگام به کار می‌رود.
در واقع، در حال حاضر سرور به برچسب زمانی در درخواست‌های احراز هویت‌شده نیازی ندارد،
بنابراین ممکن است این دستور منسوخ شده باشد.
.TP 7
.NOP \f\*[B-Font]host\f[] \f\*[I-Font]hostname\f[]
میزبانی را که پرس‌وجوهای بعدی به آن ارسال می‌شوند، تنظیم می‌کند.
Hostname می‌تواند یک نام میزبان یا یک آدرس عددی باشد.
.TP 7
.NOP \f\*[B-Font]hostnames\f[] [\f\*[B-Font]yes\f[] | \f\*[B-Font]no\f[]]
اگر
\f\*[B-Font]yes\f[]
مشخص شود، نام‌های میزبان در نمایش اطلاعات چاپ می‌شوند.
اگر
\f\*[B-Font]no\f[]
مشخص شود، در عوض آدرس‌های عددی چاپ خواهند شد.
پیش‌فرض
\f\*[B-Font]yes\f[]
است، مگر اینکه با استفاده از سوییچ
\f\*[B-Font]\-n\f[]
در خط فرمان تغییر یافته باشد.
.TP 7
.NOP \f\*[B-Font]keyid\f[] \f\*[I-Font]keyid\f[]
این دستور امکان تعیین شماره کلیدی را فراهم می‌کند که برای احراز هویت
درخواست‌های پیکربندی استفاده می‌شود.
این شماره باید با شماره کلیدی که سرور برای این منظور پیکربندی شده است،
مطابقت داشته باشد.
.TP 7
.NOP \f\*[B-Font]quit\f[]
خروج از
\f\*[B-Font]ntpdc\fP.
.TP 7
.NOP \f\*[B-Font]passwd\f[]
این دستور از شما می‌خواهد گذرواژه‌ای (که نویسه‌های آن نمایش داده نمی‌شود) را وارد کنید
که برای احراز هویت درخواست‌های پیکربندی استفاده خواهد شد.
اگر قرار است چنین درخواست‌هایی موفقیت‌آمیز باشند، این گذرواژه باید با کلید
پیکربندی‌شده در سرور NTP برای این منظور، مطابقت داشته باشد.
.TP 7
.NOP \f\*[B-Font]timeout\f[] \f\*[I-Font]milliseconds\f[]
یک دوره مهلت زمانی برای پاسخ‌ها به پرس‌وجوهای سرور مشخص می‌کند.
پیش‌فرض حدود ۸۰۰۰ میلی‌ثانیه است.
توجه داشته باشید که از آنجا که
\f\*[B-Font]ntpdc\fP
پس از اتمام مهلت زمانی، هر پرس‌وجو را یک بار دیگر تکرار می‌کند، کل زمان انتظار برای
اتمام مهلت، دو برابر مقدار تنظیم‌شده خواهد بود.
.PP.SS "دستورهای پیام کنترلی (Control Message Commands)"
دستورهای پرس‌وجو منجر به ارسال بسته‌های حالت ۷ پروتکل NTP حاوی درخواست‌های اطلاعات به کارساز می‌شوند.
این‌ها دستورهای فقط‌خواندنی هستند،
به این معنا که هیچ تغییری در وضعیت پیکربندی کارساز
ایجاد نمی‌کنند.
.TP 7
.NOP \f\*[B-Font]listpeers\f[]
فهرست خلاصه‌ای از همتایانی را که کارساز وضعیت آن‌ها را نگه می‌دارد
دریافت کرده و چاپ می‌کند.
این فهرست باید شامل تمام پیوندهای همتای پیکربندی‌شده
و همچنین همتایانی باشد که لایهٔ (stratum) آن‌ها به‌گونه‌ای است که توسط کارساز
به عنوان نامزدهای احتمالی همگام‌سازی آینده در نظر گرفته می‌شوند.
.TP 7
.NOP \f\*[B-Font]peers\f[]
فهرستی از همتایانی را که کارساز وضعیت آن‌ها را نگهداری می‌کند،
به همراه خلاصه‌ای از آن وضعیت به دست می‌آورد.
اطلاعات خلاصه شامل نشانی همتای دوردست، نشانی رابط محلی
(0.0.0.0 اگر نشانی محلی هنوز تعیین نشده باشد)، لایهٔ (stratum)
همتای دوردست (لایهٔ ۱۶ نشان‌دهندهٔ ناهمگام بودن همتای دوردست است)،
بازهٔ نظرسنجی بر حسب ثانیه، ثبات دسترسی‌پذیری در مبنای هشت،
و تاخیر، آفست و پراکندگی تخمینی فعلی همتا، همگی بر حسب ثانیه است.
.sp \n(Ppu
.ne 2

نویسهٔ موجود در حاشیهٔ سمت چپ نشان‌دهندهٔ حالتی است که این مدخل
همتا در آن کار می‌کند.
علامت
\[oq]\&+\[cq]
نشان‌دهندهٔ متقارن فعال (symmetric active)، علامت
\[oq]\&-\[cq]
نشان‌دهندهٔ متقارن غیرفعال (symmetric passive)، علامت
\[oq]\&=\[cq]
به این معنی است که کارساز دوردست در حالت کارخواه نظرسنجی می‌شود، علامت
\[oq]\&^\[cq]
نشان می‌دهد که کارساز به این نشانی همه‌پخشی (broadcast) می‌کند، علامت
\[oq]\&~\[cq]
نشان می‌دهد که همتای دوردست همه‌پخشی ارسال می‌کند و علامت
\[oq]\&*\[cq]
همتایی را مشخص می‌کند که کارساز در حال حاضر با آن
همگام‌سازی می‌شود.
.sp \n(Ppu
.ne 2

محتوای فیلد میزبان می‌تواند یکی از چهار حالت باشد.
این مقدار می‌تواند
یک نام میزبان، یک نشانی IP، نام پیاده‌سازی ساعت مرجع به همراه پارامتر آن یا
\fBREFCLK\f[]\fR()\f[]
باشد.
با تنظیم
\f\*[B-Font]hostnames\f[]
\f\*[B-Font]no\f[]
تنها نشانی‌های IP
نمایش داده خواهند شد.
.TP 7
.NOP \f\*[B-Font]dmpeers\f[]
فهرست خلاصهٔ همتایان با تفاوت جزئی.
خروجی این دستور همسان با دستور
\f\*[B-Font]peers\f[]
است، به جز نویسهٔ ستون سمت چپ.
نویسه‌ها تنها در کنار همتایانی ظاهر می‌شوند که
در مرحلهٔ نهایی الگوریتم انتخاب ساعت گنجانده شده‌اند.
علامت
\[oq]\&.\[cq]
نشان می‌دهد که این همتا در تشخیص ساعت‌های نادرست (falseticker) کنار گذاشته شده است، در حالی که
\[oq]\&+\[cq]
نشان می‌دهد که همتا مرحله را با موفقیت پشت سر گذاشته است.
علامت
\[oq]\&*\[cq]
همتایی را نشان می‌دهد که کارساز در حال حاضر
با آن همگام‌سازی می‌شود.
.TP 7
.NOP \f\*[B-Font]showpeer\f[] \f\*[I-Font]peer_address\f[] [\f\*[I-Font]...\f[]]
نمایشی با جزئیات از متغیرهای فعلی یک
یا چند همتا را نشان می‌دهد.
بیشتر این مقادیر در مشخصات NTP
نسخهٔ ۲ شرح داده شده‌اند.
.TP 7
.NOP \f\*[B-Font]pstats\f[] \f\*[I-Font]peer_address\f[] [\f\*[I-Font]...\f[]]
شمارنده‌های آماری به ازای هر همتا را برای همتا(های)
مشخص‌شده نمایش می‌دهد.
.TP 7
.NOP \f\*[B-Font]clockstat\f[] \f\*[I-Font]clock_peer_address\f[] [\f\*[I-Font]...\f[]]
اطلاعات مربوط به ساعت یک همتا را به دست آورده و چاپ می‌کند.
مقادیر به‌دست‌آمده اطلاعاتی دربارهٔ تنظیم عوامل تصحیح (fudge factors)
و سایر اطلاعات کارایی ساعت ارائه می‌دهند.
.TP 7
.NOP \f\*[B-Font]kerninfo\f[]
پارامترهای عملیاتی حلقهٔ قفل فاز هسته (kernel phase-lock loop) را دریافت و چاپ می‌کند.
این اطلاعات تنها در صورتی در دسترس است که هسته به‌طور ویژه
برای عملکرد زمان‌سنجی دقیق اصلاح شده باشد.
.TP 7
.NOP \f\*[B-Font]loopinfo\f[] [\f\*[B-Font]oneline\f[] | \f\*[B-Font]multiline\f[]]
مقادیر متغیرهای فیلتر حلقه (loop filter) انتخابی را چاپ می‌کند.
فیلتر حلقه بخشی از NTP است که وظیفهٔ تنظیم ساعت محلی
سیستم را بر عهده دارد.
مقدار
\[oq]offset\[cq]
آخرین آفست ارائه‌شده به فیلتر حلقه توسط کد پردازش بسته است.
مقدار
\[oq]frequency\[cq]
خطای بسامد ساعت محلی بر حسب بخش در میلیون (ppm) است.
متغیر
\[oq]time_const\[cq]
سختیِ حلقهٔ قفل فاز و در نتیجه سرعتی را که می‌تواند با رانش نوسان‌ساز (oscillator drift)
تطبیق یابد، کنترل می‌کند.
مقدار
\[oq]watchdog timer\[cq]
تعداد ثانیه‌هایی است که از زمان ارائهٔ آخرین نمونهٔ آفست
به فیلتر حلقه گذشته است.
گزینه‌های
\f\*[B-Font]oneline\f[]
و
\f\*[B-Font]multiline\f[]
قالبی را که این اطلاعات باید در آن چاپ شوند مشخص می‌کنند،
که حالت پیش‌فرض
\f\*[B-Font]multiline\f[]
است.
.TP 7
.NOP \f\*[B-Font]sysinfo\f[]
مجموعه‌ای از متغیرهای وضعیت سیستم، یعنی وضعیت مربوط
به کارساز محلی را چاپ می‌کند.
همهٔ خطوط به جز چهار خط آخر در مشخصات NTP نسخهٔ ۳، RFC-1305 شرح داده شده‌اند.
.sp \n(Ppu
.ne 2

بخش
\[oq]system flags\[cq]
پرچم‌های گوناگون سیستم را نشان می‌دهد که برخی
از آن‌ها می‌توانند به ترتیب توسط دستورهای پیکربندی
\f\*[B-Font]enable\f[]
و
\f\*[B-Font]disable\f[]
تنظیم و پاک شوند.
این‌ها پرچم‌های
\f\*[B-Font]auth\f[]،
\f\*[B-Font]bclient\f[]،
\f\*[B-Font]monitor\f[]،
\f\*[B-Font]pll\f[]،
\f\*[B-Font]pps\f[]
و
\f\*[B-Font]stats\f[]
هستند.
برای معنای این پرچم‌ها به مستندات
\fCntpd\f[]\fR(1)\f[]
مراجعه کنید.
دو پرچم دیگر نیز وجود دارند که فقط‌خواندنی هستند:
\f\*[B-Font]kernel_pll\f[]
و
\f\*[B-Font]kernel_pps\f[].
این پرچم‌ها وضعیت همگام‌سازی را در هنگام استفاده از اصلاحات
زمان دقیق هسته نشان می‌دهند.
عبارت
\[oq]kernel_pll\[cq]
نشان می‌دهد که
ساعت محلی توسط هسته تنظیم می‌شود، در حالی که
\[oq]kernel_pps\[cq]
نشان می‌دهد تنظیم هسته توسط سیگنال PPS
فراهم شده است..sp \n(Ppu
.ne 2

مقدار
\[oq]stability\[cq]
خطای بسامد (فرکانس) باقی‌مانده پس از اعمال تصحیح بسامد سیستم است و برای
نگهداری و اشکال‌زدایی در نظر گرفته شده است.
در بیشتر معماری‌ها، این مقدار در ابتدا از مقداری به بزرگی ۵۰۰ ppm به مقداری
اسمی در محدوده ۰٫۰۱ تا ۰٫۱ ppm کاهش می‌یابد.
اگر پس از راه‌اندازی دیمن برای مدتی بالا باقی بماند، ممکن است مشکلی در
ساعت محلی وجود داشته باشد یا مقدار متغیر هسته
\fIkern.clockrate.tick\f[]
نادرست باشد.
.sp \n(Ppu
.ne 2

مقدار
\[oq]broadcastdelay\[cq]
تاخیر پخش همگانی (broadcast) پیش‌فرض را نشان می‌دهد، همان‌گونه که توسط دستور پیکربندی
\f\*[B-Font]broadcastdelay\f[]
تنظیم شده است.
.sp \n(Ppu
.ne 2

مقدار
\[oq]authdelay\[cq]
تاخیر احراز هویت پیش‌فرض را نشان می‌دهد، همان‌گونه که توسط دستور پیکربندی
\f\*[B-Font]authdelay\f[]
تنظیم شده است.
.TP 7
.NOP \f\*[B-Font]sysstats\f[]
چاپ شمارنده‌های آماری نگهداری‌شده در ماژول پروتکل.
.TP 7
.NOP \f\*[B-Font]memstats\f[]
چاپ شمارنده‌های آماری مربوط به کد تخصیص حافظه.
.TP 7
.NOP \f\*[B-Font]iostats\f[]
چاپ شمارنده‌های آماری نگهداری‌شده در ماژول ورودی/خروجی.
.TP 7
.NOP \f\*[B-Font]timerstats\f[]
چاپ شمارنده‌های آماری نگهداری‌شده در کد پشتیبانی از تایمر/صف رویدادها.
.TP 7
.NOP \f\*[B-Font]reslist\f[]
دریافت و چاپ فهرست محدودیت‌های سرور.
این فهرست (معمولاً) به‌صورت مرتب‌شده چاپ می‌شود و ممکن است به درک
نحوه اعمال محدودیت‌ها کمک کند.
.TP 7
.NOP \f\*[B-Font]monlist\f[] [\f\*[I-Font]version\f[]]
دریافت و چاپ آمار ترافیک جمع‌آوری‌شده و نگهداری‌شده توسط سازوکار پایش (monitor).
به طور معمول نیازی به مشخص کردن شماره نسخه نیست.
.TP 7
.NOP \f\*[B-Font]clkbug\f[] \f\*[I-Font]clock_peer_address\f[] [\f\*[I-Font]...\f[]]
دریافت اطلاعات اشکال‌زدایی برای یک راه‌انداز ساعت مرجع (reference clock).
این اطلاعات تنها توسط برخی از راه‌اندازهای ساعت ارائه می‌شود و در بیشتر
موارد بدون در دست داشتن نسخه‌ای از کد منبع راه‌انداز، غیرقابل رمزگشایی است.
.PP
.SS "درخواست‌های پیکربندی زمان اجرا (Runtime Configuration Requests)"
تمامی درخواست‌هایی که باعث تغییر وضعیت در سرور می‌شوند، توسط سرور و با استفاده
از یک کلید NTP پیکربندی‌شده احراز هویت می‌گردند (این امکان نیز وجود دارد که
سرور با پیکربندی نکردن کلید، این سازوکار را غیرفعال کند).
شماره کلید و کلید مربوطه باید به
\f\*[B-Font]ntpdc\fP
نیز معرفی شوند.
این کار را می‌توان با استفاده از دستورهای
\f\*[B-Font]keyid\f[]
و
\f\*[B-Font]passwd\f[]
انجام داد؛ دستور دوم در ترمینال، گذرواژه‌ای را برای استفاده به عنوان کلید
رمزنگاری درخواست می‌کند.
همچنین نخستین باری که دستوری صادر شود که منجر به ارسال یک درخواست احراز
هویت‌شده به سرور گردد، شماره کلید و گذرواژه به طور خودکار از شما پرسیده خواهد شد.
احراز هویت نه‌تنها تایید می‌کند که درخواست‌کننده اجازه ایجاد چنین تغییراتی
را دارد، بلکه سطح بالاتری از حفاظت را در برابر خطاهای انتقال فراهم می‌آورد.
.sp \n(Ppu
.ne 2

درخواست‌های احراز هویت‌شده همیشه شامل یک برچسب زمانی در داده‌های بسته هستند
که در محاسبه کد احراز هویت گنجانده می‌شود.
این برچسب زمانی توسط سرور با برچسب زمان دریافت خود مقایسه می‌شود.
اگر تفاوت آن‌ها بیش از یک مقدار ناچیز باشد، درخواست رد می‌شود.
این کار به دو دلیل انجام می‌گیرد.
نخست، حملات بازپخش (replay attacks) ساده به سرور توسط کسانی که ممکن است قادر
به استراق سمع ترافیک در شبکه محلی (LAN) شما باشند را بسیار دشوارتر می‌سازد.
دوم، درخواست تغییرات پیکربندی در سرور شما را از سوی میزبان‌های دوردست از نظر
توپولوژی سخت‌تر می‌کند.
اگرچه سازوکار پیکربندی مجدد با سرور روی میزبان محلی به خوبی کار می‌کند و
ممکن است بین میزبان‌های همگام‌سازی‌شده از نظر زمانی روی همان شبکه محلی به اندازه
کافی خوب کار کند، اما برای میزبان‌های دورتر بسیار ضعیف عمل خواهد کرد.
به این ترتیب، اگر گذرواژه‌های منطقی انتخاب شوند، در توزیع و حفاظت از کلیدها
دقت شود و محدودیت‌های مناسبی بر آدرس مبدا اعمال گردد، سازوکار پیکربندی
مجدد در زمان اجرا باید سطح امنیت مناسبی را فراهم کند.
.sp \n(Ppu
.ne 2

دستورهای زیر همگی درخواست‌های احراز هویت‌شده ایجاد می‌کنند.
.TP 7
.NOP \f\*[B-Font]addpeer\f[] \f\*[I-Font]peer_address\f[] [\f\*[I-Font]keyid\f[]] [\f\*[I-Font]version\f[]] [\f\*[B-Font]prefer\f[]]
افزودن یک اتصال همتای پیکربندی‌شده در آدرس ارائه‌شده که در حالت فعال متقارن
(symmetric active) کار می‌کند.
توجه داشته باشید که ممکن است با اجرای این دستور، یک اتصال موجود با همان
همتا حذف شود، یا در صورت لزوم صرفاً برای انطباق با پیکربندی جدید تبدیل گردد.
اگر آرگومان اختیاری
\f\*[I-Font]keyid\f[]
یک عدد صحیح غیر صفر باشد، تمام بسته‌های خروجی به سمت سرور دوردست یک فیلد
احراز هویت متصل خواهند داشت که با این کلید رمزنگاری شده است.
اگر مقدار 0 باشد (یا داده نشود)، هیچ احراز هویتی انجام نخواهد شد.
پارامتر
\f\*[I-Font]version\f[]
می‌تواند 1، 2 یا 3 باشد و مقدار پیش‌فرض آن 3 است.
کلمه کلیدی
\f\*[B-Font]prefer\f[]
نشان‌دهنده یک همتای ترجیحی است (و بنابراین در صورت امکان، در درجه اول برای
همگام‌سازی ساعت استفاده خواهد شد).
همتای ترجیحی همچنین اعتبار سیگنال PPS را تعیین می‌کند \- اگر همتای ترجیحی
برای همگام‌سازی مناسب باشد، سیگنال PPS نیز معتبر تلقی می‌شود.
.TP 7
.NOP \f\*[B-Font]addserver\f[] \f\*[I-Font]peer_address\f[] [\f\*[I-Font]keyid\f[]] [\f\*[I-Font]version\f[]] [\f\*[B-Font]prefer\f[]]
کاملاً مشابه دستور addpeer است، به جز اینکه حالت عملیاتی آن کلاینت (client) است.
.TP 7
.NOP \f\*[B-Font]broadcast\f[] \f\*[I-Font]peer_address\f[] [\f\*[I-Font]keyid\f[]] [\f\*[I-Font]version\f[]] [\f\*[B-Font]prefer\f[]]
کاملاً مشابه دستور addpeer است، به جز اینکه حالت عملیاتی آن پخش همگانی (broadcast) است.
در این حالت، یک شناسه کلید و کلید معتبر الزامی است.
پارامتر
\f\*[I-Font]peer_address\f[]
می‌تواند آدرس برودکست شبکه محلی یا یک آدرس گروه چندپخشی (multicast)
اختصاص‌یافته به NTP باشد.
در صورت استفاده از آدرس چندپخشی، وجود یک هسته با قابلیت پشتیبانی از مالتی‌کست
الزامی است.
.TP 7
.NOP \f\*[B-Font]unconfig\f[] \f\*[I-Font]peer_address\f[] [\f\*[I-Font]...\f[]]
این دستور باعث می‌شود بیت پیکربندی‌شده (configured bit) از همتا(های)
مشخص‌شده حذف شود.
در بیشتر موارد، این امر منجر به حذف اتصال همتا خواهد شد.
با این حال، در صورت لزوم، چنانچه همتای دوردست تمایل به ادامه ارتباط به این
شکل داشته باشد، ممکن است اتصال در حالت پیکربندی‌نشده باقی بماند.
.TP 7
.NOP \f\*[B-Font]fudge\f[] \f\*[I-Font]peer_address\f[] [\f\*[B-Font]time1\f[]] [\f\*[B-Font]time2\f[]] [\f\*[I-Font]stratum\f[]] [\f\*[I-Font]refid\f[]]
این دستور روشی را برای تنظیم برخی داده‌ها برای ساعت مرجع فراهم می‌کند.
برای اطلاعات بیشتر، کد منبع برنامه را مشاهده کنید.
.TP 7
.NOP \f\*[B-Font]enable\f[] [\f\*[B-Font]auth\f[] | \f\*[B-Font]bclient\f[] | \f\*[B-Font]calibrate\f[] | \f\*[B-Font]kernel\f[] | \f\*[B-Font]monitor\f[] | \f\*[B-Font]ntp\f[] | \f\*[B-Font]pps\f[] | \f\*[B-Font]stats\f[]].TP 7
.NOP \f\*[B-Font]disable\f[] [\f\*[B-Font]auth\f[] | \f\*[B-Font]bclient\f[] | \f\*[B-Font]calibrate\f[] | \f\*[B-Font]kernel\f[] | \f\*[B-Font]monitor\f[] | \f\*[B-Font]ntp\f[] | \f\*[B-Font]pps\f[] | \f\*[B-Font]stats\f[]]
این دستورها همانند دستورهای
\f\*[B-Font]enable\f[]
و
\f\*[B-Font]disable\f[]
در فایل پیکربندی
\fCntpd\f[]\fR(1)\f[]
عمل می‌کنند.
.RS
.TP 7
.NOP \f\*[B-Font]auth\f[]
به سرور امکان می‌دهد تنها در صورتی با همتایان پیکربندی‌نشده همگام‌سازی شود
که همتا با استفاده از رمزنگاری کلید عمومی یا کلید خصوصی
به‌درستی احراز هویت شده باشد.
پیش‌فرض این پرچم enable است.
.TP 7
.NOP \f\*[B-Font]bclient\f[]
به سرور امکان می‌دهد برای دریافت پیام از یک سرور برودکست (broadcast) یا چندپخشی (multicast)،
همانند دستور multicastclient با آدرس پیش‌فرض، شنود کند.
پیش‌فرض این پرچم disable است.
.TP 7
.NOP \f\*[B-Font]calibrate\f[]
ویژگی واسنجی (calibrate) را برای ساعت‌های مرجع فعال می‌کند.
پیش‌فرض این پرچم disable است.
.TP 7
.NOP \f\*[B-Font]kernel\f[]
سامان‌دهی زمان در هسته (kernel time discipline) را در صورت در دسترس بودن فعال می‌کند.
پیش‌فرض این پرچم در صورت وجود پشتیبانی enable و در غیر این صورت disable است.
.TP 7
.NOP \f\*[B-Font]monitor\f[]
امکان نظارت را فعال می‌کند.
برای اطلاعات بیشتر مستندات مربوط به دستور
\f\*[B-Font]monlist\f[]
را در اینجا ببینید.
پیش‌فرض این پرچم enable است.
.TP 7
.NOP \f\*[B-Font]ntp\f[]
سامان‌دهی زمان و بسامد را فعال می‌کند.
در عمل، این کلید حلقهٔ بازخورد را باز و بسته می‌کند
که برای آزمودن سودمند است.
پیش‌فرض این پرچم enable است.
.TP 7
.NOP \f\*[B-Font]pps\f[]
سیگنال پالس در ثانیه (PPS) را هنگامی که زمان
و بسامد توسط اصلاحات زمان دقیق در هسته سامان‌دهی می‌شوند فعال می‌کند.
برای اطلاعات بیشتر، صفحهٔ
\(lqA Kernel Model for Precision Timekeeping\(rq
(موجود به عنوان بخشی از مستندات HTML ارائه‌شده در
\fI/usr/share/doc/ntp\f[])
را ببینید.
پیش‌فرض این پرچم disable است.
.TP 7
.NOP \f\*[B-Font]stats\f[]
امکان جمع‌آوری آمار را فعال می‌کند.
برای اطلاعات بیشتر بخش
\fIMonitoring\f[] \fIOptions\f[]
از
\fCntp.conf\f[]\fR(5)\f[]
را ببینید.
پیش‌فرض این پرچم disable است.
.RE
.TP 7
.NOP \f\*[B-Font]restrict\f[] \f\*[I-Font]address\f[] \f\*[I-Font]mask\f[] \f\*[I-Font]flag\f[] [\f\*[I-Font]...\f[]]
این دستور همانند دستورهای فایل پیکربندی
\f\*[B-Font]restrict\f[]
در
\fCntpd\f[]\fR(1)\f[]
عمل می‌کند.
.TP 7
.NOP \f\*[B-Font]unrestrict\f[] \f\*[I-Font]address\f[] \f\*[I-Font]mask\f[] \f\*[I-Font]flag\f[] [\f\*[I-Font]...\f[]]
محدودیت‌های مدخل منطبق را از فهرست restrict برمی‌دارد.
.TP 7
.NOP \f\*[B-Font]delrestrict\f[] \f\*[I-Font]address\f[] \f\*[I-Font]mask\f[] [\f\*[B-Font]ntpport\f[]]
مدخل منطبق را از فهرست restrict حذف می‌کند.
.TP 7
.NOP \f\*[B-Font]readkeys\f[]
باعث پاکسازی مجموعهٔ فعلی کلیدهای احراز هویت و
دریافت یک مجموعهٔ جدید از طریق بازخوانی فایل کلیدها می‌شود (که باید
در فایل پیکربندی
\fCntpd\f[]\fR(1)\f[]
مشخص شده باشد).
این کار
امکان تغییر کلیدهای رمزنگاری را بدون راه‌اندازی مجدد سرور فراهم می‌کند.
.TP 7
.NOP \f\*[B-Font]trustedkey\f[] \f\*[I-Font]keyid\f[] [\f\*[I-Font]...\f[]]
.TP 7
.NOP \f\*[B-Font]untrustedkey\f[] \f\*[I-Font]keyid\f[] [\f\*[I-Font]...\f[]]
این دستورها همانند دستورهای فایل پیکربندی
\f\*[B-Font]trustedkey\f[]
و
\f\*[B-Font]untrustedkey\f[]
در
\fCntpd\f[]\fR(1)\f[]
عمل می‌کنند.
.TP 7
.NOP \f\*[B-Font]authinfo\f[]
اطلاعات مربوط به ماژول احراز هویت را بازمی‌گرداند،
از جمله کلیدهای شناخته‌شده و تعداد دفعات رمزنگاری و رمزگشایی
انجام‌شده.
.TP 7
.NOP \f\*[B-Font]traps\f[]
تله‌های (traps) تنظیم‌شده در سرور را نمایش می‌دهد.
برای اطلاعات بیشتر فهرست کد منبع را ببینید.
.TP 7
.NOP \f\*[B-Font]addtrap\f[] \f\*[I-Font]address\f[] [\f\*[I-Font]port\f[]] [\f\*[I-Font]interface\f[]]
یک تله برای پیام‌های ناهمگام تنظیم می‌کند.
برای اطلاعات بیشتر فهرست کد منبع را ببینید.
.TP 7
.NOP \f\*[B-Font]clrtrap\f[] \f\*[I-Font]address\f[] [\f\*[I-Font]port\f[]] [\f\*[I-Font]interface\f[]]
یک تله برای پیام‌های ناهمگام را پاک می‌کند.
برای اطلاعات بیشتر فهرست کد منبع را ببینید.
.TP 7
.NOP \f\*[B-Font]reset\f[]
شمارنده‌های آماری را در ماژول‌های مختلف سرور صفر می‌کند.
برای اطلاعات بیشتر فهرست کد منبع را ببینید.
.PP.SH "محیط (ENVIRONMENT)"
برای متغیرهای محیطی پیکربندی، \fBOPTION PRESETS\fP را ببینید.
.SH "فایل‌ها (FILES)"
برای فایل‌های پیکربندی، \fBOPTION PRESETS\fP را ببینید.
.SH "وضعیت خروج (EXIT STATUS)"
یکی از مقادیر خروج زیر بازگردانده خواهد شد:
.TP
.NOP 0 " (EXIT_SUCCESS)"
اجرای موفقیت‌آمیز برنامه.
.TP
.NOP 1 " (EXIT_FAILURE)"
عملیات ناموفق بود یا نحو دستور معتبر نبود.
.TP
.NOP 66 " (EX_NOINPUT)"
فایل پیکربندی مشخص‌شده بارگیری نشد.
.TP
.NOP 70 " (EX_SOFTWARE)"
خطای عملیاتی داخلی در libopts رخ داد. لطفاً آن را به
autogen-users@lists.sourceforge.net گزارش دهید. با تشکر.
.PP
.SH "همچنین ببینید (SEE ALSO)"
\fCntp.conf\f[]\fR(5)\f[],
\fCntpd\f[]\fR(1)\f[]
David L. Mills,
\fINetwork Time Protocol (Version 3)\fR,
RFC1305
.PP

.SH "نویسندگان (AUTHORS)"
دستورالعمل‌های قالب‌بندی در این سند از FreeBSD آمده است.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
حق نشر (C) 1992-2024 متعلق به The University of Delaware و Network Time Foundation است؛ کلیه حقوق محفوظ است.
این برنامه تحت شرایط مجوز NTP، <http://ntp.org/license> منتشر شده است.
.SH "گزارش باگ‌ها (BUGS)"
ابزار
\f\*[B-Font]ntpdc\fP
یک وصله‌پینه و سرهم‌بندی خام است.
بسیاری از اطلاعاتی که نمایش می‌دهد به‌شدت کسل‌کننده است و احتمالاً تنها پیاده‌ساز آن می‌تواند به آن علاقه‌مند باشد.
این برنامه به‌گونه‌ای طراحی شده بود که افزودن قابلیت‌های جدید (و موقتی) به آن آسان باشد، به بهای افت شدید راحتی استفاده از برنامه.
با این وجود، این برنامه گه‌گاه مفید واقع می‌شود.
.sp \n(Ppu
.ne 2

لطفاً باگ‌ها را به http://bugs.ntp.org گزارش دهید.
.sp \n(Ppu
.ne 2

لطفاً گزارش‌های باگ را به https://bugs.ntp.org یا bugs@ntp.org ارسال کنید.
.SH "نکات (NOTES)"
این صفحهٔ راهنما توسط \fIAutoGen\fP از تعاریف گزینه‌های \fBntpdc\fP تولید شده است.