نام (NAME)

update-leap - مدیریت و به‌روزرسانی فایل ثانیه‌های کبیسه

خلاصه دستور (SYNOPSIS)

update-leap [-flags] [-flag [value]] [--option-name[[=| ]value]]

تمام آرگومان‌ها باید از نوع گزینه باشند.

توضیحات (DESCRIPTION)

دستور update-leap فایل موجود روی سیستم محلی را اعتبارسنجی کرده و در صورت لزوم، فایل تعاریف ثانیهٔ کبیسه را به‌روزرسانی می‌کند.

به‌طور معمول، فایل با استفاده از دستورالعمل «leapfile» در ntp.conf(5) یافت می‌شود. با این حال، می‌توان یک مکان جایگزین را در خط فرمان مشخص کرد.

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

در صورتی که فایل فعلی قابل قبول باشد، هیچ بارگیری یا بازراه‌اندازی انجام نمی‌گیرد.

گزینهٔ ‎-c نیز می‌تواند برای فراخوانی اسکریپتی دیگر جهت انجام وظایف مدیریتی استفاده شود، مانند کپی کردن فایل در سایر سیستم‌های محلی.

این دستور می‌تواند به‌عنوان یک کار زمان‌بندی‌شدهٔ cron اجرا شود. از آنجا که این فایل به‌ندرت به‌روزرسانی می‌شود و ثانیه‌های کبیسه حداقل از یک ماه قبل (معمولاً زودتر) اعلام می‌شوند، نیازی به اجرای آن با تواتری بیش از حدوداً هر سه هفته یک‌بار نیست.

برای سازگاری رفتاری با cron، متغیر CRONJOB=1 را در crontab تعریف کنید.

این اسکریپت به $REQUIREDCMDS وابسته است.

گزینه‌ها (OPTIONS)

-s string, --source-url=string

نشانی اینترنتی (URL) نسخهٔ مرجع فایل ثانیه‌های کبیسه.

نشانی اینترنتی نسخهٔ مرجع را برای بارگیری مشخص می‌کند $LEAPSRC

-4, --ipv4

تنها از آدرس‌های IPv4 برای تحلیل نام DNS استفاده می‌کند. این گزینه نباید در ترکیب با هیچ‌یک از گزینه‌های زیر استفاده شود: ipv6.

تحلیل DNS نام‌های میزبان بعدی در خط فرمان را به فضای نام IPv4 اجبار می‌کند.
_EndOfDoc_; };

flag = {
name = ipv6;
flags-cant = ipv4, prefer;
value = 6;
descrip = "تنها از آدرس‌های IPv6 برای تحلیل نام DNS استفاده می‌کند";
doc = <<- _EndOfDoc_
تحلیل DNS نام‌های میزبان بعدی در خط فرمان را به فضای نام IPv6 اجبار می‌کند.
_EndOfDoc_; };

flag = {
name = prefer;
flags-cant = ipv4, ipv6;
value = p;
arg-type = keyword;
keyword = 4, 6;
descrip = 'ترجیح دادن آدرس‌های IPv4 یا IPv6 (طبق مشخص‌شده)، اما استفاده از هر دو';
doc = <<- _EndOfDoc_ ترجیح دادن آدرس‌های IPv4 یا IPv6 (طبق مشخص‌شده)، اما استفاده از هر دو.

-d float, --destination=float

نام فایل روی سیستم محلی.

نامی که برای ذخیرهٔ leapfile روی سیستم محلی استفاده می‌شود. $LEAPFILE

-e string, --expiration=string

نوسازی leapfile این مدت پیش از انقضای آن.

مشخص کنید چه مدت پیش از انقضا فایل باید نوسازی شود. واحدها الزامی هستند، مثلاً «‎-e 60 days». توجه داشته باشید که مقادیر بزرگ‌تر به معنای نوسازی‌های مکررتر است. "$PREFETCH"

-f string, --ntp-conf-file=string

مکان فایل ntp.conf.

مکان ntp.conf را مشخص کنید (برای اطمینان از وجود دستورالعمل leapfile و تعیین leapfile پیش‌فرض استفاده می‌شود) /etc/ntp.conf

-F, --force-update

به‌روزرسانی اجباری leapfile.

اجبار به به‌روزرسانی حتی اگر فایل کنونی سالم بوده و نزدیک به انقضا نباشد.

--dont-wait

عدم انتظار برای فشردن کلید بین رسم‌ها.

-?, --help

نمایش اطلاعات نحوهٔ استفاده و خروج.

-!, --more-help

ارسال اطلاعات تفصیلی نحوهٔ استفاده به یک صفحه‌بند (pager).

-v [{v|c|n --version [{v|c|n}]}]

نمایش نسخهٔ برنامه و خروج. حالت پیش‌فرض «v» (نسخهٔ ساده) است. حالت «c» اطلاعات حق نشر را چاپ می‌کند و «n» تذکر کامل حق نشر را چاپ خواهد کرد.

نحوه استفاده (USAGE)

موارد استفاده

وضعیت خروج (EXIT STATUS)

یکی از مقادیر خروج زیر بازگردانده خواهد شد:

0 (EXIT_SUCCESS): اجرای موفق برنامه.
1 (EXIT_FAILURE): عملیات ناموفق بود یا نحو دستور معتبر نبود.
70 (EX_SOFTWARE): کتابخانهٔ libopts دچار خطای عملیاتی داخلی شد. لطفاً آن را به autogen-users@lists.sourceforge.net گزارش دهید. با تشکر.

نویسندگان (AUTHORS)

Timothe Litt

نکات (NOTES)

این صفحهٔ راهنما با استفاده از AutoGen از روی تعاریف گزینه‌های update-leap تولید شده است.