Bug 75864

Summary: FreeBSD 5.3 kern-developer install does not add Makefile in /usr/src
Product: Documentation Reporter: Eli K. Breen <eli>
Component: Books & ArticlesAssignee: Pav Lucistnik <pav>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Eli K. Breen 2005-01-05 19:50:12 UTC 
When installing FreeBSD 5.3-RELEASE and selecting the Kern-Developer install,
which provides kernel sources in addition to the minimal install, there is no
Makefile provided in /usr/src. This prevents recompiling the kernel as per the
documentation throughout the FreeBSD website. The recommended procedure for
compiling a new kernel is to cd /usr/src and run "make buildkernel or make
installkernel". 

Simply adding the Makefile and Makefile.inc from a full-install 5.3-RELEASE
machine allows for the kernel to be built and installed. (cd /usr/src && make
buildkernel KERNCONF=FOO && make installkernel KERNCONF=FOO

Cheers.

Fix: 

Standard install "kern-developer" should add the appropriate Makefile to /usr/src.
How-To-Repeat: Install FreeBSD 5.3-RELEASE from CD Media, install using standard install
"kern-developer" (Installs kernel sources only). 

Once the install is complete, cd /usr/src in order to recompile the kernel.

ls -l Makefile. 
File not found
Comment 1 brooks 2005-01-05 20:44:32 UTC 
Installing just the Makefile would serve no purpose.  The point of
buildkernel is that it can use the tools from buildworld to make the
kernel.  That requires all the sources.  The old method of building
kernels must be used unless you are going to install all sources.

IMO, this is documentation bug.

-- Brooks
Comment 2 Brooks Davis freebsd_committer freebsd_triage 2005-01-05 20:52:43 UTC 
Responsible Changed
From-To: freebsd-bugs->freebsd-doc

Assign to -doc since the real issue is that you can't do buildkernel 
usefully without full sources.
Comment 3 Eli K. Breen 2005-01-05 23:24:26 UTC 
Noted.

Thanks!

-E-

Brooks Davis wrote:
> Installing just the Makefile would serve no purpose.  The point of
> buildkernel is that it can use the tools from buildworld to make the
> kernel.  That requires all the sources.  The old method of building
> kernels must be used unless you are going to install all sources.
> 
> IMO, this is documentation bug.
> 
> -- Brooks
Comment 4 Pav Lucistnik freebsd_committer freebsd_triage 2005-08-18 21:03:55 UTC 
Brooks,

would something like this added to Handbook chapter about compiling
kernel satisfy you?

Procedure 2. Building a Kernel the "New" Way
[..]
+ Note: This method of kernel building requires full source files.
  If you only installed the kernel source, use the traditional method,
  as described above.

http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig-building.html

-- 
Pav Lucistnik <pav@oook.cz>
              <pav@FreeBSD.org>
Comment 5 brooks 2005-08-18 21:08:58 UTC 
On Thu, Aug 18, 2005 at 10:03:55PM +0200, Pav Lucistnik wrote:
> Brooks,
> 
> would something like this added to Handbook chapter about compiling
> kernel satisfy you?
> 
> Procedure 2. Building a Kernel the "New" Way
> [..]
> + Note: This method of kernel building requires full source files.
>   If you only installed the kernel source, use the traditional method,
>   as described above.
> 
> http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig-building.html


This would be fine.

-- Brooks

-- 
Any statement of the form "X is the one, true Y" is FALSE.
PGP fingerprint 655D 519C 26A7 82E7 2529  9BF0 5D8E 8BE9 F238 1AD4
Comment 6 Pav Lucistnik freebsd_committer freebsd_triage 2005-08-19 10:32:30 UTC 
State Changed
From-To: open->closed

The necessity of full /usr/src for make buildkernel is already mentioned 
in the Handbook chapter, but in a different place. I added an explicit note 
just under the "New way" example, that reemphasises this requirement.
Comment 7 Pav Lucistnik freebsd_committer freebsd_triage 2005-08-19 10:32:30 UTC 
Responsible Changed
From-To: freebsd-doc->pav

Take possible followups