]>
Commit | Line | Data |
---|---|---|
295b3979 | 1 | //po4a: entry man manual |
fd8c1504 MB |
2 | = rtcwake(8) |
3 | :doctype: manpage | |
4 | :man manual: System Administration | |
5 | :man source: util-linux {release-version} | |
6 | :page-layout: base | |
7 | :command: rtcwake | |
8 | ||
9 | == NAME | |
10 | ||
11 | rtcwake - enter a system sleep state until specified wakeup time | |
12 | ||
13 | == SYNOPSIS | |
14 | ||
4d297435 | 15 | *rtcwake* [options] [*-d* _device_] [*-m* _standby_mode_] {*-s* _seconds_|*-t* _time_t_} |
fd8c1504 MB |
16 | |
17 | == DESCRIPTION | |
18 | ||
19 | This program is used to enter a system sleep state and to automatically wake from it at a specified time. | |
20 | ||
21 | This uses cross-platform Linux interfaces to enter a system sleep state, and leave it no later than a specified time. It uses any RTC framework driver that supports standard driver model wakeup flags. | |
22 | ||
23 | This is normally used like the old *apmsleep* utility, to wake from a suspend state like ACPI S1 (standby) or S3 (suspend-to-RAM). Most platforms can implement those without analogues of BIOS, APM, or ACPI. | |
24 | ||
25 | On some systems, this can also be used like *nvram-wakeup*, waking from states like ACPI S4 (suspend to disk). Not all systems have persistent media that are appropriate for such suspend modes. | |
26 | ||
27 | Note that alarm functionality depends on hardware; not every RTC is able to setup an alarm up to 24 hours in the future. | |
28 | ||
bd67ca44 | 29 | The suspend setup may be interrupted by active hardware; for example wireless USB input devices that continue to send events for some fraction of a second after the return key is pressed. *rtcwake* tries to avoid this problem and it waits to the terminal to settle down before entering a system sleep. |
fd8c1504 MB |
30 | |
31 | == OPTIONS | |
32 | ||
33 | *-A*, *--adjfile* _file_:: | |
4eab78d3 | 34 | Specify an alternative path to the adjust file. |
fd8c1504 MB |
35 | |
36 | *-a*, *--auto*:: | |
4eab78d3 | 37 | Read the clock mode (whether the hardware clock is set to UTC or local time) from the _adjtime_ file, where *hwclock*(8) stores that information. This is the default. |
fd8c1504 MB |
38 | |
39 | *--date* _timestamp_:: | |
4eab78d3 | 40 | Set the wakeup time to the value of the timestamp. Format of the timestamp can be any of the following: |
d315cc4d MB |
41 | |
42 | [cols=",",] | |
43 | |=== | |
44 | |YYYYMMDDhhmmss | | |
45 | |YYYY-MM-DD hh:mm:ss | | |
46 | |YYYY-MM-DD hh:mm |(seconds will be set to 00) | |
47 | |YYYY-MM-DD |(time will be set to 00:00:00) | |
48 | |hh:mm:ss |(date will be set to today) | |
49 | |hh:mm |(date will be set to today, seconds to 00) | |
50 | |tomorrow |(time is set to 00:00:00) | |
51 | |+5min | | |
52 | |=== | |
fd8c1504 MB |
53 | |
54 | *-d*, *--device* _device_:: | |
4eab78d3 | 55 | Use the specified _device_ instead of *rtc0* as realtime clock. This option is only relevant if your system has more than one RTC. You may specify *rtc1*, *rtc2*, ... here. |
fd8c1504 MB |
56 | |
57 | *-l*, *--local*:: | |
4eab78d3 | 58 | Assume that the hardware clock is set to local time, regardless of the contents of the _adjtime_ file. |
fd8c1504 MB |
59 | |
60 | *--list-modes*:: | |
4eab78d3 | 61 | List available *--mode* option arguments. |
fd8c1504 MB |
62 | |
63 | *-m*, *--mode* _mode_:: | |
4eab78d3 MB |
64 | Go into the given standby state. Valid values for _mode_ are: |
65 | ||
66 | *standby*;; | |
67 | ACPI state S1. This state offers minimal, though real, power savings, while providing a very low-latency transition back to a working system. This is the default mode. | |
68 | ||
69 | *freeze*;; | |
70 | The processes are frozen, all the devices are suspended and all the processors idled. This state is a general state that does not need any platform-specific support, but it saves less power than Suspend-to-RAM, because the system is still in a running state. (Available since Linux 3.9.) | |
71 | ||
72 | *mem*;; | |
73 | ACPI state S3 (Suspend-to-RAM). This state offers significant power savings as everything in the system is put into a low-power state, except for memory, which is placed in self-refresh mode to retain its contents. | |
74 | ||
75 | *disk*;; | |
76 | ACPI state S4 (Suspend-to-disk). This state offers the greatest power savings, and can be used even in the absence of low-level platform support for power management. This state operates similarly to Suspend-to-RAM, but includes a final step of writing memory contents to disk. | |
77 | ||
78 | *off*;; | |
79 | ACPI state S5 (Poweroff). This is done by calling '/sbin/shutdown'. Not officially supported by ACPI, but it usually works. | |
80 | ||
81 | *no*;; | |
82 | Don't suspend, only set the RTC wakeup time. | |
83 | ||
84 | *on*;; | |
85 | Don't suspend, but read the RTC device until an alarm time appears. This mode is useful for debugging. | |
86 | ||
87 | *disable*;; | |
88 | Disable a previously set alarm. | |
89 | ||
90 | *show*;; | |
91 | Print alarm information in format: "alarm: off|on <time>". The time is in ctime() output format, e.g., "alarm: on Tue Nov 16 04:48:45 2010". | |
fd8c1504 MB |
92 | |
93 | *-n*, *--dry-run*:: | |
4eab78d3 | 94 | This option does everything apart from actually setting up the alarm, suspending the system, or waiting for the alarm. |
fd8c1504 MB |
95 | |
96 | *-s*, *--seconds* _seconds_:: | |
4eab78d3 | 97 | Set the wakeup time to _seconds_ in the future from now. |
fd8c1504 MB |
98 | |
99 | *-t*, *--time* _time_t_:: | |
4eab78d3 | 100 | Set the wakeup time to the absolute time _time_t_. _time_t_ is the time in seconds since 1970-01-01, 00:00 UTC. Use the *date*(1) tool to convert between human-readable time and _time_t_. |
fd8c1504 MB |
101 | |
102 | *-u*, *--utc*:: | |
4eab78d3 | 103 | Assume that the hardware clock is set to UTC (Universal Time Coordinated), regardless of the contents of the _adjtime_ file. |
fd8c1504 MB |
104 | |
105 | *-v*, *--verbose*:: | |
4eab78d3 | 106 | Be verbose. |
fd8c1504 | 107 | |
2b2d3172 | 108 | include::man-common/help-version.adoc[] |
fd8c1504 MB |
109 | |
110 | == NOTES | |
111 | ||
112 | Some PC systems can't currently exit sleep states such as *mem* using only the kernel code accessed by this driver. They need help from userspace code to make the framebuffer work again. | |
113 | ||
114 | == FILES | |
115 | ||
ef63c72a | 116 | _{ADJTIME_PATH}_ |
fd8c1504 MB |
117 | |
118 | == HISTORY | |
119 | ||
120 | The program was posted several times on LKML and other lists before appearing in kernel commit message for Linux 2.6 in the GIT commit 87ac84f42a7a580d0dd72ae31d6a5eb4bfe04c6d. | |
121 | ||
122 | == AUTHORS | |
123 | ||
4d297435 | 124 | The program was written by mailto:dbrownell@users.sourceforge.net[David Brownell] and improved by mailto:bwalle@suse.de[Bernhard Walle]. |
fd8c1504 MB |
125 | |
126 | == COPYRIGHT | |
127 | ||
4d297435 | 128 | This is free software. You may redistribute copies of it under the terms of the link:http://www.gnu.org/licenses/gpl.html[GNU General Public License]. There is NO WARRANTY, to the extent permitted by law. |
fd8c1504 MB |
129 | |
130 | == SEE ALSO | |
131 | ||
71811eea | 132 | *adjtime_config*(5), |
fd8c1504 MB |
133 | *hwclock*(8), |
134 | *date*(1) | |
135 | ||
625e9c61 | 136 | include::man-common/bugreports.adoc[] |
fd8c1504 | 137 | |
625e9c61 | 138 | include::man-common/footer.adoc[] |
fd8c1504 MB |
139 | |
140 | ifdef::translation[] | |
625e9c61 | 141 | include::man-common/translation.adoc[] |
fd8c1504 | 142 | endif::[] |