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.\" 2701ddd31fSRuslan Ermilov.\" $FreeBSD$ 2801ddd31fSRuslan Ermilov.\" 29*8defc88cSMarius Strobl.Dd April 18, 2023 30cc264d00SThomas Moestl.Dt GEM 4 31cc264d00SThomas Moestl.Os 32cc264d00SThomas Moestl.Sh NAME 33cc264d00SThomas Moestl.Nm gem 34*8defc88cSMarius Strobl.Nd GEM/GMAC Ethernet device driver 35cc264d00SThomas Moestl.Sh SYNOPSIS 3613311d23SMarius StroblTo compile this driver into the kernel, 3713311d23SMarius Stroblplace the following lines in your 3813311d23SMarius Stroblkernel configuration file: 3913311d23SMarius Strobl.Bd -ragged -offset indent 40cc264d00SThomas Moestl.Cd "device miibus" 41cc264d00SThomas Moestl.Cd "device gem" 4213311d23SMarius Strobl.Ed 4313311d23SMarius Strobl.Pp 4413311d23SMarius StroblAlternatively, to load the driver as a 4513311d23SMarius Stroblmodule at boot time, place the following line in 4613311d23SMarius Strobl.Xr loader.conf 5 : 4713311d23SMarius Strobl.Bd -literal -offset indent 4813311d23SMarius Stroblif_gem_load="YES" 4913311d23SMarius Strobl.Ed 50cc264d00SThomas Moestl.Sh DESCRIPTION 51cc264d00SThomas MoestlThe 52cc264d00SThomas Moestl.Nm 53d54384d9SMarius Strobldriver provides support for the GMAC Ethernet hardware found mostly in 54*8defc88cSMarius Stroblthe last Apple PowerBooks G3s and most G4-based Apple hardware. 55d54384d9SMarius Strobl.Pp 56d54384d9SMarius StroblAll controllers supported by the 57d54384d9SMarius Strobl.Nm 58d54384d9SMarius Strobldriver have TCP checksum offload capability for both receive and transmit, 59d54384d9SMarius Stroblsupport for the reception and transmission of extended frames for 60d54384d9SMarius Strobl.Xr vlan 4 61d54384d9SMarius Strobland a 512-bit multicast hash filter. 6270a310e2SSimon L. B. Nielsen.Sh HARDWARE 63092f607dSMarius StroblChips supported by the 6470a310e2SSimon L. B. Nielsen.Nm 6570a310e2SSimon L. B. Nielsendriver include: 6670a310e2SSimon L. B. Nielsen.Pp 6770a310e2SSimon L. B. Nielsen.Bl -bullet -compact 68cc264d00SThomas Moestl.It 69092f607dSMarius StroblApple GMAC 70cc264d00SThomas Moestl.It 71092f607dSMarius StroblSun GEM Gigabit Ethernet 72cc264d00SThomas Moestl.El 731ed3fed7SMarius Strobl.Pp 741ed3fed7SMarius StroblThe 751ed3fed7SMarius Stroblfollowing add-on cards are known to work with the 761ed3fed7SMarius Strobl.Nm 771ed3fed7SMarius Strobldriver at this time: 781ed3fed7SMarius Strobl.Pp 791ed3fed7SMarius Strobl.Bl -bullet -compact 801ed3fed7SMarius Strobl.It 811ed3fed7SMarius StroblSun Gigabit Ethernet PCI 2.0/3.0 (GBE/P) 821ed3fed7SMarius Strobl(part no.\& 501-4373) 831ed3fed7SMarius Strobl.El 84cc264d00SThomas Moestl.Sh SEE ALSO 8522e1a9d5SChristian Brueffer.Xr altq 4 , 86cc264d00SThomas Moestl.Xr miibus 4 , 87cc264d00SThomas Moestl.Xr netintro 4 , 88d54384d9SMarius Strobl.Xr vlan 4 , 89cc264d00SThomas Moestl.Xr ifconfig 8 90cc264d00SThomas Moestl.Sh HISTORY 91cc264d00SThomas MoestlThe 92cc264d00SThomas Moestl.Nm 93cc264d00SThomas Moestldevice driver appeared in 94cc264d00SThomas Moestl.Nx 1.6 . 95cc264d00SThomas MoestlThe first 96cc264d00SThomas Moestl.Fx 97cc264d00SThomas Moestlversion to include it was 98cc264d00SThomas Moestl.Fx 5.0 . 99cc264d00SThomas Moestl.Sh AUTHORS 10001ddd31fSRuslan Ermilov.An -nosplit 101cc264d00SThomas MoestlThe 102cc264d00SThomas Moestl.Nm 103d54384d9SMarius Strobldriver was written for 104d54384d9SMarius Strobl.Nx 105d54384d9SMarius Stroblby 1066c899950SBaptiste Daroussin.An Eduardo Horvath Aq Mt eeh@NetBSD.org . 107d54384d9SMarius StroblIt was ported to 108d54384d9SMarius Strobl.Fx 109d54384d9SMarius Stroblby 1106c899950SBaptiste Daroussin.An Thomas Moestl Aq Mt tmm@FreeBSD.org 111d54384d9SMarius Strobland later on improved by 1126c899950SBaptiste Daroussin.An Marius Strobl Aq Mt marius@FreeBSD.org . 113cc264d00SThomas MoestlThe man page was written by 1146c899950SBaptiste Daroussin.An Thomas Klausner Aq Mt wiz@NetBSD.org . 115