1.\"
2.\" Copyright (c) 2003 Tom Rhodes
3.\" All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\" notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\" notice, this list of conditions and the following disclaimer in the
12.\" documentation and/or other materials provided with the distribution.
13.\"
14.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24.\" SUCH DAMAGE.
25.\"
26.\" $FreeBSD: head/share/man/man4/xe.4 147872 2005-07-10 02:00:35Z imp $
27.\"
28.Dd July 4, 2004
29.Dt XE 4
30.Os
31.Sh NAME
32.Nm xe
33.Nd Xircom PCMCIA Ethernet device driver
34.Sh SYNOPSIS
35.Cd "device xe"
36.Sh DESCRIPTION
37The
38.Nm
39driver supports
40.Tn PCMCIA
41Ethernet adapters based on Xircom CE2- and CE3-class hardware.
42This includes devices made by Xircom along with
43various
44.Tn OEM
45manufacturers.
46.Pp
47Please note that the
48.Nm
49driver only supports
50.Tn PCMCIA
51cards and their Ethernet functions.
52.Nm
53does not support the on-board modem device located on some
54version of the Ethernet/modem combo cards.
55In particular, Xircom RealPort2 cards are not supported by this driver.
56.Pp
57The
58.Nm
59driver supports the following media types:
60.Bl -tag -width ".Cm autoselect"
61.It Cm autoselect
62Enable autoselection of media type and options.
63.It Cm 10Base2/BNC
64Select 10Mbps operation on a BNC coaxial connector.
65.It Cm 10BaseT/UTP
66Select 10Mbps operation on a RJ-45 connector.
67.It Cm 100BaseTX
68Select 100Mbps operation.
69.El
70.Pp
71Note that 100BaseTX operation is not available on CE2-class cards,
72while the 10Base2/BNC mode is only available on CE2-class cards.
73Full-duplex
74operation is currently not supported.
75For more information on configuring network interface devices,
76see
77.Xr ifconfig 8 .
78.Sh HARDWARE
79The
80.Nm
81driver supports the following cards:
82.Pp
83.Bl -bullet -compact
84.It
85Xircom CreditCard Ethernet (PS-CE2-10)
86.It
87Xircom CreditCard Ethernet + Modem 28 (PS-CEM-28)
88.It
89Xircom CreditCard Ethernet + Modem 33 (CEM33)
90.It
91Xircom CreditCard 10/100 (CE3, CE3B)
92.It
93Xircom CreditCard Ethernet 10/100 + Modem 56 (CEM56)
94.It
95Xircom RealPort Ethernet 10 (RE10)
96.It
97Xircom RealPort Ethernet 10/100 (RE100)
98.It
99Xircom RealPort Ethernet 10/100 + Modem 56 (REM56, REM56G)
100.It
101Accton Fast EtherCard-16 (EN2226)
102.It
103Compaq Microcom CPQ550 Ethernet/Modem PC Card
104.It
105Compaq Netelligent 10/100 PC Card (CPQ-10/100)
106.It
107Intel EtherExpress Pro/100 PC Card Mobile Adapter 16 (Pro/100 M16A)
108.It
109Intel EtherExpress Pro/100 LAN/Modem PC Card Adapter (Pro/100 M16B)
110.El
111.Pp
112Other similar devices using the same hardware may also be supported.
113.Sh DIAGNOSTICS
114.Bl -diag
115.It "xe%d: Cannot allocate ioport"
116.It "xe%d: Cannot allocate irq"
117A fatal initialization error occurred while attempting to allocate
118system resources for the card.
119.It "xe%d: Unable to fix your %s combo card"
120A fatal initialization error occurred while attempting to attach an
121Ethernet/modem combo card.
122.It "xe%d: watchdog timeout: resetting card"
123The card failed to generate an interrupt acknowledging a
124transmitted packet.
125May indicate a
126.Tn PCMCIA
127configuration problem.
128.It "xe%d: no carrier"
129The card has lost all contact with the network; this
130usually indicates a cable problem.
131.El
132.Sh SEE ALSO
133.Xr pccard 4 ,
134.Xr ifconfig 8
135.Sh HISTORY
136The
137.Nm
138driver first appeared in
139.Fx 3.3 .
140.Sh AUTHORS
141.An -nosplit
142The
143.Nm
144device driver was written by
145.An Scott Mitchell Aq rsm@FreeBSD.org .
146This manual page was written by
147.An Scott Mitchell Aq rsm@FreeBSD.org ,
148and
149.An Tom Rhodes Aq trhodes@FreeBSD.org .
150.Sh BUGS
151Supported devices will fail to attach on some machines using the
152.Tn NEWCARD
153.Tn PC
154Card framework.
155.Pp
156Automatic media selection is usually unreliable.
2.\" Copyright (c) 2003 Tom Rhodes
3.\" All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\" notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\" notice, this list of conditions and the following disclaimer in the
12.\" documentation and/or other materials provided with the distribution.
13.\"
14.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24.\" SUCH DAMAGE.
25.\"
26.\" $FreeBSD: head/share/man/man4/xe.4 147872 2005-07-10 02:00:35Z imp $
27.\"
28.Dd July 4, 2004
29.Dt XE 4
30.Os
31.Sh NAME
32.Nm xe
33.Nd Xircom PCMCIA Ethernet device driver
34.Sh SYNOPSIS
35.Cd "device xe"
36.Sh DESCRIPTION
37The
38.Nm
39driver supports
40.Tn PCMCIA
41Ethernet adapters based on Xircom CE2- and CE3-class hardware.
42This includes devices made by Xircom along with
43various
44.Tn OEM
45manufacturers.
46.Pp
47Please note that the
48.Nm
49driver only supports
50.Tn PCMCIA
51cards and their Ethernet functions.
52.Nm
53does not support the on-board modem device located on some
54version of the Ethernet/modem combo cards.
55In particular, Xircom RealPort2 cards are not supported by this driver.
56.Pp
57The
58.Nm
59driver supports the following media types:
60.Bl -tag -width ".Cm autoselect"
61.It Cm autoselect
62Enable autoselection of media type and options.
63.It Cm 10Base2/BNC
64Select 10Mbps operation on a BNC coaxial connector.
65.It Cm 10BaseT/UTP
66Select 10Mbps operation on a RJ-45 connector.
67.It Cm 100BaseTX
68Select 100Mbps operation.
69.El
70.Pp
71Note that 100BaseTX operation is not available on CE2-class cards,
72while the 10Base2/BNC mode is only available on CE2-class cards.
73Full-duplex
74operation is currently not supported.
75For more information on configuring network interface devices,
76see
77.Xr ifconfig 8 .
78.Sh HARDWARE
79The
80.Nm
81driver supports the following cards:
82.Pp
83.Bl -bullet -compact
84.It
85Xircom CreditCard Ethernet (PS-CE2-10)
86.It
87Xircom CreditCard Ethernet + Modem 28 (PS-CEM-28)
88.It
89Xircom CreditCard Ethernet + Modem 33 (CEM33)
90.It
91Xircom CreditCard 10/100 (CE3, CE3B)
92.It
93Xircom CreditCard Ethernet 10/100 + Modem 56 (CEM56)
94.It
95Xircom RealPort Ethernet 10 (RE10)
96.It
97Xircom RealPort Ethernet 10/100 (RE100)
98.It
99Xircom RealPort Ethernet 10/100 + Modem 56 (REM56, REM56G)
100.It
101Accton Fast EtherCard-16 (EN2226)
102.It
103Compaq Microcom CPQ550 Ethernet/Modem PC Card
104.It
105Compaq Netelligent 10/100 PC Card (CPQ-10/100)
106.It
107Intel EtherExpress Pro/100 PC Card Mobile Adapter 16 (Pro/100 M16A)
108.It
109Intel EtherExpress Pro/100 LAN/Modem PC Card Adapter (Pro/100 M16B)
110.El
111.Pp
112Other similar devices using the same hardware may also be supported.
113.Sh DIAGNOSTICS
114.Bl -diag
115.It "xe%d: Cannot allocate ioport"
116.It "xe%d: Cannot allocate irq"
117A fatal initialization error occurred while attempting to allocate
118system resources for the card.
119.It "xe%d: Unable to fix your %s combo card"
120A fatal initialization error occurred while attempting to attach an
121Ethernet/modem combo card.
122.It "xe%d: watchdog timeout: resetting card"
123The card failed to generate an interrupt acknowledging a
124transmitted packet.
125May indicate a
126.Tn PCMCIA
127configuration problem.
128.It "xe%d: no carrier"
129The card has lost all contact with the network; this
130usually indicates a cable problem.
131.El
132.Sh SEE ALSO
133.Xr pccard 4 ,
134.Xr ifconfig 8
135.Sh HISTORY
136The
137.Nm
138driver first appeared in
139.Fx 3.3 .
140.Sh AUTHORS
141.An -nosplit
142The
143.Nm
144device driver was written by
145.An Scott Mitchell Aq rsm@FreeBSD.org .
146This manual page was written by
147.An Scott Mitchell Aq rsm@FreeBSD.org ,
148and
149.An Tom Rhodes Aq trhodes@FreeBSD.org .
150.Sh BUGS
151Supported devices will fail to attach on some machines using the
152.Tn NEWCARD
153.Tn PC
154Card framework.
155.Pp
156Automatic media selection is usually unreliable.