share/man/man4/kse.4

   1 .\"     $NetBSD: kse.4,v 1.8 2009/05/27 19:23:59 snj Exp $
   2 .\"
   3 .\" Copyright (c) 2006 Tohru Nishimura.
   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 ``AS IS'' AND ANY EXPRESS OR
  15 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  16 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  17 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  18 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  19 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  20 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  21 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  22 .\" INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  23 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  24 .\"
  25 .Dd July 6, 2006
  26 .Dt KSE 4
  27 .Os
  28 .Sh NAME
  29 .Nm kse
  30 .Nd Micrel 8842/8841 PCI Ethernet controller driver
  31 .Sh SYNOPSIS
  32 .Cd "kse* at pci? dev ? function ?"
  33 .Sh DESCRIPTION
  34 The
  35 .Nm
  36 driver supports Ethernet interfaces based on the Micrel 8842/8841
  37 PCI Ethernet chips.
  38 The 8842 has 2 Ethernet ports which behave as a managed switch to
  39 bridge each other.
  40 It works like a T-shape connector of Ethernet data flow in which
  41 an Ethernet controller sits at the leg of the T.
  42 Frames can flow between the two ports while traffic destined for
  43 the 8842 reaches the EMAC.
  44 The 8841 is a plain 10/100 Ethernet.
  45 The
  46 .Nm
  47 driver distinguishes and handles them according to the HW model.
  48 .Sh SEE ALSO
  49 .Xr arp 4 ,
  50 .Xr ifmedia 4 ,
  51 .Xr netintro 4 ,
  52 .Xr pci 4 ,
  53 .Xr ifconfig 8
  54 .Sh AUTHORS
  55 The
  56 .Nm
  57 driver was written by
  58 .An Tohru Nishimura .
  59 .Sh BUGS
  60 __STRICT_ALIGNMENT case is not written.
  61 8842 media selection keeps
  62 .Dq auto
  63 and indicates
  64 .Dq up 100baseTX-FX flow
  65 when either of two ports is found link-up.
  66 There is no functional provision to see and control the media
  67 selection of them this moment.
  68 Advanced features like flow volume bound, VLAN tag insertion/removal,
  69 QoS DiffServ are not implemented and remain uncontrollable by the
  70 .Nm
  71 driver.
  72 UDP4CSUM is not very useful since the HW has an implementation
  73 error for the case when a large UDP datagram is fragmented into
  74 MTU sized frames.