1.\" $NetBSD: xi.4,v 1.10 2002/02/07 03:15:09 ross Exp $ 2.\" 3.\" Copyright (c) 2000 The NetBSD Foundation, Inc. 4.\" All rights reserved. 5.\" 6.\" This code is derived from software contributed to The NetBSD Foundation 7.\" by Gregory McGarry. 8.\" 9.\" Redistribution and use in source and binary forms, with or without 10.\" modification, are permitted provided that the following conditions 11.\" are met: 12.\" 1. Redistributions of source code must retain the above copyright 13.\" notice, this list of conditions and the following disclaimer. 14.\" 2. Redistributions in binary form must reproduce the above copyright 15.\" notice, this list of conditions and the following disclaimer in the 16.\" documentation and/or other materials provided with the distribution. 17.\" 3. All advertising materials mentioning features or use of this software 18.\" must display the following acknowledgement: 19.\" This product includes software developed by the NetBSD 20.\" Foundation, Inc. and its contributors. 21.\" 4. Neither the name of The NetBSD Foundation nor the names of its 22.\" contributors may be used to endorse or promote products derived 23.\" from this software without specific prior written permission. 24.\" 25.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 26.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 27.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 28.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 29.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 30.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 31.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 32.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 33.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 34.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 35.\" POSSIBILITY OF SUCH DAMAGE. 36.\" 37.Dd June 4, 2000 38.Dt XI 4 39.Os 40.Sh NAME 41.Nm xi 42.Nd Xircom CreditCard Ethernet device driver 43.Sh SYNOPSIS 44.Cd "xi* at pcmcia? function ? 45.Pp 46Configuration of PHYs may also be necessary. See 47.Xr mii 4 . 48.Sh DESCRIPTION 49The 50.Nm 51driver provides support for the Xircom CreditCard family of PCMCIA 52Ethernet adapters. Supported cards include: 53.Pp 54.Bl -item -compact -offset indent 55.It 56Xircom CreditCard Ethernet II 57.It 58Xircom CreditCard 10/100 Ethernet 59.\" .It Xircom CreditCard Ethernet + Modem 60.\" .It Xircom CreditCard 10/100 Ethernet + Modem 61.It 62Xircom RealPort 10/100 Ethernet + Modem (Ethernet function only) 63.It 64Intel EtherExpress Pro/100 65.It 66Compaq Netelligent 10/100 67.El 68.Pp 69Cards which should work, but have not been confirmed include: 70.Pp 71.Bl -item -compact -offset indent 72.It 73Xircom RealPort Ethernet 74.It 75Xircom RealPort 10/100 Ethernet 76.El 77.Pp 78Some Xircom Ethernet products are supported by the 79.Xr tlp 4 80driver. 81.Sh MEDIA SELECTION 82Media selection is done using 83.Xr ifconfig 8 84using the standard 85.Xr ifmedia 4 86mechanism. Refer to those manual pages for more information. 87.Sh SEE ALSO 88.Xr ifmedia 4 , 89.Xr mii 4 , 90.Xr netintro 4 , 91.Xr pcmcia 4 , 92.Xr tlp 4 , 93.Xr ifconfig 8 94.Sh HISTORY 95The 96.Nm 97device driver appeared in 98.Nx 1.5 . 99.Sh BUGS 100The driver suffers from poor performance. Even with the 10/100 cards, 101do not expect more than ~450KB/s. Some 10/100 cards may not autonegotiate 102reliably and require manual media selection. 103.Pp 104The Xircom multifunction cards which contain both Ethernet and modem 105interfaces are known to have problems. This is due to the card not 106reporting itself correctly as a multifunction card. 107