Date: Wed, 10 Jul 2002 23:40:04 -0400 (EDT) From: Chris Pepper <pepper@rockefeller.edu> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/40443: Update books/faq/book.sgml for USB .ko's & clarify FAQ description. Message-ID: <20020711034004.07DC7A848@guest.reppep.com>
next in thread | raw e-mail | index | archive | help
>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 <http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/faq/hardware.html#USBKBD>. >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 @@ <para>Welcome to the FreeBSD 2.X-4.X FAQ!</para> - <para>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 + <para>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.</para> @@ -2426,18 +2426,21 @@ </question> <answer> - <para>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.</para> + <para>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.</para> + + <para>With FreeBSD 4.1 and later, USB support can be + enabled in /etc/rc.conf; everything else is automatic. + Edit <filename>/etc/rc.conf</filename> and add the + following lines:</para> - <procedure> - <step> - <para>Use FreeBSD 3.2 or later.</para> - </step> + <programlisting>usbd_enable="YES" +usbd_flags=""</programlisting> - <step> - <para>Add the following lines to your kernel configuration + <para>For FreeBSD 4.0, add the following lines to your kernel configuration file, and rebuild the kernel.</para> <programlisting>device uhci @@ -2446,7 +2449,7 @@ device ukbd options KBD_INSTALL_CDEV</programlisting> - <para>In versions of FreeBSD before 4.0, use this + <para>In versions of FreeBSD before 4.0, use these lines instead:</para> <programlisting>controller uhci0 @@ -2454,35 +2457,22 @@ controller usb0 controller ukbd0 options KBD_INSTALL_CDEV</programlisting> - </step> - <step> - <para>Go to the <filename>/dev</filename> directory and create + <para>If you've rebuilt your kernel, go to the <filename>/dev</filename> directory and create device nodes as follows:</para> <screen>&prompt.root; <userinput>cd /dev</userinput> &prompt.root; <userinput>./MAKEDEV kbd0 kbd1</userinput></screen> - - </step> - - <step> - <para>Edit <filename>/etc/rc.conf</filename> and add the - following lines:</para> - - <programlisting>usbd_enable="YES" -usbd_flags=""</programlisting> - - </step> - </procedure> - <para>After the system is rebooted, the AT keyboard becomes + <para>After the system is rebooted, the AT or PS/2 keyboard becomes <devicename>/dev/kbd0</devicename> and the USB keyboard becomes <devicename>/dev/kbd1</devicename>, if both are connected to the - system. If there is the USB keyboard only, it will be - <devicename>/dev/ukbd0</devicename>.</para> + system. If the only keyboard is USB, it will be + <devicename>/dev/ukbd0</devicename> and <devicename>/dev/kbd0</devicename>.</para> - <para>If you want to use the USB keyboard in the console, you - have to explicitly tell the console driver to use the existing + <para>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.</para> --- 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020711034004.07DC7A848>