docs/84154: Handbook somewhat off in use of /boot/kernel.old

[Gary W. Swearingen]

>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".


-- 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.

>Release-Note:
>Audit-Trail:
>Unformatted: