From owner-freebsd-doc Sat Apr 8 7:10:10 2000 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 8831637B9BF for ; Sat, 8 Apr 2000 07:10:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id HAA40444; Sat, 8 Apr 2000 07:10:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from kestrel.prod.itd.earthlink.net (kestrel.prod.itd.earthlink.net [207.217.121.155]) by hub.freebsd.org (Postfix) with ESMTP id BAE7B37B9B8 for ; Sat, 8 Apr 2000 07:04:52 -0700 (PDT) (envelope-from eogren@earthlink.net) Received: from rod.darktech.org (ip132.cambridge2.ma.pub-ip.psi.net [38.32.112.132]) by kestrel.prod.itd.earthlink.net (8.9.3/8.9.3) with ESMTP id HAA05387 for ; Sat, 8 Apr 2000 07:04:47 -0700 (PDT) Received: by rod.darktech.org (Postfix, from userid 1001) id 1B3091F3; Sat, 8 Apr 2000 10:05:56 -0400 (EDT) Message-Id: <20000408140556.1B3091F3@rod.darktech.org> Date: Sat, 8 Apr 2000 10:05:56 -0400 (EDT) From: eogren@earthlink.net Reply-To: eogren@earthlink.net To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/17861: FAQ isn't completely up-to-date Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 17861 >Category: docs >Synopsis: FAQ still needs 4.0 inserted in some places >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Apr 8 07:10:01 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Eric Ogren >Release: FreeBSD 4.0-STABLE i386 >Organization: >Environment: FreeBSD rod.darktech.org 4.0-STABLE FreeBSD 4.0-STABLE #3: Tue Apr 4 21:01:56 EDT 2000 eogren@rod.darktech.org:/usr/src/sys/compile/BLUE i386 >Description: The FAQ still has a couple of places where it should be updated since 4.0 has been released. Also, added / modified a couple of entries to bring them up-to-date: * 'Panic: can't mount root!' updated to reflect the new boot loader (nothing added, just deleted) * Added a 'Error: can't find libc.so.4' question * Added a 'How do I upgrade from 3.X->4.x' question, just to make sure that no-one can claim we don't mention this procedure anywhere in our documentation. >How-To-Repeat: Read the FAQ >Fix: Index: book.sgml =================================================================== RCS file: /usr/local/doctree/doc/en_US.ISO_8859-1/books/faq/book.sgml,v retrieving revision 1.49 diff -u -r1.49 book.sgml --- book.sgml 2000/04/03 12:01:33 1.49 +++ book.sgml 2000/04/08 13:59:40 @@ -5,7 +5,7 @@ - Frequently Asked Questions for FreeBSD 2.X and 3.X + Frequently Asked Questions for FreeBSD 2.X, 3.X and 4.X @@ -16,7 +16,7 @@ $FreeBSD: doc/en_US.ISO_8859-1/books/faq/book.sgml,v 1.49 2000/04/03 12:01:33 phantom Exp $ - This is the FAQ for FreeBSD versions 2.X and 3.X. All entries + This is the FAQ for FreeBSD versions 2.X, 3.X, and 4.X. All entries are assumed to be relevant to FreeBSD 2.0.5 and later, unless otherwise noted. Any entries with a <XXX> are under construction. If you are interested in helping with this project, @@ -37,7 +37,7 @@ Preface - Welcome to the FreeBSD 2.X-3.X FAQ! + Welcome to the FreeBSD 2.X-4.X FAQ! As is usual with Usenet FAQs, this document aims to cover the most frequently asked questions concerning the FreeBSD operating @@ -58,7 +58,7 @@ - Briefly, FreeBSD 2.X is a UN*X-like operating system based + Briefly, FreeBSD is a UN*X-like operating system based on U.C. Berkeley's 4.4BSD-lite release for the i386 platform. It is also based indirectly on William Jolitz's port of U.C. Berkeley's Net/2 to the i386, known as 386BSD, though very @@ -152,16 +152,16 @@ Version 3.4 + URL="ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/4.0-RELEASE/">4.0 is the latest stable version; it was - released in December, 1999. This is also the latest + released in March, 2000. This is also the latest release version. Briefly explained, -STABLE is aimed at the ISP or other corporate user who wants stability and a low change count over the wizzy new features of the latest -CURRENT snapshot. Releases can come - from either "branch," but you should only use + from either branch, but you should only use -CURRENT if you're sure that you're prepared for its increased volatility (relative to -STABLE, that is). @@ -244,9 +244,16 @@ releases. Snapshot releases are directly available from ftp://current.FreeBSD.org/pub/FreeBSD/ - and are generated, on the average, once a day for the - 5.0-CURRENT, 4.X-STABLE and 3.X-STABLE branches. + URL="ftp://current.FreeBSD.org/pub/FreeBSD/"> + ftp://current.FreeBSD.org/pub/FreeBSD/ + for 5.0-CURRENT and + + releng4.FreeBSD.org for 4-STABLE snapshots. + 3-STABLE snapshots can be found at + + releng3.FreeBSD.org. + Snapshots are generated, on the average, once a day for + all actively developed branches. @@ -339,7 +346,7 @@ - FreeBSD 3.x currently runs on the Since 3.x, FreeBSD has run on the DEC Alpha as well as the x86 architecture. Some interest has also been expressed in a SPARC port, but details on this project are not yet @@ -397,26 +404,26 @@ URL="ftp://current.FreeBSD.org/pub/FreeBSD/releases/i386/3.4-RELEASE/">3.4-RELEASE directory. - - 2.2 Snapshot - releases are made once a day along the RELENG_2_2 branch (post - 2.2.8) as it slowly winds down in maintenance mode. The - RELENG_2_2 branch is currently being carefully maintained by - the legacy support folks and no changes other than those - strictly necessary for security or reliability enhancements - are now made. - - + The current 4.X-STABLE release, 4.0-RELEASE can be + found in the 4.0-RELEASE directory. + + 3.X Snapshot releases are also made once a day along the RELENG_3 branch (post 3.0-RELEASE) as it continues on its way towards - 3.4-RELEASE. + 3.5-RELEASE. - + + + 4.X + snapshots are made once a day as well. + + 5.0 Snapshot @@ -1630,7 +1637,28 @@ -At the Boot: prompt, enter +For FreeBSD 3.3 and later, reboot the system and hit +"Enter" at the "Booting kernel in 10 seconds; hit +[Enter] to interrupt" prompt. This will drop you into the boot +loader. +Then type set +root_disk_unit="<disk_number>". disk_number +will be 0 if FreeBSD is installed on the master drive +on the first IDE controller, 1 if it is installed +on the slave on the first IDE controller, 2 if it +is installed on the master of the second IDE controller, and +3 if it is installed on the slave of the second +IDE controller. +Then type "boot", and your system should boot +correctly. +To make this change permanent (ie so you don't have to do this +everytime you reboot or turn on your FreeBSD machine), put the line +"root_disk_unit="<disk_number>" in +/boot/loader.conf.local. + + + +If using FreeBSD 3.2 or earlier, at the Boot: prompt, enter 1:wd(2,a)kernel and press Enter. If the system starts, then run the command echo "1:wd(2,a)kernel" > /boot.config @@ -1771,7 +1799,24 @@ kernel, and installed a new kernel builtin from them without making world. This is not supported. Make world. - + + + +How do I upgrade from 3.X -> 4.X? + +We strongly recommend that you use +binary snapshots to do this. 4.X-STABLE snapshots are available at +releng4.FreeBSD.org. +If you wish to upgrade using source, please see the FreeBSD +Handbook for more information. +Upgrading via source is never recommended for new +users, and upgading from 3.X -> 4.X is even less so; make sure you +have read the instructions carefully before attempting to uprade via +source this! + + -for 4.0-CURRENT +for 4.0-RELEASE/4.X-STABLE -ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/packages-4-current/ +ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/packages-4-stable/ + + +for 5.X-CURRENT + + +ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/i386/packages-5-current + + + @@ -3484,11 +3538,21 @@ Where do I find libc.so.3.0? -You are trying to run a package for 2.2/3.x/4.0 on a 2.1.x +You are trying to run a package built on 2.2 and later on a 2.1.x system. Please take a look at the previous section and get the correct port/package for your system. + +I get a message "Error: can't find +libc.so.4.0" + + +You accidently downloaded packages meant for 4.X and 5.X +systems and attempted to install them on your 2.X or 3.X FreeBSD system. +Please download the correct version of the +packages. + @@ -8382,17 +8446,21 @@ -RELENG_2_2 AKA 2.2-STABLE AKA "2.2 branch" +RELENG_2_2 AKA 2.2-STABLE -RELENG_3 AKA 3.X-STABLE AKA "3.0 branch" +RELENG_3 AKA 3.X-STABLE -HEAD AKA AKA 4.0-CURRENT +RELENG_4 AKA 4.X-STABLE + +HEAD AKA AKA 5.0-CURRENT + + @@ -8401,15 +8469,12 @@ "the current, non-branched development stream" which we simply refer to as . -Right now, is the 4.0 development stream and the -3.0-STABLE branch, RELENG_3, forked off from - in Jan 1999. +Right now, is the 5.0 development stream and the +4-STABLE branch, RELENG_4, forked off from + in Mar 2000. The 2.2-STABLE branch, RELENG_2_2, departed -CURRENT in -November 1996. - -The 2.1-STABLE branch, RELENG_2_1_0, departed -CURRENT in -September of 1994. This branch has been fully retired. +November 1996, and has pretty much been retired. >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message