Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 45970 - Genkernel documentation should include required setting information
Summary: Genkernel documentation should include required setting information
Status: RESOLVED INVALID
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Handbook (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Docs Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2004-03-28 03:47 UTC by Paul Grimes
Modified: 2004-03-28 05:30 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Paul Grimes 2004-03-28 03:47:10 UTC
In order to get genkernel generated initrd and kernels to work, you must compile the filesystems used for the initrd and your /boot and / into the kernel.  This is the cause of most of the kernel booting errors that occur at "Stage 4: mouting root file system" output.

This is not mentioned anywhere in the genkernel documentation.  Although this is a requirement of using the initrd, not genkernel, since genkernel uses initrd by default, it is essential that the genkernel documentation mention this for people not used to using initrd, especially in either the handbook or the install documentation.  There are a number of inconclusive forum threads on the subject, but it is not easy to search for as it is often classed as an "error in booting".


Reproducible: Always
Steps to Reproduce:
1.  Search forums, fail to find answer quickly :-)
2.  Read documentation, fail to find solution
3.
				
Actual Results:  
Booting problem not solved 

Expected Results:  
Solution for problem found quickly
Comment 1 Sven Vermeulen (RETIRED) gentoo-dev 2004-03-28 05:30:21 UTC
You added this to the "Handbook" component, but you talk about the genkernel document. The Gentoo Handbook states this:

"""
Note that, if your boot partition doesn't use ext2 or ext3 as filesystem you need to manually configure your kernel using genkernel --menuconfig all and add support for your filesystem in the kernel (i.e. not as a module).
"""

The genkernel document itself doesn't mention it, but it isn't the main goal of genkernel.xml anyway. As you said before, it's not genkernel's fault.