From owner-freebsd-doc@FreeBSD.ORG Wed Jul 27 11:52:35 2005 Return-Path: X-Original-To: freebsd-doc@FreeBSD.org Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id BFFC316A420 for ; Wed, 27 Jul 2005 11:52:35 +0000 (GMT) (envelope-from jhb@FreeBSD.org) Received: from mail22.sea5.speakeasy.net (mail22.sea5.speakeasy.net [69.17.117.24]) by mx1.FreeBSD.org (Postfix) with ESMTP id D67DE43D77 for ; Wed, 27 Jul 2005 11:52:34 +0000 (GMT) (envelope-from jhb@FreeBSD.org) Received: (qmail 21759 invoked from network); 27 Jul 2005 11:52:34 -0000 Received: from server.baldwin.cx ([216.27.160.63]) (envelope-sender ) by mail22.sea5.speakeasy.net (qmail-ldap-1.03) with AES256-SHA encrypted SMTP for ; 27 Jul 2005 11:52:33 -0000 Received: from zion.baldwin.cx (zion.baldwin.cx [192.168.0.7]) (authenticated bits=0) by server.baldwin.cx (8.13.1/8.13.1) with ESMTP id j6RBqGoH033337; Wed, 27 Jul 2005 07:52:24 -0400 (EDT) (envelope-from jhb@FreeBSD.org) From: John Baldwin To: freebsd-doc@FreeBSD.org, garys@opusnet.com Date: Wed, 27 Jul 2005 07:52:05 -0400 User-Agent: KMail/1.8 References: In-Reply-To: MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-6" Content-Transfer-Encoding: quoted-printable Content-Disposition: inline Message-Id: <200507270752.06458.jhb@FreeBSD.org> X-Spam-Status: No, score=-2.8 required=4.2 tests=ALL_TRUSTED autolearn=failed version=3.0.2 X-Spam-Checker-Version: SpamAssassin 3.0.2 (2004-11-16) on server.baldwin.cx Cc: FreeBSD-gnats-submit@FreeBSD.org Subject: Re: docs/84154: Handbook somewhat off in use of /boot/kernel.old X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 27 Jul 2005 11:52:36 -0000 On Wednesday 27 July 2005 01:57 am, Gary W. Swearingen wrote: > >Number: 84154 > >Category: docs > >Synopsis: Handbook somewhat off in use of /boot/kernel.old > >Confidential: no > >Severity: non-critical > >Priority: low > >Responsible: freebsd-doc > >State: open > >Quarter: > >Keywords: > >Date-Required: > >Class: doc-bug > >Submitter-Id: current-users > >Arrival-Date: Wed Jul 27 06:00:32 GMT 2005 > >Closed-Date: > >Last-Modified: > >Originator: Gary W. Swearingen > >Release: FreeBSD 5.4-RELEASE i386 > >Organization: > > none > > >Environment: > > n/a > > >Description: > > The handbook's concept of /boot/kernel always being moved to > /boot/kernel.old is wrong (in two places). The move is only > made if the currently running kernel came from /boot/kernel/. > > >How-To-Repeat: > > n/a > > >Fix: > > -- In section 8.3 Building and Installing a Custom Kernel, > > change > The new kernel will be copied to the /boot/kernel directory as > /boot/kernel/kernel and the old kernel will be moved to > /boot/kernel.old/kernel. > to > The new kernel and modules will be copied to the /boot/kernel directory > but that directory will first be moved in place of /boot/kernel.old > if the currently running kernel came from "/boot/kernel". How about: The new kernel and modules will be copied to the /boot/kernel directory. I= f=20 the currently running kernel came from "/boot/kernel", then the old kernel= =20 and modules will be moved to the /boot/kernel.old directory. > -- In section 8.6, under "The kernel does not boot", > > change > You cannot rely on > kernel.old because when installing a new kernel, > kernel.old is overwritten with the last installed kernel > which may be non-functional. > to > Standard kernel builds write to /boot/kernel, with > that directory first moved in place of /boot/kernel.old > if the currently running kernel came from /boot/kernel. I haven't read the full doc for context, but it looks like the replacement= =20 text doesn't actually replace the same meaning. The reason for kernel.old= =20 only getting updated if the kernel being installed is running is to try to= =20 make kernel.old more reliable as in theory it should always be a kernel tha= t=20 was running well enough to do an installkernel now. Probably the surroundi= ng=20 section here needs more updating to reflect that larger change. =2D-=20 John Baldwin =A0<>< =A0http://www.FreeBSD.org/~jhb/ "Power Users Use the Power to Serve" =A0=3D =A0http://www.FreeBSD.org