minix/commands/readclock/readclock.8

   1 .TH READCLOCK 8
   2 .SH NAME
   3 readclock \- read or set a real time clock
   4 .SH SYNOPSIS
   5 \fBreadclock\fP [\fB\-nqwW2\fP]
   6 .SH DESCRIPTION
   7 .B Readclock
   8 reads the real time clock and sets the operating system time.  It is usually
   9 the second thing done in
  10 .BR /etc/rc ,
  11 the first thing is setting the time zone by sourcing
  12 .BR /etc/profile .
  13 This means that the clock is assumed to tell the wall clock time.  If you
  14 want to run the clock in GMT then you can put
  15 .B "TZ=GMT"
  16 (or any other TZ value) in front of the readclock command.
  17 .SH OPTIONS
  18 .TP
  19 .B \-n
  20 Play-act, don't set the time nor change the calibration data, just show what
  21 would be done.
  22 .TP
  23 .B \-q
  24 Quiet execution. Suppresses all output.
  25 .TP
  26 .B \-w
  27 Write the current time to the hardware clock.  Dangerous, see
  28 .BR BUGS .
  29 Don't forget to use
  30 .B "TZ=GMT"
  31 in front of readclock if the clock should run in GMT.
  32 .TP
  33 .B \-W
  34 Like
  35 .BR \-w ,
  36 but also sets the status registers of the CMOS clock to their proper values.
  37 (For if the clock suddenly runs at an odd pace or has stopped and the BIOS
  38 doesn't repair it.)
  39 .TP
  40 .BR \-2 ,
  41 Add 20 to any year before 2000.  If your CMOS clock year can't run past 2000,
  42 then you can set it to 1980 and use
  43 .B \-2
  44 to correct the year.  Together with
  45 .B \-w
  46 the year minus 20 is written to the clock.
  47 .SH FILES
  48 .TP 20n
  49 /etc/profile
  50 Timezone and other shell initialization code.
  51 .SH "SEE ALSO"
  52 .BR date (1),
  53 .BR utime (1).
  54 .SH BUGS
  55 Reported to not work on some AT's.
  56 .PP
  57 May mess up the clock royally when setting it
  58 .RB ( \-w ).
  59 Only if you have a very standard AT and you are not afraid of having your
  60 CMOS setup reset to the default with a "checksum error" should you use
  61 .BR readclock
  62 to set the time of the CMOS clock.  You have been warned.
  63 .SH AUTHOR
  64 Kees J. Bot (kjb@cs.vu.nl)