share/man/man4/man4.sparc64/intro.4

   1 .\"     $NetBSD: intro.4,v 1.3 2005/06/20 13:25:25 peter Exp $
   2 .\"
   3 .\" Copyright (c) 1996 Jonathan Stone.
   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 .\" 3. All advertising materials mentioning features or use of this software
  15 .\"    must display the following acknowledgement:
  16 .\"      This product includes software developed by Jonathan Stone.
  17 .\" 4. The name of the author may not be used to endorse or promote products
  18 .\"    derived from this software without specific prior written permission
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  21 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  22 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  23 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  24 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  25 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  26 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  27 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  28 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  29 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  30 .\"
  31 .Dd May 10, 2007
  32 .Dt INTRO 4 sparc64
  33 .Os
  34 .Sh NAME
  35 .Nm intro
  36 .Nd introduction to sparc64 special files and hardware support
  37 .Sh DESCRIPTION
  38 This section describes the special files, related driver functions,
  39 and networking support
  40 available in the system.
  41 In this part of the manual, the
  42 .Tn SYNOPSIS
  43 section of
  44 each configurable device gives a sample specification
  45 for use in constructing a system description for the
  46 .Xr config 1
  47 program.
  48 The
  49 .Tn DIAGNOSTICS
  50 section lists messages which may appear on the console
  51 and/or in the system error log
  52 .Pa /var/log/messages
  53 due to errors in device operation;
  54 see
  55 .Xr syslogd 8
  56 for more information.
  57 .Pp
  58 This section contains both devices
  59 which may be configured into the system
  60 and network related information.
  61 The networking support is introduced in
  62 .Xr netintro 4 .
  63 .Sh DEVICE SUPPORT
  64 This section describes the hardware supported on the SPARC64
  65 platform.
  66 Software support for these devices comes in two forms.  A hardware
  67 device may be supported with a character or block
  68 .Em device driver ,
  69 or it may be used within the networking subsystem and have a
  70 .Em network interface driver .
  71 Block and character devices are accessed through files in the file
  72 system of a special type; see
  73 .Xr mknod 8 .
  74 Network interfaces are indirectly accessed through the interprocess
  75 communication facilities provided by the system; see
  76 .Xr socket 2 .
  77 .Pp
  78 A hardware device is identified to the system at configuration time
  79 and the appropriate device or network interface driver is then compiled
  80 into the system.  When the resultant system is booted, the
  81 autoconfiguration facilities in the system probe for the device
  82 and, if found, enable the software support for it.
  83 If a device does not respond at autoconfiguration
  84 time it is not accessible at any time afterwards.
  85 To enable a device which did not autoconfigure,
  86 the system must be rebooted.
  87 .Pp
  88 The autoconfiguration system is described in
  89 .Xr autoconf 4 .
  90 A list of the supported devices is given below.
  91 .Sh SEE ALSO
  92 .Xr config 1 ,
  93 .Xr autoconf 4 ,
  94 .Xr cd 4 ,
  95 .Xr cgsix 4 ,
  96 .Xr ch 4 ,
  97 .Xr kbd 4 ,
  98 .Xr le 4 ,
  99 .Xr magma 4 ,
 100 .Xr mem 4 ,
 101 .Xr ms 4 ,
 102 .Xr openprom 4 ,
 103 .Xr scsi 4 ,
 104 .Xr sd 4 ,
 105 .Xr ss 4 ,
 106 .Xr st 4 ,
 107 .Xr tcx 4 ,
 108 .Xr uk 4
 109 .Sh LIST OF DEVICES
 110 The devices listed below are supported in this incarnation of
 111 the system.  Devices are indicated by their functional interface.
 112 Not all supported devices are listed.
 113 .Pp
 114 .Bl -tag -width leXlebufferXX
 115 .It auxio
 116 Auxiliary I/O \*[Am] LED
 117 .It bpp
 118 Bi-directional Parallel port
 119 .It cgsix
 120 8 bit obio (sun4c \*[Am] sun4m), Sbus color graphics frame buffer
 121 .It com
 122 PC-style serial port
 123 .It eeprom
 124 Sun non-volatile configuration RAM driver
 125 .It esp
 126 ESP200 SCSI controller
 127 .br
 128 FSBE/S (X1053A, part # 501-2015) Fast SCSI-2/Buffered Ethernet Sbus controller
 129 .It fdc
 130 Floppy Disk Controller
 131 .It ffb
 132 Creator \*[Am] Creaor3D graphics frame buffer
 133 .It isp
 134 Qlogic ISP Sbus and PCI SCSI controller
 135 .It kbd
 136 Sun type 2, type 3, type 4, and type 5 keyboards (on zs or com)
 137 .It le/lebuffer
 138 AMD 7990 LANCE Ethernet controller
 139 .It lpt
 140 PC-style parallel port
 141 .It magma
 142 Magma Sp Serial/Parallel board device driver
 143 .It ms
 144 Sun mouse (on zs or com)
 145 .It openprom
 146 Sun Open boot PROM (what became IEEE 1275) configuration driver
 147 .It power
 148 power management
 149 .Xr halt 8
 150 and
 151 .Xr shutdown 8
 152 commands can use it to power down the system.
 153 .It sab
 154 Siemens 82532 \*[Am] 83538 serial controller
 155 .It zs
 156 Zilog 8530 serial controller
 157 .El
 158 .Pp
 159 PCI devices are supported through the
 160 .Xr pci 4
 161 bus and associated devices.
 162 .Pp
 163 PCMCIA devices are supported through the
 164 .Xr pcmcia 4
 165 bus and associated devices.
 166 .Pp
 167 Cardbus devices are supported through the
 168 .Xr cardbus 4
 169 bus and associated devices.
 170 .Pp
 171 USB devices are supported through the
 172 .Xr usb 4
 173 bus and associated devices.
 174 .Sh UNSUPPORTED DEVICES
 175 The following devices are not supported, due to unavailability of
 176 either documentation, sample hardware, or willing volunteer:
 177 .Bl -tag -width cgfourteenXX
 178 .It atifb
 179 ATI 3D Rage Pro VGA graphics adapter (Ultra5, Ultra10)
 180 .It fdc
 181 sun4u floppy drive controllers (EBus based machines only)
 182 .It cgfourteen
 183 24 bit Sbus color frame buffer
 184 .It cgthree
 185 8 bit Sbus color frame buffer
 186 .El
 187 .Sh HISTORY
 188 This
 189 .Tn sparc64
 190 .Nm intro
 191 appeared in
 192 .Nx 1.6 .
 193 Large chunks of text carefully recycled (shamelessly appropriated) from
 194 .Nx Ns Tn /sparc
 195 .Nm .