.\" rtc.4
.\" Copyright 2002 Urs Thuermann (urs@isnogud.escape.de)
.\"
+.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
-.\" License along with this manual; if not, write to the Free
-.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
-.\" USA.
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END
.\"
.\" $Id: rtc.4,v 1.4 2005/12/05 17:19:49 urs Exp $
.\"
even while the computer is turned off.
RTCs often provide alarms and other interrupts.
-All i386 PCs, and ACPI based systems, have an RTC that is compatible with
+All i386 PCs, and ACPI-based systems, have an RTC that is compatible with
the Motorola MC146818 chip on the original PC/AT.
Today such an RTC is usually integrated into the mainboard's chipset
(south bridge), and uses a replaceable coin-sized backup battery.
Non-PC systems, such as embedded systems built around system-on-chip
processors, use other implementations.
They usually won't offer the same functionality as the RTC from a PC/AT.
-.SS RTC vs System Clock
+.SS RTC vs system clock
RTCs should not be confused with the system clock, which is
a software clock maintained by the kernel and used to implement
.BR gettimeofday (2)
and
.BR time (2),
-as well as setting timestamps on files, etc.
+as well as setting timestamps on files, and so on.
The system clock reports seconds and microseconds since a start point,
defined to be the POSIX Epoch: 1970-01-01 00:00:00 +0000 (UTC).
(One common implementation counts timer interrupts, once
To do so, the kernel has to briefly turn off periodic interrupts;
this might affect programs using that RTC.
-An RTC's Epoch has nothing to do with the POSIX Epoch which is only
-used for the system clock.
+An RTC's Epoch has nothing to do with the POSIX Epoch which is
+used only for the system clock.
If the year according to the RTC's Epoch and the year register is
less than 1970 it is assumed to be 100 years later, that is, between 2000
scenarios like periodic alarms at fifteen minutes after every hour,
or on the first day of each month.
Such usage is nonportable;
-portable user space code only expects a single alarm interrupt, and
+portable user-space code expects only a single alarm interrupt, and
will either disable or reinitialize the alarm after receiving it.
Some RTCs support periodic interrupts with periods that are multiples
nonvolatile memory;
and other hardware
capabilities that are not currently exposed by this API.
-.SH "SEE ALSO"
+.SH SEE ALSO
.BR date (1),
.BR adjtimex (2),
.BR gettimeofday (2),
.BR time (2),
.BR gmtime (3),
.BR time (7),
-.BR hwclock (8),
-/usr/src/linux/Documentation/rtc.txt
+.BR hwclock (8)
+
+.I Documentation/rtc.txt
+in the Linux kernel source tree
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.