xref: /openbsd-src/share/man/man4/cas.4 (revision 30cd3717f86c709debe28117979fba84115159b2)
1.\"	$OpenBSD: cas.4,v 1.10 2022/03/21 14:56:16 miod Exp $
2.\"
3.\" Copyright (c) 2007 Mark Kettenis <kettenis@openbsd.org>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd $Mdocdate: March 21 2022 $
18.Dt CAS 4
19.Os
20.Sh NAME
21.Nm cas
22.Nd Sun Cassini 10/100/1Gb Ethernet device
23.Sh SYNOPSIS
24.Cd "cas* at pci?"
25.Cd "brgphy* at mii?"
26.Cd "gentbi* at mii?"
27.Cd "nsgphy* at mii?"
28.Sh DESCRIPTION
29The
30.Nm
31driver provides support for various NICs based on the Sun
32Cassini/Cassini+ and National Semiconductor Saturn Ethernet controller
33chips, including the following:
34.Pp
35.Bl -bullet -compact -offset indent
36.It
37Sun GigaSwift Ethernet Adapter (10/100/1000baseT)
38.It
39Sun GigaSwift Ethernet MMF Adapter (1000baseSX)
40.It
41Sun Quad GigaSwift Ethernet UTP Adapter (10/100/1000baseT)
42.It
43Sun Quad GigaSwift PCI-X Adapter (10/100/1000baseT)
44.It
45Sun Dual Gigabit Ethernet and Dual SCSI/P Adapter (10/100/1000baseT)
46.El
47.Pp
48It uses an internal or external PHY or an external 10-bit interface.
49.Pp
50The
51.Nm
52driver supports several media types, which are selected via the
53.Xr ifconfig 8
54command.
55The supported media types are:
56.Bl -tag -width "media" -offset indent
57.It Cm media No autoselect
58Attempt to autoselect the media type (default)
59.It Cm media No 1000baseT Cm mediaopt No full-duplex
60Use 1000baseT on copper, full duplex
61.It Cm media No 1000baseT Cm mediaopt No half-duplex
62Use 1000baseT on copper, half duplex
63.It Cm media No 1000baseSX Cm mediaopt No full-duplex
64Use 1000baseSX on fiber, full duplex
65.It Cm media No 1000baseSX Cm mediaopt No half-duplex
66Use 1000baseSX on fiber, half duplex
67.It Cm media No 100baseTX Cm mediaopt No full-duplex
68Use 100baseTX, full duplex
69.It Cm media No 100baseTX Cm mediaopt No half-duplex
70Use 100baseTX, half duplex
71.It Cm media No 10baseT Cm mediaopt No full-duplex
72Use 10baseT, full duplex
73.It Cm media No 10baseT Cm mediaopt No half-duplex
74Use 10baseT, half duplex
75.El
76.Sh SEE ALSO
77.Xr arp 4 ,
78.Xr brgphy 4 ,
79.Xr gentbi 4 ,
80.Xr ifmedia 4 ,
81.Xr inet 4 ,
82.Xr intro 4 ,
83.Xr netintro 4 ,
84.Xr nsgphy 4 ,
85.Xr hostname.if 5 ,
86.Xr ifconfig 8
87.Sh HISTORY
88.Ox
89support for
90.Nm
91first appeared in
92.Ox 4.1 .
93.Sh AUTHORS
94The
95.Nm
96driver was written by
97.An Mark Kettenis Aq Mt kettenis@openbsd.org
98based on the
99.Xr gem 4
100driver.
101.Sh BUGS
102The
103.Nm
104driver does not yet use many of the advanced features the Cassini chip
105offers.
106