share/man/man4/man4.arc/intro.4

   1 .\"     $NetBSD: intro.4,v 1.5 2005/06/20 13:25:24 peter Exp $
   2 .\"
   3 .\" Copyright (c) 2003 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 April 29, 2003
  28 .Dt INTRO 4 arc
  29 .Os
  30 .Sh NAME
  31 .Nm intro
  32 .Nd introduction to special files and hardware support
  33 .Sh DESCRIPTION
  34 This section describes the special files, related driver functions,
  35 and networking support available in the system.
  36 In this part of the manual, the
  37 .Tn SYNOPSIS
  38 section of each configurable device gives a sample specification
  39 for use in constructing a system description for the
  40 .Xr config 1
  41 program.
  42 The
  43 .Tn DIAGNOSTICS
  44 section lists messages which may appear on the console
  45 and/or in the system error log
  46 .Pa /var/log/messages
  47 due to errors in device operation; see
  48 .Xr syslogd 8
  49 for more information.
  50 .Pp
  51 This section contains both devices which may be configured into
  52 the system and network related information.
  53 The networking support is introduced in
  54 .Xr netintro 4 .
  55 .Sh DEVICE SUPPORT
  56 This section describes the hardware supported by
  57 .Nx Ns /arc .
  58 Software support for these devices comes in two forms.
  59 A hardware device may be supported with a character or block
  60 .Em device driver ,
  61 or it may be used within the networking subsystem and have a
  62 .Em network interface driver .
  63 Block and character devices are accessed through files in the file
  64 system of a special type; see
  65 .Xr mknod 8 .
  66 Network interfaces are indirectly accessed through the interprocess
  67 communication facilities provided by the system; see
  68 .Xr socket 2 .
  69 .Pp
  70 A hardware device is identified to the system at configuration time
  71 and the appropriate device or network interface driver is then
  72 compiled into the system.
  73 When the resultant system is booted, the autoconfiguration facilities
  74 in the system probe for the device and, if found, enable the software
  75 support for it.
  76 If a device does not respond at autoconfiguration time it is not
  77 accessible at any time afterwards.
  78 To enable a device which did not autoconfigure, the
  79 system must be rebooted.
  80 .Pp
  81 The autoconfiguration system is described in
  82 .Xr autoconf 4 .
  83 A list of the supported devices is given below.
  84 .Sh SEE ALSO
  85 .Xr config 1 ,
  86 .Xr autoconf 4
  87 .Sh HARDWARE
  88 .Nx Ns /arc
  89 supports a variety of systems conforming to the ARC machine
  90 specification.
  91 The following systems are supported:
  92 .Pp
  93 .Bl -tag -width XXXXXX -offset indent -compact
  94 .It Acer PICA
  95 .It DESKstation rPC44
  96 .It DESKstation Tyne
  97 .It MIPS Magnum 4000
  98 .It NEC Express 5800/230 PCI R4K
  99 .It NEC Express 5800/240 EISA R4K
 100 .It NEC Express RISCserver
 101 .It NEC ImageRISCstation
 102 .It NEC RISCserver 2200
 103 .It NEC RISCstation 2200 EISA
 104 .It NEC RISCstation 2200 PCI
 105 .It NEC RISCstation 2250
 106 .El
 107 .Sh LIST OF DEVICES
 108 The devices listed below are supported in this incarnation of the
 109 system.
 110 Devices are indicated by their functional interface.
 111 Not all supported devices are listed.
 112 .Pp
 113 .Bl -tag -width jazzisabr -offset indent -compact
 114 .It arcsisabr
 115 DESKstation rPC44 ISA host bridge
 116 .It jazzio
 117 Jazz internal bus host bridge
 118 .It jazzisabr
 119 Jazz ISA/EISA bus bridge
 120 .It necpb
 121 NEC RISCstation PCI host bridge
 122 .It tyneisabr
 123 DESKstation Tyne ISA host bridge
 124 .El
 125 .Pp
 126 The following devices on the Jazz internal bus are supported.
 127 .Pp
 128 .Bl -tag -width mcclock -offset indent -compact
 129 .It asc
 130 NCR 53c9x-based SCSI interface
 131 .It com
 132 NS16550-based serial communications interface
 133 .It fdc
 134 Floppy disk controller
 135 .It lpt
 136 Parallel port
 137 .It mcclock
 138 DS1287 real-time clock
 139 .It oosiop
 140 Symbios/NCR 53c700-based SCSI interface
 141 .It osiop
 142 Symbios/NCR 53c710-based SCSI interface
 143 .It pckbc
 144 PC keyboard controller
 145 .It sn
 146 SONIC Ethernet
 147 .It timer
 148 Interval timer
 149 .It vga
 150 VGA graphics
 151 .El
 152 .Pp
 153 PCI devices are supported through the
 154 .Xr pci 4
 155 bus and associated device drivers.
 156 .Pp
 157 ISA devices are supported through the
 158 .Xr isa 4
 159 bus and associated device drivers.
 160 .Pp
 161 .\"EISA devices are supported through the
 162 .\".Xr eisa 4
 163 .\"bus and associated device drivers.
 164 .\".Pp
 165 Console devices using ISA, Jazzio, or PCI video adaptors and standard AT
 166 or PS/2 keyboards are supported by the machine independent
 167 .Xr wscons 4
 168 console driver.
 169 .Sh UNSUPPORTED DEVICES
 170 The following devices are not supported, due to unavailability of
 171 either documentation or sample hardware:
 172 .Pp
 173 .Bl -tag -width XXXXXX -offset indent -compact
 174 .It AD1848 audio on Jazzio
 175 .It EISA devices
 176 .It VXL framebuffer on MIPS Magnum and RISCstation 2200 EISA
 177 .El
 178 .Sh HISTORY
 179 This
 180 .Tn arc
 181 .Nm intro
 182 appeared in
 183 .Nx 2.0 .
 184 .Sh BUGS
 185 DESKstation rPC44 and Tyne support is currently broken.