share/man/man4/de.4

   1 .\"
   2 .\" Copyright (c) 1997 David E. O'Brien
   3 .\"
   4 .\" All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\"
  15 .\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR
  16 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  17 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  18 .\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT,
  19 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  20 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  21 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  22 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  23 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  24 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  25 .\"
  26 .\" $FreeBSD$
  27 .\"
  28 .Dd October 24, 2018
  29 .Dt DE 4
  30 .Os
  31 .Sh NAME
  32 .Nm de
  33 .Nd "DEC DC21x4x Ethernet device driver"
  34 .Sh SYNOPSIS
  35 To compile this driver into the kernel,
  36 place the following line in your
  37 kernel configuration file:
  38 .Bd -ragged -offset indent
  39 .Cd "device de"
  40 .Ed
  41 .Pp
  42 Alternatively, to load the driver as a
  43 module at boot time, place the following line in
  44 .Xr loader.conf 5 :
  45 .Bd -literal -offset indent
  46 if_de_load="YES"
  47 .Ed
  48 .Sh DEPRECATION NOTICE
  49 The
  50 .Nm
  51 driver is not present in
  52 .Fx 13.0
  53 and later.
  54 See https://github.com/freebsd/fcp/blob/master/fcp-0101.md for more
  55 information.
  56 .Sh DESCRIPTION
  57 The
  58 .Nm
  59 driver provides support for the Ethernet adapters based on the Digital
  60 Equipment DC21x4x based self-contained Ethernet and Fast Ethernet
  61 chips.
  62 .Pp
  63 The
  64 .Nm
  65 driver supports the following media types:
  66 .Bl -tag -width xxxxxxxxxxxxxxx
  67 .It autoselect
  68 Enable autoselection of the media type and options
  69 .It 10baseT/UTP
  70 Set 10Mbps operation on the 10baseT port
  71 .It 10base2/BNC
  72 Set 10Mbps operation on the BNC port
  73 .It 10base5/AUI
  74 Set 10Mbps operation on the AUI port
  75 .It 100baseTX
  76 Set 100Mbps (Fast Ethernet) operation
  77 .It 100baseFX
  78 Set 100Mbps operation
  79 .It 100baseT4
  80 Set 100Mbps operation (4-pair cat-3 cable)
  81 .El
  82 .Pp
  83 The
  84 .Nm
  85 driver supports the following media options:
  86 .Bl -tag -width xxxxxxxxxxxxxxx
  87 .It full-duplex
  88 Set full duplex operation
  89 .El
  90 .Pp
  91 Note that the media types available depend on the particular card in use.
  92 Some cards are explicitly programmed to a particular media type by a
  93 setup utility and are not changeable.
  94 .Pp
  95 Use the
  96 .Xr ifconfig 8
  97 command and in particular the
  98 .Fl m
  99 flag to list the supported media types for your particular card.
 100 .Pp
 101 The old
 102 .Dq ifconfig linkN
 103 method of configuration is not supported.
 104 .Sh HARDWARE
 105 Adapters supported by the
 106 .Nm
 107 driver include:
 108 .Pp
 109 .Bl -bullet -compact
 110 .It
 111 Adaptec ANA-6944/TX
 112 .It
 113 Cogent EM100FX and EM440TX
 114 .It
 115 Corega FastEther PCI-TX
 116 .It
 117 D-Link DFE-500TX
 118 .It
 119 DEC DE435, DEC DE450, and DEC DE500
 120 .It
 121 ELECOM LD-PCI2T, LD-PCITS
 122 .It
 123 I-O DATA LA2/T-PCI
 124 .It
 125 SMC Etherpower 8432, 9332 and 9334
 126 .It
 127 ZNYX ZX3xx
 128 .El
 129 .Sh DIAGNOSTICS
 130 .Bl -diag
 131 .It "de%d: waking device from sleep/snooze mode"
 132 The 21041 and 21140A chips support suspending the operation of the card.
 133 .It "de%d: error: desired IRQ of %d does not match device's actual IRQ of %d"
 134 The device probe detected that the board is configured for a different
 135 interrupt than the one specified in the kernel configuration file.
 136 .It "de%d: not configured; limit of %d reached or exceeded"
 137 There is a limit of 32
 138 .Nm
 139 devices allowed in a single machine.
 140 .It "de%d: not configured; 21040 pass 2.0 required (%d.%d found)"
 141 .It "de%d: not configured; 21140 pass 1.1 required (%d.%d found)"
 142 Certain revisions of the chipset are not supported by this driver.
 143 .El
 144 .Sh SEE ALSO
 145 .Xr altq 4 ,
 146 .Xr arp 4 ,
 147 .Xr netintro 4 ,
 148 .Xr ng_ether 4 ,
 149 .Xr ifconfig 8
 150 .Sh AUTHORS
 151 .An -nosplit
 152 The
 153 .Nm
 154 device driver was written by
 155 .An Matt Thomas .
 156 This manual page was written by
 157 .An David E. O'Brien .