share/man/man4/cm.4

   1 .\"
   2 .\" Copyright (c) 2004 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$
  27 .\"
  28 .Dd July 28, 2004
  29 .Dt CM 4
  30 .Os
  31 .Sh NAME
  32 .Nm cm
  33 .Nd SMC Arcnet Ethernet device driver
  34 .Sh SYNOPSIS
  35 .Cd device isa
  36 .Cd device cm
  37 .Sh DESCRIPTION
  38 The
  39 .Nm
  40 driver provides support for the
  41 .Tn Arcnet
  42 .Tn ISA
  43 network adapters.
  44 .Pp
  45 This driver also has quirks preset in the
  46 .Xr device.hints 5
  47 file for card detection.
  48 .Sh HARDWARE
  49 The
  50 .Nm
  51 driver supports the following
  52 card models:
  53 .Pp
  54 .Bl -bullet -compact
  55 .It
  56 SMC90c26
  57 .It
  58 SMC90c56
  59 .It
  60 SMC90c66 in '56 compatibility mode.
  61 .El
  62 .Sh IMPLEMENTATION NOTES
  63 When the
  64 .Va NOARP
  65 flag is set on the
  66 .Nm
  67 interface,
  68 it does not employ the address resolution protocol described in
  69 .Xr arp 4
  70 to dynamically map between Internet and Ethernet addresses on
  71 the local network.
  72 Instead it uses the least significant 8 bits of the
  73 .Tn IP
  74 address as the hardware address
  75 like described in
  76 .Tn RFC
  77 1051
  78 and
  79 .Tn RFC
  80 1201.
  81 .Pp
  82 With the
  83 .Dv IFF_LINK0
  84 flag cleared
  85 .Tn IP/ARP/RARP
  86 encoding is done according to
  87 .Tn RFC
  88 1201
  89 that is, with Packet Header Definition Standard header and packet type
  90 212 / 213.
  91 The
  92 .Tn MTU
  93 is normally 1500.
  94 The
  95 .Dv IFF_LINK0
  96 flag is cleared by default.
  97 .Pp
  98 With the
  99 .Dv IFF_LINK0
 100 flag set,
 101 .Tn IP
 102 and
 103 .Tn ARP
 104 encoding is done according to the deprecated
 105 .Tn RFC
 106 1051 encoding, that is with simple header, packet type 240 / 241,
 107 and the
 108 .Tn MTU
 109 is 507.
 110 .Pp
 111 When switching between the two modes, use
 112 .Dl ifconfig interfacename down up
 113 to switch the
 114 .Tn MTU .
 115 .Sh DIAGNOSTICS
 116 The following driver specific error messages
 117 may be reported:
 118 .Bl -diag
 119 .It "reset: card reset, link addr = 0x%02x (cm%d)"
 120 The card is being reset and a new link address assigned.
 121 .It "srint: restarted rx on buf cm%d"
 122 The rx buffer has been emptied and will be reset.
 123 .El
 124 .Sh SEE ALSO
 125 .Xr netintro 4 ,
 126 .Xr watchdog 4 ,
 127 .Xr device.hints 5 ,
 128 .Xr ifconfig 8 ,
 129 .Xr watchdog 8
 130 .Sh HISTORY
 131 The
 132 .Nm
 133 device was ported from
 134 .Nx
 135 by
 136 .An Max Khon Aq fjoe@FreeBSD.org
 137 and first appeared in
 138 .Fx 4.6 .
 139 This manual page first appeared in
 140 .Fx 5.3 .
 141 .Sh AUTHORS
 142 This manual page was written by
 143 .An Tom Rhodes Aq trhodes@FreeBSD.org .
 144 The IMPLEMENTATION NOTES section was submitted by
 145 .An Max Khon Aq fjoe@FreeBSD.org
 146 and originated from
 147 .Nx .
 148 .Sh BUGS
 149 The
 150 .Nm
 151 driver code could do with a bit of improvement,
 152 it would be nice if some one could come along and take care of this.
 153 .Pp
 154 The IMPLEMENTATION NOTES section is specific to all Arcnet
 155 devices
 156 .Pq see Pa sys/net/if_arcsubr.c
 157 and should be moved to a more generic location.