share/man/man4/cas.4

   1 .\" $NetBSD: cas.4,v 1.1 2010/01/07 09:20:45 jdc Exp $
   2 .\"
   3 .\" Copyright (c) 2010 The NetBSD Foundation, Inc.
   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 NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  16 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  17 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  18 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  19 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  20 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  21 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  22 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  23 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  24 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  25 .\" POSSIBILITY OF SUCH DAMAGE.
  26 .\"
  27 .Dd January 7, 2010
  28 .Dt CAS 4
  29 .Os
  30 .Sh NAME
  31 .Nm cas
  32 .Nd Cassini/Cassini+ (GigaSwift) Ethernet device driver
  33 .Sh SYNOPSIS
  34 .Cd "cas* at pci? dev ? function ?"
  35 .Pp
  36 Configuration of PHYs may also be necessary.
  37 See
  38 .Xr mii 4 .
  39 .Sh DESCRIPTION
  40 The
  41 .Nm
  42 driver provides support for the Sun Cassini and Cassini+ (GigaSwift) and the
  43 National Semiconductor Saturn Ethernet hardware found in Sun UltraSPARC machines
  44 and Sun GigaSwift PCI cards.
  45 .Pp
  46 Cards supported by this driver include:
  47 .Bl -bullet -compact -offset indent
  48 .It
  49 Sun Gigaswift Ethernet (SX fibre variants)
  50 .It
  51 Sun Gigaswift Ethernet (UTP variants)
  52 .It
  53 Sun quad Gigaswift Ethernet
  54 .El
  55 .Sh SEE ALSO
  56 .Xr brgphy 4 ,
  57 .Xr gentbi 4 ,
  58 .Xr gphyter 4 ,
  59 .Xr ifmedia 4 ,
  60 .Xr intro 4 ,
  61 .Xr mii 4 ,
  62 .Xr ifconfig 8
  63 .Rs
  64 .%T "Cassini+ ASIC Specification"
  65 .%A Sun Microsystems
  66 .%O http://www.sun.com/processors/manuals/cs_plus.pdf
  67 .Re
  68 .Sh HISTORY
  69 The
  70 .Nm
  71 driver first appeared in
  72 .Ox 4.1 .
  73 .Nx
  74 support was added in
  75 .Nx 6.0 .
  76 .Sh AUTHORS
  77 .An -nosplit
  78 The
  79 .Nm
  80 driver was written for
  81 .Ox
  82 by
  83 .An Mark Kettenis
  84 .Aq kettenis@openbsd.org ,
  85 based on the
  86 .Xr gem 4
  87 driver, and ported to
  88 .Nx
  89 by
  90 .An Julian Coleman
  91 .Aq jdc@NetBSD.org .
  92 .Sh BUGS
  93 The
  94 .Nm
  95 driver does not support any of the advanced features of the Cassini chip.
  96 .Pp
  97 On the SX fibre variants of the hardware, the link may stay down if media
  98 options apart from
  99 .Dv autoselect
 100 are chosen.