From PeterJeremy@optushome.com.au Fri Jan 23 23:00:36 2004 Return-Path: Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 536B716A4CE for ; Fri, 23 Jan 2004 23:00:36 -0800 (PST) Received: from cirb503493.alcatel.com.au (c211-30-75-229.belrs2.nsw.optusnet.com.au [211.30.75.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id A362743D39 for ; Fri, 23 Jan 2004 23:00:31 -0800 (PST) (envelope-from PeterJeremy@optushome.com.au) Received: from cirb503493.alcatel.com.au (localhost.alcatel.com.au [127.0.0.1]) by cirb503493.alcatel.com.au (8.12.10/8.12.9) with ESMTP id i0O70Pe3012568 for ; Sat, 24 Jan 2004 18:00:25 +1100 (EST) (envelope-from jeremyp@cirb503493.alcatel.com.au) Received: (from jeremyp@localhost) by cirb503493.alcatel.com.au (8.12.10/8.12.9/Submit) id i0O70Pt2012567; Sat, 24 Jan 2004 18:00:25 +1100 (EST) (envelope-from jeremyp) Message-Id: <200401240700.i0O70Pt2012567@cirb503493.alcatel.com.au> Date: Sat, 24 Jan 2004 18:00:25 +1100 (EST) From: Peter Jeremy Reply-To: Peter Jeremy To: FreeBSD-gnats-submit@freebsd.org Cc: Subject: Misleading documentation on FreeBSD installation requirements X-Send-Pr-Version: 3.113 X-GNATS-Notify: >Number: 61824 >Category: www >Synopsis: Misleading documentation on FreeBSD installation requirements >Confidential: no >Severity: non-critical >Priority: low >Responsible: gabor >State: closed >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Fri Jan 23 23:10:13 PST 2004 >Closed-Date: Mon Mar 12 14:56:39 GMT 2007 >Last-Modified: Mon Mar 12 14:56:39 GMT 2007 >Originator: Peter Jeremy >Release: FreeBSD 5-CURRENT i386 (and 4.9-STABLE) >Organization: n/a >Environment: System: FreeBSD cirb503493.alcatel.com.au 4.9-STABLE FreeBSD 4.9-STABLE #5: Sat Dec 20 08:48:42 EST 2003 root@server.vk2pj.dyndns.org:/home/obj/i586/usr/src/sys/pj1592 i386 >Description: 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. >How-To-Repeat: Documentation and commit log inspection >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. >Release-Note: >Audit-Trail: From: Pav Lucistnik To: bug-followup@FreeBSD.org Cc: Subject: Re: www/61824: Misleading documentation on FreeBSD installation requirements Date: Sun, 08 Jan 2006 20:01:42 +0100 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 An arrow (+0,+0) {@f0} finds a mark. It dies. State-Changed-From-To: open->closed State-Changed-By: gabor State-Changed-When: Mon Mar 12 14:54:47 UTC 2007 State-Changed-Why: All of the mentioned problems are solved for 6.2, I think we can close this now. Responsible-Changed-From-To: freebsd-www->gabor Responsible-Changed-By: gabor Responsible-Changed-When: Mon Mar 12 14:54:47 UTC 2007 Responsible-Changed-Why: Track PR. http://www.freebsd.org/cgi/query-pr.cgi?pr=61824 >Unformatted: