Bug 860 - Kernel build instructions should match current distributions
Summary: Kernel build instructions should match current distributions
Keywords:
Status: CLOSED NOTABUG
Alias: None
Product: Red Hat Linux
Classification: Retired
Component: rhl-ig-x86
Version: 5.2
Hardware: All
OS: Linux
medium
medium
Target Milestone: ---
Assignee: Sandra Moore
QA Contact:
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 1999-01-18 03:24 UTC by Daniel Senie
Modified: 2014-08-04 22:22 UTC (History)
1 user (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 1999-06-29 17:25:14 UTC
Embargoed:


Attachments (Terms of Use)

Description Daniel Senie 1999-01-18 03:24:50 UTC
The instructions for building new kernels and placing them
into /boot, building modules and placing them and so forth
should match present RedHat distribution naming and build
conventions.

By this I mean the instructions in the book should
acknowledge the fact that the kernel isn't in /boot/vmlinuz
(now in a file named for the release, /boot/vmlinuz is an
unused link).

Building a custom kernel and installing it by the book's
instructions can cause problems. I suggest replacing this
text with the text of the web page for upgrading kernels,
with some modifications so that custom kernels are installed
with names like:

    vmlinuz-2.0.36-custom

and modules are placed in

    /lib/modules/2.0.36-custom

and so forth. If the makefiles had installation capabilities
which did this, so much the better.

It appears this particular text in the printed manual has
not changed in many releases, but the software has.

Comment 1 Jeff Johnson 1999-01-18 14:57:59 UTC
The instructions (installation guide p 197) document how to build a
working Linux kernel. The instructions do not document how Red Hat
packages kernels. The kernel packaging is designed to permit
installation of custom kernels from sources other than Red Hat
without interference from the Red Hat kernel package.

The makefiles in the kernel are deliberately *not* modified
in order to provide a consistent way of building custom
kernels. See the kernel spec file if you are interested in
how Red Hat packages kernels.

Comment 2 Daniel Senie 1999-01-18 15:12:59 UTC
While I don't want to belabor the point, the issue is things like
telling you to move the old kernel out of the way, and building new
initrd images and such result in the files in the /boot directory
somewhat altered in structure from the original.

If that's how you prefer it, I'll drop it there.

It will potentially result in systems which get mangled worse during
a subsequent upgrade to a new version of RHL using the CDROM
installer.

It seemed to me that updating these instructions some would be a real
service to your paying customers.

Had I not had a production system mangled last night as a result of
the instructions NOT working so well, I would not have bothered
opening this bug. I've built lots of kernels in the past, and will
continue to do so, but the only thing I use custom kernels for is to
rebuild the kernel that matches the stock one for the current release
to add a driver or two. Your book seemed to be attempting to describe
the process for doing just this, making a slightly custom version of
the installed kernel. If the instructions don't match the naming users
are going to find, you might as well save a few fractions of a tree
and remove those sections of the manual.

I've said my piece. You can go close this bug again.


Note You need to log in before you can comment on or make changes to this bug.