ehci man pages before src

6 files changed, 87 insertions, 6 deletions

diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index e6abf3bdb85..60d0f877fc3 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.260 2004/05/03 15:18:19 drahn Exp $
+#	$OpenBSD: Makefile,v 1.261 2004/05/23 02:43:42 deraadt Exp $
 
 MAN=	aac.4 ac97.4 acphy.4 addcom.4 adv.4 aha.4 ahb.4 ahc.4 \
 	aic.4 amdpm.4 ami.4 amphy.4 an.4 aria.4 ast.4 atalk.4 \
@@ -7,7 +7,7 @@ MAN=	aac.4 ac97.4 acphy.4 addcom.4 adv.4 aha.4 ahb.4 ahc.4 \
 	brgphy.4 bridge.4 cac.4 cardbus.4 carp.4 ccd.4 cd.4 \
 	ch.4 clcs.4 clct.4 clnp.4 cltp.4 cmpci.4 cnw.4 com.4 \
 	crypto.4 cue.4 cy.4 cz.4 dc.4 dcphy.4 ddb.4 de.4 dpt.4 \
-	drum.4 eap.4 ec.4 eephy.4 ef.4 eg.4 eisa.4 el.4 em.4 \
+	drum.4 eap.4 ec.4 eephy.4 ef.4 eg.4 ehci.4 eisa.4 el.4 em.4 \
 	emu.4 enc.4 ep.4 esa.4 esis.4 eso.4 ess.4 exphy.4 \
 	faith.4 fd.4 fdc.4 fms.4 fpa.4 fxp.4 gdt.4 gem.4 gif.4 \
 	gpr.4 gre.4 gtp.4 hifn.4 hil.4 hilid.4 hilkbd.4 hilms.4 \
diff --git a/share/man/man4/ehci.4 b/share/man/man4/ehci.4
new file mode 100644
index 00000000000..85b11b5c43b
--- /dev/null
+++ b/share/man/man4/ehci.4
@@ -0,0 +1,74 @@
+.\" $OpenBSD: ehci.4,v 1.1 2004/05/23 02:43:42 deraadt Exp $
+.\"
+.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Lennart Augustsson.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"        This product includes software developed by the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd November 5, 2001
+.Dt EHCI 4
+.Os
+.Sh NAME
+.Nm ehci
+.Nd USB Enhanced Host Controller driver
+.Sh SYNOPSIS
+.Cd "ehci* at pci? dev ? function ?"
+.Cd "usb*  at ehci?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the USB Enhanced Host Controller Interface,
+which is used by USB 2.0 controllers.
+.Pp
+EHCI controllers are peculiar in that they can only handle the USB 2.0
+protocol.  This means that they normally have one or more companion controllers
+(i.e.,
+.Xr ohci 4
+or
+.Xr uhci 4 )
+handling USB 1.x devices.  Consequently each USB connector is electrically
+connected to two USB controllers.  The handling of this is totally automatic,
+but can be noticed since USB 1.x and USB 2.0 devices plugged in to the same
+connector appear to connect to different USB busses.
+.Sh SEE ALSO
+.Xr cardbus 4 ,
+.Xr ohci 4 ,
+.Xr pci 4 ,
+.Xr uhci 4 ,
+.Xr usb 4
+.Sh BUGS
+The driver is not finished and is quite buggy.
+.Pp
+There is no support (yet) for hubs that are connected with high speed upstream
+and low or full speed downstream (i.e., for transaction translators).
+.Pp
+There is no support (yet) for interrupt or isochronous transfers.
diff --git a/share/man/man4/ohci.4 b/share/man/man4/ohci.4
index 8994d83176f..7da49234eb6 100644
--- a/share/man/man4/ohci.4
+++ b/share/man/man4/ohci.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ohci.4,v 1.4 2002/09/26 07:55:40 miod Exp $
+.\" $OpenBSD: ohci.4,v 1.5 2004/05/23 02:43:42 deraadt Exp $
 .\" $NetBSD: ohci.4,v 1.5 1999/11/23 01:47:34 augustss Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
@@ -49,6 +49,7 @@ The
 .Nm
 driver provides support for USB Open Host Controller Interface.
 .Sh SEE ALSO
+.Xr ehci 4 ,
 .Xr intro 4 ,
 .Xr pci 4 ,
 .Xr uhci 4 ,
diff --git a/share/man/man4/pci.4 b/share/man/man4/pci.4
index 0004c66664c..f19f3f78491 100644
--- a/share/man/man4/pci.4
+++ b/share/man/man4/pci.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: pci.4,v 1.90 2004/05/03 15:18:19 drahn Exp $
+.\"	$OpenBSD: pci.4,v 1.91 2004/05/23 02:43:42 deraadt Exp $
 .\"	$NetBSD: pci.4,v 1.29 2000/04/01 00:32:23 tsarna Exp $
 .\"
 .\" Copyright (c) 2000 Theo de Raadt.  All rights reserved.
@@ -356,6 +356,8 @@ TV tuners and video capture boards.
 Yenta compatible
 .Tn CardBus
 bridges.
+.It Xr ehci 4
+USB EHCI host controller.
 .It Xr ohci 4
 USB OHCI host controller.
 .It Xr pcic 4
@@ -471,6 +473,7 @@ driver.
 .Xr dino 4 ,
 .Xr dpt 4 ,
 .Xr eap 4 ,
+.Xr ehci 4 ,
 .Xr eisa 4 ,
 .Xr em 4 ,
 .Xr emu 4 ,
diff --git a/share/man/man4/uhci.4 b/share/man/man4/uhci.4
index 9724d89a5a5..f8c0ec8b804 100644
--- a/share/man/man4/uhci.4
+++ b/share/man/man4/uhci.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: uhci.4,v 1.5 2004/03/21 23:37:43 miod Exp $
+.\" $OpenBSD: uhci.4,v 1.6 2004/05/23 02:43:42 deraadt Exp $
 .\" $NetBSD: uhci.4,v 1.3 1999/09/12 18:47:12 kleink Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
@@ -50,6 +50,7 @@ The
 driver provides support for USB Universal Host Controller Interface.
 .Sh SEE ALSO
 .Xr intro 4 ,
+.Xr ehci 4 ,
 .Xr ohci 4 ,
 .Xr pci 4 ,
 .Xr usb 4
diff --git a/share/man/man4/usb.4 b/share/man/man4/usb.4
index 20b68a62662..53d7eed857f 100644
--- a/share/man/man4/usb.4
+++ b/share/man/man4/usb.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: usb.4,v 1.30 2004/04/03 21:34:25 jmc Exp $
+.\"	$OpenBSD: usb.4,v 1.31 2004/05/23 02:43:42 deraadt Exp $
 .\"	$NetBSD: usb.4,v 1.15 1999/07/29 14:20:32 augustss Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
@@ -42,8 +42,10 @@
 .Nm usb
 .Nd introduction to Universal Serial Bus support
 .Sh SYNOPSIS
+.Cd "ehci*   at pci? dev ? function ?"
 .Cd "uhci*   at pci? dev ? function ?"
 .Cd "ohci*   at pci? dev ? function ?"
+.Cd "usb*    at ehci? flags 0x00"
 .Cd "usb*    at uhci? flags 0x00"
 .Cd "usb*    at ohci? flags 0x00"
 .Cd "uhub*   at usb?"