'\" t
.\"     Title: rtcwake
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: Administracja systemem
.\"    Source: util-linux 2.42.3
.\"  Language: English
.\"
.TH "RTCWAKE" "8" "2026-09-02" "util\-linux 2.42.3" "Administracja systemem"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAZWA"
rtcwake \- wchodzi w stan uśpienia systemu do zadanego czasu wybudzenia
.SH "SKŁADNIA"
.sp
\fBrtcwake\fP [opcje] [\fB\-d\fP \fIurządzenie\fP] [\fB\-m\fP \fItryb\-uśpienia\fP] {\fB\-s\fP \fIsekundy\fP|\fB\-t\fP \fItime_t\fP}
.SH "OPIS"
.sp
Program służy do przejścia w systemowy stan uśpienia i automatycznego wybudzenia z niego o podanym czasie.
.sp
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.
.sp
Zwykle korzysta się z niego jak ze starego narzędzia \fBapmsleep\fP, 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.
.sp
W większości systemów, można z niego korzystać jak z \fBnvram\-wakeup\fP, 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.
.sp
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ść.
.sp
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. \fBrtcwake\fP stara się uniknąć tego problemu, odczekując na stabilizację terminala przed przejściem w stan uśpienia.
.SH "OPCJE"
.sp
\fB\-A\fP, \fB\-\-adjfile\fP \fIplik\fP
.RS 4
Określa alternatywną ścieżkę pliku dostosowania.
.RE
.sp
\fB\-a\fP, \fB\-\-auto\fP
.RS 4
Odczytuje tryb zegara (tego, czy zegar sprzętowy jest ustawiony na UTC, czy na czas lokalny) z pliku \fIadjtime\fP, gdzie \fBhwclock\fP(8) przechowuje tę informację. Tak jest domyślnie.
.RE
.sp
\fB\-\-date\fP \fIznacznik\-czasu\fP
.RS 4
Ustawia czas wybudzenia na wartość podanego znacznika czasowego. Formatem \fIznacznika\-czasu\fP może być jeden z poniższych:
.sp
.if n .RS 4
.nf
.fam C
 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)
.fam
.fi
.if n .RE
.sp
Przykłady formatu \fB+\fP\fIliczba\fP[\fBsmhd\fP] to: \fB+5m\fP, \fB+6h\fP, \fB+2d\fP. Jako jednostkę można podać też dłuższy angielski wariant: \fB+5min\fP, \fB+6hours\fP, \fB+2days\fP.
.RE
.sp
\fB\-d\fP, \fB\-\-device\fP \fIurządzenie\fP
.RS 4
Używa podanego \fIurządzenia\fP jako zegara czasu rzeczywistego, zamiast \fBrtc0\fP. Opcja ma znaczenie tylko, jeśli w systemie jest więcej niż jeden RTC. Można tu podać \fBrtc1\fP, \fBrtc2\fP, .\|.\|. .
.RE
.sp
\fB\-l\fP, \fB\-\-local\fP
.RS 4
Przyjmuje, że zegar sprzętowy jest ustawiony na czas lokalny, niezależnie od zawartości pliku \fIadjtime\fP.
.RE
.sp
\fB\-\-list\-modes\fP
.RS 4
Wypisuje dostępne argumenty opcji \fB\-\-mode\fP.
.RE
.sp
\fB\-m\fP, \fB\-\-mode\fP \fItryb\fP
.RS 4
Przechodzi w podany stan wstrzymania. Prawidłowymi wartościami \fItrybu\fP są:
.sp
\fBstandby\fP
.RS 4
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.
.RE
.sp
\fBfreeze\fP
.RS 4
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).
.RE
.sp
\fBmem\fP
.RS 4
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.
.RE
.sp
\fBdisk\fP
.RS 4
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.
.RE
.sp
\fBoff\fP
.RS 4
Stan S5 ACPI (wyłączenie). Dokonywane przez wywołanie "/sbin/shutdown". Nie jest oficjalnie obsługiwane przez ACPI, lecz zwykle działa.
.RE
.sp
\fBno\fP
.RS 4
Nie wstrzymuje, jedynie ustawia czas wybudzenia RTC.
.RE
.sp
\fBon\fP
.RS 4
Nie wstrzymuje, lecz odczytuje urządzenie RTC do wystąpienia czasu alarmu. Tryb przydatny do debugowania.
.RE
.sp
\fBdisable\fP
.RS 4
Wyłącza alarm ustawiony wcześniej.
.RE
.sp
\fBshow\fP
.RS 4
Pokazuje informacje o alarmie w postaci: "alarm: wyłączony|włączony <czas>". Czas występuje w formacie wyjściowym \fBctime\fP(3) np. "alarm: włączony wto 16 lis 04:48:45 2010".
.RE
.RE
.sp
\fB\-n\fP, \fB\-\-dry\-run\fP
.RS 4
Opcja wykonuje wszystko, poza faktycznym ustawieniem alarmu, wstrzymaniem systemu lub czekaniem na alarm.
.RE
.sp
\fB\-s\fP, \fB\-\-seconds\fP \fIsekundy\fP
.RS 4
Ustawia czas wybudzenia na liczbę \fIsekund\fP od teraz.
.RE
.sp
\fB\-t\fP, \fB\-\-time\fP \fItime_t\fP
.RS 4
Ustawia czas wybudzenia na wartość bezwzględną \fItime_t\fP. \fItime_t\fP to czas w sekundach od 1970\-01\-01, 00:00 UTC. Czas można przekonwertować pomiędzy postacią czytelną a \fItime_t\fP narzędziem \fBdate\fP(1).
.RE
.sp
\fB\-u\fP, \fB\-\-utc\fP
.RS 4
Przyjmuje, że zegar sprzętowy jest ustawiony na czas uniwersalny UTC (Universal Time Coordinated), niezależnie od zawartości pliku \fIadjtime\fP.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
Więcej szczegółów.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Wyświetla ten tekst i wychodzi.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Wyświetla wersję i wychodzi.
.RE
.SH "UWAGI"
.sp
Niektóre systemy nie mogą obecnie wyjść ze stanów uśpienia takich jak \fBmem\fP, 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.
.SH "PLIKI"
.sp
\fI/etc/adjtime\fP
.SH "HISTORIA"
.sp
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.
.SH "AUTORZY"
.sp
Program napisał \c
.MTO "dbrownell\(atusers.sourceforge.net" "David Brownell" ","
a ulepszył
.MTO "bwalle\(atsuse.de" "Bernhard Walle" "."
.SH "PRAWA AUTORSKIE"
.sp
Jest to wolne oprogramowanie. Można redystrybuować jego kopie na zasadach licencji \c
.URL "http://www.gnu.org/licenses/gpl.html" "GNU General Public License" "."
BRAK GWARANCJI, w zakresie dozwolonym przez prawo.
.SH "ZOBACZ TAKŻE"
.sp
\fBadjtime_config\fP(5), \fBhwclock\fP(8), \fBdate\fP(1)
.SH "ZGŁASZANIE BŁĘDÓW"
.sp
Problemy należy zgłaszać w \c
.URL "https://github.com/util\-linux/util\-linux/issues" "systemie śledzenia błędów" "."
.SH "DOSTĘPNOŚĆ"
.sp
Polecenie \fBrtcwake\fP jest częścią pakietu util\-linux, który można pobrać ze strony \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Archiwum jądra Linux" "."