From owner-freebsd-doc@FreeBSD.ORG Fri May 21 02:40:23 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 2C37816A4CE for ; Fri, 21 May 2004 02:40:23 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1FA5243D1D for ; Fri, 21 May 2004 02:40:23 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) i4L9eM2M028294 for ; Fri, 21 May 2004 02:40:22 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i4L9eMm9028293; Fri, 21 May 2004 02:40:22 -0700 (PDT) (envelope-from gnats) Resent-Date: Fri, 21 May 2004 02:40:22 -0700 (PDT) Resent-Message-Id: <200405210940.i4L9eMm9028293@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Gavin Atkinson Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8AB0C16A4CE for ; Fri, 21 May 2004 02:38:00 -0700 (PDT) Received: from mail-gw1.york.ac.uk (mail-gw1.york.ac.uk [144.32.128.246]) by mx1.FreeBSD.org (Postfix) with ESMTP id E530C43D45 for ; Fri, 21 May 2004 02:37:59 -0700 (PDT) (envelope-from ga9@buffy.york.ac.uk) Received: from kimiko.york.ac.uk (kimiko.york.ac.uk [144.32.226.167]) by mail-gw1.york.ac.uk (8.12.10/8.12.10) with ESMTP id i4L9bt90020469 for ; Fri, 21 May 2004 10:37:56 +0100 (BST) Received: from buffy.york.ac.uk (buffy.york.ac.uk [IPv6:2001:630:61:0:20c:f1ff:fe85:e351]) by kimiko.york.ac.uk (8.12.11/8.12.11) with ESMTP id i4L9btRL077613 for ; Fri, 21 May 2004 10:37:55 +0100 (BST) (envelope-from ga9@buffy.york.ac.uk) Received: from buffy.york.ac.uk (localhost.york.ac.uk [127.0.0.1]) by buffy.york.ac.uk (8.12.11/8.12.11) with ESMTP id i4L9btx3040641 for ; Fri, 21 May 2004 10:37:55 +0100 (BST) (envelope-from ga9@buffy.york.ac.uk) Received: (from ga9@localhost) by buffy.york.ac.uk (8.12.11/8.12.11/Submit) id i4L9btGH040640; Fri, 21 May 2004 10:37:55 +0100 (BST) (envelope-from ga9) Message-Id: <200405210937.i4L9btGH040640@buffy.york.ac.uk> Date: Fri, 21 May 2004 10:37:55 +0100 (BST) From: Gavin Atkinson To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/66980: Relnotes troubleshooting section update for 5.x X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Gavin Atkinson List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 21 May 2004 09:40:23 -0000 >Number: 66980 >Category: docs >Synopsis: Relnotes troubleshooting section update for 5.x >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Fri May 21 02:40:22 PDT 2004 >Closed-Date: >Last-Modified: >Originator: Gavin Atkinson >Release: FreeBSD 5.2-CURRENT i386 >Organization: >Environment: System: FreeBSD buffy.york.ac.uk 5.2-CURRENT FreeBSD 5.2-CURRENT #1: Fri May 7 15:12:41 BST 2004 root@buffy.york.ac.uk:/usr/obj/usr/src/sys/GENERIC i386 >Description: The troubleshooting section of http://www.freebsd.org/releases/5.2.1R/installation-i386.html is very out of date with respect to the situation with 5.x. For example, in several places it mentions using UserConfig, which hasn't existed since 2000/06/12. >How-To-Repeat: Try following some of the instructions... >Fix: (Patch also at http://www.devrandom.co.uk/freebsd/insttrouble.diff) Note that I have gone with 8 spaces rather than a tab at the start of each line as this is the predominant style (about 30 lines start with tab, about 200 with 8 spaces) Index: src/release/doc/en_US.ISO8859-1/installation/common/trouble.sgml =================================================================== RCS file: /usr/cvs/src/release/doc/en_US.ISO8859-1/installation/common/trouble.sgml,v retrieving revision 1.13 diff -u -r1.13 trouble.sgml --- src/release/doc/en_US.ISO8859-1/installation/common/trouble.sgml 8 Dec 2003 22:38:39 -0000 1.13 +++ src/release/doc/en_US.ISO8859-1/installation/common/trouble.sgml 21 May 2004 08:48:59 -0000 @@ -203,8 +203,10 @@ from working. - Use the UserConfig utility (see - HARDWARE.TXT) and disable the probing + Set the hints + hint.mcd.0.disabled="1" and + hint.mcd.1.disabled="1" + in the third stage boot loader to disable the probing of the mcd0 and mcd1 devices. Generally speaking, you should only leave the devices that you will be using @@ -218,16 +220,17 @@ Your card is probably on a different IRQ from what is - specified in the kernel configuration. The ed driver does + specified in the /boot/device.hints file. The ed driver does not use the `soft' configuration by default (values entered using EZSETUP in DOS), but it will use the software - configuration if you specify ? in the IRQ field of your - kernel config file. + configuration if you specify -1 in the hints + for the interface. Either move the jumper on the card to a hard configuration setting (altering the kernel settings if - necessary), or specify the IRQ as -1 in UserConfig or ? - in your kernel config file. This will tell the kernel to + necessary), or specify the IRQ as -1 + by setting the hint hint.ed.0.irq="-1" + This will tell the kernel to use the soft configuration. Another possibility is that your card is at IRQ 9, @@ -244,9 +247,9 @@ Older IBM laptops use a non-standard keyboard controller, so you must tell the keyboard driver (atkbd0) to - go into a special mode which works on the ThinkPads. Change - the atkbd0 'Flags' to 0x4 in UserConfig and it should work - fine. (Look in the Input Menu for 'Keyboard'.) + go into a special mode which works on the ThinkPads. Set the + hint hint.atkbd.0.flags="4" and it should work + fine. @@ -268,23 +271,8 @@ This is a known problem, and will hopefully be fixed in the future. In order to get your system installed at - all, boot with the option into - UserConfig, but don't use the pretty - visual mode but the plain old CLI mode. Type: - - eisa 12 -quit - - at the prompt. (Instead of `quit', you might also - type `visual', and continue the rest of the configuration - session in visual mode.) While it's recommended to compile - a custom kernel, dset now also understands to save - this value. - - Refer to the FAQ topic 3.16 for an explanation of the - problem, and for how to continue. Remember that you can - find the FAQ on your local system in /usr/share/doc/FAQ, - provided you have installed the `doc' distribution. + all, set the hint hw.eisa_slots="12" in the + third stage loader. @@ -297,16 +285,7 @@ Your machine doesn't like the new i586_copyout and i586_copyin code for some reason. To - disable this, boot the installation boot floppy and when it - comes to the very first menu (the choice to drop into kernel - UserConfig mode or not) choose the command-line interface - (expert mode) version and type the following - at it: - - flags npx0 1 - - Then proceed normally to boot. This will be saved - into your kernel, so you only need to do it once. + disable this, set the hint hint.npx.0.flags="1" @@ -328,8 +307,8 @@ With Compaq being always a little different from other systems, they do not announce their floppy drive in the CMOS RAM of an Aero notebook. Therefore, the floppy disk driver - assumes there is no drive configured. Go to the UserConfig - screen, and set the Flags value of the fdc0 device to 0x1. + assumes there is no drive configured. Set the hint + hint.fdc.0.flags="1" This pretends the existence of the first floppy drive (as a 1.44 MB drive) to the driver without asking the CMOS at all. >Release-Note: >Audit-Trail: >Unformatted: