summaryrefslogtreecommitdiff
path: root/static/netbsd/man4/gem.4 4.html
blob: e10c7680dd5d64766b677aa21d9987a5cb310636 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
<table class="head">
  <tr>
    <td class="head-ltitle">GEM(4)</td>
    <td class="head-vol">Device Drivers Manual</td>
    <td class="head-rtitle">GEM(4)</td>
  </tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">gem</code> &#x2014; <span class="Nd">ERI/GEM/GMAC
    Ethernet device driver</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp"><code class="Cd">gem* at pci? dev ? function ?</code>
  <br/>
  <code class="Cd">gem* at sbus? slot ? offset ?</code></p>
<p class="Pp">Configuration of PHYs may also be necessary. See
    <a class="Xr">mii(4)</a>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">The <code class="Nm">gem</code> driver provides support for the
    GMac Ethernet hardware found mostly in the last Apple PowerBooks G3s and
    most G4-based Apple hardware, as well as many Sun UltraSPARCs.</p>
<p class="Pp">Cards supported by this driver include:</p>
<ul class="Bl-bullet Bd-indent Bl-compact">
  <li>Sun GEM Gigabit Ethernet (SX fibre variants)</li>
  <li>Sun ERI 10/100</li>
  <li>Apple GMAC</li>
</ul>
<p class="Pp">The GEM family supports hardware checksumming to assist in
    computing IPv4 TCP checksums. The <code class="Nm">gem</code> driver
    supports this feature of the chip. See <a class="Xr">ifconfig(8)</a> for
    information on how to enable this feature.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
  ALSO</a></h1>
<p class="Pp"><a class="Xr">bmtphy(4)</a>, <a class="Xr">ifmedia(4)</a>,
    <a class="Xr">intro(4)</a>, <a class="Xr">makphy(4)</a>,
    <a class="Xr">mii(4)</a>, <a class="Xr">ifconfig(8)</a></p>
<p class="Pp"><cite class="Rs"><span class="RsA">Sun Microsystems</span>,
    <span class="RsT">GEM Gigabit Ethernet ASIC Specification</span>,
    <a class="RsU" href="http://www.sun.com/processors/manuals/ge.pdf">http://www.sun.com/processors/manuals/ge.pdf</a>.</cite></p>
<p class="Pp"><cite class="Rs"><span class="RsA">Sun Microsystems</span>,
    <span class="RsT">Sbus GEM Specification</span>,
    <a class="RsU" href="http://mediacast.sun.com/users/Barton808/media/gem_sbus-1.pdf">http://mediacast.sun.com/users/Barton808/media/gem_sbus-1.pdf</a>.</cite></p>
</section>
<section class="Sh">
<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
<p class="Pp">The <code class="Nm">gem</code> device driver appeared in
    <span class="Ux">NetBSD 1.6</span>. Support for PCI SX fibre cards was added
    in <span class="Ux">NetBSD 5.0</span>. Support for SBus SX fibre cards was
    added in <span class="Ux">NetBSD 5.0</span>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<p class="Pp">The <code class="Nm">gem</code> driver was written by
    <span class="An">Eduardo Horvath</span> &#x27E8;eeh@NetBSD.org&#x27E9;. SX
    fibre support was added by <span class="An">Julian Coleman</span>
    &#x27E8;jdc@NetBSD.org&#x27E9;. The man page was written by
    <span class="An">Thomas Klausner</span> &#x27E8;wiz@NetBSD.org&#x27E9;.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
<p class="Pp">The hardware checksumming support does not support IPv4 UDP,
    although this was allowed prior to <span class="Ux">NetBSD 5.0</span>. Also,
    the hardware IPv4 TCP receive checksumming support has bugs, so this is
    disabled.</p>
<p class="Pp">On the SX fibre variants of the hardware, the link will stay down
    if there is a duplex mismatch. Also, packet transmission may fail when in
    <code class="Cm">half-duplex</code> mode.</p>
</section>
</div>
<table class="foot">
  <tr>
    <td class="foot-date">June 2, 2018</td>
    <td class="foot-os">NetBSD 10.1</td>
  </tr>
</table>