xref: /freebsd/share/man/man4/mgb.4 (revision dbe522e6cad06f52646e59d7c7f44dfc22a45f5f)
1d58e8e48SEd Maste.\" Copyright (c) 2019 The FreeBSD Foundation.
2d58e8e48SEd Maste.\"
3d58e8e48SEd Maste.\" Redistribution and use in source and binary forms, with or without
4d58e8e48SEd Maste.\" modification, are permitted provided that the following conditions
5d58e8e48SEd Maste.\" are met:
6d58e8e48SEd Maste.\" 1. Redistributions of source code must retain the above copyright
7d58e8e48SEd Maste.\"    notice, this list of conditions and the following disclaimer.
8d58e8e48SEd Maste.\" 2. Redistributions in binary form must reproduce the above copyright
9d58e8e48SEd Maste.\"    notice, this list of conditions and the following disclaimer in the
10d58e8e48SEd Maste.\"    documentation and/or other materials provided with the distribution.
11d58e8e48SEd Maste.\"
12d58e8e48SEd Maste.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
13d58e8e48SEd Maste.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
14d58e8e48SEd Maste.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
15d58e8e48SEd Maste.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
16d58e8e48SEd Maste.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
17d58e8e48SEd Maste.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
18d58e8e48SEd Maste.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
19d58e8e48SEd Maste.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
20d58e8e48SEd Maste.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
21d58e8e48SEd Maste.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
22d58e8e48SEd Maste.\" SUCH DAMAGE.
23d58e8e48SEd Maste.\"
24d58e8e48SEd Maste.\" $FreeBSD$
25d58e8e48SEd Maste.\"
26d58e8e48SEd Maste.Dd May 2, 2019
27d58e8e48SEd Maste.Dt MGB 4
28d58e8e48SEd Maste.Os
29d58e8e48SEd Maste.Sh NAME
30d58e8e48SEd Maste.Nm mgb
31d58e8e48SEd Maste.Nd "Microchip LAN743x PCIe Gigabit Ethernet driver"
32d58e8e48SEd Maste.Sh SYNOPSIS
33d58e8e48SEd MasteTo load the driver as a module at boot time, place the following line in
34d58e8e48SEd Maste.Xr loader.conf 5 :
35d58e8e48SEd Maste.Bd -literal -offset indent
36d58e8e48SEd Masteif_mgb_load="YES"
37d58e8e48SEd Maste.Ed
38d58e8e48SEd Maste.Sh DESCRIPTION
39d58e8e48SEd MasteThe
40d58e8e48SEd Maste.Nm
41*dbe522e6SEd Mastedriver is experimental, and is not yet connected to the build.
42*dbe522e6SEd Maste.Pp
43*dbe522e6SEd MasteThe
44*dbe522e6SEd Maste.Nm
45d58e8e48SEd Mastedevice driver provides support for PCIe Gigabit Ethernet adapters based on
46d58e8e48SEd MasteMicrochip's LAN7430 and LAN7431.
47d58e8e48SEd Maste.Pp
48d58e8e48SEd MasteFor more information on configuring this device, see
49d58e8e48SEd Maste.Xr ifconfig 8 .
50d58e8e48SEd Maste.Sh HARDWARE
51d58e8e48SEd MasteThe
52d58e8e48SEd Maste.Nm
53d58e8e48SEd Mastedriver supports:
54d58e8e48SEd Maste.Pp
55d58e8e48SEd Maste.Bl -bullet -compact
56d58e8e48SEd Maste.It
57d58e8e48SEd MasteMicrochip LAN7430 PCIe Gigabit Ethernet controller with PHY
58d58e8e48SEd Maste.It
59d58e8e48SEd MasteMicrochip LAN7431 PCIe Gigabit Ethernet controller with RGMII interface
60d58e8e48SEd Maste.El
61d58e8e48SEd Maste.Sh SEE ALSO
62d58e8e48SEd Maste.Xr arp 4 ,
63d58e8e48SEd Maste.Xr miibus 4 ,
64d58e8e48SEd Maste.Xr ifconfig 8
65d58e8e48SEd Maste.Sh CAVEATS
66d58e8e48SEd MasteThe driver does not yet implement support for many hardware features,
67d58e8e48SEd Masteincluding:
68d58e8e48SEd Maste.Bl -bullet -compact
69d58e8e48SEd Maste.It
70d58e8e48SEd MasteMultiple RX queue support
71d58e8e48SEd Maste.It
72d58e8e48SEd MasteRX and TX checksum offload
73d58e8e48SEd Maste.It
74d58e8e48SEd MasteHardware VLAN tagging or untagging
75d58e8e48SEd Maste.It
76d58e8e48SEd MasteMulticast receive packet filtering
77d58e8e48SEd Maste.It
78d58e8e48SEd MasteWake on LAN (WoL)
79d58e8e48SEd Maste.It
80d58e8e48SEd MasteLSO
81d58e8e48SEd Maste.It
82d58e8e48SEd MasteRSS
83d58e8e48SEd Maste.El
84d58e8e48SEd Maste.Pp
85d58e8e48SEd MasteLAN7431 support is completely untested.
86