'\" t
.TH "TIMESYNCD\&.CONF" "5" "" "systemd 261.2" "timesyncd.conf"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
timesyncd.conf, timesyncd.conf.d \- فایل‌های پیکربندی همگام‌سازی زمان شبکه
.SH "خلاصه دستور (SYNOPSIS)"
.PP
.RS 4
/etc/systemd/timesyncd\&.conf
.RE
.RS 4
/run/systemd/timesyncd\&.conf
.RE
.RS 4
/usr/local/lib/systemd/timesyncd\&.conf
.RE
.RS 4
/usr/lib/systemd/timesyncd\&.conf
.RE
.RS 4
/etc/systemd/timesyncd\&.conf\&.d/*\&.conf
.RE
.RS 4
/run/systemd/timesyncd\&.conf\&.d/*\&.conf
.RE
.RS 4
/usr/local/lib/systemd/timesyncd\&.conf\&.d/*\&.conf
.RE
.RS 4
/usr/lib/systemd/timesyncd\&.conf\&.d/*\&.conf
.RE
.SH "توضیحات (DESCRIPTION)"
.PP
این فایل‌های پیکربندی همگام‌سازی زمان شبکه NTP را کنترل می‌کنند\&. برای شرح کلی ساختار دستوری به
\fBsystemd.syntax\fR(7)
مراجعه کنید\&.
.SH "دایرکتوری‌های پیکربندی و اولویت (CONFIGURATION DIRECTORIES AND PRECEDENCE)"
.PP
پیکربندی پیش‌فرض در زمان کامپایل تعیین می‌شود، بنابراین پیکربندی تنها زمانی مورد نیاز است که انحراف از آن مقادیر پیش‌فرض لازم باشد\&. فایل پیکربندی اصلی از یکی از دایرکتوری‌های فهرست‌شده به ترتیب اولویت بارگذاری می‌شود و تنها اولین فایل یافت‌شده استفاده می‌گردد:
/etc/systemd/،
/run/systemd/،
/usr/local/lib/systemd/
\&\s-2\u[1]\d\s+2،
/usr/lib/systemd/\&. نسخه ارائه‌شده توسط توزیع‌کننده (vendor) شامل ورودی‌های کامنت‌شده‌ای است که مقادیر پیش‌فرض را به عنوان راهنمای مدیر سیستم نشان می‌دهد\&. بازنویسی‌های محلی را نیز می‌توان با ایجاد قطعات تکمیلی (drop-in) مطابق توضیحات زیر انجام داد\&. فایل پیکربندی اصلی را نیز می‌توان برای این منظور ویرایش کرد (یا یک رونوشت در
/etc/
اگر در
/usr/
عرضه شده باشد)، با این حال استفاده از قطعات تکمیلی (drop-in) برای پیکربندی محلی نسبت به تغییر دادن فایل پیکربندی اصلی توصیه می‌شود\&.
.PP
علاوه بر فایل پیکربندی اصلی، قطعه‌های پیکربندی تکمیلی (drop-in) از دایرکتوری‌های
/usr/lib/systemd/*\&.conf\&.d/،
/usr/local/lib/systemd/*\&.conf\&.d/، و
/etc/systemd/*\&.conf\&.d/
خوانده می‌شوند\&. این قطعات تکمیلی اولویت بالاتری دارند و فایل پیکربندی اصلی را بازنویسی (override) می‌کنند\&. فایل‌ها در زیردایرکتوری‌های پیکربندی
*\&.conf\&.d/
صرف‌نظر از اینکه در کدام زیردایرکتوری قرار دارند، بر اساس نام فایل خود به ترتیب واژه‌نگاری (lexicographic) مرتب می‌شوند\&. هنگامی که چندین فایل یک گزینه یکسان را تعیین می‌کنند، برای گزینه‌هایی که فقط یک مقدار واحد را می‌پذیرند، ورودی موجود در فایلی که نام آن در آخرین جایگاه قرار می‌گیرد اولویت دارد، و برای گزینه‌هایی که فهرستی از مقادیر را می‌پذیرند، ورودی‌ها به همان ترتیبی که در فایل‌های مرتب‌شده ظاهر می‌شوند جمع‌آوری می‌گردند\&.
.PP
هنگامی که بسته‌ها نیاز به سفارشی‌سازی پیکربندی دارند، می‌توانند قطعات تکمیلی (drop-in) را در
/usr/
نصب کنند\&. فایل‌های موجود در
/etc/
برای مدیر سیستم محلی رزرو شده‌اند، که می‌تواند از این منطق برای بازنویسی فایل‌های پیکربندی نصب‌شده توسط بسته‌های توزیع‌کننده استفاده کند\&. برای بازنویسی قطعات تکمیلی بسته، باید از قطعات تکمیلی استفاده شود، زیرا فایل پیکربندی اصلی اولویت پایین‌تری دارد\&. توصیه می‌شود نام تمام فایل‌ها در این زیردایرکتوری‌ها با یک عدد دو رقمی و یک خط تیره پیشوندگذاری شود تا ترتیب آن‌ها ساده‌تر شود\&. این کار همچنین مفهوم اولویت‌های قطعات تکمیلی را تعریف می‌کند تا به توزیع‌کنندگان سیستم‌عامل اجازه دهد قطعات تکمیلی را در محدوده خاصی پایین‌تر از محدوده مورد استفاده کاربران عرضه کنند\&. این امر خطر بازنویسی تصادفی قطعات تکمیلی تعریف‌شده توسط کاربران را توسط قطعات تکمیلی بسته‌ها کاهش می‌دهد\&. توصیه می‌شود از محدوده 10\-40 برای قطعات تکمیلی در
/usr/
و از محدوده 60\-90 برای قطعات تکمیلی در
/etc/
و
/run/
استفاده شود، تا اطمینان حاصل گردد که قطعات تکمیلی محلی و گذرا بر قطعات تکمیلی عرضه‌شده توسط توزیع‌کننده سیستم‌عامل اولویت دارند\&.
.PP
برای غیرفعال کردن یک فایل پیکربندی ارائه‌شده توسط توزیع‌کننده، روش توصیه‌شده قرار دادن یک پیوند نمادین (symlink) به
/dev/null
در دایرکتوری پیکربندی در
/etc/
با همان نام فایل پیکربندی توزیع‌کننده است\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
تنظیمات زیر در بخش [Time] پیکربندی می‌شوند:
.PP
\fINTP=\fR
.RS 4
فهرستی از نام‌های میزبان یا آدرس‌های IP سرور NTP که با فاصله از هم جدا شده‌اند\&. در زمان اجرا، این فهرست با هرگونه سرور NTP به ازای هر رابط شبکه که از
\fBsystemd-networkd.service\fR(8)
دریافت شده است، ترکیب می‌شود\&.
\fBsystemd\-timesyncd\fR
به نوبت با تمام سرورهای پیکربندی‌شده سیستم یا به ازای هر رابط ارتباط برقرار می‌کند تا زمانی که یکی پاسخ دهد\&. هنگامی که یک رشته خالی اختصاص داده شود، فهرست سرورهای NTP بازنشانی می‌شود و تمامی انتساب‌های قبلی بی‌اثر خواهند شد\&. مقدار پیش‌فرض این تنظیم یک فهرست خالی است\&.
.sp
افزوده‌شده در نسخه 216\&.
.RE
.PP
\fIFallbackNTP=\fR
.RS 4
فهرستی از نام‌های میزبان یا آدرس‌های IP سرور NTP جداشده با فاصله برای استفاده به عنوان سرورهای NTP پشتیبان (fallback)\&. هرگونه سرور NTP به ازای هر رابط که از
\fBsystemd-networkd.service\fR(8)
دریافت شده باشد بر این تنظیم اولویت دارد، همان‌طور که هر سروری که از طریق
\fINTP=\fR
در بالا تنظیم شده باشد اولویت دارد\&. بنابراین این تنظیم تنها زمانی مرتبط و مؤثر است که هیچ اطلاعات سرور NTP دیگری شناخته‌شده نباشد\&. هنگامی که یک رشته خالی اختصاص داده شود، فهرست سرورهای NTP بازنشانی می‌شود و تمام انتساب‌های قبلی بی‌اثر خواهند شد\&. اگر این گزینه مشخص نشده باشد، از فهرست سرورهای NTP تعبیه‌شده در زمان کامپایل استفاده می‌شود\&.
.sp
افزوده‌شده در نسخه 216\&.
.RE
.PP
\fIRootDistanceMaxSec=\fR
.RS 4
حداکثر فاصله ریشه (root distance) قابل قبول، یعنی حداکثر زمان تخمینی لازم برای انتقال یک بسته از سرور دارای ساعت مرجع به سروری که به آن متصل هستیم\&. اگر سرور فعلی این محدودیت را برآورده نکند،
\fBsystemd\-timesyncd\fR
به سرور دیگری تغییر وضعیت خواهد داد\&.
.sp
یک مقدار بازه زمانی را می‌پذیرد\&. واحد پیش‌فرض ثانیه است، اما واحدهای دیگر نیز ممکن است مشخص شوند؛ به
\fBsystemd.time\fR(7)
مراجعه کنید\&. مقدار پیش‌فرض 5 ثانیه است\&.
.sp
افزوده‌شده در نسخه 236\&.
.RE
.PP
\fIPollIntervalMinSec=\fR, \fIPollIntervalMaxSec=\fR
.RS 4
حداقل و حداکثر فواصل زمانی نظرسنجی (poll interval) برای پیام‌های NTP\&. نظرسنجی از حداقل فاصله زمانی شروع می‌شود و در پاسخ به بسته‌های دریافتی در محدوده مشخص‌شده تنظیم می‌گردد\&.
.sp
هر تنظیم یک مقدار بازه زمانی را می‌پذیرد\&. واحد پیش‌فرض ثانیه است، اما واحدهای دیگر نیز ممکن است مشخص شوند؛ به
\fBsystemd.time\fR(7)
مراجعه کنید\&.
مقدار پیش‌فرض
\fIPollIntervalMinSec=\fR
برابر با 32 ثانیه است و نباید کمتر از 16\ \&ثانیه باشد\&.
مقدار پیش‌فرض
\fIPollIntervalMaxSec=\fR
برابر با 34\ \&دقیقه\ \&و\ \&8\ \&ثانیه (2048\ \&ثانیه) است و باید بزرگتر از
\fIPollIntervalMinSec=\fR
باشد\&.
.sp
افزوده‌شده در نسخه 236\&.
.RE
.PP
\fIConnectionRetrySec=\fR
.RS 4
حداقل تاخیر را قبل از انجام تلاش‌های بعدی برای برقراری ارتباط با یک سرور NTP جدید مشخص می‌کند\&.
.sp
یک مقدار بازه زمانی را می‌پذیرد\&. واحد پیش‌فرض ثانیه است، اما واحدهای دیگر نیز ممکن است مشخص شوند؛ به
\fBsystemd.time\fR(7)
مراجعه کنید\&. مقدار پیش‌فرض 30 ثانیه است و نباید کمتر از 1 ثانیه باشد\&.
.sp
افزوده‌شده در نسخه 248\&.
.RE
.PP
\fISaveIntervalSec=\fR
.RS 4
فاصله زمانی که در آن زمان جاری به صورت دوره‌ای روی دیسک ذخیره می‌شود، در صورت عدم وجود هرگونه همگام‌سازی اخیر از یک سرور NTP\&. این قابلیت به‌ویژه برای سیستم‌های آفلاین و فاقد ساعت بی‌درنگ محلی (RTC) مفید است، زیرا تضمین می‌کند که ساعت سیستم در طول راه‌اندازی‌های مجدد تقریباً یکنواخت (monotonic) باقی می‌ماند\&.
.sp
یک مقدار بازه زمانی را می‌پذیرد\&. واحد پیش‌فرض ثانیه است، اما واحدهای دیگر نیز ممکن است مشخص شوند؛ به
\fBsystemd.time\fR(7)
مراجعه کنید\&. مقدار پیش‌فرض 60 ثانیه است\&.
.sp
افزوده‌شده در نسخه 250\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBsystemd-timesyncd.service\fR(8), \fBsystemd-networkd.service\fR(8)
.SH "نکات (NOTES)"
.IP " 1." 4
💣💥🧨💥💥💣 لطفاً توجه داشته باشید که این فایل‌های پیکربندی باید همیشه در دسترس باشند\&. اگر
/usr/local/
یک پارتیشن جداگانه باشد، ممکن است در مراحل اولیه بوت در دسترس نباشد و نباید برای پیکربندی استفاده شود\&.