1cc264d00SThomas Moestl.\" $NetBSD: gem.4,v 1.2 2003/02/14 15:20:18 grant Exp $ 2cc264d00SThomas Moestl.\" 3cc264d00SThomas Moestl.\" Copyright (c) 2002 The NetBSD Foundation, Inc. 4cc264d00SThomas Moestl.\" All rights reserved. 5cc264d00SThomas Moestl.\" 6cc264d00SThomas Moestl.\" Redistribution and use in source and binary forms, with or without 7cc264d00SThomas Moestl.\" modification, are permitted provided that the following conditions 8cc264d00SThomas Moestl.\" are met: 9cc264d00SThomas Moestl.\" 1. Redistributions of source code must retain the above copyright 10cc264d00SThomas Moestl.\" notice, this list of conditions and the following disclaimer. 11cc264d00SThomas Moestl.\" 2. Redistributions in binary form must reproduce the above copyright 12cc264d00SThomas Moestl.\" notice, this list of conditions and the following disclaimer in the 13cc264d00SThomas Moestl.\" documentation and/or other materials provided with the distribution. 14cc264d00SThomas Moestl.\" 15cc264d00SThomas Moestl.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 16cc264d00SThomas Moestl.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 17cc264d00SThomas Moestl.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 18cc264d00SThomas Moestl.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 19cc264d00SThomas Moestl.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 20cc264d00SThomas Moestl.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 21cc264d00SThomas Moestl.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 22cc264d00SThomas Moestl.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 23cc264d00SThomas Moestl.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 24cc264d00SThomas Moestl.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 25cc264d00SThomas Moestl.\" POSSIBILITY OF SUCH DAMAGE. 26cc264d00SThomas Moestl.\" 27*8defc88cSMarius Strobl.Dd April 18, 2023 28cc264d00SThomas Moestl.Dt GEM 4 29cc264d00SThomas Moestl.Os 30cc264d00SThomas Moestl.Sh NAME 31cc264d00SThomas Moestl.Nm gem 32*8defc88cSMarius Strobl.Nd GEM/GMAC Ethernet device driver 33cc264d00SThomas Moestl.Sh SYNOPSIS 3413311d23SMarius StroblTo compile this driver into the kernel, 3513311d23SMarius Stroblplace the following lines in your 3613311d23SMarius Stroblkernel configuration file: 3713311d23SMarius Strobl.Bd -ragged -offset indent 38cc264d00SThomas Moestl.Cd "device miibus" 39cc264d00SThomas Moestl.Cd "device gem" 4013311d23SMarius Strobl.Ed 4113311d23SMarius Strobl.Pp 4213311d23SMarius StroblAlternatively, to load the driver as a 4313311d23SMarius Stroblmodule at boot time, place the following line in 4413311d23SMarius Strobl.Xr loader.conf 5 : 4513311d23SMarius Strobl.Bd -literal -offset indent 4613311d23SMarius Stroblif_gem_load="YES" 4713311d23SMarius Strobl.Ed 48cc264d00SThomas Moestl.Sh DESCRIPTION 49cc264d00SThomas MoestlThe 50cc264d00SThomas Moestl.Nm 51d54384d9SMarius Strobldriver provides support for the GMAC Ethernet hardware found mostly in 52*8defc88cSMarius Stroblthe last Apple PowerBooks G3s and most G4-based Apple hardware. 53d54384d9SMarius Strobl.Pp 54d54384d9SMarius StroblAll controllers supported by the 55d54384d9SMarius Strobl.Nm 56d54384d9SMarius Strobldriver have TCP checksum offload capability for both receive and transmit, 57d54384d9SMarius Stroblsupport for the reception and transmission of extended frames for 58d54384d9SMarius Strobl.Xr vlan 4 59d54384d9SMarius Strobland a 512-bit multicast hash filter. 6070a310e2SSimon L. B. Nielsen.Sh HARDWARE 61092f607dSMarius StroblChips supported by the 6270a310e2SSimon L. B. Nielsen.Nm 6370a310e2SSimon L. B. Nielsendriver include: 6470a310e2SSimon L. B. Nielsen.Pp 6570a310e2SSimon L. B. Nielsen.Bl -bullet -compact 66cc264d00SThomas Moestl.It 67092f607dSMarius StroblApple GMAC 68cc264d00SThomas Moestl.It 69092f607dSMarius StroblSun GEM Gigabit Ethernet 70cc264d00SThomas Moestl.El 711ed3fed7SMarius Strobl.Pp 721ed3fed7SMarius StroblThe 731ed3fed7SMarius Stroblfollowing add-on cards are known to work with the 741ed3fed7SMarius Strobl.Nm 751ed3fed7SMarius Strobldriver at this time: 761ed3fed7SMarius Strobl.Pp 771ed3fed7SMarius Strobl.Bl -bullet -compact 781ed3fed7SMarius Strobl.It 791ed3fed7SMarius StroblSun Gigabit Ethernet PCI 2.0/3.0 (GBE/P) 801ed3fed7SMarius Strobl(part no.\& 501-4373) 811ed3fed7SMarius Strobl.El 82cc264d00SThomas Moestl.Sh SEE ALSO 8322e1a9d5SChristian Brueffer.Xr altq 4 , 84cc264d00SThomas Moestl.Xr miibus 4 , 85cc264d00SThomas Moestl.Xr netintro 4 , 86d54384d9SMarius Strobl.Xr vlan 4 , 87cc264d00SThomas Moestl.Xr ifconfig 8 88cc264d00SThomas Moestl.Sh HISTORY 89cc264d00SThomas MoestlThe 90cc264d00SThomas Moestl.Nm 91cc264d00SThomas Moestldevice driver appeared in 92cc264d00SThomas Moestl.Nx 1.6 . 93cc264d00SThomas MoestlThe first 94cc264d00SThomas Moestl.Fx 95cc264d00SThomas Moestlversion to include it was 96cc264d00SThomas Moestl.Fx 5.0 . 97cc264d00SThomas Moestl.Sh AUTHORS 9801ddd31fSRuslan Ermilov.An -nosplit 99cc264d00SThomas MoestlThe 100cc264d00SThomas Moestl.Nm 101d54384d9SMarius Strobldriver was written for 102d54384d9SMarius Strobl.Nx 103d54384d9SMarius Stroblby 1046c899950SBaptiste Daroussin.An Eduardo Horvath Aq Mt eeh@NetBSD.org . 105d54384d9SMarius StroblIt was ported to 106d54384d9SMarius Strobl.Fx 107d54384d9SMarius Stroblby 1086c899950SBaptiste Daroussin.An Thomas Moestl Aq Mt tmm@FreeBSD.org 109d54384d9SMarius Strobland later on improved by 1106c899950SBaptiste Daroussin.An Marius Strobl Aq Mt marius@FreeBSD.org . 111cc264d00SThomas MoestlThe man page was written by 1126c899950SBaptiste Daroussin.An Thomas Klausner Aq Mt wiz@NetBSD.org . 113