| cs.4 (89612) | cs.4 (131530) |
|---|---|
| 1.\" 2.\" Copyright (c) 1998 Michael Smith 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 unchanged lines hidden (view full) --- 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.\" | 1.\" 2.\" Copyright (c) 1998 Michael Smith 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 unchanged lines hidden (view full) --- 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/man4.i386/cs.4 89612 2002-01-21 12:36:12Z mpp $ | 26.\" $FreeBSD: head/share/man/man4/man4.i386/cs.4 131530 2004-07-03 18:29:24Z ru $ |
| 27.\" 28.Dd July 20, 1998 29.Dt CS 4 i386 30.Os 31.Sh NAME 32.Nm cs 33.Nd ethernet device driver 34.Sh SYNOPSIS --- 7 unchanged lines hidden (view full) --- 42.Cd hint.cs.0.maddr="0xd000" 43.Sh DESCRIPTION 44The 45.Nm 46driver provides support for ISA ethernet adapters based on the 47.Tn Crystal Semiconductor CS8900 48and 49.Tn CS8920 | 27.\" 28.Dd July 20, 1998 29.Dt CS 4 i386 30.Os 31.Sh NAME 32.Nm cs 33.Nd ethernet device driver 34.Sh SYNOPSIS --- 7 unchanged lines hidden (view full) --- 42.Cd hint.cs.0.maddr="0xd000" 43.Sh DESCRIPTION 44The 45.Nm 46driver provides support for ISA ethernet adapters based on the 47.Tn Crystal Semiconductor CS8900 48and 49.Tn CS8920 |
| 50NICs. These devices are used on the | 50NICs. 51These devices are used on the |
| 51.Tn IBM EtherJet ISA 52adapters and in many embedded applications where the high integration, small 53size and low cost of the CS89x0 family compensate for their drawbacks. 54.Pp 55The 56.Nm 57driver will obtain configuration parameters either from 58.Pa /boot/device.hints 59or from the card. 60At least the I/O port number must be specified. 61Other parameters specified in 62.Pa /boot/device.hints 63will be used if present; 64the card may be soft-configured so these may be any valid | 52.Tn IBM EtherJet ISA 53adapters and in many embedded applications where the high integration, small 54size and low cost of the CS89x0 family compensate for their drawbacks. 55.Pp 56The 57.Nm 58driver will obtain configuration parameters either from 59.Pa /boot/device.hints 60or from the card. 61At least the I/O port number must be specified. 62Other parameters specified in 63.Pa /boot/device.hints 64will be used if present; 65the card may be soft-configured so these may be any valid |
| 65value. Adapters based on the CS8920 normally offer PnP configuration and the driver | 66value. 67Adapters based on the CS8920 normally offer PnP configuration and the driver |
| 66will detect the 67.Tn IBM EtherJet 68and the 69.Tn CSC6040 70adapters automatically. 71.Pp 72Note that the CS8900 is limited to 4 IRQ values; these are normally implemented | 68will detect the 69.Tn IBM EtherJet 70and the 71.Tn CSC6040 72adapters automatically. 73.Pp 74Note that the CS8900 is limited to 4 IRQ values; these are normally implemented |
| 73as 5, 10, 11 and 12. The CS8920 has no such limitation. | 75as 5, 10, 11 and 12. 76The CS8920 has no such limitation. |
| 74.Pp 75Memory-mapped and DMA operation are not supported at this time. 76.Sh DIAGNOSTICS 77.Bl -diag 78.It "cs%d: full/half duplex negotiation timeout" | 77.Pp 78Memory-mapped and DMA operation are not supported at this time. 79.Sh DIAGNOSTICS 80.Bl -diag 81.It "cs%d: full/half duplex negotiation timeout" |
| 79The attempt to negotiate duplex settings with the hub timed out. This may | 82The attempt to negotiate duplex settings with the hub timed out. 83This may |
| 80indicate a cabling problem or a faulty or incompatible hub. 81.It "cs%d: failed to enable <media>" 82The CS89x0 failed to select the nominated media, either because it is not 83present or not operating correctly. 84.It "cs%d: No EEPROM, assuming defaults" | 84indicate a cabling problem or a faulty or incompatible hub. 85.It "cs%d: failed to enable <media>" 86The CS89x0 failed to select the nominated media, either because it is not 87present or not operating correctly. 88.It "cs%d: No EEPROM, assuming defaults" |
| 85The CS89x0 does not have an EEPROM, or the EEPROM is hopelessly damaged. Operation | 89The CS89x0 does not have an EEPROM, or the EEPROM is hopelessly damaged. 90Operation |
| 86will only be successful if the configuration entry lists suitable values for 87the adapter. 88.It "cs%d: Invalid irq" 89The IRQ specified in the configuration entry is not valid for the adapter. 90.It "cs%d: Could not allocate memory for NIC" | 91will only be successful if the configuration entry lists suitable values for 92the adapter. 93.It "cs%d: Invalid irq" 94The IRQ specified in the configuration entry is not valid for the adapter. 95.It "cs%d: Could not allocate memory for NIC" |
| 91There is a critical memory shortage. The adapter will not function. | 96There is a critical memory shortage. 97The adapter will not function. |
| 92.It "cs%d: Adapter has no media" 93The adapter is not configured for a specific media type. 94The media type will have 95to be manually set. 96.It "This is a %s, but LDN %d is disabled" 97The PnP probe code found a recognised adapter, but the adapter is disabled. 98.It "failed to read pnp parms" 99A PnP adapter was found, but configuration parameters for it could not be read. 100.It "failed to pnp card parameters" | 98.It "cs%d: Adapter has no media" 99The adapter is not configured for a specific media type. 100The media type will have 101to be manually set. 102.It "This is a %s, but LDN %d is disabled" 103The PnP probe code found a recognised adapter, but the adapter is disabled. 104.It "failed to read pnp parms" 105A PnP adapter was found, but configuration parameters for it could not be read. 106.It "failed to pnp card parameters" |
| 101The parameters obtained via PnP were not accepted by the driver. The adapter | 107The parameters obtained via PnP were not accepted by the driver. 108The adapter |
| 102may not function. 103.El 104.Sh CAVEATS | 109may not function. 110.El 111.Sh CAVEATS |
| 105The CS89x0 family of adapters have a very small RAM buffer (4K). This may | 112The CS89x0 family of adapters have a very small RAM buffer (4K). 113This may |
| 106cause problems with extremely high network loads or bursty network traffic. 107In particular, NFS operations should be limited to 1k read/write transactions 108in order to avoid overruns. 109.Sh SEE ALSO 110.Xr arp 4 , 111.Xr netintro 4 , 112.Xr ng_ether 4 , 113.Xr ifconfig 8 114.Sh AUTHORS 115.An -nosplit 116The 117.Nm 118device driver was written by 119.An Maxim Bolotin 120and 121.An Oleg Sharoiko . 122This manpage was written by 123.An Michael Smith . | 114cause problems with extremely high network loads or bursty network traffic. 115In particular, NFS operations should be limited to 1k read/write transactions 116in order to avoid overruns. 117.Sh SEE ALSO 118.Xr arp 4 , 119.Xr netintro 4 , 120.Xr ng_ether 4 , 121.Xr ifconfig 8 122.Sh AUTHORS 123.An -nosplit 124The 125.Nm 126device driver was written by 127.An Maxim Bolotin 128and 129.An Oleg Sharoiko . 130This manpage was written by 131.An Michael Smith . |