Hwclock is a program that runs under Linux and sets and queries the 
Hardware Clock, which is often called the Real Time Clock, RTC, or
CMOS clock.

You can set the Hardware Clock to a particular time or from the Linux
System Time.  You can set the Linux System Time from the Hardware
Clock, and a typical usage is to invoke hwclock from a system startup
script to initialize the System Time.

hwclock's --adjust function corrects systematic drift in the Hardware
Clock.  You just invoke it regularly and it corrects for a fast or
slow Hardware Clock.  hwclock automatically computes how fast or slow
the Hardware Clock is every time you set it.

hwclock uses /dev/rtc if it is available.  Otherwise, it uses its own
direct I/O to do what the rtc device driver would normally do.


INSTALLATION
------------

Hwclock is shipped with an ELF executable built for ISA (Intel)
machines.  So there is nothing to build for those machines.  Just
install the executable file "hwclock" and the man page file
"hwclock.8" in suitable directories (such as /sbin/hwclock and
/usr/man/man8/hwclock.8) and you're ready to go.

hwclock accesses platform-dependent hardware, so if you have something
other than an ISA machine, the shipped executable probably doesn't work,
and you have to compile hwclock yourself.

Sometimes, you need to install hwclock setuid root.  If you want users
other than the superuser to be able to display the clock value using the
direct ISA I/O method, install it setuid root.  If you have the /dev/rtc
interface on your system or are on a non-ISA system, there's no need for
users to use the direct ISA I/O method, so don't bother.

To install setuid root, do something like this:

  chmod a=rx,u=s /sbin/hwclock

In any case, hwclock will not allow you to set anything unless you
have the superuser _real_ uid.  (This restriction is not necessary if
you haven't installed setuid root, but it's there for now).

You may want to preformat and/or compress the man page before installing.

If you want to build hwclock, just cd to the src directory and invoke
make with no parameters.

hwclock calls option processing routines in the libsshopt library,
which is part of Sverre H. Huseby's "shhopt" package.  A copy of the
source code for this library is included in the package and the build
process will build a private copy of the library.  But you can use a
copy that is already on your system by altering the make file.  You
can find a more authoritative copy of this library, and its source
code, on sunsite (ftp://sunsite.unc.edu/pub/Linux/libs/shhopt-X.Y).


SERVICE
-------

hwclock is enthusiastically maintained by bryanh@giraffe-data.com
(Bryan Henderson).  Please email Bryan any bug reports, questions, or
suggestions.
