xref: /netbsd-src/share/man/man4/man4.emips/enic.4 (revision 370b757da0b6af069273f414ae59ae49c0db506f)
1.\"	$NetBSD: enic.4,v 1.7 2017/02/18 22:39:00 wiz 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 February 17, 2017
29.Dt ENIC 4
30.Os
31.Sh NAME
32.Nm enic
33.Nd eMIPS ExtensibleNIC Ethernet interface driver
34.Sh SYNOPSIS
35.Cd "enic* at ebus0 addr ?"
36.Sh DESCRIPTION
37The
38.Nm
39interface provides access to an
40.Tn Ethernet
41network via the eMIPS builtin
42.Tn eNIC
43(Extensible Network Interface Controller - Ethernet) interface.
44.Pp
45Each of the host's network addresses
46is specified at boot time with an
47.Dv SIOCSIFADDR
48.Xr ioctl 2 .
49The
50.Nm
51interface employs the Address Resolution Protocol (ARP) described in
52.Xr arp 4
53to dynamically map between Internet and
54.Tn Ethernet
55addresses on the local network.
56.Pp
57Multicast Ethernet frames are unconditionally received and must be
58filtered in software.
59.Sh HARDWARE
60.Ss emips
61The
62.Tn ENIC
63interface is present on the BEE3 and Xilinx XUP boards.
64The interface speed is wired at 1Gbps.
65.Sh DIAGNOSTICS
66.Bl -diag
67.It "enic%d: enic_put: no mem?"
68The driver could not allocate a transmit buffer, packet was not sent.
69.It "enic%d: internal error"
70This and other messages are indicative of bad hardware or software
71driver coding errors.
72.El
73.Sh SEE ALSO
74.Xr arp 4 ,
75.Xr emips/intro 4 ,
76.Xr ifmedia 4 ,
77.Xr inet 4 ,
78.Xr ifconfig 8
79.Sh HISTORY
80.Nm
81driver first appeared in
82.Nx 6.0 .
83