From owner-freebsd-doc Wed Jul 10 20:40:15 2002 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 81F8A37B400 for ; Wed, 10 Jul 2002 20:40:03 -0700 (PDT) Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id C390443E4A for ; Wed, 10 Jul 2002 20:40:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.4/8.12.4) with ESMTP id g6B3e2JU009713 for ; Wed, 10 Jul 2002 20:40:02 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.4/8.12.4/Submit) id g6B3e2UK009712; Wed, 10 Jul 2002 20:40:02 -0700 (PDT) Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 13C1A37B400 for ; Wed, 10 Jul 2002 20:39:40 -0700 (PDT) Received: from guest.reppep.com (guest.reppep.com [64.81.19.110]) by mx1.FreeBSD.org (Postfix) with ESMTP id 45B7C43E42 for ; Wed, 10 Jul 2002 20:39:39 -0700 (PDT) (envelope-from pepper@reppep.com) Received: by guest.reppep.com (Postfix, from userid 501) id 07DC7A848; Wed, 10 Jul 2002 23:40:04 -0400 (EDT) Message-Id: <20020711034004.07DC7A848@guest.reppep.com> Date: Wed, 10 Jul 2002 23:40:04 -0400 (EDT) From: Chris Pepper Reply-To: Chris Pepper To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/40443: Update books/faq/book.sgml for USB .ko's & clarify FAQ description. Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >Number: 40443 >Category: docs >Synopsis: Update books/faq/book.sgml for USB .ko's & clarify FAQ description. >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: Wed Jul 10 20:40:01 PDT 2002 >Closed-Date: >Last-Modified: >Originator: Chris Pepper >Release: FreeBSD 4.6-STABLE i386 >Organization: >Environment: System: FreeBSD guest.reppep.com 4.6-STABLE FreeBSD 4.6-STABLE #3: Sun Jul 7 02:08:43 EDT 2002 root@guest.reppep.com:/usr/obj/usr/src/sys/GENERIC i386 >Description: The FAQ intro, as written, implies most FAQs are about FreeBSD. As written, the FAQ says a kernel rebuild is required to use a USB keyboard. Per John Baldwin, this is no longer true since 4.1 (per the USB mouse section, it may not be necessary since 4.0, but I'm believing John). >How-To-Repeat: Visit . >Fix: Apply patch below, to reword intro para, and mention that 4.1+ can load USB support automatically. --- book.sgml.diff begins here --- Index: book.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/faq/book.sgml,v retrieving revision 1.456 diff -u -r1.456 book.sgml --- book.sgml 2002/06/28 23:44:37 1.456 +++ book.sgml 2002/07/11 03:35:06 @@ -62,9 +62,9 @@ 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 - system (and of course answer them!). Although originally intended + As is usual with FAQs, this document identifies and answers some + frequently asked questions, in this case concerning the FreeBSD operating + system. Although originally intended to reduce bandwidth and avoid the same old questions being asked over and over again, FAQs have become recognized as valuable information resources. @@ -2426,18 +2426,21 @@ - USB device support was added to FreeBSD 3.1. However, it - is still in preliminary state and may not always work as of - version 3.2. If you want to experiment with the USB keyboard - support, follow the procedure described below. + Preliminary USB device support was added to FreeBSD 3.1, + and significantly improved in 3.2; 3.1 is not recommended + for USB usage. As of FreeBSD 4.1, the GENERIC kernel + can automatically load USB device drivers as + necessary. + + With FreeBSD 4.1 and later, USB support can be + enabled in /etc/rc.conf; everything else is automatic. + Edit /etc/rc.conf and add the + following lines: - - - Use FreeBSD 3.2 or later. - + usbd_enable="YES" +usbd_flags="" - - Add the following lines to your kernel configuration + For FreeBSD 4.0, add the following lines to your kernel configuration file, and rebuild the kernel. device uhci @@ -2446,7 +2449,7 @@ device ukbd options KBD_INSTALL_CDEV - In versions of FreeBSD before 4.0, use this + In versions of FreeBSD before 4.0, use these lines instead: controller uhci0 @@ -2454,35 +2457,22 @@ controller usb0 controller ukbd0 options KBD_INSTALL_CDEV - - - Go to the /dev directory and create + If you've rebuilt your kernel, go to the /dev directory and create device nodes as follows: &prompt.root; cd /dev &prompt.root; ./MAKEDEV kbd0 kbd1 - - - - - Edit /etc/rc.conf and add the - following lines: - - usbd_enable="YES" -usbd_flags="" - - - - After the system is rebooted, the AT keyboard becomes + After the system is rebooted, the AT or PS/2 keyboard becomes /dev/kbd0 and the USB keyboard becomes /dev/kbd1, if both are connected to the - system. If there is the USB keyboard only, it will be - /dev/ukbd0. + system. If the only keyboard is USB, it will be + /dev/ukbd0 and /dev/kbd0. - If you want to use the USB keyboard in the console, you - have to explicitly tell the console driver to use the existing + If you want to use the USB keyboard in the console with + an AT or PS/2 keyboard connected, you + have to explicitly tell the console driver to use the USB keyboard. This can be done by running the following command as a part of system initialization. --- book.sgml.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message