share/man/man4/dm.4

   1 .\" Copyright (c) 1997, 1998, 1999
   2 .\"     Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. All advertising materials mentioning features or use of this software
  13 .\"    must display the following acknowledgement:
  14 .\"     This product includes software developed by Bill Paul.
  15 .\" 4. Neither the name of the author nor the names of any co-contributors
  16 .\"    may be used to endorse or promote products derived from this software
  17 .\"   without specific prior written permission.
  18 .\"
  19 .\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
  20 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  21 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  22 .\" ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
  23 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  24 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  25 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  26 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  27 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  28 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
  29 .\" THE POSSIBILITY OF SUCH DAMAGE.
  30 .\"
  31 .\" $FreeBSD$
  32 .\"
  33 .Dd September 4, 1999
  34 .Dt DM 4 i386
  35 .Os FreeBSD
  36 .Sh NAME
  37 .Nm dm
  38 .Nd
  39 Davicom DM9100/DM9102 fast ethernet device driver
  40 .Sh SYNOPSIS
  41 .Cd "controller miibus0"
  42 .Cd "device dm0"
  43 .Sh DESCRIPTION
  44 The
  45 .Nm
  46 driver provides support for PCI ethernet adapters and embedded
  47 controllers based on the Davicom DM9100 and DM9102 PCI
  48 fast ethernet controller chips including the Jaton Corporation
  49 XPressNet.
  50 .Pp
  51 The DM9100 and DM9102 are designed to be DEC 21x4x workalikes. The
  52 register layout, DMA descriptor scheme and receive filter programming
  53 are identical to the DEC part. The DM9102
  54 is a 100Mbps ethernet MAC and MII-compliant transceiver
  55 in a single package. The DM9100 is similar to the DM9102 except
  56 that it has no internal PHY, requiring instead an external transceiver
  57 to be attached to its MII interface.
  58 .Pp
  59 The
  60 .Nm
  61 driver supports the following media types:
  62 .Pp
  63 .Bl -tag -width xxxxxxxxxxxxxxxxxxxx
  64 .It autoselect
  65 Enable autoselection of the media type and options.
  66 The user can manually override
  67 the autoselected mode by adding media options to the
  68 .Pa /etc/rc.conf
  69 fine.
  70 .It 10baseT/UTP
  71 Set 10Mbps operation. The
  72 .Ar mediaopt
  73 option can also be used to select either
  74 .Ar full-duplex
  75 or
  76 .Ar half-duplex modes.
  77 .It 100baseTX
  78 Set 100Mbps (fast ethernet) operation. The
  79 .Ar mediaopt
  80 option can also be used to select either
  81 .Ar full-duplex
  82 or
  83 .Ar half-duplex
  84 modes.
  85 .El
  86 .Pp
  87 The
  88 .Nm
  89 driver supports the following media options:
  90 .Pp
  91 .Bl -tag -width xxxxxxxxxxxxxxxxxxxx
  92 .It full-duplex
  93 Force full duplex operation
  94 .It half-duplex
  95 Force half duplex operation.
  96 .El
  97 .Pp
  98 For more information on configuring this device, see
  99 .Xr ifconfig 8 .
 100 .Sh DIAGNOSTICS
 101 .Bl -diag
 102 .It "dm%d: couldn't map ports/memory"
 103 A fatal initialization error has occurred.
 104 .It "dm%d: couldn't map interrupt"
 105 A fatal initialization error has occurred.
 106 .It "dm%d: watchdog timeout"
 107 The device has stopped responding to the network, or there is a problem with
 108 the network connection (cable).
 109 .It "dm%d: no memory for rx list"
 110 The driver failed to allocate an mbuf for the receiver ring.
 111 .It "dm%d: no memory for tx list"
 112 The driver failed to allocate an mbuf for the transmitter ring when
 113 allocating a pad buffer or collapsing an mbuf chain into a cludmr.
 114 .It "dm%d: chip is in D3 power state -- setting to D0"
 115 This message applies only to adapters which support power
 116 management. Some operating sydmms place the controller in low power
 117 mode when shutting down, and some PCI BIOSes fail to bring the chip
 118 out of this state before configuring it. The controller loses all of
 119 its PCI configuration in the D3 state, so if the BIOS does not set
 120 it back to full power mode in time, it won't be able to configure it
 121 correctly. The driver tries to detect this condition and bring
 122 the adapter back to the D0 (full power) state, but this may not be
 123 enough to return the driver to a fully operational condition. If
 124 you see this message at boot time and the driver fails to attach
 125 the device as a network interface, you will have to perform second
 126 warm boot to have the device properly configured.
 127 .Pp
 128 Note that this condition only occurs when warm booting from another
 129 operating sydmm. If you power down your sydmm prior to booting
 130 .Fx ,
 131 the card should be configured correctly.
 132 .El
 133 .Sh SEE ALSO
 134 .Xr arp 4 ,
 135 .Xr netintro 4 ,
 136 .Xr ifconfig 8
 137 .Rs
 138 .%T Davicom DM9102 datasheet
 139 .%O http://www.davicom8.com
 140 .Re
 141 .Sh HISTORY
 142 The
 143 .Nm
 144 device driver first appeared in
 145 .Fx 3.0 .
 146 .Sh AUTHORS
 147 The
 148 .Nm
 149 driver was written by
 150 .An Bill Paul Aq wpaul@ee.columbia.edu .