xref: /netbsd-src/share/man/man4/ne.4 (revision b1c86f5f087524e68db12794ee9c3e3da1ab17a0)
1.\"	$NetBSD: ne.4,v 1.16 2010/04/07 11:10:25 tsutsui Exp $
2.\"
3.\" Copyright (c) 1997, 1998 The NetBSD Foundation, Inc.
4.\" All rights reserved.
5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Jason R. Thorpe of the Numerical Aerospace Simulation Facility,
8.\" NASA Ames Research Center.
9.\"
10.\" Redistribution and use in source and binary forms, with or without
11.\" modification, are permitted provided that the following conditions
12.\" are met:
13.\" 1. Redistributions of source code must retain the above copyright
14.\"    notice, this list of conditions and the following disclaimer.
15.\" 2. Redistributions in binary form must reproduce the above copyright
16.\"    notice, this list of conditions and the following disclaimer in the
17.\"    documentation and/or other materials provided with the distribution.
18.\"
19.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29.\" POSSIBILITY OF SUCH DAMAGE.
30.\"
31.Dd April 3, 2010
32.Dt NE 4
33.Os
34.Sh NAME
35.Nm ne
36.Nd NE2000 and compatible Ethernet cards device driver
37.Sh SYNOPSIS
38.Ss ISA boards
39.Cd "ne0 at isa? port 0x280 irq 9"
40.Cd "ne1 at isa? port 0x300 irq 10"
41.Cd "ne* at isapnp?"
42.Ss MCA boards
43.Cd "ne* at mca? slot ?"
44.Ss PCI boards
45.Cd "ne* at pci? dev ? function ?"
46.Ss PCMCIA
47.Cd "ne* at pcmcia? function ?"
48.Ss acorn32
49.Cd "ne* at podulebus?"
50.Ss amiga
51.Cd "ne* at zbus0" # AriadneII, X-surf
52.Ss amigappc
53.Cd "ne* at zbus0" # AriadneII, X-surf
54.Ss atari
55.Cd "ne0 at mainbus0 # EtherNEC on Atari ROM cartridge slot"
56.Ss evbarm
57.Cd "ne0 at obio? addr 0x0e000200 intr 5 # on-board Asix AX88796"
58.Ss evbsh3
59.Cd "ne0 at mainbus? # Realtek RTL8019AS"
60.Ss x68k
61.Cd "ne* at intio0 addr 0xece300 intr 249 # Nereid Ethernet"
62.Cd "ne* at intio0 addr 0xeceb00 intr 248 # Nereid Ethernet"
63.Cd "neptune0 at intio0 addr 0xece000 intr 249 # Neptune-X"
64.Cd "neptune1 at intio0 addr 0xece400 intr 249 # Neptune-X at alt. addr."
65.Cd "ne* at neptune? addr 0x300"
66.Sh DESCRIPTION
67The
68.Nm
69device driver supports NE2000 and compatible (including NE1000) Ethernet
70cards.
71While the original NE2000 is designed for ISA bus, the compatible
72Realtek 8019 chip is widely used on various local busses and
73.Nm
74driver also supports such devices on various machines.
75.Sh MEDIA SELECTION
76The Realtek 8019 (ISA, ISAPnP, some PCMCIA) and Realtek 8029 (PCI)
77NE2000-compatible Ethernet chips include support for software media
78selection.
79If one of these chips is detected by the driver, the list
80of supported media will be displayed.
81.Pp
82For all other chips supported by the
83.Nm
84driver, media selection must be performed either via card jumper
85settings or by vendor-supplied configuration programs.
86.Sh DIAGNOSTICS
87.Bl -diag
88.It "ne0: where did the card go?"
89The driver found the card, but was unable to make the card respond
90to complete the configuration sequence.
91.El
92.Sh SEE ALSO
93.Xr ifmedia 4 ,
94.Xr intro 4 ,
95.Xr isa 4 ,
96.Xr isapnp 4 ,
97.Xr mca 4 ,
98.Xr pci 4 ,
99.Xr pcmcia 4 ,
100.Xr ifconfig 8
101