نام (NAME)

rtcwake - به خواب بردن سیستم و بیدار کردن آن در زمان مشخص با استفاده از RTC

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

rtcwake [options] [-d device] [-m standby_mode] {-s seconds|-t time_t}

توضیحات (DESCRIPTION)

این برنامه برای بردن سیستم به حالت خواب و بیدار کردن خودکار آن در یک زمان مشخص استفاده می‌شود.

این ابزار از رابط‌های چندسکویی لینوکس برای ورود به حالت خواب سیستم و خروج از آن حداکثر تا زمان مشخص‌شده استفاده می‌کند. این برنامه از هر درایور چارچوب RTC که از پرچم‌های بیدارباش استاندارد مدل درایور پشتیبانی کند استفاده می‌کند.

این برنامه معمولاً مانند ابزار قدیمی apmsleep برای بیدار شدن از حالت تعلیق مانند ACPI S1 (آماده‌باش یا standby) یا S3 (تعلیق در رم یا suspend-to-RAM) به کار می‌رود. بیشتر پلتفرم‌ها می‌توانند این حالت‌ها را بدون معادل‌های BIOS، APM یا ACPI پیاده‌سازی کنند.

در برخی سیستم‌ها، از این ابزار می‌توان مانند nvram-wakeup برای بیدار شدن از حالت‌هایی مانند ACPI S4 (تعلیق روی دیسک یا suspend to disk) نیز استفاده کرد. همه سیستم‌ها دارای رسانه پایدار مناسب برای چنین حالت‌های تعلیقی نیستند.

توجه داشته باشید که قابلیت هشدار به سخت‌افزار بستگی دارد؛ همه RTCها قادر به تنظیم هشدار تا ۲۴ ساعت در آینده نیستند.

آماده‌سازی تعلیق ممکن است توسط سخت‌افزارهای فعال دچار وقفه شود؛ برای نمونه دستگاه‌های ورودی USB بی‌سیم که پس از فشرده شدن کلید Enter همچنان برای کسری از ثانیه رویدادها را ارسال می‌کنند. rtcwake تلاش می‌کند تا از این مشکل جلوگیری کند و پیش از ورود به خواب سیستم، منتظر می‌ماند تا پایانه به وضعیت پایدار برسد.

گزینه‌ها (OPTIONS)

-A, --adjfile file

مشخص کردن یک مسیر جایگزین برای فایل تنظیم.

-a, --auto

خواندن حالت ساعت (اینکه ساعت سخت‌افزاری روی UTC یا زمان محلی تنظیم شده است) از فایل adjtime، جایی که hwclock(8) این اطلاعات را ذخیره می‌کند. این حالت پیش‌فرض است.

--date timestamp

تنظیم زمان بیدارباش به مقدار این برچسب زمان (timestamp). قالب timestamp می‌تواند هر یک از موارد زیر باشد:

YYYYMMDDhhmmss
"YYYY-MM-DD hh:mm:ss"
"YYYY-MM-DD hh:mm"      (ثانیه 00 است)
YYYY-MM-DD              (زمان 00:00:00 است)
hh:mm:ss                (تاریخ امروز است)
hh:mm                   (تاریخ امروز است، ثانیه 00 است)
+number[smhd]           (ثانیه/دقیقه/ساعت/روز پس از اکنون)
tomorrow                (زمان 00:00:00 است)

نمونه‌هایی از قالب +number[smhd] عبارتند از: +5m، +6h، +2d. مشخص‌کننده واحد می‌تواند طولانی‌تر باشد: +5min، +6hours، +2days.

-d, --device device

استفاده از device مشخص‌شده به جای rtc0 به عنوان ساعت بی‌درنگ. این گزینه تنها زمانی کاربرد دارد که سیستم شما بیش از یک RTC داشته باشد. می‌توانید rtc1، rtc2، ... را در اینجا مشخص کنید.

-l, --local

فرض کردن اینکه ساعت سخت‌افزاری صرف‌نظر از محتویات فایل adjtime، روی زمان محلی تنظیم شده است.

--list-modes

فهرست کردن آرگومان‌های معتبر گزینه --mode.

-m, --mode mode

رفتن به حالت آماده‌باش (standby) داده‌شده. مقادیر معتبر برای mode عبارتند از:

standby

حالت ACPI S1. این حالت صرفه‌جویی اندک، اما واقعی، در مصرف انرژی را فراهم می‌کند، در حالی که انتقال بسیار کم‌تاخیر به یک سیستم فعال را ارائه می‌دهد. این حالت پیش‌فرض است.

freeze

فرایندها منجمد می‌شوند، تمام دستگاه‌ها به حالت تعلیق درمی‌آیند و تمام پردازنده‌ها بیکار (idle) می‌شوند. این حالت یک وضعیت عمومی است که به هیچ پشتیبانی خاص پلتفرم نیاز ندارد، اما انرژی کمتری نسبت به تعلیق در رم (Suspend-to-RAM) ذخیره می‌کند، زیرا سیستم همچنان در وضعیت اجرا قرار دارد. (از لینوکس 3.9 در دسترس است.)

mem

حالت ACPI S3 (تعلیق در رم یا Suspend-to-RAM). این حالت صرفه‌جویی قابل توجهی در مصرف انرژی فراهم می‌کند چرا که همه‌چیز در سیستم در وضعیت کم‌مصرف قرار می‌گیرد، به جز حافظه اصلی که برای نگهداری محتویات خود در حالت خودتازه‌سازی (self-refresh) قرار می‌گیرد.

disk

حالت ACPI S4 (تعلیق روی دیسک یا Suspend-to-disk). این حالت بیشترین صرفه‌جویی در مصرف انرژی را فراهم می‌کند و حتی در غیاب پشتیبانی سطح پایین پلتفرم از مدیریت انرژی نیز می‌تواند استفاده شود. این حالت مانند Suspend-to-RAM عمل می‌کند، اما شامل مرحله نهایی نوشتن محتویات حافظه بر روی دیسک است.

off

حالت ACPI S5 (خاموش کردن یا Poweroff). این کار با فراخوانی '/sbin/shutdown' انجام می‌شود. به‌طور رسمی توسط ACPI پشتیبانی نمی‌شود، اما معمولاً کار می‌کند.

no

تعلیق نکن، فقط زمان بیدارباش RTC را تنظیم کن.

on

تعلیق نکن، اما دستگاه RTC را تا زمانی که زمان هشدار پدیدار شود بخوان. این حالت برای اشکال‌زدایی مفید است.

disable

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

show

چاپ اطلاعات هشدار در قالب: "alarm: off|on <time>". زمان در قالب خروجی ctime(3) است، برای نمونه "alarm: on Tue Nov 16 04:48:45 2010".

-n, --dry-run

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

-s, --seconds seconds

تنظیم زمان بیدارباش به اندازه seconds ثانیه در آینده نسبت به اکنون.

-t, --time time_t

تنظیم زمان بیدارباش به زمان مطلق time_t. مقدار time_t زمان بر حسب ثانیه از مبدا 1970-01-01, 00:00 UTC است. از ابزار date(1) برای تبدیل بین زمان خوانا برای انسان و time_t استفاده کنید.

-u, --utc

فرض کردن اینکه ساعت سخت‌افزاری صرف‌نظر از محتویات فایل adjtime، روی UTC (زمان هماهنگ جهانی) تنظیم شده است.

-v, --verbose

حالت پرگویی (نمایش جزئیات بیشتر).

-h, --help

نمایش متن راهنما و خروج.

-V, --version

نمایش نسخه و خروج.

نکات (NOTES)

برخی از سیستم‌های PC در حال حاضر نمی‌توانند تنها با استفاده از کد هسته که توسط این درایور قابل دسترسی است، از حالت‌های خواب مانند mem خارج شوند. آنها برای راه‌اندازی مجدد فریم‌بافر به کمک کدهای فضای کاربری (userspace) نیاز دارند.

فایل‌ها (FILES)

/etc/adjtime

تاریخچه (HISTORY)

این برنامه پیش از قرار گرفتن در پیام کامیت هسته برای لینوکس 2.6 در کامیت گیت 87ac84f42a7a580d0dd72ae31d6a5eb4bfe04c6d، چندین بار در LKML و سایر لیست‌های پستی ارسال شده بود.

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

این برنامه توسط David Brownell <dbrownell@users.sourceforge.net> نوشته شده و توسط Bernhard Walle <bwalle@suse.de>. بهبود یافته است.

حق نشر (COPYRIGHT)

این یک نرم‌افزار آزاد است. شما می‌توانید نسخه‌های آن را تحت شرایط مجوز عمومی همگانی گنو (GPL) http://www.gnu.org/licenses/gpl.html. بازنشر دهید. هیچ‌گونه ضمانتی، تا حدی که قانون مجاز دانسته است، وجود ندارد.

همچنین ببینید (SEE ALSO)

adjtime_config(5), hwclock(8), date(1)

گزارش باگ‌ها (REPORTING BUGS)

برای گزارش باگ‌ها، از ردیاب اشکالات https://github.com/util-linux/util-linux/issues. استفاده کنید.

در دسترس بودن (AVAILABILITY)

دستور rtcwake بخشی از بسته util-linux است که می‌تواند از بایگانی هسته لینوکس https://www.kernel.org/pub/linux/utils/util-linux. دریافت شود.