'\" t
.\"     Title: chronyd
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-04-30
.\"    Manual: System Administration
.\"    Source: chrony 4.8
.\"  Language: Persian
.\"
.TH "CHRONYD" "8" "2026-04-30" "chrony 4.8" "System Administration"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
chronyd \- دیمن سرویس همگام‌سازی زمان chrony
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBchronyd\fP [\fIگزینه\fP].\|.\|. [\fIدستورالعمل\fP].\|.\|.
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBchronyd\fP یک دیمن برای همگام‌سازی ساعت سیستم است. این برنامه می‌تواند ساعت را با کارسازهای NTP، ساعت‌های مرجع (مانند گیرنده GPS) و ورودی‌های دستی از طریق ساعت مچی و صفحه‌کلید به‌وسیلهٔ \fBchronyc\fP همگام‌سازی کند. همچنین می‌تواند به‌عنوان یک کارساز و همتا (peer) در پروتکل NTPv4 (استاندارد RFC 5905) عمل کرده و خدمات زمانی را به سایر رایانه‌های موجود در شبکه ارائه دهد.
.sp
اگر هیچ دستورالعمل پیکربندی در خط فرمان مشخص نشود، \fBchronyd\fP آن‌ها را از یک پروندهٔ پیکربندی می‌خواند. مسیر پیش‌فرض کامپایل‌شده برای این پرونده \fI/etc/chrony.conf\fP است.
.sp
پیام‌های اطلاع‌رسانی، هشدارها و خطاها در syslog ثبت خواهند شد.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-4\fP
.RS 4
با این گزینه، نام‌های میزبان تنها به نشانی‌های IPv4 تفکیک می‌شوند و فقط سوکت‌های IPv4 ایجاد خواهند شد.
.RE
.sp
\fB\-6\fP
.RS 4
با این گزینه، نام‌های میزبان تنها به نشانی‌های IPv6 تفکیک می‌شوند و فقط سوکت‌های IPv6 ایجاد خواهند شد.
.RE
.sp
\fB\-f\fP \fIپرونده\fP
.RS 4
از این گزینه می‌توان برای تعیین یک مسیر جایگزین جهت پروندهٔ پیکربندی استفاده کرد. مقدار پیش‌فرض کامپایل‌شده \fI/etc/chrony.conf\fP است.
.RE
.sp
\fB\-n\fP
.RS 4
هنگام اجرا در این حالت، برنامه خود را از ترمینال جدا نمی‌کند (در پیش‌زمینه باقی می‌ماند).
.RE
.sp
\fB\-d\fP
.RS 4
هنگام اجرا در این حالت، برنامه خود را از ترمینال جدا نمی‌کند و همهٔ پیام‌ها به‌جای syslog در ترمینال نوشته می‌شوند. اگر \fBchronyd\fP با پشتیبانی از اشکال‌زدایی کامپایل شده باشد، می‌توان از این گزینه دو بار برای فعال‌سازی پیام‌های اشکال‌زدایی استفاده کرد.
.RE
.sp
\fB\-l\fP \fIپرونده\fP
.RS 4
این گزینه نوشتن پیام‌های گزارش را به‌جای syslog یا ترمینال، در یک پرونده فعال می‌کند.
.RE
.sp
\fB\-L\fP \fIسطح\fP
.RS 4
این گزینه حداقل سطح اهمیت پیام‌هایی را که باید در پروندهٔ گزارش، syslog یا ترمینال نوشته شوند مشخص می‌کند. سطوح زیر قابل تعیین هستند: \-1 (اشکال‌زدایی، در صورت کامپایل با پشتیبانی از اشکال‌زدایی)، 0 (اطلاع‌رسانی)، 1 (هشدار)، 2 (خطای غیرمهلک) و 3 (خطای مهلک). مقدار پیش‌فرض 0 است.
.RE
.sp
\fB\-p\fP
.RS 4
هنگام اجرا در این حالت، \fBchronyd\fP پیکربندی را چاپ کرده و خارج می‌شود. این دستور خود را از ترمینال جدا نخواهد کرد. از این گزینه می‌توان برای بررسی نحو (سینتکس) پیکربندی و دریافت کل پیکربندی استفاده کرد، حتی اگر در چندین پرونده تقسیم شده باشد و با دستورالعمل‌های \fBinclude\fP یا \fBconfdir\fP خوانده شود.
.RE
.sp
\fB\-q\fP
.RS 4
هنگام اجرا در این حالت، \fBchronyd\fP ساعت سیستم را یک‌بار تنظیم کرده و خارج می‌شود. این برنامه از ترمینال جدا نخواهد شد.
.RE
.sp
\fB\-Q\fP
.RS 4
این گزینه مشابه گزینهٔ \fB\-q\fP است، با این تفاوت که فقط انحراف زمانی (offset) را بدون اعمال هیچ‌گونه اصلاحی بر روی ساعت چاپ می‌کند و درگاه‌های کارساز را غیرفعال می‌سازد تا اجازه دهد \fBchronyd\fP بدون مجوزهای ریشه (root) اجرا شود، به این شرط که پیکربندی فاقد دستورالعمل‌هایی باشد که به چنین مجوزهایی نیاز دارند (مانند \fBrefclock\fP، \fBhwtimestamp\fP، \fBrtcfile\fP و غیره).
.RE
.sp
\fB\-r\fP
.RS 4
این گزینه تلاش می‌کند پرونده‌های حاوی تاریخچهٔ نمونه‌ها را برای هر یک از کارسازها و ساعت‌های مرجع مورد استفاده، دوباره بارگذاری کرده و سپس حذف کند. انتظار می‌رود این پرونده‌ها در پوشه‌ای قرار داشته باشند که توسط دستورالعمل \fBdumpdir\fP در پروندهٔ پیکربندی مشخص شده است. این گزینه زمانی مفید است که می‌خواهید به هر دلیلی، مثلاً برای نصب نسخهٔ جدید، \fBchronyd\fP را برای مدت کوتاهی متوقف کرده و مجدداً راه‌اندازی کنید. با این حال، این گزینه تنها باید در سیستم‌هایی استفاده شود که هسته می‌تواند جبران‌سازی ساعت را در زمانی که تحت کنترل \fBchronyd\fP نیست حفظ کند (یعنی لینوکس، FreeBSD، NetBSD، illumos و macOS نسخهٔ 10.13 یا بالاتر).
.RE
.sp
\fB\-R\fP
.RS 4
هنگامی که از این گزینه استفاده شود، دستورالعمل \fBinitstepslew\fP و دستورالعمل \fBmakestep\fP که با یک حد مثبت به کار رفته است نادیده گرفته خواهند شد. این گزینه هنگام راه‌اندازی مجدد \fBchronyd\fP مفید است و می‌تواند همراه با گزینهٔ \fB\-r\fP استفاده شود.
.RE
.sp
\fB\-s\fP
.RS 4
این گزینه ساعت سیستم را از ساعت بلادرنگ سخت‌افزاری رایانه (RTC) یا بر اساس آخرین زمان تغییر پروندهٔ مشخص‌شده توسط دستورالعمل \fBdriftfile\fP تنظیم می‌کند. ساعت‌های سخت‌افزاری (RTC) تنها در لینوکس پشتیبانی می‌شوند.
.sp
در صورت استفاده همراه با گزینهٔ \fB\-r\fP، برنامهٔ \fBchronyd\fP پس از تنظیم ساعت سیستم از روی RTC تلاش می‌کند تا نمونه‌های قدیمی را حفظ کند. از این ویژگی می‌توان استفاده کرد تا به \fBchronyd\fP امکان داده شود میانگین‌گیری بلندمدت نرخ افزایش یا کاهش زمان را در طول راه‌اندازی‌های مجدد سیستم محاسبه کند؛ این قابلیت برای سیستم‌هایی با دسترسی ناپیوسته به شبکه که در صورت عدم استفاده خاموش می‌شوند مفید است. برای کارکرد مناسب، این ویژگی نیازمند آن است که \fBchronyd\fP در آخرین باری که رایانه روشن بوده، آمار دقیقی از اختلاف بین RTC و ساعت سیستم ثبت کرده باشد.
.sp
اگر آخرین زمان تغییر پروندهٔ drift دیرتر از زمان جاری سیستم و زمان RTC باشد، زمان سیستم روی آن تنظیم می‌شود تا زمانی که \fBchronyd\fP قبلاً در آن متوقف شده بود بازیابی شود. این قابلیت در رایانه‌هایی که فاقد RTC هستند یا RTC آن‌ها خراب است (برای نمونه باتری آن تمام شده) مفید واقع می‌شود.
.RE
.sp
\fB\-t\fP \fIمهلت‌زمانی\fP
.RS 4
این گزینه یک مهلت‌زمانی (به ثانیه) تنظیم می‌کند که پس از آن \fBchronyd\fP خارج خواهد شد. اگر ساعت همگام نشده باشد، با یک وضعیت غیرصفر خارج می‌شود. این ویژگی در ترکیب با گزینهٔ \fB\-q\fP یا \fB\-Q\fP برای کوتاه کردن حداکثر زمان انتظار برای اندازه‌گیری‌ها، یا با گزینهٔ \fB\-r\fP برای محدود کردن مدت‌زمان اجرای \fBchronyd\fP مفید است در حالی که همچنان به آن اجازه می‌دهد فرکانس ساعت سیستم را تنظیم کند.
.RE
.sp
\fB\-u\fP \fIکاربر\fP
.RS 4
این گزینه نام کاربر سیستمی را مشخص می‌کند که \fBchronyd\fP پس از راه‌اندازی برای رها کردن دسترسی‌های ریشه (root) به آن تغییر هویت می‌دهد. این گزینه بر دستورالعمل \fBuser\fP اولویت دارد. مقدار پیش‌فرض کامپایل‌شده \fIchrony\fP است.
.sp
در لینوکس، \fBchronyd\fP باید با پشتیبانی از کتابخانهٔ \fBlibcap\fP کامپایل شده باشد. در macOS، FreeBSD، NetBSD و illumos برنامهٔ \fBchronyd\fP به دو فرآیند منشعب (fork) می‌شود. فرآیند فرزند امتیازات ریشه را حفظ می‌کند، اما تنها می‌تواند دامنهٔ بسیار محدودی از فراخوان‌های سیستمی ممتاز را به نمایندگی از والد انجام دهد.
.RE
.sp
\fB\-U\fP
.RS 4
این گزینه بررسی دسترسی‌های ریشه را غیرفعال می‌کند تا به \fBchronyd\fP اجازه دهد تحت یک کاربر غیرریشه اجرا شود، با این فرض که فرآیند تمام قابلیت‌های لازم (capabilities، مثلاً فراهم‌شده توسط مدیر سرویس) و دسترسی به تمام پرونده‌ها، پوشه‌ها و دستگاه‌های مورد نیاز برای عملکرد صحیح در پیکربندی مشخص‌شده را دارا است. توجه داشته باشید که در پیکربندی‌های مختلف و نسخه‌های گوناگون هستهٔ لینوکس ممکن است به قابلیت‌های متفاوتی نیاز باشد. راه‌اندازی \fBchronyd\fP با کاربری غیر از ریشه در شرایطی که پیکربندی شناخته‌شده نیست یا حداقل به دستورالعمل‌های خاصی محدود نشده است، توصیه نمی‌شود.
.RE
.sp
\fB\-F\fP \fIسطح\fP
.RS 4
این گزینه فیلترهای فراخوان سیستم را که توسط فرآیندهای \fBchronyd\fP بارگذاری می‌شوند، در صورتی که با پشتیبانی از سازوکار رایانش امن لینوکس (seccomp) کامپایل شده باشد، پیکربندی می‌کند. سه سطح تعریف شده است: 0، 1 و 2. فیلترها در سطح 0 غیرفعال هستند. در سطوح 1 و 2، اگر \fBchronyd\fP فراخوان سیستمی انجام دهد که توسط فیلترها مسدود شده است، فرآیند متوقف خواهد شد (kill می‌شود). این سطح می‌تواند به‌صورت یک عدد منفی تعیین شود تا به‌جای سیگنال SIGKILL سیگنال SIGSYS فعال گردد، که برای اشکال‌زدایی مفید است. مقدار پیش‌فرض 0 است.
.sp
در سطح 1، فیلترها تنها به فراخوان‌های سیستمی برگزیده‌ای اجازه می‌دهند که انتظار می‌رود به‌طور معمول توسط \fBchronyd\fP اجرا شوند. سایر فراخوان‌های سیستمی مسدود می‌شوند. این سطح تنها در صورتی توصیه می‌شود که عملکرد آن بر روی نسخهٔ سیستم محل نصب \fBchrony\fP تأیید شده باشد. این فیلترها باید به فراخوان‌های سیستمی انجام‌شده توسط کتابخانه‌های مورد استفادهٔ \fBchronyd\fP (مانند libc) نیز اجازهٔ اجرا بدهند، اما نسخه‌ها یا پیاده‌سازی‌های مختلف کتابخانه‌ها ممکن است فراخوان‌های متفاوتی انجام دهند. در صورتی که فیلترها فراخوانی سیستمی را نادیده گرفته باشند، ممکن است \fBchronyd\fP حتی در شرایط عادی کارکرد متوقف شود.
.sp
در سطح 2، فیلترها تنها تعداد محدودی از فراخوان‌های سیستمی خاص (مانند fork و exec) را مسدود می‌کنند. این رویکرد از تشخیص‌های مثبت کاذب (false positive) جلوگیری می‌کند، اما حفاظت از سیستم در برابر یک فرآیند دست‌کاری‌شده یا آسیب‌دیدهٔ \fBchronyd\fP بسیار محدودتر خواهد بود.
.sp
این فیلترها را نمی‌توان در صورت استفاده از دستورالعمل \fBmailonchange\fP فعال کرد.
.RE
.sp
\fB\-P\fP \fIاولویت\fP
.RS 4
در لینوکس، FreeBSD، NetBSD و illumos این گزینه زمان‌بند بلادرنگ SCHED_FIFO را در اولویت مشخص‌شده (که باید عددی بین 0 تا 100 باشد) انتخاب می‌کند. در macOS، این گزینه باید مقداری برابر با 0 (برای غیرفعال کردن خط‌مشی محدودیت زمانی ریسه) یا 1 (برای فعال‌سازی این خط‌مشی) داشته باشد. سایر سیستم‌ها از این گزینه پشتیبانی نمی‌کنند. مقدار پیش‌فرض 0 است.
.RE
.sp
\fB\-m\fP
.RS 4
این گزینه برنامهٔ \fBchronyd\fP را در حافظهٔ رم قفل می‌کند تا هرگز به حافظهٔ جانبی (صفحه‌بندی/swap) منتقل نشود. این حالت تنها در لینوکس، FreeBSD، NetBSD و illumos پشتیبانی می‌شود.
.RE
.sp
\fB\-x\fP
.RS 4
این گزینه کنترل ساعت سیستم را غیرفعال می‌کند. برنامهٔ \fBchronyd\fP تلاشی برای اعمال تغییرات بر روی ساعت نخواهد کرد. با این فرض که ساعت سیستم آزادانه کار می‌کند، همچنان انحراف زمانی و فرکانس آن را نسبت به زمان واقعی تخمینی ردیابی می‌کند. این گزینه امکان راه‌اندازی \fBchronyd\fP را بدون داشتن قابلیت تنظیم ساعت سیستم (برای نمونه در برخی از کانتینرها) جهت کار به‌عنوان یک کارساز NTP فراهم می‌سازد.
.RE
.sp
\fB\-v\fP, \fB\-\-version\fP
.RS 4
با این گزینه، \fBchronyd\fP شمارهٔ نسخه را در ترمینال چاپ کرده و خارج می‌شود.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
با این گزینه، \fBchronyd\fP پیام راهنما را در ترمینال چاپ کرده و خارج می‌شود.
.RE
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.sp
\fBLISTEN_FDS\fP
.RS 4
در سیستم‌های لینوکسی، مدیر سرویس systemd ممکن است توصیف‌گرهای پرونده (file descriptors) مربوط به سوکت‌های از پیش راه‌اندازی‌شده را به \fBchronyd\fP منتقل کند. مدیر سرویس توصیف‌گرهای پرونده را تخصیص داده و متصل (bind) می‌کند و یک رونوشت از آن را به هر نمونهٔ ایجادشده از سرویس تحویل می‌دهد. این سازوکار امکان راه‌اندازی مجدد بدون وقفه (zero\-downtime) سرویس را فراهم می‌آورد، زیرا سوکت‌ها درخواست‌های کلاینت را تا زمانی که سرویس قادر به پردازش آن‌ها باشد در بافر نگه می‌دارند. مدیر سرویس متغیر محیطی LISTEN_FDS را روی تعداد توصیف‌گرهای پروندهٔ منتقل‌شده تنظیم می‌کند.
.RE
.sp
\fBNOTIFY_SOCKET\fP
.RS 4
مدیر سرویس systemd این متغیر را برای سرویس‌هایی از نوع \fBnotify\fP مقداردهی می‌کند. زمانی که \fBchronyd\fP به‌طور کامل راه‌اندازی شده و آمادهٔ پذیرش دستورات (برای نمونه از سوی \fBchronyc\fP) باشد، پیامی به این سوکت ارسال می‌کند؛ در صورتی که از گزینهٔ \fB\-s\fP یا دستورالعمل \fBinitstepslew\fP استفاده شده باشد، ساعت نیز از قبل تنظیم شده است. این سازوکار جایگزینی برای سرویس‌های نوع \fBforking\fP است که نیازی به پروندهٔ شناسه فرآیند (PID file) ندارد. برای جلوگیری از انشعاب (fork)، برنامهٔ \fBchronyd\fP باید با گزینهٔ \fB\-n\fP یا \fB\-d\fP اجرا شود.
.RE
.SH "فایل‌ها (FILES)"
.sp
\fI/etc/chrony.conf\fP
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBchronyc(1)\fP, \fBchrony.conf(5)\fP
.SH "اشکالات (BUGS)"
.sp
جهت دریافت دستورالعمل‌های مربوط به گزارش اشکالات، لطفاً به نشانی زیر مراجعه کنید:
.URL "https://chrony\-project.org" "" "."
.SH "نویسندگان (AUTHORS)"
.sp
پروژهٔ chrony توسط ریچارد کورنو (Richard Curnow)، میروسلاو لیچوار (Miroslav Lichvar) و دیگران نوشته شده است.