1 |
.\" $MidnightBSD$ |
2 |
.\"- |
3 |
.\" Copyright (c) 2004 Jason L. Wright (jason@thought.net) |
4 |
.\" Copyright (c) 2005 Marius Strobl <marius@FreeBSD.org> |
5 |
.\" All rights reserved. |
6 |
.\" |
7 |
.\" Redistribution and use in source and binary forms, with or without |
8 |
.\" modification, are permitted provided that the following conditions |
9 |
.\" are met: |
10 |
.\" 1. Redistributions of source code must retain the above copyright |
11 |
.\" notice, this list of conditions and the following disclaimer. |
12 |
.\" 2. Redistributions in binary form must reproduce the above copyright |
13 |
.\" notice, this list of conditions and the following disclaimer in the |
14 |
.\" documentation and/or other materials provided with the distribution. |
15 |
.\" |
16 |
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR |
17 |
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED |
18 |
.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE |
19 |
.\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, |
20 |
.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES |
21 |
.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR |
22 |
.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) |
23 |
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, |
24 |
.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN |
25 |
.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE |
26 |
.\" POSSIBILITY OF SUCH DAMAGE. |
27 |
.\" |
28 |
.\" from: OpenBSD: clock.4,v 1.3 2004/09/24 07:04:15 miod Exp |
29 |
.\" $FreeBSD: stable/10/share/man/man4/man4.sparc64/rtc.4 147531 2005-06-22 15:35:14Z ru $ |
30 |
.\" |
31 |
.Dd June 18, 2005 |
32 |
.Dt RTC 4 sparc64 |
33 |
.Os |
34 |
.Sh NAME |
35 |
.Nm rtc |
36 |
.Nd "non-volatile RAM / real time clock" |
37 |
.Sh SYNOPSIS |
38 |
.Cd "device genclock" |
39 |
.Cd "device mc146818" |
40 |
.Cd "device rtc" |
41 |
.Sh DESCRIPTION |
42 |
The |
43 |
.Nm |
44 |
driver is a front-end for the machine-independent |
45 |
.Tn Motorola |
46 |
MC146818 and compatible clocks driver. |
47 |
The |
48 |
.Tn Motorola |
49 |
MC146818 and compatible clocks driver provides access to the real time clock |
50 |
part of the chips it supports to |
51 |
.Fx |
52 |
by interfacing with the generic clock code. |
53 |
.Pp |
54 |
.Tn Dallas / |
55 |
.Tn Maxim Semiconductor |
56 |
DS1287 chips |
57 |
(those are compatible to the |
58 |
.Tn Motorola |
59 |
MC146818 clocks) |
60 |
are found on the ISA bus of |
61 |
.Tn UltraSPARC II |
62 |
systems and the EBus bus of |
63 |
.Tn UltraSPARC III |
64 |
systems. |
65 |
.Sh DIAGNOSTICS |
66 |
The following driver specific error message may be reported: |
67 |
.Bl -diag |
68 |
.It "mc146818_attach_attach: battery low" |
69 |
The device signals that its battery is low and should be replaced. |
70 |
The |
71 |
.Nm |
72 |
driver refused to attach the device in this case as the time in the real time |
73 |
clock is probably invalid. |
74 |
This gives the generic clock code the chance to use another device as the |
75 |
system real time clock that otherwise would not have been chosen. |
76 |
.El |
77 |
.Sh SEE ALSO |
78 |
.Xr ebus 4 , |
79 |
.Xr eeprom 4 |
80 |
.Sh HISTORY |
81 |
The |
82 |
.Nm |
83 |
driver first appeared in |
84 |
.Fx 5.4 . |
85 |
.Sh AUTHORS |
86 |
The |
87 |
.Nm |
88 |
driver was written by |
89 |
.An "Marius Strobl" Aq marius@FreeBSD.org . |