xref: /netbsd-src/share/man/man4/man4.emips/enic.4 (revision 6a493d6bc668897c91594964a732d38505b70cbb)
1.\"	$NetBSD: enic.4,v 1.3 2011/02/14 21:13:17 pooka Exp $
2.\"
3.\" Copyright (c) 2001, 2010 The NetBSD Foundation, Inc.
4.\"
5.\" This file is derived from work contributed by Microsoft Corporation.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\"
16.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE.
27.\"
28.Dd July 27, 2010
29.Dt ENIC 4
30.Os
31.Sh NAME
32.Nm enic
33.Nd eMIPS ExtensibleNIC Ethernet interface driver
34.Cd "enic* at ebus0 addr ?"
35.Sh DESCRIPTION
36The
37.Nm
38interface provides access to a
39.Tn Ethernet
40network via the eMIPS builtin
41.Tn eNIC
42(Extensible Network Interface Controller - Ethernet) interface.
43.Pp
44Each of the host's network addresses
45is specified at boot time with an
46.Dv SIOCSIFADDR
47.Xr ioctl 2 .
48The
49.Nm
50interface employs the Address Resolution Protocol (ARP) described in
51.Xr arp 4
52to dynamically map between Internet and
53.Tn Ethernet
54addresses on the local network.
55.Pp
56Multicast Ethernet frames are unconditionally received and must be filtered in software.
57.Sh HARDWARE
58.Ss emips
59The
60.Tn ENIC
61interface is present on the BEE3 and Xilinx XUP boards. The interface speed is wired at 1Gbps.
62.Sh DIAGNOSTICS
63.Bl -diag
64.It "enic%d: enic_put: no mem?"
65The driver could not allocate a transmit buffer, packet was not sent.
66.It "enic%d: internal error"
67This and other messages are indicative of bad hardware or software driver coding errors.
68.El
69.Sh SEE ALSO
70.Xr arp 4 ,
71.Xr ifmedia 4 ,
72.Xr inet 4 ,
73.Xr intro 4 ,
74.Xr ifconfig 8
75.Sh HISTORY
76.Nm
77driver first appeared in
78.Nx 6.0 .
79