share/man/man4/man4.sparc64/rtc.4

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