Merge branch 'vendor/LIBRESSL'
[dragonfly.git] / share / man / man4 / mos.4
1 .\"
2 .\" Copyright (c) 2011 Rick van der Zwet <info@rickvanderzwet.nl>
3 .\"
4 .\" Permission to use, copy, modify, and distribute this software for any
5 .\" purpose with or without fee is hereby granted, provided that the above
6 .\" copyright notice and this permission notice appear in all copies.
7 .\"
8 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15 .\"
16 .\" $FreeBSD: head/share/man/man4/mos.4 233648 2012-03-29 05:02:12Z eadler $
17 .\"
18 .Dd November 16, 2018
19 .Dt MOS 4
20 .Os
21 .Sh NAME
22 .Nm mos
23 .Nd Moschip MCS7730/MCS7830/MCS7832 USB Ethernet driver
24 .Sh SYNOPSIS
25 To compile this driver into the kernel,
26 place the following lines in your
27 kernel configuration file:
28 .Bd -ragged -offset indent
29 .Cd "device uhci"
30 .Cd "device ohci"
31 .Cd "device ehci"
32 .Cd "device usb"
33 .Cd "device miibus"
34 .Cd "device uether"
35 .Cd "device mos"
36 .Ed
37 .Pp
38 Alternatively, to load the driver as a
39 module at boot time, place the following line in
40 .Xr loader.conf 5 :
41 .Bd -literal -offset indent
42 if_mos_load="YES"
43 .Ed
44 .Sh DESCRIPTION
45 The
46 .Nm
47 driver provides support for USB Ethernet adapters based on the
48 Moschip MCS7730/MCS7830/MCS7832 chipset.
49 .Pp
50 The adapters that contain the Moschip MCS7730/MCS7830/MCS7832 chipset
51 will operate at 100Base-TX and full-duplex.
52 .Pp
53 The Moschip contains a 10/100
54 Ethernet MAC with MII interface and is designed to work with both
55 Ethernet and HomePNA transceivers.
56 Although designed to interface with
57 100Mbps peripherals, this only works with USB 2.0. The existing USB 1.0
58 standard specifies a maximum transfer speed of 12Mbps.
59 USB 1.0 Users should therefore not expect to actually achieve 100Mbps speeds
60 with these devices.
61 .Pp
62 The Moschip supports a 64-bit multicast hash table, single perfect
63 filter entry for the station address and promiscuous mode.
64 Packets are
65 received and transmitted over separate USB bulk transfer endpoints.
66 .Pp
67 For more information on configuring this device, see
68 .Xr ifconfig 8 .
69 .Sh HARDWARE
70 Adapters supported by the
71 .Nm
72 driver include:
73 .Pp
74 .Bl -bullet -compact
75 .It
76 Sitecom LN030
77 .El
78 .Sh SEE ALSO
79 .Xr altq 4 ,
80 .Xr arp 4 ,
81 .Xr ifmedia 4 ,
82 .Xr miibus 4 ,
83 .Xr netintro 4 ,
84 .Xr ng_ether 4 ,
85 .Xr ifconfig 8
86 .Rs
87 .%T ADMtek AN986 data sheet
88 .%O http://www.moschip.com/data/products/MCS7830/Data%20Sheet_7830.pdf
89 .Re
90 .Sh HISTORY
91 The
92 .Nm
93 device driver first appeared in
94 .Fx 8.2 .
95 .Sh AUTHORS
96 The
97 .Nm
98 driver was written by
99 .An Rick van der Zwet Aq Mt info@rickvanderzwet.nl .