From pepper@reppep.com  Wed Feb  5 19:57:58 2003
Return-Path: <pepper@reppep.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id E9BAB37B401; Wed,  5 Feb 2003 19:57:58 -0800 (PST)
Received: from www.reppep.com (www.reppep.com [66.92.104.200])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 6ECFE43F93; Wed,  5 Feb 2003 19:57:58 -0800 (PST)
	(envelope-from pepper@reppep.com)
Received: by www.reppep.com (Postfix, from userid 501)
	id 601BCFDD2; Wed,  5 Feb 2003 22:57:57 -0500 (EST)
Message-Id: <20030206035757.601BCFDD2@www.reppep.com>
Date: Wed,  5 Feb 2003 22:57:57 -0500 (EST)
From: Chris Pepper <pepper@rockefeller.edu>
Reply-To: Chris Pepper <pepper@rockefeller.edu>
To: FreeBSD-gnats-submit@freebsd.org
Cc: imp@freebsd.org
Subject: Handbook section on upgrading kernel says to test new kernel, but not what to test.
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         47991
>Category:       docs
>Synopsis:       Handbook section on upgrading kernel says to test new kernel, but not what to test.
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Feb 05 20:00:04 PST 2003
>Closed-Date:    Sat Nov 04 03:13:35 GMT 2006
>Last-Modified:  Sat Nov 04 03:13:35 GMT 2006
>Originator:     Chris Pepper
>Release:        FreeBSD 4.7-STABLE i386
>Organization:
>Environment:
System: FreeBSD www.reppep.com 4.7-STABLE FreeBSD 4.7-STABLE #0: Tue Dec 3 14:05:51 EST 2002 root@www.reppep.com:/usr/obj/usr/src/sys/REPPEP i386


	
>Description:
	<http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html#AEN27243> says after "make installworld" one should boot single-user to verify the new kernel works, but not how to perform this verification:

      <div class="SECT2">
        <h2 class="SECT2"><a id="AEN27243" name="AEN27243">21.4.8
        Reboot into Single User Mode</a></h2>

        <p>You should reboot into single user mode to test the new
        kernel works. Do this by following the instructions in <a
        href="makeworld.html#MAKEWORLD-SINGLEUSER">Section
        21.4.4</a>.</p>
      </div>

	I had previously thought I should verify the functionality of ps and friends, but I just did an installworld and broke ps. I now think this is simply an indication of the kernel having evolved, and installworld would clear the problem up, but the Handbook (and UPDATING) should have some information on what to test at this stage, and probably at minimum a reference to <http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig-trouble.html> for tips on backing out a bad kernel.
>How-To-Repeat:
	Rebuild a kernel, read the Handbook, and try to determine if all is well or busted after "make installkernel" and reboot.
	
>Fix:
	Clarify what to look for after make installkernel and before make installworld, and exit strategies if things go in the pot.
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Sat Aug 9 12:18:25 PDT 2003 
Responsible-Changed-Why:  
I'll review this, therefor assign it to me. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=47991 
State-Changed-From-To: open->closed 
State-Changed-By: trhodes 
State-Changed-When: Sat Nov 4 03:13:06 UTC 2006 
State-Changed-Why:  
I'm too late, this has changed during the years and the 
problem went away.  Thanks Chris! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=47991 
>Unformatted: