'\" t
.\"     Title: chronyc
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-04-30
.\"    Manual: User manual
.\"    Source: chrony 4.8
.\"  Language: Persian
.\"
.TH "CHRONYC" "1" "2026-04-30" "chrony 4.8" "User manual"
.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 - نام"
chronyc \- رابط خط فرمان برای دیمن chrony
.SH "SYNOPSIS - نحوه‌ی استفاده"
.sp
\fBchronyc\fP [\fIOPTION\fP].\|.\|. [\fICOMMAND\fP].\|.\|.
.SH "DESCRIPTION - توضیحات"
.sp
برنامهٔ \fBchronyc\fP یک رابط خط فرمان است که می‌توان از آن برای پایش عملکرد \fBchronyd\fP و تغییر پارامترهای عملیاتی گوناگون در حین اجرای آن استفاده کرد.
.sp
اگر هیچ دستوری در خط فرمان مشخص نشود، \fBchronyc\fP منتظر ورودی از سوی کاربر خواهد ماند. هنگام اجرا از یک پایانه، اعلان \fIchronyc>\fP نمایش داده می‌شود. اگر ورودی یا خروجی \fBchronyc\fP از یا به یک پرونده تغییر مسیر داده شود، اعلان نمایش داده نخواهد شد.
.sp
دو روش برای دسترسی \fBchronyc\fP به \fBchronyd\fP وجود دارد: یکی از طریق پروتکل اینترنت (IPv4 یا IPv6) و دیگری از طریق یک سوکت دامنه یونیکس (Unix domain socket) که به‌صورت محلی توسط کاربر root یا \fIchrony\fP در دسترس است. به‌طور پیش‌فرض، \fBchronyc\fP ابتدا تلاش می‌کند به سوکت دامنه یونیکس متصل شود. مسیر پیش‌فرض کامپایل‌شده \fI/var/run/chrony/chronyd.sock\fP است. اگر این اتصال ناموفق باشد (برای نمونه به این دلیل که \fBchronyc\fP تحت یک کاربر غیر از root اجرا شده است)، تلاش خواهد کرد به 127.0.0.1 و سپس به ::1 متصل شود.
.sp
به‌طور پیش‌فرض، تنها دستورهای پایش زیر که بر رفتار \fBchronyd\fP تأثیری ندارند از طریق شبکه مجاز هستند: \fBactivity\fP، \fBmanual list\fP، \fBrtcdata\fP، \fBsmoothing\fP، \fBsourcename\fP، \fBsources\fP، \fBsourcestats\fP، \fBtracking\fP، \fBwaitsync\fP.
مجموعه میزبان‌هایی که \fBchronyd\fP این دستورها را از آن‌ها می‌پذیرد را می‌توان با دستورالعمل \fBcmdallow\fP در پروندهٔ پیکربندی \fBchronyd\fP یا دستور \fBcmdallow\fP در \fBchronyc\fP پیکربندی کرد. به‌طور پیش‌فرض، این دستورها تنها از localhost (127.0.0.1 یا ::1) پذیرفته می‌شوند.
.sp
سایر دستورهای پایش را می‌توان با دستورالعمل \fBopencommands\fP برای دسترسی از طریق شبکه فعال کرد. دستورهای پایش با دسترسی شبکه‌ای غیرفعال و همچنین دستورهایی که بر رفتار \fBchronyd\fP اثر می‌گذارند تنها از طریق سوکت دامنه یونیکس مجاز هستند. اگر این دستورها از طریق شبکه ارسال شوند، \fBchronyd\fP با خطای \(oqNot authorised\(cq پاسخ خواهد داد، حتی اگر از مبدأ localhost باشد.
.sp
داشتن دسترسی کامل به \fBchronyd\fP از طریق \fBchronyc\fP کم‌وبیش معادل توانایی اصلاح پروندهٔ پیکربندی \fBchronyd\fP و راه‌اندازی مجدد آن است.
.SH "OPTIONS - گزینه‌ها"
.sp
\fB\-4\fP
.RS 4
با این گزینه، نام میزبان‌ها فقط به نشانی‌های IPv4 تفکیک می‌شوند.
.RE
.sp
\fB\-6\fP
.RS 4
با این گزینه، نام میزبان‌ها فقط به نشانی‌های IPv6 تفکیک می‌شوند.
.RE
.sp
\fB\-n\fP
.RS 4
این گزینه تفکیک نشانی‌های IP به نام میزبان را غیرفعال می‌کند؛ برای نمونه جهت جلوگیری از جستجوهای کند DNS. نشانی‌های طولانی برای جا شدن در ستون کوتاه نمی‌شوند.
.RE
.sp
\fB\-N\fP
.RS 4
این گزینه چاپ نام میزبان‌ها یا نشانی‌های IP اصلی منابع NTP را که در پروندهٔ پیکربندی یا دستورهای \fBchronyc\fP مشخص شده‌اند، فعال می‌کند. بدون گزینه‌های \fB\-n\fP و \fB\-N\fP، نام میزبان‌های چاپ‌شده از جستجوهای معکوس DNS به‌دست می‌آیند و ممکن است با نام میزبان‌های مشخص‌شده متفاوت باشند.
.RE
.sp
\fB\-c\fP
.RS 4
این گزینه چاپ گزارش‌ها را در قالب مقادیر جداشده با کاما (CSV) فعال می‌کند. جستجوهای معکوس DNS غیرفعال خواهد شد، زمان به‌صورت تعداد ثانیه‌ها از مبدأ تاریخ (epoch) چاپ می‌شود و مقادیر برحسب ثانیه به واحدهای دیگر تبدیل نخواهند شد.
.RE
.sp
\fB\-e\fP
.RS 4
با این گزینه، هر پاسخ \fBchronyc\fP با یک سطر حاوی یک نقطه منفرد پایان می‌یابد.
.RE
.sp
\fB\-d\fP
.RS 4
اگر \fBchronyc\fP با پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این گزینه چاپ پیام‌های اشکال‌زدایی را فعال می‌کند.
.RE
.sp
\fB\-m\fP
.RS 4
به‌طور معمول، همهٔ آرگومان‌های خط فرمان به عنوان یک دستور واحد تفسیر می‌شوند. با این گزینه می‌توان چندین دستور را مشخص کرد. هر آرگومان به عنوان یک دستور کامل تفسیر خواهد شد.
.RE
.sp
\fB\-h\fP \fIhost\fP
.RS 4
این گزینه میزبانی را که باید توسط \fBchronyc\fP فراخوانی شود مشخص می‌کند. این مقدار را می‌توان با نام میزبان، نشانی IP یا مسیر سوکت محلی دامنه یونیکس مشخص کرد. چندین مقدار را می‌توان به‌صورت فهرستی جداشده با کاما برای ایجاد یک سازوکار جایگزین (fallback) تعیین نمود.
.sp
مقدار پیش‌فرض \fI/var/run/chrony/chronyd.sock,127.0.0.1,::1\fP است، یعنی همان میزبانی که \fBchronyc\fP در آن اجرا می‌شود. ابتدا سعی می‌کند به سوکت دامنه یونیکس متصل شود و در صورت ناموفق بودن (مثلاً به‌دلیل اجرا تحت کاربری غیر از root)، تلاش خواهد کرد به 127.0.0.1 و سپس ::1 متصل گردد.
.RE
.sp
\fB\-p\fP \fIport\fP
.RS 4
این گزینه به کاربر امکان می‌دهد شماره درگاه UDP را که \fBchronyd\fP مقصد برای اتصالات پایش خود استفاده می‌کند مشخص کند. مقدار پیش‌فرض 323 است؛ به‌ندرت نیازی به تغییر آن خواهد بود.
.RE
.sp
\fB\-u\fP \fIuser\fP
.RS 4
این گزینه نام کاربری را تعیین می‌کند که \fBchronyc\fP هنگام آغاز تحت کاربر root، برای لغو دسترسی‌های ویژه خود به آن جابجا خواهد شد. اگر این گزینه روی \fIroot\fP تنظیم شده باشد یا شناسه کاربر مؤثر فرایند آغازشده 0 نباشد، \fBchronyc\fP تلاشی برای تغییر هویت خود نخواهد کرد. مقدار پیش‌فرض کامپایل‌شده \fIroot\fP است.
.RE
.sp
\fB\-f\fP \fIfile\fP
.RS 4
این گزینه نادیده گرفته می‌شود و صرفاً برای سازگاری ارائه شده است.
.RE
.sp
\fB\-a\fP
.RS 4
این گزینه نادیده گرفته می‌شود و صرفاً برای سازگاری ارائه شده است.
.RE
.sp
\fB\-v\fP, \fB\-\-version\fP
.RS 4
با این گزینه، \fBchronyc\fP شماره نگارش خود را در پایانه نمایش داده و خارج می‌شود.
.RE
.sp
\fB\-\-help\fP
.RS 4
با این گزینه، \fBchronyc\fP یک پیام راهنما را در پایانه نمایش داده و خارج می‌شود.
.RE
.SH "دستورها (COMMANDS)"
.sp
این بخش هر یک از دستورهای در دسترس در برنامه \fBchronyc\fP را شرح می‌دهد\&.
.SS "ساعت سیستم (System clock)"
.sp
\fBtracking\fP
.RS 4
دستور \fBtracking\fP پارامترهای مربوط به عملکرد ساعت سیستم را نمایش می‌دهد\&. نمونه‌ای از این خروجی در زیر نشان داده شده است\&.
.sp
.if n .RS 4
.nf
.fam C
Reference ID\&    : CB00710F (ntp1.example.net)
Stratum\&         : 3
Ref time (UTC)\&  : Fri Jan 27 09:49:17 2017
System time\&     : 0.000006523 seconds slow of NTP time
Last offset\&     : \-0.000006747 seconds
RMS offset\&      : 0.000035822 seconds
Frequency\&       : 3.225 ppm slow
Residual freq\&   : \-0.000 ppm
Skew\&            : 0.129 ppm
Root delay\&      : 0.013639022 seconds
Root dispersion : 0.001100737 seconds
Update interval : 64.2 seconds
Leap status\&     : Normal
.fam
.fi
.if n .RE
.sp
فیلدها به شرح زیر توضیح داده شده‌اند:
.sp
\fBReference ID\fP
.RS 4
این فیلد شناسه مرجع و نام (یا آدرس IP) سروری است که رایانه در حال حاضر با آن همگام‌سازی شده است\&. برای آدرس‌های IPv4، شناسه مرجع برابر با همان آدرس است و برای آدرس‌های IPv6، برابر با ۳۲ بیت نخست جمع‌کنترلی MD5 آدرس می‌باشد\&.
.sp
اگر شناسه مرجع \fI7F7F0101\fP باشد و هیچ نام یا آدرس IP وجود نداشته باشد، به این معنی است که رایانه با هیچ منبع خارجی همگام‌سازی نشده و حالت محلی (\fIlocal\fP) فعال است (از طریق دستور \fBlocal\fP در \fBchronyc\fP، یا دستورالعمل \fBlocal\fP در پرونده پیکربندی)\&.
.sp
شناسه مرجع به صورت یک عدد هگزادسیمال چاپ می‌شود\&. توجه داشته باشید که در نسخه‌های قدیمی‌تر به صورت چهار عددی نقطه‌دار (quad\-dotted) چاپ می‌شد و ممکن بود با یک آدرس IPv4 اشتباه گرفته شود\&.
.RE
.sp
\fBStratum\fP
.RS 4
استراتوم (stratum) نشان می‌دهد که ما چند جهش با رایانه‌ای که ساعت مرجع متصل دارد فاصله داریم\&. چنین رایانه‌ای یک رایانه stratum\-1 است، بنابراین رایانه موجود در این مثال دو جهش فاصله دارد (یعنی \fIntp1.example.net\fP یک stratum\-2 است و از یک stratum\-1 همگام می‌شود)\&.
.RE
.sp
\fBRef time\fP
.RS 4
این مقدار زمانی (به وقت UTC) است که در آن آخرین اندازه‌گیری از منبع مرجع پردازش شده است\&.
.RE
.sp
\fBSystem time\fP
.RS 4
این مقدار، اختلاف (offset) کنونی بین ساعت NTP و ساعت سیستم است\&. ساعت NTP یک ساعت نرم‌افزاری (مجازی) نگهداری‌شده توسط \fBchronyd\fP است که با منابع زمانی پیکربندی‌شده همگام بوده و زمان را برای کلاینت‌های NTP فراهم می‌کند\&. ساعت سیستم با ساعت NTP همگام‌سازی می‌شود\&. برای جلوگیری از جهش‌های ناگهانی در زمان سیستم (steps)، که ممکن است پیامدهای نامطلوبی برای برخی برنامه‌ها داشته باشد، ساعت سیستم معمولاً تنها با افزایش یا کاهش سرعت (تا نرخ تعیین‌شده توسط دستورالعمل \fBmaxslewrate\fP) تصحیح می‌شود\&. اگر این اختلاف بیش از حد بزرگ باشد، این تصحیح زمان بسیار زیادی خواهد برد\&. با استفاده از دستور \fBmakestep\fP، یا دستورالعمل \fBmakestep\fP در پرونده پیکربندی می‌توان جهش را تحمیل کرد\&.
.sp
توجه داشته باشید که تمام اختلاف‌های دیگر گزارش‌شده توسط \fBchronyc\fP و بیشتر اختلاف‌ها در پرونده‌های لاگ نسبت به ساعت NTP هستند، نه ساعت سیستم\&.
.RE
.sp
\fBLast offset\fP
.RS 4
این فیلد، اختلاف محلی برآوردشده در آخرین به‌روزرسانی ساعت است\&. مقدار مثبت نشان می‌دهد که زمان محلی (به عنوان زمان واقعی برآوردشده قبلی) جلوتر از منابع زمانی بوده است\&.
.RE
.sp
\fBRMS offset\fP
.RS 4
این مقدار میانگین بلندمدت مقدار اختلاف است\&.
.RE
.sp
\fBFrequency\fP
.RS 4
«فرکانس» (frequency) نرخی است که اگر \fBchronyd\fP آن را تصحیح نمی‌کرد، ساعت سیستم دچار خطا می‌شد\&. این مقدار بر حسب ppm (بخش در میلیون) بیان می‌شود\&. برای نمونه، مقدار 1 ppm به این معناست که وقتی ساعت سیستم تصور می‌کند ۱ ثانیه جلو رفته است، در واقع نسبت به زمان واقعی ۱٫۰۰۰۰۰۱ ثانیه جلو رفته است\&.
.RE
.sp
\fBResidual freq\fP
.RS 4
این فیلد «فرکانس باقیمانده» را برای منبع مرجع انتخاب‌شده کنونی نشان می‌دهد\&. این مقدار هرگونه تفاوت میان فرکانسی را که اندازه‌گیری‌های منبع مرجع بیانگر آن هستند و فرکانسی را که در حال حاضر استفاده می‌شود، بازتاب می‌دهد\&.
.sp
دلیل اینکه این مقدار همواره صفر نیست، اعمال یک رویه هموارسازی بر روی فرکانس است\&. هر بار که اندازه‌گیری جدیدی از منبع مرجع به دست می‌آید و یک فرکانس باقیمانده جدید محاسبه می‌شود، دقت برآوردشده این باقیمانده با دقت برآوردشده مقدار فرکانس موجود (مورد «skew» بعدی را ببینید) مقایسه می‌شود\&. میانگین وزنی برای فرکانس جدید محاسبه می‌شود که وزن‌های آن وابسته به این دقت‌ها است\&. اگر اندازه‌گیری‌های منبع مرجع یک روند یکنواخت را دنبال کنند، باقیمانده با گذشت زمان به صفر میل خواهد کرد\&.
.RE
.sp
\fBSkew\fP
.RS 4
این مقدار کران خطای برآوردشده روی فرکانس است\&.
.RE
.sp
\fBRoot delay\fP
.RS 4
این مجموع تأخیرهای مسیر شبکه تا رایانه stratum\-1 است که این رایانه در نهایت با آن همگام شده است\&.
.RE
.sp
\fBRoot dispersion\fP
.RS 4
این مجموع پراکندگی انباشته‌شده از طریق تمام رایانه‌ها در مسیر بازگشت به رایانه stratum\-1 است که این رایانه در نهایت با آن همگام شده است\&. پراکندگی به دلیل تفکیک‌پذیری ساعت سیستم، تغییرات آماری اندازه‌گیری و غیره است\&.
.sp
کران مطلق دقت ساعت رایانه (با فرض درست بودن رایانه stratum\-1) با رابطه زیر بیان می‌شود:
.sp
.if n .RS 4
.nf
.fam C
clock_error <= |system_time_offset| + root_dispersion + (0.5 * root_delay)
.fam
.fi
.if n .RE
.RE
.sp
\fBUpdate interval\fP
.RS 4
این فاصله زمانی بین دو به‌روزرسانی آخر ساعت است\&.
.RE
.sp
\fBLeap status\fP
.RS 4
این وضعیت کبیسه است که می‌تواند \fINormal\fP، \fIInsert second\fP، \fIDelete second\fP یا \fINot synchronised\fP باشد\&.
.RE
.RE
.sp
\fBmakestep\fP, \fBmakestep\fP \fIthreshold\fP \fIlimit\fP
.RS 4
به‌طور معمول \fBchronyd\fP باعث می‌شود سیستم هرگونه اختلاف زمانی را با کاهش یا افزایش سرعت ساعت در صورت نیاز به‌تدریج تصحیح کند\&. در شرایط خاص، ممکن است انحراف ساعت سیستم به حدی زیاد باشد که روند تصحیح تدریجی (slewing) برای اصلاح ساعت زمان بسیار زیادی ببرد\&.
.sp
در این شرایط می‌توان از دستور \fBmakestep\fP استفاده کرد\&. این دستور دو شکل دارد\&. شکل نخست پارامتری ندارد؛ به \fBchronyd\fP اعلام می‌کند هرگونه تصحیح باقی‌مانده‌ای را که به‌طور تدریجی در حال انجام بود لغو کند و با جهش ساعت سیستم به میزان معادل، آن را بلافاصله درست کند\&.
.sp
شکل دوم، جهش خودکار را مشابه با دستورالعمل \fBmakestep\fP پیکربندی می‌کند\&. این شکل دارای دو پارامتر است: آستانه جهش (بر حسب ثانیه) و تعداد به‌روزرسانی‌های آینده ساعت که آستانه برای آن‌ها فعال خواهد بود\&. این را می‌توان همراه با دستور \fBburst\fP به کار برد تا اندازه‌گیری جدید به‌سرعت انجام شده و در صورت نیاز ساعت با جهش تصحیح شود، بدون اینکه نیازی به صبر کردن برای تکمیل اندازه‌گیری توسط \fBchronyd\fP و به‌روزرسانی ساعت باشد\&.
.sp
.if n .RS 4
.nf
.fam C
makestep 0.1 1
burst 1/2
.fam
.fi
.if n .RE
.sp
هشدار: برخی نرم‌افزارها به‌شدت تحت تأثیر چنین جهش‌هایی در زمان سیستم قرار می‌گیرند\&. (به همین دلیل است که \fBchronyd\fP در حالت عادی از تصحیح تدریجی استفاده می‌کند\&.)
.RE
.sp
\fBmaxupdateskew\fP \fIskew\-in\-ppm\fP
.RS 4
این دستور اثری مشابه دستورالعمل
\fBmaxupdateskew\fP در
پرونده پیکربندی دارد\&.
.RE
.sp
\fBwaitsync\fP [\fImax\-tries\fP [\fImax\-correction\fP [\fImax\-skew\fP [\fIinterval\fP]]]]
.RS 4
دستور \fBwaitsync\fP منتظر می‌ماند تا \fBchronyd\fP همگام‌سازی شود\&.
.sp
حداکثر چهار آرگومان اختیاری را می‌توان مشخص کرد\&. نخستین مورد حداکثر تعداد تلاش‌ها پیش از صرف‌نظر کردن و بازگرداندن کد خطای غیرصفر است\&. هنگامی که 0 مشخص شود، یا هیچ آرگومانی داده نشود، تعداد تلاش‌ها محدود نخواهد بود\&.
.sp
آرگومان‌های دوم و سوم حداکثر تصحیح مجاز باقی‌مانده ساعت سیستم و حداکثر انحراف مجاز (بر حسب ppm) هستند، همان‌طور که توسط دستور \fBtracking\fP در فیلدهای \fBSystem time\fP و \fBSkew\fP گزارش شده است\&. اگر مشخص نشود یا صفر باشد، مقدار بررسی نخواهد شد\&.
.sp
آرگومان چهارم فاصله‌ای است که بر حسب ثانیه مشخص می‌شود و بررسی در آن تکرار می‌گردد\&. این فاصله به‌طور پیش‌فرض 10 ثانیه است\&.
.sp
یک مثال:
.sp
.if n .RS 4
.nf
.fam C
waitsync 60 0.01
.fam
.fi
.if n .RE
.sp
که حداکثر حدود 10 دقیقه (60 بار 10 ثانیه‌ای) منتظر می‌ماند تا \fBchronyd\fP با یک منبع همگام شود و تصحیح باقی‌مانده کمتر از 10 میلی‌ثانیه باشد\&.
.RE
.SS "منابع زمانی (Time sources)"
.sp
\fBsources\fP [\fB\-a\fP] [\fB\-v\fP]
.RS 4
این دستور اطلاعات مربوط به منابع زمانی فعلی که \fBchronyd\fP به آن‌ها دسترسی دارد را نمایش می‌دهد.
.sp
اگر گزینه \fB\-a\fP مشخص شود، تمام منابع نمایش داده می‌شوند، از جمله مواردی که هنوز نشانی شناخته‌شده‌ای ندارند. چنین منابعی دارای یک شناسه با قالب \fIID#XXXXXXXXXX\fP هستند که می‌تواند در سایر دستورهایی که انتظار یک نشانی منبع دارند استفاده شود.
.sp
گزینه \fB\-v\fP خروجی با جزئیات بیشتر را فعال می‌کند. در این حالت، سطرهای عنوان اضافی به عنوان یادآوری برای مفهوم هر ستون نمایش داده می‌شوند.
.sp
.if n .RS 4
.nf
.fam C
MS Name/IP address\&         Stratum Poll Reach LastRx Last sample
===============================================================================
#* GPS0\&                          0\&   4\&   377\&    11\&   \-479ns[ \-621ns] +/\-\&  134ns
^? ntp1.example.net\&              2\&   6\&   377\&    23\&   \-923us[ \-924us] +/\-\&   43ms
^+ ntp2.example.net\&              1\&   6\&   377\&    21\&  \-2629us[\-2619us] +/\-\&   86ms
.fam
.fi
.if n .RE
.sp
ستون‌ها به شرح زیر هستند:
.sp
\fBM\fP
.RS 4
این ستون حالت منبع را مشخص می‌کند. \fI^\fP نمایانگر سرور، \fI=\fP نمایانگر همتا (peer) و \fI#\fP نمایانگر یک ساعت مرجع متصل محلی است.
.RE
.sp
\fBS\fP
.RS 4
این ستون وضعیت گزینش منبع را مشخص می‌کند.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fI*\fP نشان‌دهنده بهترین منبعی است که در حال حاضر برای همگام‌سازی برگزیده شده است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fI+\fP نشان‌دهنده سایر منابع برگزیده برای همگام‌سازی است که با بهترین منبع ترکیب می‌شوند.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fI\-\fP نشان‌دهنده منبعی است که برای همگام‌سازی قابل انتخاب در نظر گرفته می‌شود، اما در حال حاضر برگزیده نشده است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIx\fP نشان‌دهنده منبعی است که \fBchronyd\fP آن را خطاسنج (falseticker) تلقی می‌کند (یعنی زمان آن با اکثریت منابع دیگر یا منابع مشخص‌شده با گزینه \fBtrust\fP ناهمخوان است).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fI~\fP نشان‌دهنده منبعی است که زمان آن تغییرپذیری و نوسان بیش از حدی دارد.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fI?\fP نشان‌دهنده منبعی است که به دلایل دیگر (مانند غیرقابل دسترس بودن، همگام نبودن، یا نداشتن داده‌های اندازه‌گیری کافی) برای همگام‌سازی قابل انتخاب در نظر گرفته نمی‌شود.
.RE
.RE
.sp

.RS 4
برای دریافت جزئیات بیشتر درباره وضعیت گزینش می‌توان از دستور \fBselectdata\fP استفاده کرد.
.RE
.sp
\fBName/IP address\fP
.RS 4
این ستون نام یا نشانی IP منبع، یا شناسه مرجع (reference ID) را برای ساعت‌های مرجع نمایش می‌دهد.
.RE
.sp
\fBStratum\fP
.RS 4
این ستون لایه (stratum) منبع را همان‌گونه که در آخرین نمونه دریافتی گزارش شده، نمایش می‌دهد. لایه ۱ نشان‌دهنده رایانه‌ای با ساعت مرجع متصل محلی است. رایانه‌ای که با رایانه لایه ۱ همگام شده باشد در لایه ۲ قرار دارد. رایانه‌ای که با رایانه لایه ۲ همگام شده باشد در لایه ۳ است، و به همین ترتیب.
.RE
.sp
\fBPoll\fP
.RS 4
این ستون نرخ نظرسنجی از منبع را بر پایه لگاریتم مبنای ۲ بازه زمانی بر حسب ثانیه نمایش می‌دهد. بدین ترتیب، مقدار ۶ بیانگر انجام اندازه‌گیری در هر ۶۴ ثانیه است. \fBchronyd\fP با توجه به شرایط محیطی نرخ نظرسنجی را به صورت خودکار تغییر می‌دهد.
.RE
.sp
\fBReach\fP
.RS 4
این ستون ثبات دسترسی‌پذیری منبع را به صورت یک عدد اکتال (مبنای ۸) نمایش می‌دهد. این ثبات دارای ۸ بیت است؛ در هر نظرسنجی یک بیت به سمت چپ شیفت می‌خورد و با دریافت یک پاسخ معتبر NTP (یا صرفاً یک نمونه در مورد ساعت مرجع) از منبع، با ۱ به‌روزرسانی می‌شود. مقدار ۳۷۷ مشخص می‌کند که در تمام ۸ نظرسنجی اخیر پاسخ یا نمونه معتبری دریافت شده است. توجه داشته باشید که حتی اگر نمونه‌ها برای همگام‌سازی مناسب تشخیص داده نشده و نادیده گرفته شوند، ثبات دسترسی‌پذیری همچنان برای نظرسنجی آن‌ها مقدار ۱ خواهد داشت.
.RE
.sp
\fBLastRx\fP
.RS 4
این ستون مشخص می‌کند آخرین نمونه معتبر (که در ستون بعدی نمایش یافته) چه مدت پیش از منبع دریافت شده است. اندازه‌گیری‌هایی که در برخی آزمایش‌ها مردود شده‌اند نادیده گرفته می‌شوند. این مقدار معمولاً بر حسب ثانیه است. حروف \fIm\fP، \fIh\fP، \fId\fP یا \fIy\fP به ترتیب نشان‌دهنده دقیقه، ساعت، روز یا سال هستند.
.RE
.sp
\fBLast sample\fP
.RS 4
این ستون انحراف و جابه‌جایی (offset) بین ساعت محلی و منبع را در آخرین اندازه‌گیری نشان می‌دهد. عدد داخل قلاب‌ها انحراف اندازه‌گیری‌شده واقعی را نمایش می‌دهد. این مقدار می‌تواند دارای پسوندهای \fIns\fP (نانوثانیه)، \fIus\fP (میکروثانیه)، \fIms\fP (میلی‌ثانیه) یا \fIs\fP (ثانیه) باشد. عدد سمت چپ قلاب‌ها مقدار اندازه‌گیری اصلی را نشان می‌دهد که جهت اعمال تغییرات تدریجی نرخ ساعت (slews) بر ساعت محلی پس از آن زمان، تعدیل شده است. جابه‌جایی مثبت نشان‌دهنده جلوتر بودن ساعت محلی از منبع است. عدد پس از نشانگر \fI+/\-\fP میزان حاشیه خطای اندازه‌گیری (فاصله ریشه NTP یا root distance) را نمایش می‌دهد.
.RE
.RE
.sp
\fBsourcestats\fP [\fB\-a\fP] [\fB\-v\fP]
.RS 4
دستور \fBsourcestats\fP اطلاعات مربوط به نرخ رانش (drift rate) و فرایند برآورد جابه‌جایی را برای هر یک از منابعی که اکنون توسط \fBchronyd\fP در حال بررسی هستند نمایش می‌دهد.
.sp
اگر گزینه \fB\-a\fP مشخص شود، تمام منابع نمایش داده می‌شوند، از جمله آن‌هایی که هنوز نشانی شناخته‌شده‌ای ندارند. چنین منابعی شناسه‌ای با قالب \fIID#XXXXXXXXXX\fP دارند که می‌توان در دستورهای دیگری که نیازمند نشانی منبع هستند از آن بهره برد.
.sp
گزینه \fB\-v\fP خروجی پرجزئیات را فعال می‌کند. در این حالت، سطرهای عنوان اضافی به عنوان یادآوری مفهوم هر ستون نمایش داده می‌شوند.
.sp
یک نمونه گزارش به شرح زیر است:
.sp
.if n .RS 4
.nf
.fam C
Name/IP Address\&            NP\&  NR\&  Span\&  Frequency\&  Freq Skew\&  Offset\&  Std Dev
===============================================================================
ntp1.example.net\&           11\&   5\&   46m\&     \-0.001\&      0.045\&      1us\&    25us
.fam
.fi
.if n .RE
.sp
ستون‌ها به شرح زیر هستند:
.sp
\fBName/IP Address\fP
.RS 4
این ستون نام یا نشانی IP سرور NTP (یا همتا) یا شناسه مرجع ساعت مرجعی است که باقی سطر به آن تعلق دارد.
.RE
.sp
\fBNP\fP
.RS 4
این تعداد نقاط نمونه‌برداری است که در حال حاضر برای سرور ذخیره و نگهداری می‌شوند. نرخ رانش و جابه‌جایی فعلی از طریق انجام رگرسیون خطی روی این نقاط برآورد می‌گردند.
.RE
.sp
\fBNR\fP
.RS 4
این تعداد دوره‌های باقیمانده‌ها (runs of residuals) با علامت یکسان پس از آخرین رگرسیون است. اگر این عدد نسبت به شمار نمونه‌ها بیش از اندازه کوچک شود، مشخص می‌کند که خط مستقیم دیگر انطباق و برازش خوبی روی داده‌ها ندارد. در صورتی که تعداد دوره‌ها خیلی کم باشد، \fBchronyd\fP نمونه‌های قدیمی‌تر را کنار گذاشته و رگرسیون را مجدداً اجرا می‌کند تا تعداد دوره‌ها به مقداری قابل قبول برسد.
.RE
.sp
\fBSpan\fP
.RS 4
این بازه زمانی میان کهنه‌ترین و تازه‌ترین نمونه است. اگر واحدی درج نشده باشد مقدار بر حسب ثانیه است. در نمونه ارائه‌شده، این بازه ۴۶ دقیقه است.
.RE
.sp
\fBFrequency\fP
.RS 4
این بسامد باقیمانده برآورد‌شده برای سرور بر حسب بخش در میلیون (ppm) است. در این مورد، برآورد شده که ساعت رایانه به میزان ۱ واحد در ۱۰^۹ نسبت به سرور عقب می‌افتد.
.RE
.sp
\fBFreq Skew\fP
.RS 4
این کران خطای برآورد‌شده روی \fBFreq\fP است (باز هم بر حسب بخش در میلیون).
.RE
.sp
\fBOffset\fP
.RS 4
این مقدار جابه‌جایی برآورد‌شده منبع است.
.RE
.sp
\fBStd Dev\fP
.RS 4
این انحراف معیار نمونه برآورد‌شده است.
.RE
.RE
.sp
\fBselectdata\fP [\fB\-a\fP] [\fB\-v\fP]
.RS 4
دستور \fBselectdata\fP اطلاعات ویژه مربوط به گزینش منابع زمانی را نمایش می‌دهد. با مشخص شدن گزینه \fB\-a\fP، تمامی منابع از جمله منابع بدون نشانی شناخته‌شده نمایش می‌یابند. با گزینه \fB\-v\fP نیز سطرهای عنوان اضافی به عنوان یادآوری مفهوم هر ستون افزوده می‌شوند.
.sp
نمونه‌ای از خروجی در زیر نمایش داده شده است.
.sp
.if n .RS 4
.nf
.fam C
S Name/IP Address\&        Auth COpts EOpts Last Score\&     Interval\&  Leap
=======================================================================
D ntp1.example.net\&          Y \-\-\-\-\- \-\-TR\-\&    4\&   1.0\&   \-61ms\&   +62ms\&  N
* ntp2.example.net\&          N \-\-\-\-\- \-\-\-\-\-\&    0\&   1.0 \-6846us +7305us\&  N
+ ntp3.example.net\&          N \-\-\-\-\- \-\-\-\-\-\&   10\&   1.0 \-7381us +7355us\&  N
.fam
.fi
.if n .RE
.sp
ستون‌ها به شرح زیر هستند:
.sp
\fBS\fP
.RS 4
این ستون وضعیت منبع پس از آخرین فرایند گزینش منبع را نمایش می‌دهد. این وضعیت مشابه وضعیت گزارش‌شده در دستور \fBsources\fP است، با این تفاوت که حالات بیشتری در اینجا گزارش می‌شوند.
.RE
.sp

.RS 4
حالات زیر نشان‌دهنده آن هستند که منبع برای همگام‌سازی قابل انتخاب دانسته نمی‌شود:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIN\fP \- دارای گزینه \fBnoselect\fP است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIM\fP \- اندازه‌گیری‌های کافی در اختیار ندارد.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIs\fP \- همگام‌سازی نشده است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fId\fP \- فاصله ریشه‌ای بزرگ‌تر از بیشینه فاصله مجاز دارد (که با دستورالعمل \fBmaxdistance\fP پیکربندی می‌شود).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fI~\fP \- نوسان و لرزش (jitter) بزرگ‌تر از بیشینه مجاز دارد (که توسط دستورالعمل \fBmaxjitter\fP پیکربندی می‌شود).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIw\fP \- منتظر سایر منابع می‌ماند تا از وضعیت \fIM\fP خارج شوند.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIS\fP \- فقط دارای اندازه‌گیری‌های کهنه‌تر از منابع در دسترس است، یا برای نظرسنجی‌های پیاپی زیادی در دسترس نبوده است (پیکربندی‌شده با گزینه \fBmaxunreach\fP).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIO\fP \- دارای لایه‌ای مساوی یا بالاتر از لایه یتیم (orphan stratum) است (که توسط دستورالعمل \fBlocal\fP پیکربندی می‌شود).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIT\fP \- با منابعی که دارای گزینه \fBtrust\fP هستند انطباق کامل ندارد.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIx\fP \- با منابع دیگر انطباق و سازگاری ندارد (خطاسنج یا falseticker).
.RE
.RE
.sp

.RS 4
حالات زیر نشان‌دهنده آن هستند که منبع قابل انتخاب در نظر گرفته شده، اما هم‌اکنون برای همگام‌سازی استفاده نمی‌شود:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIW\fP \- منتظر می‌ماند تا منابع دیگر قابل گزینش شوند (لازم دانسته شده توسط دستورالعمل \fBminsources\fP یا گزینه \fBrequire\fP منبعی دیگر).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIP\fP \- منبع قابل گزینش دیگری به دلیل داشتن گزینه \fBprefer\fP ترجیح داده شده است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIU\fP \- در انتظار اندازه‌گیری جدید است (پس از گزینش یک منبع برتر متفاوت).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fID\fP \- فاصله ریشه‌ای دارد (یا اخیراً داشته) که برای ترکیب شدن با منابع دیگر بسیار بزرگ است (پیکربندی‌شده با دستورالعمل \fBcombinelimit\fP).
.RE
.RE
.sp

.RS 4
حالات زیر نشان‌دهنده این هستند که منبع برای همگام‌سازی ساعت محلی به کار می‌رود:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fI+\fP \- با بهترین منبع ترکیب شده است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fI*\fP \- به عنوان بهترین منبع برای به‌روزرسانی داده‌های مرجع (مانند تأخیر ریشه، پراکندگی ریشه) برگزیده شده است.
.RE
.RE
.sp
\fBName/IP address\fP
.RS 4
این ستون نام یا نشانی IP منبع را در صورت بودن یک سرور NTP، یا شناسه مرجع را در صورت بودن یک ساعت مرجع نمایش می‌دهد.
.RE
.sp
\fBAuth\fP
.RS 4
این ستون فعال بودن یا نبودن سازوکار احراز هویت را برای منبع تعیین می‌کند. \fIY\fP نشان‌دهنده بله و \fIN\fP نشان‌دهنده خیر است.
.RE
.sp
\fBCOpts\fP
.RS 4
این ستون گزینه‌های گزینش پیکربندی‌شده برای منبع را نمایش می‌دهد.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIN\fP نمایانگر گزینه \fBnoselect\fP است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIP\fP نمایانگر گزینه \fBprefer\fP است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIT\fP نمایانگر گزینه \fBtrust\fP است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIR\fP نمایانگر گزینه \fBrequire\fP است.
.RE
.RE
.sp
\fBEOpts\fP
.RS 4
این ستون گزینه‌های گزینش مؤثر و فعال کنونی منبع را نمایش می‌دهد، که ممکن است به دلیل حالت گزینش احراز هویت (پیکربندی‌شده توسط دستورالعمل \fBauthselectmode\fP) با گزینه‌های پیکربندی‌شده تفاوت داشته باشد. نشانه‌ها همانند ستون \fBCOpts\fP هستند.
.RE
.sp
\fBLast\fP
.RS 4
این ستون نشان می‌دهد در زمان انجام گزینش، آخرین اندازه‌گیری منبع چه مدت پیش رخ داده است.
.RE
.sp
\fBScore\fP
.RS 4
این ستون امتیاز کنونی در برابر منبع موجود در وضعیت \fI*\fP را نشان می‌دهد. سیستم امتیازدهی مانع از تغییر مکرر و بی‌رویه منبع زمانی می‌شود که چندین منبع دارای فاصله ریشه نزدیک به هم باشند. مقداری بیش از ۱ نشان‌دهنده برتری این منبع نسبت به منبع \fI*\fP در گزینش‌های اخیر است. با رسیدن امتیاز به ۱۰، بهترین منبع بازگزینی شده و امتیازها به ۱ بازنشانی می‌شوند.
.RE
.sp
\fBInterval\fP
.RS 4
این ستون کران پایین و بالای بازه‌ای را نشان می‌دهد که انتظار می‌رفت با در نظر گرفتن فاصله ریشه در هنگام گزینش، شامل جابه‌جایی واقعی ساعت محلی باشد.
.RE
.sp
\fBLeap\fP
.RS 4
این ستون وضعیت کنونی ثانیه کبیسه منبع را نمایش می‌دهد.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIN\fP نمایانگر وضعیت عادی (بدون ثانیه کبیسه) است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fI+\fP نشان می‌دهد یک ثانیه کبیسه در انتهای ماه افزوده خواهد شد.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fI\-\fP نشان می‌دهد یک ثانیه کبیسه در پایان ماه کاسته خواهد شد.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fI?\fP نشان‌دهنده وضعیت نامعلوم است (هیچ اندازه‌گیری معتبری انجام نشده است).
.RE
.RE
.RE
.sp
\fBselectopts\fP \fIaddress|refid\fP [\fI+|\-option\fP].\|.\|.
.RS 4
دستور \fBselectopts\fP گزینه‌های گزینش پیکربندی‌شده یک منبع NTP مشخص‌شده با نشانی IP (یا شناسه \fIID#XXXXXXXXXX\fP به کار رفته برای نشانی‌های ناشناخته)، یا یک ساعت مرجع با شناسه مرجع رشته‌ای را تغییر می‌دهد.
.sp
گزینه‌های گزینش را می‌توان با نشانه \fB+\fP افزود یا با نشانه \fB\-\fP حذف کرد. از دستور \fBselectdata\fP می‌توان برای راستی‌آزمایی پیکربندی بهره گرفت. گزینه‌های ویرایش‌شده در گزینش منبع بعدی، برای مثال هنگامی که یک اندازه‌گیری تازه ثبت شود یا دستور \fBreselect\fP اجرا گردد، اعمال خواهند شد.
.sp
یک نمونه استفاده از این دستور در ادامه آمده است.
.sp
.if n .RS 4
.nf
.fam C
selectopts 1.2.3.4 \-noselect +prefer
selectopts GPS +trust
.fam
.fi
.if n .RE
.RE
.sp
\fBreselect\fP
.RS 4
جهت پیشگیری از جابه‌جایی بیش از حد بین منابع، \fBchronyd\fP می‌تواند همگام‌سازی با یک منبع را حفظ کند حتی اگر آن منبع در لحظه حاضر بهترین مورد در میان گزینه‌های موجود نباشد.
.sp
دستور \fBreselect\fP برای واداشتن \fBchronyd\fP به گزینش مجدد بهترین منبع همگام‌سازی کاربرد دارد.
.RE
.sp
\fBreselectdist\fP \fIdistance\fP
.RS 4
دستور \fBreselectdist\fP فاصله گزینش مجدد را تنظیم می‌کند. این دستور هم‌ارز دستورالعمل \fBreselectdist\fP در پرونده پیکربندی است.
.RE
.sp
\fBoffset\fP \fIaddress|refid\fP \fIoffset\fP
.RS 4
دستور \fBoffset\fP مقدار تصحیح جابه‌جایی منبع NTP مشخص‌شده با نشانی IP (یا شناسه \fIID#XXXXXXXXXX\fP به کار رفته برای نشانی‌های ناشناخته)، یا یک ساعت مرجع مشخص با شناسه مرجع رشته‌ای را تعدیل می‌نماید. این دستور به ترتیب هم‌ارز گزینه \fBoffset\fP در دستورالعمل‌های \fBserver\fP یا \fBrefclock\fP می‌باشد.
.RE
.SS "منابع NTP (NTP sources)"
.sp
\fBactivity\fP
.RS 4
این دستور تعداد سرورها و همتایانی (peers) را که برخط و برون‌خط هستند گزارش
می‌دهد. اگر گزینه \fBauto_offline\fP در تعیین برخی از سرورها یا همتایان به کار
رفته باشد، دستور \fBactivity\fP می‌تواند برای تشخیص زمانی که همگی آن‌ها پس از قطع
اتصال شبکه وارد وضعیت برون‌خط شده‌اند مفید باشد.
.sp
این گزارش تعداد سرورها و همتایان را در ۵ وضعیت نشان می‌دهد:
.sp
\fBonline\fP
.RS 4
سرور یا همتا در حال حاضر برخط است (یعنی از نظر \fBchronyd\fP در دسترس فرض می‌شود)
.RE
.sp
\fBoffline\fP
.RS 4
سرور یا همتا در حال حاضر برون‌خط است (یعنی از نظر \fBchronyd\fP غیرقابل دسترس فرض
می‌شود و هیچ سنجشی از آن انجام نخواهد شد.)
.RE
.sp
\fBburst_online\fP
.RS 4
دستور burst برای سرور یا همتا آغاز شده و در حال انجام است؛ پس از اتمام
رگبار، سرور یا همتا به وضعیت برخط بازگردانده خواهد شد.
.RE
.sp
\fBburst_offline\fP
.RS 4
دستور burst برای سرور یا همتا آغاز شده و در حال انجام است؛ پس از اتمام
رگبار، سرور یا همتا به وضعیت برون‌خط بازگردانده خواهد شد.
.RE
.sp
\fBunresolved\fP
.RS 4
نام سرور یا همتا هنوز به یک نشانی حل‌وفصل نشده است؛ این منبع در گزارش‌های
\fBsources\fP و \fBsourcestats\fP قابل مشاهده نیست.
.RE
.RE
.sp
\fBauthdata\fP [\fB\-a\fP]
.RS 4
دستور \fBauthdata\fP اطلاعات مختص احراز هویت منابع NTP را نمایش می‌دهد. اگر
گزینه \fB\-a\fP مشخص شود، همه منابع نمایش داده می‌شوند، از جمله آن‌هایی که هنوز
نشانی شناخته‌شده‌ای ندارند. نمونه‌ای از خروجی در زیر نشان داده شده است.
.sp
.if n .RS 4
.nf
.fam C
Name/IP address\&             Mode KeyID Type KLen Last Atmp\&  NAK Cook CLen
=========================================================================
ntp1.example.net\&             NTS\&     1\&   15\&  256 135m\&    0\&    0\&    8\&  100
ntp2.example.net\&              SK\&    30\&   13\&  128\&    \-\&    0\&    0\&    0\&    0
ntp3.example.net\&               \-\&     0\&    0\&    0\&    \-\&    0\&    0\&    0\&    0
.fam
.fi
.if n .RE
.sp
ستون‌ها به شرح زیر هستند:
.sp
\fBName/IP address\fP
.RS 4
این ستون نام یا نشانی IP منبع را نشان می‌دهد.
.RE
.sp
\fBMode\fP
.RS 4
این ستون نشان می‌دهد چه سازوکاری بسته‌های NTP دریافت‌شده از منبع را احراز هویت
می‌کند. \fINTS\fP به معنای امنیت زمان شبکه (Network Time Security)، \fISK\fP به معنای کلید
متقارن (symmetric key)، و \fI\-\fP به معنای غیرفعال بودن احراز هویت است.
.RE
.sp
\fBKeyID\fP
.RS 4
این ستون شناسه‌ای از کلید استفاده‌شده برای احراز هویت را نشان می‌دهد. در مورد
کلید متقارن، این همان شناسه موجود در فایل کلید است.
در مورد NTS، عددی است که از صفر شروع شده و با هر برقراری موفق کلید با استفاده از
پروتکل NTS\-KE یکی افزایش می‌یابد؛ یعنی نشان می‌دهد چند بار برقراری کلید با این
منبع انجام شده است.
.RE
.sp
\fBType\fP
.RS 4
این ستون شناسه‌ای از الگوریتم مورد استفاده برای احراز هویت را نشان می‌دهد.
در مورد کلید متقارن، تابع درهم‌سازی یا رمز تعیین‌شده در فایل کلید است.
در مورد NTS، الگوریتم رمزنگاری احراز هویت‌شده با داده‌های مرتبط (AEAD) است
که در پروتکل NTS\-KE توافق می‌شود. مقادیر زیر می‌توانند گزارش شوند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
1: MD5
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
2: SHA1
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
3: SHA256
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
4: SHA384
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
5: SHA512
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
6: SHA3\-224
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
7: SHA3\-256
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
8: SHA3\-384
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
9: SHA3\-512
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
10: TIGER
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
11: WHIRLPOOL
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
13: AES128
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
14: AES256
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
15: AEAD\-AES\-SIV\-CMAC\-256
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
30: AEAD\-AES\-128\-GCM\-SIV
.RE
.RE
.sp
\fBKLen\fP
.RS 4
این ستون طول کلید را بر حسب بیت نشان می‌دهد.
.RE
.sp
\fBLast\fP
.RS 4
این ستون نشان می‌دهد چه مدت پیش آخرین برقراری موفق کلید انجام شده است.
این مقدار بر حسب ثانیه است، یا حروف \fIm\fP، \fIh\fP، \fId\fP یا \fIy\fP نشان‌دهنده دقیقه،
ساعت، روز یا سال هستند.
.RE
.sp
\fBAtmp\fP
.RS 4
این ستون تعداد دفعات تلاش برای برقراری کلید از زمان آخرین برقراری موفق
کلید را نشان می‌دهد. عددی بزرگ‌تر از ۱ نشان‌دهنده مشکلی در شبکه یا سرور است.
.RE
.sp
\fBNAK\fP
.RS 4
این ستون نشان می‌دهد آیا یک NTS NAK از زمان آخرین درخواست دریافت شده است یا خیر.
یک NAK نشان می‌دهد احراز هویت در سمت سرور به دلیل استفاده \fBchronyd\fP از کوکی‌ای که
دیگر معتبر نیست ناموفق بوده است و باید برای دریافت کوکی‌های جدید دوباره برقراری کلید
را انجام دهد.
.RE
.sp
\fBCook\fP
.RS 4
این ستون تعداد کوکی‌های NTS را که \fBchronyd\fP در حال حاضر در اختیار دارد نشان می‌دهد.
اگر برقراری کلید موفقیت‌آمیز بوده باشد، عددی کوچک‌تر از ۸ نشان‌دهنده مشکلی در شبکه یا
سرور است.
.RE
.sp
\fBCLen\fP
.RS 4
این ستون طول کوکی NTS را که در درخواست بعدی استفاده خواهد شد، بر حسب بایت
نشان می‌دهد.
.RE
.RE
.sp
\fBntpdata\fP [\fIaddress\fP]
.RS 4
دستور \fBntpdata\fP آخرین سنجش معتبر و سایر اطلاعات اختصاصی NTP را درباره
منبع NTP مشخص‌شده، یا تمام منابع NTP (با نشانی شناخته‌شده) در صورت عدم تعیین
نشانی، نمایش می‌دهد. نمونه‌ای از خروجی در زیر نشان داده شده است.
.sp
.if n .RS 4
.nf
.fam C
Remote address\&  : 203.0.113.15 (CB00710F)
Remote port\&     : 123
Local address\&   : 203.0.113.74 (CB00714A)
Leap status\&     : Normal
Version\&         : 4
Mode\&            : Server
Stratum\&         : 1
Poll interval\&   : 10 (1024 seconds)
Precision\&       : \-24 (0.000000060 seconds)
Root delay\&      : 0.000015 seconds
Root dispersion : 0.000015 seconds
Reference ID\&    : 47505300 (GPS)
Reference time\&  : Fri Nov 25 15:22:12 2016
Offset\&          : \-0.000060878 seconds
Peer delay\&      : 0.000175634 seconds
Peer dispersion : 0.000000681 seconds
Response time\&   : 0.000053050 seconds
Jitter asymmetry: +0.00
NTP tests\&       : 111 111 1111
Interleaved\&     : No
Authenticated\&   : No
TX timestamping : Kernel
RX timestamping : Kernel
Total TX\&        : 24
Total RX\&        : 24
Total valid RX\&  : 24
Total good RX\&   : 22
Total kernel TX : 24
Total kernel RX : 24
Total HW TX\&     : 0
Total HW RX\&     : 0
.fam
.fi
.if n .RE
.sp
فیلدها به شرح زیر توضیح داده می‌شوند:
.sp
\fBRemote address\fP
.RS 4
نشانی IP سرور یا همتای NTP، و شناسه مرجع (reference ID) متناظر.
.RE
.sp
\fBRemote port\fP
.RS 4
شماره درگاه UDP که درخواست به آن ارسال شده است. درگاه استاندارد NTP شماره
۱۲۳ است.
.RE
.sp
\fBLocal address\fP
.RS 4
نشانی IP محلی که پاسخ را دریافت کرده است، و شناسه مرجع متناظر.
.RE
.sp
\fBLeap status\fP, \fBVersion\fP, \fBMode\fP, \fBStratum\fP, \fBPoll interval\fP, \fBPrecision\fP, \fBRoot delay\fP, \fBRoot dispersion\fP, \fBReference ID\fP, \fBReference time\fP
.RS 4
مقادیر NTP از آخرین پاسخ معتبر.
.RE
.sp
\fBOffset\fP, \fBPeer delay\fP, \fBPeer dispersion\fP
.RS 4
مقادیر اندازه‌گیری‌شده.
.RE
.sp
\fBResponse time\fP
.RS 4
مدت زمانی که سرور یا همتا صرف پردازش درخواست و انتظار پیش از ارسال پاسخ کرده است.
.RE
.sp
\fBJitter asymmetry\fP
.RS 4
عدم تقارن برآوردشده لرزش (jitter) شبکه در مسیر به سمت منبع. این عدم تقارن
می‌تواند بین \-0.5 و 0.5 باشد. مقدار منفی بدین معناست که تاخیر بسته‌های ارسالی
به منبع، متغیرتر از تاخیر بسته‌های بازگشتی از منبع است.
.RE
.sp
\fBNTP tests\fP
.RS 4
نتایج آزمون‌های ۱ تا ۳ و ۵ تا ۷ از RFC 5905، و آزمون‌های بیشینه تاخیر، نسبت
تاخیر، نسبت انحراف تاخیر (یا چندک تاخیر)، و حلقه همگام‌سازی.
.RE
.sp
\fBInterleaved\fP
.RS 4
نشان می‌دهد آیا پاسخ در حالت درهم‌بافته (interleaved mode) بوده است یا خیر.
.RE
.sp
\fBAuthenticated\fP
.RS 4
نشان می‌دهد آیا پاسخ احراز هویت شده است یا خیر.
.RE
.sp
\fBTX timestamping\fP
.RS 4
منبع برچسب زمانی ارسال محلی. مقادیر معتبر شامل \fIDaemon\fP،
\fIKernel\fP، و \fIHardware\fP هستند.
.RE
.sp
\fBRX timestamping\fP
.RS 4
منبع برچسب زمانی دریافت محلی.
.RE
.sp
\fBTotal TX\fP
.RS 4
تعداد بسته‌های ارسال‌شده به منبع.
.RE
.sp
\fBTotal RX\fP
.RS 4
تعداد تمام بسته‌های دریافت‌شده از منبع.
.RE
.sp
\fBTotal valid RX\fP
.RS 4
تعداد بسته‌هایی که از دو گروه اول آزمون‌های NTP با موفقیت عبور کرده‌اند.
.RE
.sp
\fBTotal good RX\fP
.RS 4
تعداد بسته‌هایی که از هر سه گروه آزمون‌های NTP عبور کرده‌اند، یعنی سنجش
NTP پذیرفته شده است.
.RE
.sp
\fBTotal kernel TX\fP
.RS 4
تعداد بسته‌های ارسالی به منبع که برچسب زمانی آن‌ها توسط هسته ثبت شده است.
.RE
.sp
\fBTotal kernel RX\fP
.RS 4
تعداد بسته‌های دریافتی از منبع که برچسب زمانی آن‌ها توسط هسته ثبت شده است.
.RE
.sp
\fBTotal HW TX\fP
.RS 4
تعداد بسته‌های ارسالی به منبع که برچسب زمانی آن‌ها توسط کارت شبکه (NIC) ثبت شده است.
.RE
.sp
\fBTotal HW RX\fP
.RS 4
تعداد بسته‌های دریافتی از منبع که برچسب زمانی آن‌ها توسط کارت شبکه (NIC) ثبت شده است.
.RE
.RE
.sp
\fBadd peer\fP \fIname\fP [\fIoption\fP].\|.\|.
.RS 4
دستور \fBadd peer\fP اجازه می‌دهد یک همتای NTP جدید در حین اجرای
\fBchronyd\fP اضافه شود.
.sp
پس از عبارت \fBadd peer\fP، نحو پارامترها و گزینه‌های بعدی دقیقاً مشابه با
دستورالعمل \fBpeer\fP در فایل پیکربندی است.
.sp
نمونه‌ای از استفاده از این دستور در زیر نشان داده شده است.
.sp
.if n .RS 4
.nf
.fam C
add peer ntp1.example.net minpoll 6 maxpoll 10 key 25
.fam
.fi
.if n .RE
.RE
.sp
\fBadd pool\fP \fIname\fP [\fIoption\fP].\|.\|.
.RS 4
دستور \fBadd pool\fP اجازه می‌دهد یک استخر (pool) از سرورهای NTP در حین اجرای
\fBchronyd\fP افزوده شود.
.sp
پس از عبارت \fBadd pool\fP، نحو پارامترها و گزینه‌های بعدی دقیقاً مشابه با
دستورالعمل \fBpool\fP در فایل پیکربندی است.
.sp
نمونه‌ای از استفاده از این دستور در زیر نشان داده شده است:
.sp
.if n .RS 4
.nf
.fam C
add pool ntp1.example.net maxsources 3 iburst
.fam
.fi
.if n .RE
.RE
.sp
\fBadd server\fP \fIname\fP [\fIoption\fP].\|.\|.
.RS 4
دستور \fBadd server\fP اجازه می‌دهد یک سرور جدید NTP در حین اجرای
\fBchronyd\fP افزوده شود.
.sp
پس از عبارت \fBadd server\fP، نحو پارامترها و گزینه‌های بعدی دقیقاً مشابه با
دستورالعمل \fBserver\fP در فایل پیکربندی است.
.sp
نمونه‌ای از استفاده از این دستور در زیر نشان داده شده است:
.sp
.if n .RS 4
.nf
.fam C
add server ntp1.example.net minpoll 6 maxpoll 10 key 25
.fam
.fi
.if n .RE
.RE
.sp
\fBdelete\fP \fIaddress\fP
.RS 4
دستور \fBdelete\fP اجازه می‌دهد یک سرور یا همتای NTP از مجموعه فعلی منابع
حذف شود.
.RE
.sp
\fBburst\fP \fIgood\fP/\fImax\fP [\fImask\fP/\fImasked\-address\fP], \fBburst\fP \fIgood\fP/\fImax\fP [\fImasked\-address\fP/\fImasked\-bits\fP], \fBburst\fP \fIgood\fP/\fImax\fP [\fIaddress\fP]
.RS 4
دستور \fBburst\fP به \fBchronyd\fP اعلام می‌کند که مجموعه‌ای از سنجش‌ها را در بازه
زمانی کوتاهی برای هر یک از منابع NTP خود به انجام رساند (به جای سنجش‌های دوره‌ای
معمول که انجام می‌دهد). پس از چنین رگباری، \fBchronyd\fP برای هر منبع به وضعیت قبلی
بازمی‌گردد. این وضعیت می‌تواند برخط باشد (اگر منبع به صورت معمول و دوره‌ای سنجیده
می‌شد) یا برون‌خط (اگر منبع به عنوان برون‌خط مشخص شده بود). (یک منبع می‌تواند با
دستورهای \fBonline\fP و \fBoffline\fP میان وضعیت‌های برخط و برون‌خط جابه‌جا شود.)
.sp
آرگومان‌های \fImask\fP و \fImasked\-address\fP اختیاری هستند، که در این صورت \fBchronyd\fP
یک رگبار برای تمام منابع تعریف‌شده فعلی خود آغاز می‌کند.
.sp
آرگومان‌ها معنا و قالب زیر را دارند:
.sp
\fIgood\fP
.RS 4
این پارامتر تعداد سنجش‌های مناسبی را مشخص می‌کند که \fBchronyd\fP مایل است از هر
منبع به دست آورد. یک سنجش در صورتی مناسب است که از آزمون‌های معینی عبور کند؛ برای
مثال، زمان رفت‌وبرگشت به منبع باید قابل قبول باشد. (این کار به \fBchronyd\fP امکان می‌دهد
سنجش‌هایی را که احتمالاً نادرست یا جعلی هستند رد کند.)
.RE
.sp
\fImax\fP
.RS 4
این پارامتر بیشینه تعداد سنجش‌هایی را مشخص می‌کند که \fBchronyd\fP حتی در صورت عدم
دستیابی به تعداد مورد نیاز سنجش‌های مناسب، تلاش خواهد کرد به انجام رساند.
.RE
.sp
\fImask\fP
.RS 4
این یک نشانی IP است که نشانی IP هر یک از منابع \fBchronyd\fP\*(Aqs با آن ماسک می‌شود.
.RE
.sp
\fImasked\-address\fP
.RS 4
این یک نشانی IP است. اگر نشانی IP ماسک‌شده یک منبع با این مقدار همخوانی داشته
باشد، دستور burst بر آن منبع اعمال می‌شود.
.RE
.sp
\fImasked\-bits\fP
.RS 4
این پارامتر می‌تواند همراه با \fImasked\-address\fP برای نمادگذاری CIDR استفاده شود،
که جایگزین کوتاه‌تری برای شکل با mask است.
.RE
.sp
\fIaddress\fP
.RS 4
این یک نشانی IP یا یک نام میزبان است. دستور burst تنها بر همان منبع اعمال
می‌شود.
.RE
.RE
.sp

.RS 4
.sp
اگر هیچ آرگومان \fImask\fP یا \fImasked\-address\fP ارائه نشود، تمام منابع منطبق
خواهند شد.
.sp
نمونه‌ای از شکل دوآرگومانی این دستور:
.sp
.if n .RS 4
.nf
.fam C
burst 2/10
.fam
.fi
.if n .RE
.sp
این دستور باعث می‌شود \fBchronyd\fP تلاش کند دو سنجش مناسب از هر منبع به دست آورد،
و پس از دستیابی به دو مورد متوقف شود، اما در هیچ شرایطی بیش از ده کاوش به سمت منبع
تلاش نخواهد کرد.
.sp
نمونه‌هایی از شکل چهارآرگومانی این دستور:
.sp
.if n .RS 4
.nf
.fam C
burst 2/10 255.255.0.0/1.2.0.0
burst 2/10 2001:db8:789a::/48
.fam
.fi
.if n .RE
.sp
در حالت اول، نمونه‌برداری ۲ از ۱۰ تنها بر منابعی اعمال می‌شود که نشانی IPv4 آن‌ها به
شکل \fI1.2.x.y\fP باشد، که در آن \fIx\fP و \fIy\fP دلخواه هستند. در حالت دوم،
نمونه‌برداری بر منابعی اعمال می‌شود که ۴۸ بیت نخست نشانی IPv6 آن‌ها برابر با
\fI2001:db8:789a\fP باشد.
.sp
نمونه‌ای از شکل سه‌آرگومانی این دستور:
.sp
.if n .RS 4
.nf
.fam C
burst 2/10 ntp1.example.net
.fam
.fi
.if n .RE
.RE
.sp
\fBmaxdelay\fP \fIaddress\fP \fIdelay\fP
.RS 4
این امکان را فراهم می‌کند که گزینه \fBmaxdelay\fP برای یکی از منابع اصلاح شود،
مشابه تعیین گزینه \fBmaxdelay\fP برای دستورالعمل \fBserver\fP در فایل پیکربندی.
.RE
.sp
\fBmaxdelaydevratio\fP \fIaddress\fP \fIratio\fP
.RS 4
این امکان را فراهم می‌کند که گزینه \fBmaxdelaydevratio\fP برای یکی از منابع اصلاح
شود، مشابه تعیین گزینه \fBmaxdelaydevratio\fP برای دستورالعمل \fBserver\fP در
فایل پیکربندی.
.RE
.sp
\fBmaxdelayratio\fP \fIaddress\fP \fIratio\fP
.RS 4
این امکان را فراهم می‌کند که گزینه \fBmaxdelayratio\fP برای یکی از منابع اصلاح شود،
مشابه تعیین گزینه \fBmaxdelayratio\fP برای دستورالعمل \fBserver\fP در فایل
پیکربندی.
.RE
.sp
\fBmaxpoll\fP \fIaddress\fP \fImaxpoll\fP
.RS 4
دستور \fBmaxpoll\fP برای اصلاح بیشینه بازه نظرسنجی (polling) برای یکی از منابع
مجموعه فعلی استفاده می‌شود. این معادل گزینه \fBmaxpoll\fP در دستورالعمل \fBserver\fP در
فایل پیکربندی است.
.sp
توجه داشته باشید که بیشینه بازه نظرسنجی جدید تنها پس از انجام سنجش بعدی اعمال
می‌شود.
.RE
.sp
\fBminpoll\fP \fIaddress\fP \fIminpoll\fP
.RS 4
دستور \fBminpoll\fP برای اصلاح کمینه بازه نظرسنجی (polling) برای یکی از منابع مجموعه
فعلی استفاده می‌شود. این معادل گزینه \fBminpoll\fP در دستورالعمل \fBserver\fP در فایل
پیکربندی است.
.sp
توجه داشته باشید که کمینه بازه نظرسنجی جدید تنها پس از انجام سنجش بعدی اعمال
می‌شود.
.RE
.sp
\fBminstratum\fP \fIaddress\fP \fIminstratum\fP
.RS 4
دستور \fBminstratum\fP برای اصلاح لایه (stratum) کمینه برای یکی از منابع مجموعه فعلی
استفاده می‌شود. این معادل گزینه \fBminstratum\fP در دستورالعمل \fBserver\fP در فایل
پیکربندی است.
.RE
.sp
\fBoffline\fP [\fIaddress\fP], \fBoffline\fP [\fImasked\-address\fP/\fImasked\-bits\fP], \fBoffline\fP [\fImask\fP/\fImasked\-address\fP]
.RS 4
دستور \fBoffline\fP برای هشدار به \fBchronyd\fP در مورد این‌که اتصال شبکه به یک یا چند
میزبان خاص در شرف قطع شدن است استفاده می‌شود، مثلاً در رایانه‌هایی با اتصال متناوب
به منابع زمانی خود.
.sp
مورد دیگر استفاده از \fBoffline\fP زمانی است که یک رایانه زمان را به گروهی محلی از
رایانه‌ها ارائه می‌دهد و اتصالی دائمی به سرورهای زمان واقعی در خارج از سازمان دارد.
با این حال، اتصال خارجی در ساعات مشخصی از روز بار ترافیکی سنگینی دارد و سنجش‌های
به‌دست‌آمده در آن زمان‌ها قابلیت اطمینان کمتری دارند. در این حالت، احتمالاً مفیدترین
روش تعیین نرخ تغییر یا شیب زمان در طول دوره‌های خلوت و حفظ حالت کل شبکه در دوره‌های
بار سنگین است. دستورهای \fBoffline\fP و \fBonline\fP می‌توانند برای دستیابی به این
هدف استفاده شوند.
.sp
چهار شکل از دستور \fBoffline\fP وجود دارد. شکل اول یک عامه‌ساز (wildcard) است، به معنای
همه منابع (شامل منابعی که هنوز نشانی شناخته‌شده‌ای ندارند). شکل دوم امکان تعیین یک
ماسک نشانی IP و یک نشانی ماسک‌شده را می‌دهد. شکل سوم از نمادگذاری CIDR استفاده می‌کند.
شکل چهارم از یک نشانی IP یا نام میزبان استفاده می‌کند. این حالت‌ها در زیر نشان داده
شده‌اند.
.sp
.if n .RS 4
.nf
.fam C
offline
offline 255.255.255.0/1.2.3.0
offline 2001:db8:789a::/48
offline ntp1.example.net
.fam
.fi
.if n .RE
.sp
شکل دوم بدین معناست که دستور \fBoffline\fP باید بر هر منبعی اعمال شود که نشانی IPv4
آن در زیرشبکه \fI1.2.3\fP باشد. (نشانی میزبان با ماسک به صورت منطقی AND می‌شود، و اگر
نتیجه با \fImasked\-address\fP مطابقت داشته باشد میزبان پردازش می‌شود.) شکل سوم بدین
معناست که دستور باید بر تمام منابعی اعمال شود که ۴۸ بیت نخست نشانی IPv6 آن‌ها برابر با
\fI2001:db8:789a\fP است. شکل چهارم بدین معناست که دستور تنها باید بر همان یک منبع
اعمال شود.
.sp
شکل عامه‌ساز نشانی معادل موارد زیر است:
.sp
.if n .RS 4
.nf
.fam C
offline 0.0.0.0/0.0.0.0
offline ::/0
.fam
.fi
.if n .RE
.RE
.sp
\fBonline\fP [\fIaddress\fP], \fBonline\fP [\fImasked\-address\fP/\fImasked\-bits\fP], \fBonline\fP [\fImask\fP/\fImasked\-address\fP]
.RS 4
دستور \fBonline\fP عملکردی برعکس دستور \fBoffline\fP دارد. این دستور برای مطلع ساختن
\fBchronyd\fP از برقراری مجدد اتصال شبکه به یک یا چند منبع خاص به کار می‌رود.
.sp
نحو این دستور با دستور \fBoffline\fP یکسان است.
.RE
.sp
\fBonoffline\fP
.RS 4
دستور \fBonoffline\fP به \fBchronyd\fP دستور می‌دهد که تمام منابع دارای نشانی شناخته‌شده را
مطابق با پیکربندی فعلی شبکه به وضعیت برخط یا برون‌خط تغییر دهد. یک منبع در صورتی برخط
در نظر گرفته می‌شود که ارسال درخواست به آن امکان‌پذیر باشد، یعنی یک مسیر (route) شبکه
به سمت آن منبع وجود داشته باشد.
.RE
.sp
\fBpolltarget\fP \fIaddress\fP \fIpolltarget\fP
.RS 4
دستور \fBpolltarget\fP برای اصلاح هدف نظرسنجی (poll target) برای یکی از منابع مجموعه
فعلی استفاده می‌شود. این معادل گزینه \fBpolltarget\fP در دستورالعمل \fBserver\fP در
فایل پیکربندی است.
.RE
.sp
\fBrefresh\fP
.RS 4
دستور \fBrefresh\fP می‌تواند برای وادار کردن \fBchronyd\fP به حل‌وفصل مجدد نام‌های منابع
NTP پیکربندی‌شده به نشانی‌های IP و جایگزینی هرگونه نشانی مفقود در فهرست نشانی‌های
حل‌شده استفاده شود.
.sp
منابعی که پاسخگویی را متوقف می‌کنند پس از ۸ بازه نظرسنجی به طور خودکار با نشانی‌های
به‌تازگی حل‌شده جایگزین می‌شوند. این دستور می‌تواند برای جایگزینی فوری آن‌ها به کار رود،
مثلاً پس از تعلیق و ازسرگیری کار ماشین در یک شبکه دیگر.
.sp
توجه داشته باشید که در مورد استخرهایی با بیش از ۱۶ نشانی، یا در صورتی که همه نشانی‌های
IPv4 یا IPv6 در یک پاسخ واحد DNS گنجانده نشده باشند (مانند pool.ntp.org)، این دستور
ممکن است نشانی‌ها را حتی در صورتی که هنوز در استخر هستند جایگزین کند.
.RE
.sp
\fBreload\fP \fBsources\fP
.RS 4
دستور \fBreload sources\fP باعث می‌شود \fBchronyd\fP تمام فایل‌های \fI*.sources\fP را
از دایرکتوری‌های مشخص‌شده توسط دستورالعمل \fBsourcedir\fP دوباره بخواند.
.sp
توجه داشته باشید که منابع تغییریافته (مثلاً تعیین‌شده با یک گزینه جدید) در حافظه اصلاح
نمی‌شوند. آن‌ها حذف شده و مجدداً افزوده می‌شوند، که باعث می‌شود سنجش‌های قدیمی را از
دست داده و وضعیت انتخاب آن‌ها بازنشانی شود.
.RE
.sp
\fBsourcename\fP \fIaddress\fP
.RS 4
دستور \fBsourcename\fP نام میزبان اصلی یا نشانی‌ای را که برای یک منبع NTP در فایل
پیکربندی یا دستور \fBadd\fP مشخص شده بود چاپ می‌کند. این دستور جایگزینی برای گزینه
\fB\-N\fP است که می‌تواند در اسکریپت‌ها مفید باشد.
.sp
توجه داشته باشید که منابع NTP مختلف می‌توانند نام یکسانی داشته باشند، مانند سرورهای یک
استخر (pool).
.RE
.SS "ورود دستی زمان (Manual time input)"
.sp
\fBmanual\fP \fBon\fP, \fBmanual\fP \fBoff\fP, \fBmanual\fP \fBdelete\fP \fIindex\fP, \fBmanual\fP \fBlist\fP, \fBmanual\fP \fBreset\fP
.RS 4
دستور manual استفاده از دستور \fBsettime\fP را فعال و غیرفعال می‌کند و برای اصلاح رفتار درایور ساعت دستی به کار می‌رود\&.
.sp
شکل \fBon\fP دستور، استفاده از دستور \fBsettime\fP را فعال می‌کند\&.
.sp
شکل \fBoff\fP دستور، استفاده از دستور \fBsettime\fP را غیرفعال می‌کند\&.
.sp
شکل \fBlist\fP دستور، تمام نمونه‌هایی که هم‌اکنون در \fBchronyd\fP ذخیره شده‌اند را فهرست می‌کند\&. خروجی در زیر نشان داده شده است\&.
.sp
.if n .RS 4
.nf
.fam C
210 n_samples = 1
#\&    Date\&  Time(UTC)\&    Slewed\&   Original\&   Residual
====================================================
 0 27Jan99 22:09:20\&       0.00\&       0.97\&       0.00
.fam
.fi
.if n .RE
.sp
ستون‌ها به شرح زیر هستند:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 1." 4.2
.\}
نمایه (index) نمونه (مورد استفاده در دستور \fBmanual delete\fP)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 2." 4.2
.\}
تاریخ و زمان نمونه\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 3." 4.2
.\}
خطای ساعت سیستم در زمان ورود برچسب زمانی، با احتساب تغییرات اعمال‌شده بر ساعت سیستم از آن زمان تاکنون تنظیم شده است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 4." 4.2
.\}
خطای ساعت سیستم در زمان ورود برچسب زمانی، همان‌گونه که در ابتدا بوده است (بدون احتساب تغییرات اعمال‌شده بر ساعت سیستم از آن زمان تاکنون)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 5." 4.2
.\}
پسماند رگرسیون در این نقطه، بر حسب ثانیه\&. این امر اجازه می‌دهد تا «داده‌های پرت» (\(oqoutliers\(cq) به آسانی شناسایی شده و با استفاده از دستور \fBmanual delete\fP حذف گردند\&.
.RE
.RE
.sp

.RS 4
.sp
شکل \fBdelete\fP دستور، یک تک‌نمونه را حذف می‌کند\&. پارامتر، نمایه نمونه است، همان‌طور که در ستون نخست خروجی \fBmanual list\fP نشان داده شده است\&. پس از حذف نقطه داده، خطای کنونی و نرخ رانش (drift rate) بر پایه نقاط داده باقی‌مانده دوباره برآورد می‌شوند و ساعت سیستم در صورت نیاز تنظیم (trim) می‌گردد\&. این گزینه برای دور انداختن «داده‌های پرت» (\(oqoutliers\(cq) در نظر گرفته شده است، یعنی نمونه‌هایی که مدیر متوجه می‌شود برچسب زمانی بسیار نامناسبی را وارد کرده است\&.
.sp
شکل \fBreset\fP دستور، همه نمونه‌ها را یک‌جا حذف می‌کند\&. ساعت سیستم همان‌طور که پیش از ورود دستور کار می‌کرد، به کار خود ادامه می‌دهد\&.
.RE
.sp
\fBsettime\fP \fItime\fP
.RS 4
دستور \fBsettime\fP امکان ورود دستی زمان کنونی را فراهم می‌کند، مشروط بر اینکه این گزینه در \fBchronyd\fP پیکربندی شده باشد\&. (این امر را می‌توان چه با دستورالعمل \fBmanual\fP در پرونده پیکربندی و چه با دستور \fBmanual\fP در \fBchronyc\fP پیکربندی کرد\&.)
.sp
باید توجه داشت که درک رایانه از زمان تنها به همان اندازه‌ای دقیق خواهد بود که مرجع مورد استفاده شما برای ارائه این ورودی (مانند ساعت مچی شما) دقت دارد، و نیز اینکه با چه دقتی بتوانید زمان فشردن کلید return را تنظیم کنید\&.
.sp
به شرطی که منطقه زمانی رایانه شما به درستی تنظیم شده باشد، قادر خواهید بود زمان محلی (به جای UTC) را وارد کنید\&.
.sp
پاسخ به یک دستور موفقیت‌آمیز \fBsettime\fP نشان‌دهنده مقداری است که ساعت رایانه نادرست بوده است\&. از این طریق مشخص خواهد شد که آیا زمان را به اشتباه وارد کرده‌اید یا خیر، برای نمونه با منطقه زمانی نادرست\&.
.sp
نرخ رانش ساعت سیستم از طریق یک فرایند رگرسیون و با استفاده از اندازه‌گیری واردشده و تمام اندازه‌گیری‌های پیشین که در طول اجرای کنونی \fBchronyd\fP ثبت شده‌اند، برآورد می‌شود\&. با این حال، اندازه‌گیری واردشده برای تعدیل آفست کنونی ساعت به کار می‌رود (نه عرض از مبدأ برآوردشده از رگرسیون، که نادیده گرفته می‌شود)\&. این رفتار را با آنچه در دستور \fBmanual delete\fP رخ می‌دهد مقایسه کنید، جایی که از عرض از مبدأ برای تنظیم آفست کنونی استفاده می‌شود (زیرا در آن حالت هیچ اندازه‌گیری جدیدی وارد نشده است)\&.
.sp
زمان توسط الگوریتم عمومی \fIgetdate\fP تجزیه می‌شود\&. در نتیجه، شما تنها می‌توانید زمان را با دقت تا نزدیک‌ترین ثانیه تعیین کنید\&.
.sp
نمونه‌هایی از ورودی‌های معتبر در زیر نشان داده شده‌اند:
.sp
.if n .RS 4
.nf
.fam C
settime 16:30
settime 16:30:05
settime Nov 21, 2015 16:30:05
.fam
.fi
.if n .RE
.sp
برای شرح کامل getdate، مستندات getdate را ببینید (که برای نمونه، همراه با سورس‌کد GNU tar عرضه می‌شود)\&.
.RE
.SS "دسترسی ان‌تی‌پی (NTP access)"
.sp
\fBaccheck\fP \fIaddress\fP
.RS 4
این دستور به شما امکان می‌دهد بررسی کنید که آیا دسترسی NTP کلاینت از یک میزبان خاص مجاز است یا خیر\&.
.sp
نمونه‌هایی از کاربرد که یک میزبان نام‌گذاری‌شده و یک نشانی IP عددی را نشان می‌دهند به شرح زیر هستند:
.sp
.if n .RS 4
.nf
.fam C
accheck ntp1.example.net
accheck 1.2.3.4
accheck 2001:db8::1
.fam
.fi
.if n .RE
.sp
این دستور را می‌توان برای بررسی اثر مجموعه‌ای از دستورهای \fBallow\fP، \fBallow all\fP، \fBdeny\fP و \fBdeny all\fP که چه از طریق \fBchronyc\fP و چه در پرونده پیکربندی \fBchronyd\fP مشخص شده‌اند، به کار برد\&.
.RE
.sp
\fBclients\fP [\fB\-p\fP \fIpackets\fP] [\fB\-k\fP] [\fB\-r\fP]
.RS 4
این دستور فهرستی از کلاینت‌هایی را نشان می‌دهد که از طریق درگاه NTP، دستور یا NTS\-KE به سرور دسترسی یافته‌اند\&. این فهرست شامل دسترسی‌های انجام‌شده از طریق سوکت دستور دامنه‌ی یونیکس (Unix domain socket) نمی‌شود\&.
.sp
گزینه \fB\-p\fP کمینه تعداد بسته‌های NTP یا دستورِ دریافت‌شده، یا اتصالات پذیرفته‌شده‌ی NTS\-KE لازم برای گنجاندن کلاینت در فهرست را مشخص می‌کند\&. مقدار پیش‌فرض ۰ است، به این معنی که تمام کلاینت‌ها گزارش می‌شوند\&. با گزینه \fB\-k\fP چهار ستون آخر دسترسی‌های NTS\-KE را به جای دسترسی‌های دستوری نمایش می‌دهند\&. اگر گزینه \fB\-r\fP مشخص شود، \fBchronyd\fP پس از گزارش مقادیر کنونی، شمارنده‌های بسته‌ها یا اتصالات دریافت‌شده و دور ریخته‌شده را بازنشانی می‌کند\&.
.sp
نمونه‌ای از خروجی:
.sp
.if n .RS 4
.nf
.fam C
Hostname\&                      NTP\&   Drop Int IntL Last\&     Cmd\&   Drop Int\&  Last
===============================================================================
localhost\&                       2\&      0\&   2\&   \-\&   133\&      15\&      0\&  \-1\&     7
ntp1.example.net\&               12\&      0\&   6\&   \-\&    23\&       0\&      0\&   \-\&     \-
.fam
.fi
.if n .RE
.sp
هر ردیف، داده‌های یک میزبان منفرد را نشان می‌دهد\&. تنها میزبان‌هایی ثبت وقایع می‌شوند که بررسی‌های دسترسی میزبان را پشت سر گذاشته باشند (تنظیم‌شده با دستورها یا دستورالعمل‌های پرونده پیکربندی \fBallow\fP، \fBdeny\fP، \fBcmdallow\fP و \fBcmddeny\fP)\&. بازه‌ها به صورت توانی از ۲ بر حسب ثانیه نمایش داده می‌شوند\&.
.sp
ستون‌ها به شرح زیر هستند:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 1." 4.2
.\}
نام میزبان کلاینت\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 2." 4.2
.\}
تعداد بسته‌های NTP دریافت شده از کلاینت\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 3." 4.2
.\}
تعداد بسته‌های NTP دور ریخته‌شده برای محدود کردن نرخ پاسخ\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 4." 4.2
.\}
میانگین بازه زمانی میان بسته‌های NTP\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 5." 4.2
.\}
میانگین بازه زمانی میان بسته‌های NTP پس از اعمال محدودیت نرخ پاسخ\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 6." 4.2
.\}
مدت‌زمان سپری‌شده از دریافت آخرین بسته NTP\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 7.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 7." 4.2
.\}
تعداد بسته‌های دستوری یا اتصالات NTS\-KE دریافت/پذیرفته‌شده از کلاینت\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 8.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 8." 4.2
.\}
تعداد بسته‌های دستوری یا اتصالات NTS\-KE دور ریخته‌شده برای محدود کردن نرخ پاسخ\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 9.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 9." 4.2
.\}
میانگین بازه زمانی میان بسته‌های دستوری یا اتصالات NTS\-KE\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 10.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 10." 4.2
.\}
مدت‌زمان سپری‌شده از دریافت/پذیرش آخرین بسته دستوری یا اتصال NTS\-KE\&.
.RE
.RE
.sp
\fBserverstats\fP
.RS 4
دستور \fBserverstats\fP آمارهای سرور NTP و دستوری را نمایش می‌دهد\&.
.sp
نمونه‌ای از خروجی در زیر نشان داده شده است\&.
.sp
.if n .RS 4
.nf
.fam C
NTP packets received\&       : 1598
NTP packets dropped\&        : 8
Command packets received\&   : 19
Command packets dropped\&    : 0
Client log records dropped : 0
NTS\-KE connections accepted: 3
NTS\-KE connections dropped : 0
Authenticated NTP packets\&  : 189
Interleaved NTP packets\&    : 43
NTP timestamps held\&        : 44
NTP timestamp span\&         : 120
NTP daemon RX timestamps\&   : 0
NTP daemon TX timestamps\&   : 1537
NTP kernel RX timestamps\&   : 1590
NTP kernel TX timestamps\&   : 43
NTP hardware RX timestamps : 0
NTP hardware TX timestamps : 0
.fam
.fi
.if n .RE
.sp
فیلدها دارای معانی زیر هستند:
.sp
\fBNTP packets received\fP
.RS 4
تعداد درخواست‌های معتبر NTP دریافت شده توسط سرور\&.
.RE
.sp
\fBNTP packets dropped\fP
.RS 4
تعداد درخواست‌های NTP دور ریخته‌شده توسط سرور به دلیل محدودیت نرخ (پیکربندی‌شده توسط دستورالعمل \fBratelimit\fP)\&.
.RE
.sp
\fBCommand packets received\fP
.RS 4
تعداد درخواست‌های دستوری دریافت شده توسط سرور\&.
.RE
.sp
\fBCommand packets dropped\fP
.RS 4
تعداد درخواست‌های دستوری دور ریخته‌شده توسط سرور به دلیل محدودیت نرخ (پیکربندی‌شده توسط دستورالعمل \fBcmdratelimit\fP)\&.
.RE
.sp
\fBClient log records dropped\fP
.RS 4
تعداد رکوردهای لاگ کلاینت دور ریخته‌شده توسط سرور به منظور محدود کردن مصرف حافظه (پیکربندی‌شده توسط دستورالعمل \fBclientloglimit\fP)\&.
.RE
.sp
\fBNTS\-KE connections accepted\fP
.RS 4
تعداد اتصالات NTS\-KE پذیرفته‌شده توسط سرور\&.
.RE
.sp
\fBNTS\-KE connections dropped\fP
.RS 4
تعداد اتصالات NTS\-KE دور ریخته‌شده توسط سرور به دلیل محدودیت نرخ (پیکربندی‌شده توسط دستورالعمل \fBntsratelimit\fP)\&.
.RE
.sp
\fBAuthenticated NTP packets\fP
.RS 4
تعداد درخواست‌های NTP دریافت‌شده که احراز هویت شده بودند (با کلید متقارن یا NTS)\&.
.RE
.sp
\fBInterleaved NTP packets\fP
.RS 4
تعداد درخواست‌های NTP دریافت‌شده که در حالت درهم‌تنیده (interleaved) تشخیص داده شدند\&.
.RE
.sp
\fBNTP timestamps held\fP
.RS 4
تعداد جفت‌های برچسب زمانی دریافت و ارسال که سرور در حال حاضر برای کلاینت‌های استفاده‌کننده از حالت درهم‌تنیده در حافظه نگه می‌دارد\&.
.RE
.sp
\fBNTP timestamp span\fP
.RS 4
بازه زمانی (بر حسب ثانیه) که توسط برچسب‌های زمانی NTP نگه‌داری‌شده کنونی پوشش داده می‌شود\&.
.RE
.sp
\fBNTP daemon RX timestamps\fP
.RS 4
تعداد پاسخ‌های NTP که شامل برچسب زمانی دریافتی ثبت‌شده توسط دیمن بودند\&.
.RE
.sp
\fBNTP daemon TX timestamps\fP
.RS 4
تعداد پاسخ‌های NTP که شامل برچسب زمانی ارسالی ثبت‌شده توسط دیمن بودند\&.
.RE
.sp
\fBNTP kernel RX timestamps\fP
.RS 4
تعداد پاسخ‌های NTP که شامل برچسب زمانی دریافتی ثبت‌شده توسط کرنل بودند\&.
.RE
.sp
\fBNTP kernel TX timestamps\fP
.RS 4
تعداد پاسخ‌های NTP (در حالت درهم‌تنیده) که شامل برچسب زمانی ارسالی ثبت‌شده توسط کرنل بودند\&.
.RE
.sp
\fBNTP hardware RX timestamps\fP
.RS 4
تعداد پاسخ‌های NTP که شامل برچسب زمانی دریافتی ثبت‌شده توسط کارت شبکه (NIC) بودند\&.
.RE
.sp
\fBNTP hardware TX timestamps\fP
.RS 4
تعداد پاسخ‌های NTP (در حالت درهم‌تنیده) که شامل برچسب زمانی ارسالی ثبت‌شده توسط کارت شبکه (NIC) بودند\&.
.RE
.RE
.sp
\fBallow\fP [\fBall\fP] [\fIsubnet\fP]
.RS 4
اثر دستور allow دقیقاً مشابه دستورالعمل \fBallow\fP در پرونده پیکربندی است\&.
.sp
نحو در نمونه‌های زیر نشان داده شده است:
.sp
.if n .RS 4
.nf
.fam C
allow 1.2.3.4
allow all 3.4.5.0/24
allow 2001:db8:789a::/48
allow 0/0
allow ::/0
allow
allow all
.fam
.fi
.if n .RE
.RE
.sp
\fBdeny\fP [\fBall\fP] [\fIsubnet\fP]
.RS 4
اثر دستور allow دقیقاً مشابه دستورالعمل \fBdeny\fP در پرونده پیکربندی است\&.
.sp
نحو در نمونه‌های زیر نشان داده شده است:
.sp
.if n .RS 4
.nf
.fam C
deny 1.2.3.4
deny all 3.4.5.0/24
deny 2001:db8:789a::/48
deny 0/0
deny ::/0
deny
deny all
.fam
.fi
.if n .RE
.RE
.sp
\fBlocal\fP [\fIoption\fP].\|.\|., \fBlocal\fP \fBoff\fP
.RS 4
دستور \fBlocal\fP به \fBchronyd\fP اعلام می‌کند که به عنوان یک منبع مرجع عمل کند، حتی اگر خودش به درستی با یک منبع خارجی همگام نشده باشد\&. این دستور می‌تواند در شبکه‌های ایزوله به کار رود تا به یک رایانه اجازه دهد سرور زمان اصلی برای سایر رایانه‌ها باشد\&.
.sp
شکل نخست، حالت مرجع محلی را روی میزبان فعال می‌کند\&. نحو دقیقاً مشابه دستورالعمل \fBlocal\fP در پرونده پیکربندی است\&.
.sp
شکل دوم، حالت مرجع محلی را غیرفعال می‌کند\&.
.RE
.sp
\fBsmoothing\fP
.RS 4
دستور \fBsmoothing\fP وضعیت کنونی هموارسازی زمان سرور NTP را نمایش می‌دهد، که می‌تواند با دستورالعمل \fBsmoothtime\fP فعال گردد\&. نمونه‌ای از خروجی در زیر نشان داده شده است\&.
.sp
.if n .RS 4
.nf
.fam C
Active\&         : Yes
Offset\&         : +1.000268817 seconds
Frequency\&      : \-0.142859 ppm
Wander\&         : \-0.010000 ppm per second
Last update\&    : 17.8 seconds ago
Remaining time : 19988.4 seconds
.fam
.fi
.if n .RE
.sp
فیلدها به شرح زیر توضیح داده شده‌اند:
.sp
\fBActive\fP
.RS 4
نشان می‌دهد که آیا هموارسازی زمان سرور هم‌اکنون فعال است یا خیر\&. مقادیر ممکن \fIYes\fP و \fINo\fP هستند\&. اگر گزینه \fBleaponly\fP در دستورالعمل \fBsmoothtime\fP گنجانده شده باشد، \fI(leap second only)\fP روی این خط نمایش داده خواهد شد\&.
.RE
.sp
\fBOffset\fP
.RS 4
این آفست کنونی اعمال‌شده بر زمانی است که برای کلاینت‌های NTP ارسال می‌شود\&. مقدار مثبت یعنی کلاینت‌ها زمانی را دریافت می‌کنند که جلوتر از زمان واقعی است\&.
.RE
.sp
\fBFrequency\fP
.RS 4
آفست فرکانس کنونی زمان ارائه‌شده\&. مقدار منفی بدین معنی است که زمان دیده‌شده توسط کلاینت‌ها کُندتر از زمان واقعی پیش می‌رود\&.
.RE
.sp
\fBWander\fP
.RS 4
سرگردانی (wander) فرکانس کنونی زمان ارائه‌شده\&. مقدار منفی یعنی زمان دیده‌شده توسط کلاینت‌ها در حال کُندتر شدن است\&.
.RE
.sp
\fBLast update\fP
.RS 4
این فیلد نشان می‌دهد فرایند هموارسازی زمان چه مدت پیش به‌روزرسانی شده است، برای نمونه \fBchronyd\fP اندازه‌گیری جدیدی ثبت کرده باشد\&.
.RE
.sp
\fBRemaining time\fP
.RS 4
مدت‌زمانی که طول می‌کشد تا در صورت عدم دریافت به‌روزرسانی‌های بیشتر، آفست و فرکانس فرایند هموارسازی به صفر برسد\&.
.RE
.RE
.sp
\fBsmoothtime\fP \fBactivate\fP, \fBsmoothtime\fP \fBreset\fP
.RS 4
دستور \fBsmoothtime\fP می‌تواند برای فعال‌سازی یا بازنشانی فرایند هموارسازی زمان سرور استفاده شود، مشروط بر اینکه با دستورالعمل \fBsmoothtime\fP پیکربندی شده باشد\&.
.RE
.SS "پایش دسترسی (Monitoring access)"
.sp
\fBcmdaccheck\fP \fIaddress\fP
.RS 4
این دستور مشابه دستور \fBaccheck\fP است، با این تفاوت که برای بررسی اینکه آیا دسترسی پایش از یک میزبان مشخص مجاز است یا خیر به کار می‌رود.
.sp
نمونه‌های استفاده به شرح زیر است:
.sp
.if n .RS 4
.nf
.fam C
cmdaccheck ntp1.example.net
cmdaccheck 1.2.3.4
cmdaccheck 2001:db8::1
.fam
.fi
.if n .RE
.RE
.sp
\fBcmdallow\fP [\fBall\fP] [\fIsubnet\fP]
.RS 4
این دستور مشابه دستور \fBallow\fP است، با این تفاوت که برای مجاز ساختن میزبان‌ها یا زیرشبکه‌های خاص به استفاده از \fBchronyc\fP جهت پایش \fBchronyd\fP روی میزبان فعلی به کار می‌رود.
.RE
.sp
\fBcmddeny\fP [\fBall\fP] [\fIsubnet\fP]
.RS 4
این دستور مشابه دستور \fBdeny\fP است، با این تفاوت که برای منع میزبان‌ها یا زیرشبکه‌های خاص از استفاده از \fBchronyc\fP جهت پایش \fBchronyd\fP روی میزبان فعلی به کار می‌رود.
.RE
.SS "ساعت بلادرنگ (Real\-time clock \- RTC)"
.sp
\fBrtcdata\fP
.RS 4
دستور \fBrtcdata\fP پارامترهای فعلی RTC را نمایش می‌دهد.
.sp
نمونه‌ای از خروجی در زیر نشان داده شده است:
.sp
.if n .RS 4
.nf
.fam C
RTC ref time (GMT) : Sat May 30 07:25:56 2015
Number of samples\&  : 10
Number of runs\&     : 5
Sample span period :\&  549
RTC is fast by\&     :\&    \-1.632736 seconds
RTC gains time at\&  :\&  \-107.623 ppm
.fam
.fi
.if n .RE
.sp
فیلدها دارای معانی زیر هستند:
.sp
\fBRTC ref time (GMT)\fP
.RS 4
این مقدار خوانده‌شده از RTC در آخرین باری است که خطای آن اندازه‌گیری شده است.
.RE
.sp
\fBNumber of samples\fP
.RS 4
این تعداد اندازه‌گیری‌های قبلی است که برای تعیین نرخ پیشی گرفتن یا عقب افتادن زمان RTC استفاده می‌شود.
.RE
.sp
\fBNumber of runs\fP
.RS 4
این تعداد توالی‌های (runs) باقی‌مانده‌های هم‌علامت پس از برازش رگرسیون برای (خطای RTC) در برابر (زمان RTC) است. مقدار کوچک نشان می‌دهد که اندازه‌گیری‌ها به خوبی با یک مدل خطی تقریب زده نمی‌شوند، و الگوریتم برای بهبود برازش تمایل به حذف اندازه‌گیری‌های قدیمی‌تر خواهد داشت.
.RE
.sp
\fBSample span period\fP
.RS 4
این دوره‌ای است که اندازه‌گیری‌ها در بر می‌گیرند (از قدیمی‌ترین تا جدیدترین). بدون واحد، مقدار بر حسب ثانیه است؛ پسوندهای \fIm\fP برای دقیقه، \fIh\fP برای ساعت، \fId\fP برای روز یا \fIy\fP برای سال می‌توانند استفاده شوند.
.RE
.sp
\fBRTC is fast by\fP
.RS 4
این تخمین میزان جلو بودن ساعت RTC بر حسب ثانیه در زمانی است که ساعت مرجع (در بالا) را ثبت کرده بود. اگر این مقدار بزرگ باشد، ممکن است بخواهید (یا نخواهید) از دستور \fBtrimrtc\fP برای هماهنگ کردن RTC با ساعت سیستم استفاده کنید. (توجه داشته باشید که خطای بزرگ بر عملکرد \fBchronyd\fP تأثیری نخواهد داشت، مگر اینکه آن‌قدر بزرگ شود که باعث بروز خطاهای گرد کردن گردد.)
.RE
.sp
\fBRTC gains time at\fP
.RS 4
این مقدار زمانی است که ساعت بلادرنگ به ازای هر ثانیه‌ای که تیک می‌زند جلو می‌افتد (مثبت) یا عقب می‌ماند (منفی). این مقدار بر حسب بخش در میلیون (ppm) سنجیده می‌شود. بنابراین اگر مقدار نمایش داده شده +1 باشد، فرض کنید RTC هنگام عبور از یک مرز ثانیه‌ای مشخص کاملاً دقیق بوده باشد؛ در این صورت هنگام عبور از مرز ثانیه‌ای بعدی، ۱ میکروثانیه جلوتر خواهد بود.
.RE
.RE
.sp
\fBtrimrtc\fP
.RS 4
دستور \fBtrimrtc\fP برای اصلاح ساعت بلادرنگ (RTC) سیستم با ساعت اصلی سیستم به کار می‌رود. اگر خطای میان دو ساعت در حال حاضر کمتر از یک ثانیه تخمین زده شود، این دستور هیچ تأثیری ندارد.
.sp
این دستور هیچ آرگومانی نمی‌پذیرد. مراحل زیر را انجام می‌دهد (اگر اختلاف RTC با ساعت سیستم بیش از ۱ ثانیه باشد):
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 1." 4.2
.\}
نرخ تخمینی فعلی پیشی گرفتن یا عقب افتادن زمان RTC را به خاطر می‌سپارد و اندازه‌گیری‌های قبلی را پاک می‌کند.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 2." 4.2
.\}
ساعت بلادرنگ را جهش می‌دهد (step) تا اختلاف آن با ساعت سیستم به زیر یک ثانیه برسد.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 3." 4.2
.\}
چندین اندازه‌گیری انجام می‌دهد تا انحراف (offset) جدید میان RTC و ساعت سیستم (یعنی کسر باقی‌مانده از خطای یک ثانیه) را با دقت تعیین کند.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 4." 4.2
.\}
پارامترهای RTC را در پروندهٔ RTC (مشخص‌شده با دستورالعمل \fBrtcfile\fP در پروندهٔ پیکربندی) ذخیره می‌کند.
.RE
.RE
.sp

.RS 4
.sp
گام آخر به عنوان اقدامی احتیاطی در برابر قطعی برق رایانه قبل از خروج دیمن یا صدور دستور \fBwritertc\fP انجام می‌شود.
.sp
حتی اگر از دستور \fBtrimrtc\fP هرگز استفاده نشود (و اجازه داده شود RTC از زمان واقعی منحرف شود)، \fBchronyd\fP همچنان هم در حین اجرا و هم در سراسر راه‌اندازی‌های مجدد دستگاه به خوبی کار خواهد کرد. دستور \fBtrimrtc\fP به عنوان روشی برای اصلاح آن ارائه شده است، به شیوه‌ای که با استفادهٔ \fBchronyd\fP از آن برای حفظ زمان دقیق در سراسر راه‌اندازی‌های مجدد دستگاه سازگار باشد.
.sp
دستور \fBtrimrtc\fP می‌تواند با استفاده از دستورالعمل \fBrtcautotrim\fP در پروندهٔ پیکربندی به‌صورت خودکار توسط \fBchronyd\fP اجرا شود.
.RE
.sp
\fBwritertc\fP
.RS 4
دستور \fBwritertc\fP پارامترهای تخمینی فعلی خطا و نرخ جلو افتادن یا عقب ماندن زمان برای RTC را در پروندهٔ RTC (مشخص‌شده با دستورالعمل \fBrtcfile\fP) می‌نویسد. این اطلاعات همچنین هنگام خاتمه یافتن \fBchronyd\fP (با سیگنال‌های SIGHUP، SIGINT، SIGQUIT یا SIGTERM) یا هنگام صدور دستور \fBtrimrtc\fP به‌طور خودکار نوشته می‌شوند.
.RE
.SS "دستورهای دیگر دیمن (Other daemon commands)"
.sp
\fBcyclelogs\fP
.RS 4
دستور \fBcyclelogs\fP موجب می‌شود همهٔ پرونده‌های گزارش باز \fBchronyd\fP بسته و دوباره باز شوند. این امر امکان تغییر نام آن‌ها را فراهم می‌کند تا بتوان آن‌ها را به‌صورت دوره‌ای پاکسازی کرد. نمونه‌ای از نحوهٔ انجام این کار در زیر نشان داده شده است.
.sp
.if n .RS 4
.nf
.fam C
# mv /var/log/chrony/measurements.log /var/log/chrony/measurements1.log
# chronyc cyclelogs
# rm /var/log/chrony/measurements1.log
.fam
.fi
.if n .RE
.sp
توجه داشته باشید پرونده‌های گزارشی که با دستورالعمل \fBlog\fP فعال شده‌اند، هنگام ثبت نخستین ورودی باز می‌شوند. پروندهٔ گزارش پیام‌ها که با گزینهٔ \fB\-l\fP در \fBchronyd\fP مشخص شده است، در اوایل راه‌اندازی باز می‌شود و هنگام اجرای دستور \fBcyclelogs\fP تنها در صورتی بسته می‌شود که باز کردن پروندهٔ جدید با موفقیت انجام شود تا از دست رفتن پیام‌ها جلوگیری گردد. اگر \fBchronyd\fP برای رها کردن امتیازات root پیکربندی شده باشد و شاخهٔ حاوی پروندهٔ گزارش برای کاربر مشخص‌شده قابل نوشتن نباشد، \fBchronyd\fP قادر به باز کردن دوبارهٔ پرونده نخواهد بود.
.RE
.sp
\fBdump\fP
.RS 4
دستور \fBdump\fP موجب می‌شود \fBchronyd\fP تاریخچهٔ کنونی اندازه‌گیری‌های خود را برای هر یک از منابع در پرونده‌های تخلیه درون شاخهٔ مشخص‌شده توسط دستورالعمل \fBdumpdir\fP در پروندهٔ پیکربندی بنویسد، و همچنین کلیدهای NTS سرور و کوکی‌های NTS کلاینت را در شاخهٔ مشخص‌شده توسط دستورالعمل \fBntsdumpdir\fP ذخیره کند. توجه داشته باشید که \fBchronyd\fP این کار را هنگام خروج به‌طور خودکار انجام می‌دهد. این دستور عمدتاً برای بازرسی در زمان اجرای \fBchronyd\fP مفید است.
.RE
.sp
\fBrekey\fP
.RS 4
دستور \fBrekey\fP موجب می‌شود \fBchronyd\fP پروندهٔ کلید مشخص‌شده با دستورالعمل \fBkeyfile\fP در پروندهٔ پیکربندی را دوباره بخواند. همچنین در صورتی که \fBntsdumpdir\fP مشخص شده باشد و چرخش خودکار در پروندهٔ پیکربندی غیرفعال باشد، کلیدهای NTS سرور را نیز دوباره می‌خواند.
.RE
.sp
\fBreset\fP \fBsources\fP
.RS 4
دستور \fBreset sources\fP موجب می‌شود \fBchronyd\fP همهٔ اندازه‌گیری‌ها را کنار بگذارد و به وضعیت همگام‌نشده (unsynchronised) تغییر حالت دهد. این دستور می‌تواند به بازیابی \fBchronyd\fP در زمانی که مشخص است اندازه‌گیری‌ها دیگر معتبر یا دقیق نیستند کمک کند، برای نمونه به دلیل انتقال رایانه به یک شبکهٔ دیگر، یا بازگشت رایانه از وضعیت کم‌مصرف (که ساعت سیستم را بازنشانی می‌کند). \fBchronyd\fP هنگام تشخیص جهش غیرمنتظره در ساعت، اندازه‌گیری‌ها را به‌طور خودکار کنار می‌گذارد، اما این تشخیص کاملاً قابل اعتماد نیست.
.RE
.sp
\fBshutdown\fP
.RS 4
دستور \fBshutdown\fP موجب خروج \fBchronyd\fP می‌شود. این معادل ارسال سیگنال SIGTERM به فرایند است.
.RE
.SS "دستورهای کلاینت (Client commands)"
.sp
\fBdns\fP \fIoption\fP
.RS 4
دستور \fBdns\fP نحوهٔ تحلیل و ترجمهٔ نام‌های میزبان و نشانی‌های IP را در \fBchronyc\fP پیکربندی می‌کند. نشانی‌های IP هنگام چاپ نتایج دستورهای \fBsources\fP، \fBsourcestats\fP، \fBtracking\fP و \fBclients\fP می‌توانند به نام‌های میزبان تبدیل شوند. نام‌های میزبان در دستورهایی که یک نشانی را به عنوان آرگومان می‌گیرند تحلیل می‌شوند.
.sp
پنج گزینه وجود دارد:
.sp
\fBdns \-n\fP
.RS 4
ترجمهٔ نشانی‌های IP به نام‌های میزبان را غیرفعال می‌کند. نشانی‌های خام IP نمایش داده خواهند شد.
.RE
.sp
\fBdns +n\fP
.RS 4
ترجمهٔ نشانی‌های IP به نام‌های میزبان را فعال می‌کند. این حالت پیش‌فرض است مگر آنکه \fBchronyc\fP با گزینهٔ \fB\-n\fP آغاز شده باشد.
.RE
.sp
\fBdns \-4\fP
.RS 4
نام‌های میزبان را تنها به نشانی‌های IPv4 تحلیل می‌کند.
.RE
.sp
\fBdns \-6\fP
.RS 4
نام‌های میزبان را تنها به نشانی‌های IPv6 تحلیل می‌کند.
.RE
.sp
\fBdns \-46\fP
.RS 4
نام‌های میزبان را به هر دو خانوادهٔ نشانی تحلیل می‌کند. این رفتار پیش‌فرض است مگر آنکه \fBchronyc\fP با گزینهٔ \fB\-4\fP یا \fB\-6\fP آغاز شده باشد.
.RE
.RE
.sp
\fBtimeout\fP \fItimeout\fP
.RS 4
دستور \fBtimeout\fP مهلت زمانی اولیه برای درخواست‌های \fBchronyc\fP را به میلی‌ثانیه تنظیم می‌کند. اگر پاسخی از \fBchronyd\fP دریافت نشود، مهلت زمانی دو برابر شده و درخواست دوباره ارسال می‌شود. بیشینهٔ تعداد تلاش‌های مجدد با دستور \fBretries\fP پیکربندی می‌شود.
.sp
به‌طور پیش‌فرض، مهلت زمانی ۱۰۰۰ میلی‌ثانیه است.
.RE
.sp
\fBretries\fP \fIretries\fP
.RS 4
دستور \fBretries\fP بیشینهٔ تعداد تلاش‌های مجدد برای درخواست‌های \fBchronyc\fP را پیش از صرف‌نظر کردن تنظیم می‌کند. مهلت زمانی پاسخ توسط دستور \fBtimeout\fP کنترل می‌شود.
.sp
مقدار پیش‌فرض ۲ است.
.RE
.sp
\fBkeygen\fP [\fIid\fP [\fItype\fP [\fIbits\fP]]]
.RS 4
دستور \fBkeygen\fP کلیدی تولید می‌کند که می‌تواند به پروندهٔ کلید (مشخص‌شده با دستورالعمل \fBkeyfile\fP) افزوده شود تا امکان احراز هویت NTP میان سرور و کلاینت یا همتایان فراهم گردد. کلید از دستگاه \fI/dev/urandom\fP تولید شده و در خروجی استاندارد چاپ می‌شود.
.sp
این دستور سه آرگومان اختیاری دارد. نخستین آرگومان شمارهٔ کلید است (به‌طور پیش‌فرض ۱)، که با گزینهٔ \fBkey\fP از دستورالعمل‌های \fBserver\fP یا \fBpeer\fP در پروندهٔ پیکربندی مشخص خواهد شد. دومین آرگومان نام تابع هش یا الگوریتم رمزنگاری (cipher) است (به‌طور پیش‌فرض SHA1، یا اگر SHA1 در دسترس نباشد MD5). سومین آرگومان طول کلید بر حسب بیت در صورت انتخاب تابع هش است، بین ۸۰ تا ۴۰۹۶ بیت (به‌طور پیش‌فرض ۱۶۰ بیت).
.sp
یک نمونه:
.sp
.if n .RS 4
.nf
.fam C
keygen 73 SHA1 256
.fam
.fi
.if n .RE
.sp
که یک کلید ۲۵۶ بیتی SHA1 با شمارهٔ ۷۳ تولید می‌کند. خط چاپ‌شده سپس باید به شکلی امن منتقل شده و به پرونده‌های کلید در هر دو سمت سرور و کلاینت، یا همتایان افزوده شود. برای هر کلاینت یا همتا باید یک کلید مجزا تولید شود.
.sp
نمونه‌ای با استفاده از رمزنگاری AES128:
.sp
.if n .RS 4
.nf
.fam C
keygen 151 AES128
.fam
.fi
.if n .RE
.RE
.sp
\fBexit\fP, \fBquit\fP
.RS 4
دستورهای \fBexit\fP و \fBquit\fP از \fBchronyc\fP خارج شده و کاربر را به شل بازمی‌گردانند.
.RE
.sp
\fBhelp\fP
.RS 4
دستور \fBhelp\fP خلاصه‌ای از دستورها و آرگومان‌های آن‌ها را نمایش می‌دهد.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBchrony.conf(5)\fP, \fBchronyd(8)\fP
.SH "اشکالات (BUGS)"
.sp
برای دستورالعمل‌های مربوط به نحوه گزارش اشکالات، لطفاً ببینید:
.URL "https://chrony\-project.org/" "" "."
.SH "نویسندگان (AUTHORS)"
.sp
chrony توسط Richard Curnow، Miroslav Lichvar و دیگران نوشته شده است.