.de1 NOP
.  it 1 an-trap
.  if \\n[.$] \,\\$*\/
..
.ie t \
.ds B-Font [CB]
.ds I-Font [CI]
.ds R-Font [CR]
.el \
.ds B-Font B
.ds I-Font I
.ds R-Font R
.TH update-leap 1update-leapman "25 May 2024" "ntp (4.2.8p18)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (in-mem file)
.\"
.\" It has been AutoGen-ed May 25, 2024 at 12:05:55 AM by AutoGen 5.18.16
.\" From the definitions update-leap-opts.def
.\" and the template file agman-cmd.tpl
.SH "نام (NAME)"
\f\*[B-Font]update-leap\fP
\- مدیریت و به‌روزرسانی فایل ثانیه‌های کبیسه
.SH "خلاصه دستور (SYNOPSIS)"
\f\*[B-Font]update-leap\fP
.\" Mixture of short (flag) options and long options
[\f\*[B-Font]\-flags\f[]]
[\f\*[B-Font]\-flag\f[] [\f\*[I-Font]value\f[]]]
[\f\*[B-Font]\-\-option-name\f[][[=| ]\f\*[I-Font]value\f[]]]
.sp \n(Ppu
.ne 2

تمام آرگومان‌ها باید از نوع گزینه باشند.
.sp \n(Ppu
.ne 2

.SH "توضیحات (DESCRIPTION)"
دستور \f\*[B-Font]update-leap\fP
فایل موجود روی سیستم محلی را اعتبارسنجی کرده
و در صورت لزوم، فایل تعاریف ثانیهٔ کبیسه را به‌روزرسانی می‌کند.
.sp \n(Ppu
.ne 2

به‌طور معمول، فایل با استفاده از دستورالعمل «leapfile» در
\fCntp.conf\f[]\fR(5)\f[]
یافت می‌شود. با این حال، می‌توان یک مکان جایگزین را در خط فرمان مشخص کرد.
.sp \n(Ppu
.ne 2

اگر فایل وجود نداشته باشد، نامعتبر باشد، منقضی شده باشد یا به‌زودی منقضی شود،
یک نسخهٔ جدید بارگیری خواهد شد. اگر نسخهٔ جدید تأیید اعتبار شود، نصب شده و
NTP (به‌صورت اختیاری) بازراه‌اندازی می‌شود.
.sp \n(Ppu
.ne 2

در صورتی که فایل فعلی قابل قبول باشد، هیچ بارگیری یا بازراه‌اندازی انجام نمی‌گیرد.
.sp \n(Ppu
.ne 2

گزینهٔ ‎-c نیز می‌تواند برای فراخوانی اسکریپتی دیگر جهت انجام وظایف مدیریتی استفاده شود،
مانند کپی کردن فایل در سایر سیستم‌های محلی.
.PP
این دستور می‌تواند به‌عنوان یک کار زمان‌بندی‌شدهٔ cron اجرا شود. از آنجا که این فایل به‌ندرت به‌روزرسانی می‌شود
و ثانیه‌های کبیسه حداقل از یک ماه قبل (معمولاً زودتر) اعلام می‌شوند،
نیازی به اجرای آن با تواتری بیش از حدوداً هر سه هفته یک‌بار نیست.
.PP
برای سازگاری رفتاری با cron، متغیر CRONJOB=1 را در crontab تعریف کنید.
.PP
این اسکریپت به $REQUIREDCMDS وابسته است.
.SH "گزینه‌ها (OPTIONS)"
.TP
.NOP \f\*[B-Font]\-s\f[] \f\*[I-Font]string\f[], \f\*[B-Font]\-\-source\-url\f[]=\f\*[I-Font]string\f[]
نشانی اینترنتی (URL) نسخهٔ مرجع فایل ثانیه‌های کبیسه.
.sp
نشانی اینترنتی نسخهٔ مرجع را برای بارگیری مشخص می‌کند
$LEAPSRC
.TP
.NOP \f\*[B-Font]\-4\f[], \f\*[B-Font]\-\-ipv4\f[]
تنها از آدرس‌های IPv4 برای تحلیل نام DNS استفاده می‌کند.
این گزینه نباید در ترکیب با هیچ‌یک از گزینه‌های زیر استفاده شود:
ipv6.
.sp
        تحلیل DNS نام‌های میزبان بعدی در خط فرمان را به فضای نام IPv4 اجبار می‌کند.
        _EndOfDoc_;
};
.sp
flag = {
    name      = ipv6;
    flags-cant = ipv4, prefer;
    value     = 6;
    descrip   = "تنها از آدرس‌های IPv6 برای تحلیل نام DNS استفاده می‌کند";
    doc = <<-  _EndOfDoc_
        تحلیل DNS نام‌های میزبان بعدی در خط فرمان را به فضای نام IPv6 اجبار می‌کند.
        _EndOfDoc_;
};
.sp
flag = {
    name        = prefer;
    flags-cant	= ipv4, ipv6;
    value	= p;
    arg-type    = keyword;
    keyword	= 4, 6;
    descrip     = 'ترجیح دادن آدرس‌های IPv4 یا IPv6 (طبق مشخص‌شده)، اما استفاده از هر دو';
    doc         = <<-  _EndOfDoc_
ترجیح دادن آدرس‌های IPv4 یا IPv6 (طبق مشخص‌شده)، اما استفاده از هر دو.
.TP
.NOP \f\*[B-Font]\-d\f[] \f\*[I-Font]float\f[], \f\*[B-Font]\-\-destination\f[]=\f\*[I-Font]float\f[]
نام فایل روی سیستم محلی.
.sp
نامی که برای ذخیرهٔ leapfile روی سیستم محلی استفاده می‌شود.
$LEAPFILE
.TP
.NOP \f\*[B-Font]\-e\f[] \f\*[I-Font]string\f[], \f\*[B-Font]\-\-expiration\f[]=\f\*[I-Font]string\f[]
نوسازی leapfile این مدت پیش از انقضای آن.
.sp
مشخص کنید چه مدت پیش از انقضا فایل باید نوسازی شود.
واحدها الزامی هستند، مثلاً «‎-e 60 days». توجه داشته باشید که مقادیر بزرگ‌تر
به معنای نوسازی‌های مکررتر است.
"$PREFETCH"
.TP
.NOP \f\*[B-Font]\-f\f[] \f\*[I-Font]string\f[], \f\*[B-Font]\-\-ntp\-conf\-file\f[]=\f\*[I-Font]string\f[]
مکان فایل ntp.conf.
.sp
مکان ntp.conf را مشخص کنید (برای اطمینان از وجود دستورالعمل leapfile
و تعیین leapfile پیش‌فرض استفاده می‌شود)
/etc/ntp.conf
.TP
.NOP \f\*[B-Font]\-F\f[], \f\*[B-Font]\-\-force\-update\f[]
به‌روزرسانی اجباری leapfile.
.sp
اجبار به به‌روزرسانی حتی اگر فایل کنونی سالم بوده و نزدیک به انقضا نباشد.
.TP
.NOP \f\*[B-Font]\-\-dont\-wait\f[]
عدم انتظار برای فشردن کلید بین رسم‌ها.
.sp
.TP
.NOP \f\*[B-Font]\-\&?\f[], \f\*[B-Font]\-\-help\f[]
نمایش اطلاعات نحوهٔ استفاده و خروج.
.TP
.NOP \f\*[B-Font]\-\&!\f[], \f\*[B-Font]\-\-more-help\f[]
ارسال اطلاعات تفصیلی نحوهٔ استفاده به یک صفحه‌بند (pager).
.TP
.NOP \f\*[B-Font]\-v\f[] [{\f\*[I-Font]v|c|n\f[] \f\*[B-Font]\-\-version\f[] [{\f\*[I-Font]v|c|n\f[]}]}]
نمایش نسخهٔ برنامه و خروج. حالت پیش‌فرض «v» (نسخهٔ ساده) است. حالت «c»
اطلاعات حق نشر را چاپ می‌کند و «n» تذکر کامل حق نشر را چاپ خواهد کرد.
.PP
.SH "نحوه استفاده (USAGE)"
موارد استفاده
.SH "وضعیت خروج (EXIT STATUS)"
یکی از مقادیر خروج زیر بازگردانده خواهد شد:
.TP
.NOP 0 " (EXIT_SUCCESS)"
اجرای موفق برنامه.
.TP
.NOP 1 " (EXIT_FAILURE)"
عملیات ناموفق بود یا نحو دستور معتبر نبود.
.TP
.NOP 70 " (EX_SOFTWARE)"
کتابخانهٔ libopts دچار خطای عملیاتی داخلی شد. لطفاً آن را به
autogen-users@lists.sourceforge.net گزارش دهید. با تشکر.
.PP
.SH "نویسندگان (AUTHORS)"
.NOP  "Timothe Litt" 
.br
.SH "نکات (NOTES)"
این صفحهٔ راهنما با استفاده از \fIAutoGen\fP از روی تعاریف
گزینه‌های \fBupdate-leap\fP تولید شده است.