source: chapter07/setclock.xml@ 32220fb

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>
<sect1 id="ch-scripts-setclock">
<title>Configuring the setclock script</title>
<?dbhtml filename="setclock.html"?>

<indexterm zone="ch-scripts-setclock">
<primary sortas="d-setclock">setclock</primary>
<secondary>configuring</secondary></indexterm>

<para>This setclock script reads the time from your hardware clock, also
known as BIOS or CMOS (Complementry Metal-Oxide Semiconductor) clock, and either converts that time to localtime
using the <filename>/etc/localtime</filename> file (if the hardware clock
is set to GMT) or not (if the hardware clock is already set to localtime).
There is no way to auto-detect whether the hardware clock is set to GMT or
not, so we need to configure that here ourselves.</para>

<para>Change the value of the <emphasis>UTC</emphasis> variable below to a
<emphasis>0</emphasis> (zero) if your hardware clock is not set to GMT
time.</para>

<para>Create a new file <filename>/etc/sysconfig/clock</filename> by running
the following:</para>

<screen><userinput>cat &gt; /etc/sysconfig/clock &lt;&lt; "EOF"</userinput>
# Begin /etc/sysconfig/clock

UTC=1

# End /etc/sysconfig/clock
<userinput>EOF</userinput></screen>

<para>Now, you may want to take a look at a very good hint explaining how we
deal with time on LFS at <ulink url="&hints-root;time.txt"/>. 
It explains issues such as time zones, UTC, and the TZ environment
variable.</para>

</sect1>