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