newxml/chapter07/setclock.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
   3   <!ENTITY % general-entities SYSTEM "../general.ent">
   4   %general-entities;
   5 ]>
   6 <sect1 id="ch-scripts-setclock">
   7 <title>Configuring the setclock script</title>
   8 <?dbhtml filename="setclock.html"?>
   9
  10 <indexterm zone="ch-scripts-setclock">
  11 <primary sortas="d-setclock">setclock</primary>
  12 <secondary>configuring</secondary></indexterm>
  13
  14 <para>This setclock script reads the time from your hardware clock, also
  15 known as BIOS or CMOS (Complementry Metal-Oxide Semiconductor) clock, and either converts that time to localtime
  16 using the <filename>/etc/localtime</filename> file (if the hardware clock
  17 is set to GMT) or not (if the hardware clock is already set to localtime).
  18 There is no way to auto-detect whether the hardware clock is set to GMT or
  19 not, so we need to configure that here ourselves.</para>
  20
  21 <para>Change the value of the <emphasis>UTC</emphasis> variable below to a
  22 <emphasis>0</emphasis> (zero) if your hardware clock is not set to GMT
  23 time.</para>
  24
  25 <para>Create a new file <filename>/etc/sysconfig/clock</filename> by running
  26 the following:</para>
  27
  28 <screen><userinput>cat &gt; /etc/sysconfig/clock &lt;&lt; "EOF"</userinput>
  29 # Begin /etc/sysconfig/clock
  30
  31 UTC=1
  32
  33 # End /etc/sysconfig/clock
  34 <userinput>EOF</userinput></screen>
  35
  36 <para>Now, you may want to take a look at a very good hint explaining how we
  37 deal with time on LFS at <ulink url="&hints-root;time.txt"/>.
  38 It explains issues such as time zones, UTC, and the TZ environment
  39 variable.</para>
  40
  41 </sect1>