share/man/man4/gem.4

   1 .\" $NetBSD: gem.4,v 1.2 2003/02/14 15:20:18 grant Exp $
   2 .\"
   3 .\" Copyright (c) 2002 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\" 3. All advertising materials mentioning features or use of this software
  15 .\"    must display the following acknowledgement:
  16 .\"        This product includes software developed by the NetBSD
  17 .\"        Foundation, Inc. and its contributors.
  18 .\" 4. Neither the name of The NetBSD Foundation nor the names of its
  19 .\"    contributors may be used to endorse or promote products derived
  20 .\"    from this software without specific prior written permission.
  21 .\"
  22 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  23 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  24 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  25 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  26 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  27 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  28 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  29 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  30 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  31 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  32 .\" POSSIBILITY OF SUCH DAMAGE.
  33 .\"
  34 .\" $FreeBSD$
  35 .\"
  36 .Dd September 1, 2006
  37 .Dt GEM 4
  38 .Os
  39 .Sh NAME
  40 .Nm gem
  41 .Nd ERI/GEM/GMAC Ethernet device driver
  42 .Sh SYNOPSIS
  43 .Cd "device miibus"
  44 .Cd "device gem"
  45 .Sh DESCRIPTION
  46 The
  47 .Nm
  48 driver provides support for the GMac Ethernet hardware found mostly in
  49 the last Apple PowerBooks G3s and most G4-based Apple hardware, as
  50 well as many Sun UltraSPARCs.
  51 .Sh HARDWARE
  52 .Pp
  53 Chips supported by the
  54 .Nm
  55 driver include:
  56 .Pp
  57 .Bl -bullet -compact
  58 .It
  59 Apple GMAC
  60 .It
  61 Sun ERI 10/100 Mbps Ethernet
  62 .It
  63 Sun GEM Gigabit Ethernet
  64 .El
  65 .Sh NOTES
  66 On sparc64 the
  67 .Nm
  68 driver respects the
  69 .Va local-mac-address?
  70 system configuration variable which can be set in the Open Firmware boot
  71 monitor using the
  72 .Ic setenv
  73 command or by
  74 .Xr eeprom 8 .
  75 If set to
  76 .Dq Li false
  77 (the default), the
  78 .Nm
  79 driver will use the system's default MAC address for all of its devices.
  80 If set to
  81 .Dq Li true ,
  82 the unique MAC address of each interface is used if present rather than
  83 the system's default MAC address.
  84 .Pp
  85 Supported interfaces having their own MAC address include the on-board
  86 Sun ERI 10/100 Mbps on boards equipped with more than one Ethernet interface
  87 and the Sun Gigabit Ethernet 2.0/3.0 GBE add-on cards.
  88 .Sh CAVEATS
  89 Currently the
  90 .Nm
  91 driver fails to attach to Sun Gigabit Ethernet 2.0/3.0 (GBE/P) cards,
  92 as the SERDES used on these cards is not supported so far.
  93 The
  94 .Nm
  95 driver will also fail to probe and attach to Sun Gigabit Ethernet 2.0/3.0 (GBE/S) cards,
  96 as no SBus front-end has been written so far.
  97 .Sh SEE ALSO
  98 .Xr hme 4 ,
  99 .Xr miibus 4 ,
 100 .Xr netintro 4 ,
 101 .Xr eeprom 8 ,
 102 .Xr ifconfig 8
 103 .Sh HISTORY
 104 The
 105 .Nm
 106 device driver appeared in
 107 .Nx 1.6 .
 108 The first
 109 .Fx
 110 version to include it was
 111 .Fx 5.0 .
 112 .Sh AUTHORS
 113 .An -nosplit
 114 The
 115 .Nm
 116 driver was written by
 117 .An Eduardo Horvath
 118 .Aq eeh@NetBSD.org .
 119 The man page was written by
 120 .An Thomas Klausner
 121 .Aq wiz@NetBSD.org .