xref: /freebsd/share/man/man4/mgb.4 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
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.\"
24*667ea738SEd Maste.Dd September 28, 2021
25d58e8e48SEd Maste.Dt MGB 4
26d58e8e48SEd Maste.Os
27d58e8e48SEd Maste.Sh NAME
28d58e8e48SEd Maste.Nm mgb
29d58e8e48SEd Maste.Nd "Microchip LAN743x PCIe Gigabit Ethernet driver"
30d58e8e48SEd Maste.Sh SYNOPSIS
31d58e8e48SEd MasteTo load the driver as a module at boot time, place the following line in
32d58e8e48SEd Maste.Xr loader.conf 5 :
33d58e8e48SEd Maste.Bd -literal -offset indent
34d58e8e48SEd Masteif_mgb_load="YES"
35d58e8e48SEd Maste.Ed
36d58e8e48SEd Maste.Sh DESCRIPTION
37d58e8e48SEd MasteThe
38d58e8e48SEd Maste.Nm
39*667ea738SEd Mastedriver is experimental, and has a number of caveats and limitations.
40*667ea738SEd MasteIt is currently available only as a kernel module.
41dbe522e6SEd Maste.Pp
42dbe522e6SEd MasteThe
43dbe522e6SEd Maste.Nm
44d58e8e48SEd Mastedevice driver provides support for PCIe Gigabit Ethernet adapters based on
45d58e8e48SEd MasteMicrochip's LAN7430 and LAN7431.
46d58e8e48SEd Maste.Pp
47d58e8e48SEd MasteFor more information on configuring this device, see
48d58e8e48SEd Maste.Xr ifconfig 8 .
49d58e8e48SEd Maste.Sh HARDWARE
50d58e8e48SEd MasteThe
51d58e8e48SEd Maste.Nm
52d58e8e48SEd Mastedriver supports:
53d58e8e48SEd Maste.Pp
54d58e8e48SEd Maste.Bl -bullet -compact
55d58e8e48SEd Maste.It
56d58e8e48SEd MasteMicrochip LAN7430 PCIe Gigabit Ethernet controller with PHY
57d58e8e48SEd Maste.It
58d58e8e48SEd MasteMicrochip LAN7431 PCIe Gigabit Ethernet controller with RGMII interface
59d58e8e48SEd Maste.El
60d58e8e48SEd Maste.Sh SEE ALSO
61d58e8e48SEd Maste.Xr arp 4 ,
62d58e8e48SEd Maste.Xr miibus 4 ,
63d58e8e48SEd Maste.Xr ifconfig 8
64d58e8e48SEd Maste.Sh CAVEATS
65d58e8e48SEd MasteThe driver does not yet implement support for many hardware features,
66d58e8e48SEd Masteincluding:
67d58e8e48SEd Maste.Bl -bullet -compact
68d58e8e48SEd Maste.It
69d58e8e48SEd MasteMultiple RX queue support
70d58e8e48SEd Maste.It
71d58e8e48SEd MasteRX and TX checksum offload
72d58e8e48SEd Maste.It
73d58e8e48SEd MasteHardware VLAN tagging or untagging
74d58e8e48SEd Maste.It
75d58e8e48SEd MasteMulticast receive packet filtering
76d58e8e48SEd Maste.It
77d58e8e48SEd MasteWake on LAN (WoL)
78d58e8e48SEd Maste.It
79d58e8e48SEd MasteLSO
80d58e8e48SEd Maste.It
81d58e8e48SEd MasteRSS
82d58e8e48SEd Maste.El
83d58e8e48SEd Maste.Pp
84d58e8e48SEd MasteLAN7431 support is completely untested.
85