xref: /openbsd/share/man/man4/urndis.4 (revision 8932bfb7)
1.\" Copyright (c) 2010 Michael Knudsen <mk@openbsd.org>
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\"
8.\"    - Redistributions of source code must retain the above copyright
9.\"      notice, this list of conditions and the following disclaimer.
10.\"    - Redistributions in binary form must reproduce the above
11.\"      copyright notice, this list of conditions and the following
12.\"      disclaimer in the documentation and/or other materials provided
13.\"      with the distribution.
14.\"
15.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
16.\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
17.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
18.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
19.\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
20.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
21.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
22.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
23.\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
25.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
26.\" POSSIBILITY OF SUCH DAMAGE.
27.\"
28.\" $OpenBSD: urndis.4,v 1.10 2011/05/08 16:16:17 jmc Exp $
29.\"
30.Dd $Mdocdate: May 8 2011 $
31.Dt URNDIS 4
32.Os
33.Sh NAME
34.Nm urndis
35.Nd USB Remote NDIS Ethernet device
36.Sh SYNOPSIS
37.Cd "urndis*  at uhub?"
38.Sh DESCRIPTION
39The
40.Nm
41driver provides support for Ethernet access over Remote NDIS.
42The
43.Nm
44driver should work with all USB RNDIS devices, but the following devices are
45known to work:
46.Pp
47.Bl -bullet -compact -offset indent
48.It
49Geeksphone ONE
50.It
51Google Nexus One
52.It
53HTC Desire
54.It
55HTC Dream / T-Mobile G1 / ADP1
56.It
57HTC Hero
58.It
59HTC Magic
60.It
61HTC Tattoo
62.It
63HTC Wildfire
64.It
65Samsung Galaxy S
66.It
67Samsung Nexus S
68.El
69.Pp
70The
71.Nm
72driver does not support different media types or options.
73For more information on configuring this device, see
74.Xr ifconfig 8 .
75.Sh SEE ALSO
76.Xr arp 4 ,
77.Xr intro 4 ,
78.Xr netintro 4 ,
79.Xr usb 4 ,
80.Xr hostname.if 5 ,
81.Xr ifconfig 8
82.Sh HISTORY
83The
84.Nm
85device driver first appeared in
86.Ox 4.7 .
87.Sh AUTHORS
88.An -nosplit
89The
90.Nm
91driver was written by
92.An Jonathan Armani Aq armani@openbsd.org ,
93.An Michael Knudsen Aq mk@openbsd.org ,
94and
95.An Fabien Romano Aq fabien@openbsd.org .
96