xref: /openbsd/share/man/man4/fxp.4 (revision 76d0caae)
1.\"	$OpenBSD: fxp.4,v 1.45 2015/01/15 20:37:36 schwarze Exp $
2.\"
3.\" Copyright (c) 1997 David E. O'Brien
4.\"
5.\" All rights reserved.
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 DEVELOPERS ``AS IS'' AND ANY EXPRESS OR
17.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT,
20.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26.\"
27.Dd $Mdocdate: January 15 2015 $
28.Dt FXP 4
29.Os
30.Sh NAME
31.Nm fxp
32.Nd Intel EtherExpress PRO/100 10/100 Ethernet device
33.Sh SYNOPSIS
34.Cd "fxp* at pci?"
35.Cd "fxp* at cardbus?"
36.Cd "icsphy* at mii?"
37.Cd "inphy* at mii?"
38.Cd "iophy* at mii?"
39.Cd "nsphy* at mii?"
40.Sh DESCRIPTION
41The
42.Nm
43device driver supports the Intel EtherExpress 100 family of Ethernet cards
44based on various revisions of the i82557, i82558, i82559, i82559S,
45i82550, i82551, and i82562 chipsets, including the following:
46.Pp
47.Bl -item -offset indent -compact
48.It
49Intel EtherExpress PRO/100 PCI
50.It
51Intel EtherExpress PRO/100B PCI
52.It
53Intel EtherExpress PRO/100+ PCI
54.It
55Intel EtherExpress PRO/100 Dual-Port PCI
56.It
57Intel PRO/100 CardBus II PC Card
58.It
59Intel PRO/100 VE
60.It
61Intel PRO/100 VM
62.It
63Intel PRO/100 M
64.It
65Intel PRO/100 S
66.El
67.Pp
68The following media types and options (as given to
69.Xr ifconfig 8 )
70are supported:
71.Bl -tag -width xxx -offset indent
72.It Cm media No autoselect
73Enable autoselection of the media type and options (default).
74.It Cm media No 100baseTX Cm mediaopt No full-duplex
75Set 100Mbps (Fast Ethernet) operation and force full-duplex mode.
76.It Cm media No 100baseTX Cm mediaopt No half-duplex
77Set 100Mbps (Fast Ethernet) operation and force half-duplex mode.
78.It Cm media No 10baseT Cm mediaopt No full-duplex
79Set 10Mbps operation and force full-duplex.
80.It Cm media No 10baseT Cm mediaopt No half-duplex
81Set 10Mbps operation and force half-duplex.
82.El
83.Pp
84If no media options are present, the
85.Nm
86driver places the card into autoselect mode.
87.Sh FILES
88Some devices are able to do interrupt coalescing but it requires firmware
89updating.
90The following firmware files are potentially loaded on demand when an
91interface is brought up:
92.Pp
93.Bl -tag -width Ds -offset indent -compact
94.It Pa /etc/firmware/fxp-d101a
95.It Pa /etc/firmware/fxp-d101b0
96.It Pa /etc/firmware/fxp-d101ma
97.It Pa /etc/firmware/fxp-d101s
98.It Pa /etc/firmware/fxp-d102
99.It Pa /etc/firmware/fxp-d102c
100.It Pa /etc/firmware/fxp-d102e
101.El
102.Pp
103If a file is missing, the driver attempts to operate anyway.
104.Sh DIAGNOSTICS
105.Bl -diag
106.It "fxp0: couldn't map memory"
107A fatal initialization error has occurred.
108.It "fxp0: couldn't map interrupt"
109A fatal initialization error has occurred.
110.It "fxp0: Failed to malloc memory"
111There are not enough mbufs available for allocation.
112.It "fxp0: device timeout"
113The device has stopped responding to the network, or there is a problem with
114the network connection (cable).
115.It "fxp0: error N, could not read firmware ..."
116The device is able to do interrupt coalescing but required firmware file
117is missing.
118.El
119.Sh SEE ALSO
120.Xr arp 4 ,
121.Xr cardbus 4 ,
122.Xr icsphy 4 ,
123.Xr ifmedia 4 ,
124.Xr inphy 4 ,
125.Xr intro 4 ,
126.Xr iophy 4 ,
127.Xr netintro 4 ,
128.Xr nsphy 4 ,
129.Xr pci 4 ,
130.Xr hostname.if 5 ,
131.Xr ifconfig 8
132.Sh HISTORY
133The
134.Nm
135device driver first appeared in
136.Ox 2.2 .
137.Sh AUTHORS
138.An -nosplit
139The
140.Nm
141device driver was written by
142.An David Greenman .
143This manual page was written by
144.An David E. O'Brien .
145