RTCWAKE(8)

NAZWA
rtcwake - wchodzi w stan uśpienia systemu do zadanego czasu wybudzenia

SKŁADNIA

rtcwake [opcje] [-d urządzenie] [-m tryb-uśpienia] {-s sekundy|-t time_t}

OPIS

Program służy do przejścia w systemowy stan uśpienia i automatycznego wybudzenia z niego o podanym czasie.

Korzysta z wieloplatformowych interfejsów linuksowych do przejścia w stan uśpienia oraz opuszczenia go nie później, niż o zadanym czasie. Korzysta z dowolnego sterownika szkieletu zegara czasu rzeczywistego (RTC), obsługującego standardowy model flag wybudzenia.

Zwykle korzysta się z niego jak ze starego narzędzia apmsleep, do wybudzenia ze stanu wstrzymania, takiego jak S1 (gotowość) lub S3 (wstrzymanie do RAM-u) ACPI. Większość platform może je implementować bez odpowiedników BIOS-u, APM czy ACPI.

W większości systemów, można z niego korzystać jak z nvram-wakeup, budząc się ze stanów takich jak S4 ACPI (wstrzymanie na dysk). Nie wszystkie systemy mają trwały nośnik, który jest wymagany przy tego typu trybach.

Proszę zauważyć, że funkcja alarmu zależy od sprzętu; nie każdy RTC może ustawić alarm do 24 godzin w przyszłość.

Konfigurowanie wstrzymania może być przerwane przez aktywny sprzęt; np. przez bezprzewodowe urządzenie wejściowe USB kontynuujące wysyłanie zdarzeń przez ułamek sekundy po wciśnięciu klawisza Enter. rtcwake stara się uniknąć tego problemu, odczekując na stabilizację terminala przed przejściem w stan uśpienia.

OPCJE

-A, --adjfile plik
    Określa alternatywną ścieżkę pliku dostosowania.

-a, --auto
    Odczytuje tryb zegara (tego, czy zegar sprzętowy jest ustawiony na UTC, czy na czas lokalny) z pliku adjtime, gdzie hwclock(8) przechowuje tę informację. Tak jest domyślnie.

--date znacznik-czasu
    Ustawia czas wybudzenia na wartość podanego znacznika czasowego. Formatem znacznika-czasu może być jeden z poniższych:

         RRRRMMDDggmmss
         "RRRR-MM-DD gg:mm:ss"
         "RRRR-MM-DD gg:mm"      (sekundy będą ustawione na 00)
         RRRR-MM-DD              (czas będzie ustawiony na 00:00:00)
         gg:mm:ss                (data będzie ustawiona na dziś)
         gg:mm                   (data będzie ustawiona na dziś, sekundy na 00)
         +liczba[smhd]           (sekundy/minuty/godziny/dni od teraz)
         tomorrow                (jutro; czas jest ustawiony na 00:00:00)

    Przykłady formatu +liczba[smhd] to: +5m, +6h, +2d. Jako jednostkę można podać też dłuższy angielski wariant: +5min, +6hours, +2days.

-d, --device urządzenie
    Używa podanego urządzenia jako zegara czasu rzeczywistego, zamiast rtc0. Opcja ma znaczenie tylko, jeśli w systemie jest więcej niż jeden RTC. Można tu podać rtc1, rtc2, ... .

-l, --local
    Przyjmuje, że zegar sprzętowy jest ustawiony na czas lokalny, niezależnie od zawartości pliku adjtime.

--list-modes
    Wypisuje dostępne argumenty opcji --mode.

-m, --mode tryb
    Przechodzi w podany stan wstrzymania. Prawidłowymi wartościami trybu są:

    standby
        Stan S1 ACPI. Oferuje najmniejsze, choć widoczne, oszczędności zużytej energii, zapewniając jednocześnie bardzo szybki powrót do stanu pracy. Jest to tryb domyślny.

    freeze
        Wszystkie procesy są zamrażane, wszystkie urządzenia są zawieszane, a wszystkie procesory przechodzą w stan bezczynności. Jest to ogólny stan, który nie wymaga żadnej obsługi po stronie danej platformy, lecz oszczędza mniej energii niż wstrzymanie do RAM-u, ponieważ system wciąż działa (dostępne od Linuksa 3.9).

    mem
        Stan S3 ACPI (wstrzymanie do RAM-u). Oferuje znaczącą oszczędność zużywanej energii, ponieważ wszystko w systemie przechodzi w stan minimalnego zasilania, z wyjątkiem pamięci, przechodzącej w tryb odświeżania, w celu podtrzymania zawartości RAM-u.

    disk
        Stan S4 ACPI (wstrzymanie na dysk). Oferuje największą oszczędność energii i może być używany nawet w przypadku braku niskopoziomowej obsługi zarządzania energią po stronie platformy. Stan jest podobny do wstrzymania do RAM-u, lecz dodatkowo obejmuje końcowy krok, polegający na zapisaniu zawartości pamięci na dysk.

    off
        Stan S5 ACPI (wyłączenie). Dokonywane przez wywołanie "/sbin/shutdown". Nie jest oficjalnie obsługiwane przez ACPI, lecz zwykle działa.

    no
        Nie wstrzymuje, jedynie ustawia czas wybudzenia RTC.

    on
        Nie wstrzymuje, lecz odczytuje urządzenie RTC do wystąpienia czasu alarmu. Tryb przydatny do debugowania.

    disable
        Wyłącza alarm ustawiony wcześniej.

    show
        Pokazuje informacje o alarmie w postaci: "alarm: wyłączony|włączony <czas>". Czas występuje w formacie wyjściowym ctime(3) np. "alarm: włączony wto 16 lis 04:48:45 2010".

-n, --dry-run
    Opcja wykonuje wszystko, poza faktycznym ustawieniem alarmu, wstrzymaniem systemu lub czekaniem na alarm.

-s, --seconds sekundy
    Ustawia czas wybudzenia na liczbę sekund od teraz.

-t, --time time_t
    Ustawia czas wybudzenia na wartość bezwzględną time_t. time_t to czas w sekundach od 1970-01-01, 00:00 UTC. Czas można przekonwertować pomiędzy postacią czytelną a time_t narzędziem date(1).

-u, --utc
    Przyjmuje, że zegar sprzętowy jest ustawiony na czas uniwersalny UTC (Universal Time Coordinated), niezależnie od zawartości pliku adjtime.

-v, --verbose
    Więcej szczegółów.

-h, --help
    Wyświetla ten tekst i wychodzi.

-V, --version
    Wyświetla wersję i wychodzi.

UWAGI

Niektóre systemy nie mogą obecnie wyjść ze stanów uśpienia takich jak mem, korzystając tylko z kodu jądra dostępnego temu sterownikowi. Wymagają pomocy ze strony kodu z przestrzeni użytkownika, aby ponownie mógł zadziałać bufor ramki.

PLIKI

/etc/adjtime

HISTORIA

Program zamieszczono kilka razy na LKML i innych listach, przed jego pojawieniem się w komentarzu do zatwierdzenia zmiany GIT 87ac84f42a7a580d0dd72ae31d6a5eb4bfe04c6d przeznaczonej do Linuksa 2.6.

AUTORZY

Program napisał a ulepszył

PRAWA AUTORSKIE

Jest to wolne oprogramowanie. Można redystrybuować jego kopie na zasadach licencji BRAK GWARANCJI, w zakresie dozwolonym przez prawo.

ZOBACZ TAKŻE

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

ZGŁASZANIE BŁĘDÓW

Problemy należy zgłaszać w

DOSTĘPNOŚĆ

Polecenie rtcwake jest częścią pakietu util-linux, który można pobrać ze strony