.\" $OpenBSD: ntpd.8,v 1.49 2023/03/02 17:09:53 jmc Exp $
.\"
.\" Copyright (c) 2003, 2004, 2006 Henning Brauer <henning@openbsd.org>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER IN
.\" AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
.\" OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: March 2 2023 $
.Dt NTPD 8
.Os
.Sh "نام (NAME)"
.Nm ntpd
.Nd دیمن پروتکل زمان شبکه (NTP)
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm ntpd
.Bk -words
.Op Fl dnv
.Op Fl f Ar file
.Op Fl p Ar file
.Ek
.Sh "توضیحات (DESCRIPTION)"
دیمن
.Nm
ساعت محلی را با یک یا چند سرور دوردست NTP یا حسگرهای اختلاف زمانی محلی همگام‌سازی می‌کند.
.Nm
همچنین می‌تواند خودش به عنوان یک سرور NTP عمل کرده و زمان محلی را بازتوزیع کند.
این برنامه پروتکل زمان شبکه ساده نسخه ۴ را همان‌گونه که در RFC 5905 شرح داده شده،
و پروتکل زمان شبکه نسخه ۳ را همان‌گونه که در RFC 1305 شرح داده شده است پیاده‌سازی می‌کند.
زمان همچنین می‌تواند از سرورهای TLS HTTPS دریافت شود تا اثر حملات مرد میانی (man-in-the-middle) در NTP بدون احراز هویت کاهش یابد.
.Pp
گزینه‌ها به شرح زیر هستند:
.Bl -tag -width "-f fileXXX"
.It Fl d
به صورت دیمن اجرا نشود.
اگر این گزینه مشخص شود،
.Nm
در پیش‌زمینه اجرا شده و لاگ‌ها را در
.Em stderr
ثبت می‌کند.
.It Fl f Ar file
استفاده از
.Ar file
به عنوان فایل پیکربندی،
به جای فایل پیش‌فرض
.Pa /etc/ntpd.conf .
.It Fl n
حالت آزمایش پیکربندی (Configtest).
تنها معتبر بودن فایل پیکربندی را بررسی می‌کند.
.It Fl v
این گزینه به
.Nm
اجازه می‌دهد تا پیام‌هایی با اولویت اشکال‌زدایی (DEBUG) را به syslog ارسال کند.
.It Fl p Ar file
نوشتن شناسه فرایند (PID) در
.Ar file
.El
.Pp
.Nm
از فراخوان سیستمی
.Xr adjtime 2
برای تصحیح زمان محلی سیستم بدون ایجاد جهش‌های زمانی استفاده می‌کند.
تنظیمات ۳۲ میلی‌ثانیه و بیشتر با استفاده از
.Xr syslog 3
ثبت می‌شوند.
مقدار آستانه به این منظور انتخاب شده است تا از پر شدن بیهوده فایل‌های لاگ توسط انحراف ساعت محلی جلوگیری شود.
چنانچه
.Nm
با گزینه
.Fl d
یا
.Fl v
راه‌اندازی شود، تمام فراخوانی‌های
.Xr adjtime 2
ثبت خواهند شد.
.Pp
در زمان بوت،
.Nm
حداکثر به مدت ۱۵ ثانیه در پیش‌زمینه می‌ماند و در صورتی که محدودیت‌ها پیکربندی و برآورده شده باشند یا سرورها یا حسگرهای مورد اعتماد نتایجی بازگردانند، و به شرطی که ساعت به عقب برگردانده نشود، تلاش می‌کند زمان را بررسی و تصحیح کند.
.Pp
پس از همگام‌سازی ساعت محلی،
.Nm
فرکانس ساعت را با استفاده از فراخوان سیستمی
.Xr adjfreq 2
تنظیم می‌کند تا انحراف سامان‌مند (systematic drift) جبران شود.
.Pp
.Nm
به‌طور پیش‌فرض در زمان بوت از طریق
.Va ntpd_flags
در
.Pa /etc/rc.conf
راه‌اندازی می‌شود.
برای اطلاعات بیشتر درباره فرایند بوت و فعال‌سازی دیمن‌ها به
.Xr rc 8
و
.Xr rc.conf 8
مراجعه کنید.
.Pp
هنگامی که
.Nm
شروع به کار می‌کند، تنظیمات را از فایل پیکربندی خود، معمولاً
.Xr ntpd.conf 5 ,
و انحراف اولیه ساعت را از
.Pa /var/ntpd.drift
می‌خواند.
انحراف ساعت پس از آن به‌طور دوره‌ای در فایل drift نوشته می‌شود.
.Sh "فایل‌ها (FILES)"
.Bl -tag -width "/var/ntpd.driftXX" -compact
.It Pa /etc/ntpd.conf
فایل پیکربندی پیش‌فرض.
.It Pa /var/ntpd.drift
فایل انحراف زمان (drift).
.It Pa /var/run/ntpd.sock
فایل سوکت برای ارتباط با
.Xr ntpctl 8 .
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr date 1 ,
.Xr adjfreq 2 ,
.Xr adjtime 2 ,
.Xr ntpd.conf 5 ,
.Xr ntpctl 8 ,
.Xr rc 8 ,
.Xr rc.conf 8 ,
.Xr rdate 8
.Sh "استانداردها (STANDARDS)"
.Rs
.%A David L. Mills
.%D March 1992
.%R RFC 1305
.%T Network Time Protocol (Version 3): Specification, Implementation and Analysis
.Re
.Pp
.Rs
.%A David L. Mills
.%A Jim Martin
.%A Jack Burbank
.%A William Kasch
.%D June 2010
.%R RFC 5905
.%T Network Time Protocol Version 4: Protocol and Algorithms Specification
.Re
.Sh "تاریخچه (HISTORY)"
برنامه
.Nm
نخستین بار در
.Ox 3.6
ظاهر شد.