From owner-freebsd-doc Wed Feb 5 20: 0: 9 2003 Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 31C4B37B401 for ; Wed, 5 Feb 2003 20:00:07 -0800 (PST) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9702A43FBD for ; Wed, 5 Feb 2003 20:00:05 -0800 (PST) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.6/8.12.6) with ESMTP id h16405NS033462 for ; Wed, 5 Feb 2003 20:00:05 -0800 (PST) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.6/8.12.6/Submit) id h16405ZJ033461; Wed, 5 Feb 2003 20:00:05 -0800 (PST) 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 Reply-To: Chris Pepper To: FreeBSD-gnats-submit@FreeBSD.org Cc: imp@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/47991: Handbook section on upgrading kernel says to test new kernel, but not what to test. Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >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: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Wed Feb 05 20:00:04 PST 2003 >Closed-Date: >Last-Modified: >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: says after "make installworld" one should boot single-user to verify the new kernel works, but not how to perform this verification:

21.4.8 Reboot into Single User Mode

You should reboot into single user mode to test the new kernel works. Do this by following the instructions in Section 21.4.4.

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 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: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message