From nils@tisys.org  Wed Jan 16 02:07:00 2002
Return-Path: <nils@tisys.org>
Received: from mcqueen.wolfsburg.de (pns.wobline.de [212.68.68.5])
	by hub.freebsd.org (Postfix) with ESMTP id 571CA37B400
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 16 Jan 2002 02:06:59 -0800 (PST)
Received: from colt.ncptiddische.net (ppp-181.wobline.de [212.68.69.189] (may be forged))
	by mcqueen.wolfsburg.de (8.11.3/8.11.3/tw-20010821) with ESMTP id g0GA6vc00362
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 16 Jan 2002 11:06:57 +0100
Received: from tisys.org (howie.ncptiddische.net [192.168.0.3])
	by colt.ncptiddische.net (8.11.6/8.11.6) with ESMTP id g0GA8PX89233
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 16 Jan 2002 11:08:25 +0100 (CET)
	(envelope-from nils@tisys.org)
Received: (from nils@localhost)
	by tisys.org (8.11.6/8.11.6) id g0GA7b100931;
	Wed, 16 Jan 2002 11:07:37 +0100 (CET)
	(envelope-from nils)
Message-Id: <200201161007.g0GA7b100931@tisys.org>
Date: Wed, 16 Jan 2002 11:07:37 +0100 (CET)
From: Nils Holland <nils@tisys.org>
Reply-To: Nils Holland <nils@tisys.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Add a timezone related hint to make world section of hb
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         33937
>Category:       docs
>Synopsis:       Add a timezone related hint to make world section of hb
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Wed Jan 16 02:10:10 PST 2002
>Closed-Date:    Mon Feb 11 11:04:22 PST 2002
>Last-Modified:  Mon Feb 11 11:04:39 PST 2002
>Originator:     Nils Holland
>Release:        FreeBSD 4.5-RC i386
>Organization:
Ti Systems
>Environment:
System: FreeBSD howie.ncptiddische.net 4.5-RC FreeBSD 4.5-RC #0: Sat Jan 12 10:37:03 CET 2002 root@poison.ncptiddische.net:/usr/obj/usr/src/sys/HOWIE i386

>Description:
	If a machine's time is set to local time (for example, CET) and
	not GMT, there is a potential that (not too dramatic, but still
	weird) problems may occur during a make installworld process.
	/usr/src/UDPATING therefore suggests that users running at local
	time run "adjkerntz -i" after having booted into single user
	mode and before starting the installworld process. However,
	in order to read this suggestion in UPDATING, one would have
	to scroll way down. Therefore, I guess the handbook should
	probably include the "adjkerntz -i" statement as well, and so
	I included it in the part that tells users how to boot into
	single user mode, right after the commands that are supposed
	to clean / mount the filesystems.

>How-To-Repeat:
	Boot into single user mode using boot -s, install world, reboot
	and notice that the files you have just installed are dated one
	hour in the future (IF your machine is set to local time). Try the
	same, but run adjkerntz -i before installworld and everything will
	be fine. Browse through /usr/src/UPDATING and see that somewhere,
	near the part on going from 3.x to 4.x, it also suggests local-time
	users to run adjkerntz -i, so I guess we should do the same ;-)
	(NOTE: To actually run into problems with this, you'd have to try
	to install certain ports, which will fail until the timestamp of the
	files installed by installworld is past ;-)

>Fix:
	The following patch, applied to handbook/cutting-edge/chapter.sgml
	fixes it ;-)


*** chapter.sgml	Wed Jan 16 10:27:30 2002
--- chapter-new	Wed Jan 16 10:57:24 2002
***************
*** 754,759 ****
--- 754,769 ----
        <para>This checks the filesystems, remounts <filename>/</filename>
  	read/write, mounts all the other UFS filesystems referenced in
  	<filename>/etc/fstab</filename> and then turns swapping on.</para>
+ 	
+ 	<para>If your CMOS clock is set to local time and not to GMT,
+ 	you should also run the following command:</para>
+ &prompt.root; <userinput>adjkerntz -i</userinput></screen>
+ 
+ 	<para>This will make sure that your local timezone settings
+ 	get set up correctly - without this, you may later run into some
+ 	not dramatic, but still weird problems.</para>
+ 
+ 
      </sect2>
  
      <sect2>
>Release-Note:
>Audit-Trail:

From: Ruslan Ermilov <ru@FreeBSD.org>
To: Nils Holland <nils@tisys.org>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/33937: Add a timezone related hint to make world section of hb
Date: Wed, 16 Jan 2002 13:09:36 +0200

 This info indeed should be added, thanks!
 
 On Wed, Jan 16, 2002 at 11:07:37AM +0100, Nils Holland wrote:
 > 
 > *** chapter.sgml	Wed Jan 16 10:27:30 2002
 > --- chapter-new	Wed Jan 16 10:57:24 2002
 > ***************
 > *** 754,759 ****
 > --- 754,769 ----
 >         <para>This checks the filesystems, remounts <filename>/</filename>
 >   	read/write, mounts all the other UFS filesystems referenced in
 >   	<filename>/etc/fstab</filename> and then turns swapping on.</para>
 > + 	
 > + 	<para>If your CMOS clock is set to local time and not to GMT,
 > + 	you should also run the following command:</para>
 > + &prompt.root; <userinput>adjkerntz -i</userinput></screen>
 > + 
 > + 	<para>This will make sure that your local timezone settings
 > + 	get set up correctly - without this, you may later run into some
 > + 	not dramatic, but still weird problems.</para>
 > + 
 > + 
 >       </sect2>
 >   
 >       <sect2>
 
 -- 
 Ruslan Ermilov		Oracle Developer/DBA,
 ru@sunbay.com		Sunbay Software AG,
 ru@FreeBSD.org		FreeBSD committer,
 +380.652.512.251	Simferopol, Ukraine
 
 http://www.FreeBSD.org	The Power To Serve
 http://www.oracle.com	Enabling The Information Age
State-Changed-From-To: open->closed 
State-Changed-By: jim 
State-Changed-When: Mon Feb 11 11:04:22 PST 2002 
State-Changed-Why:  
Committed, thanks! 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=33937 
>Unformatted:
