Bug 61824

Summary: Misleading documentation on FreeBSD installation requirements
Product: Documentation Reporter: Peter Jeremy <PeterJeremy>
Component: Books & ArticlesAssignee: Gabor Kovesdan <gabor>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Peter Jeremy 2004-01-24 07:10:13 UTC
	Neither the FreeBSD 4.9-RELEASE nor 5.2-RELEASE i386 Hardware Notes
	mention the minimum amount of RAM necessary to install FreeBSD
	using the -RELEASE images and I cannot find this information in
	any other obvious place starting at www.freebsd.org.  It would
	be useful to include a link to the installation instructions
	from the "Current releases" section of
	http://www.freebsd.org/releases/index.html

	The head of
	src/release/doc/en_US.ISO8859-1/installation/common/install.sgml
	states under "Hardware Requirements" (section 1.2) that a
	minimum of 5MB RAM is necessary to install FreeBSD in an i386
	and 4MB to run it.  My understanding is that sysinstall requires
	needs at least 16MB RAM (this is documented in install.sgml
	for 4.x).

	Both the installation notes and hardware notes for -current
	state that FreeBSD will run on an 80386 or better.  This is
	not true for the GENERIC install images which require an
	80486 or better.  Running FreeBSD 5-CURRENT on an 80386 requires
	compiling a custom kernel.

	In addition, running any version of 5.x requires hardware FPU
	support by default.  This means it is not possible to install
	on an 80386 without an 80387 or 80486SX without 80487
	(MATH_EMULATE was removed from GENERIC in 1.324 on
	2001.10.20).  Early versions of 5.x could be re-compiled to
	use an FPU emulator but this was removed prior to 5.2-RELEASE
	([GPL_]MATH_EMULATE was removed from NOTES in 1.1091 on
	2003.07.22).  It is possible that this event has been
	mis-transcribed into the i386 release notes as dropping
	support for the 80386SX (the 80386SX reference was reworded in
	src/release/doc/en_US.ISO8859-1/hardware/i386/proc-i386.sgml
	v1.12 on 2003.07.29) - I am unaware of any reason other than
	(lack of) performance that would prevent FreeBSD running on an
	80386SX/80387SX combination.

Fix: 

1) Add links to Installation notes under "Current releases" in
	   http://www.freebsd.org/releases/index.html and install the
	   installation notes.
	2) Update the comments regarding supported CPUs in section id="proc"
	   of src/release/doc/en_US.ISO8859-1/hardware/i386/proc-i386.sgml
	   to indicate that an FPU is mandatory on the 386 and 486SX and
	   that the 386 requires a customised kernel.
	3) Add comment regarding RAM to section id="proc" of
	   src/release/doc/en_US.ISO8859-1/hardware/i386/proc-i386.sgml
	   along the lines of: "FreeBSD requires a minimum of 4MB to 8MB
	   to run, this can be increased substantially by application
	   requirements - a GUI desktop may need 200MB to run satisfactorily.
	   Installing FreeBSD via sysinstall requires a minimum of 16MB."
	   This would logically go just before the reference to PAE.
	4) Update section 1.2 "Hardware Requirements" of
	   src/release/doc/en_US.ISO8859-1/installation/common/install.sgml
	   along the lines of: "The standard FreeBSD installation requires a
	   486 or better processor and at least 16MB RAM.  There is no support
	   for the 286 or FPU-less CPUs.  The 386 requires a 387 NPX and a
	   customised kernel.  The 486SX requires a 487 NPX.  FreeBSD needs
	   a minimum of 4-8MB RAM on top of application requirements."

	I will try and write the above as patches if I get the time.
How-To-Repeat: 	Documentation and commit log inspection
Comment 1 Pav Lucistnik freebsd_committer freebsd_triage 2006-01-08 19:01:42 UTC
This seems a little stale. I just read 6.0-RELEASE and RELENG_6 release
docs and:

1) Seems solved
2) It talks about FPU, doesn't mention customized kernel for 386.
   Don't know if that's still relevant today, anyway. How many 386 boxes
   you encounter?
3) The whole text about memory requirements seems to be removed.
4) It talks about 24MB today. Doesn't deal with 286/386/486 flavours.

Do you mind updating your proposed fix to patch on top of 6.0-RELEASE or
newer texts?

-- 
Pav Lucistnik <pav@oook.cz>
              <pav@FreeBSD.org>

An arrow (+0,+0) {@f0} finds a mark. It dies.
Comment 2 Gabor Kovesdan freebsd_committer freebsd_triage 2007-03-12 14:54:47 UTC
State Changed
From-To: open->closed

All of the mentioned problems are solved for 6.2, I think we can close this 
now. 


Comment 3 Gabor Kovesdan freebsd_committer freebsd_triage 2007-03-12 14:54:47 UTC
Responsible Changed
From-To: freebsd-www->gabor

Track PR.