xref: /netbsd-src/share/man/man4/man4.arc/intro.4 (revision 23c8222edbfb0f0932d88a8351d3a0cf817dfb9e)
1.\"     $NetBSD: intro.4,v 1.4 2003/05/06 07:43:14 wiz 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.\" 3. All advertising materials mentioning features or use of this software
15.\"    must display the following acknowledgement:
16.\"        This product includes software developed by the NetBSD
17.\"        Foundation, Inc. and its contributors.
18.\" 4. Neither the name of The NetBSD Foundation nor the names of its
19.\"    contributors may be used to endorse or promote products derived
20.\"    from this software without specific prior written permission.
21.\"
22.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
23.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
24.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
25.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
26.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
27.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
28.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
29.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
30.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
31.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
32.\" POSSIBILITY OF SUCH DAMAGE.
33.\"
34.Dd April 29, 2003
35.Dt INTRO 4 arc
36.Os
37.Sh NAME
38.Nm intro
39.Nd introduction to special files and hardware support
40.Sh DESCRIPTION
41This section describes the special files, related driver functions,
42and networking support available in the system.
43In this part of the manual, the
44.Tn SYNOPSIS
45section of each configurable device gives a sample specification
46for use in constructing a system description for the
47.Xr config 8
48program.
49The
50.Tn DIAGNOSTICS
51section lists messages which may appear on the console
52and/or in the system error log
53.Pa /var/log/messages
54due to errors in device operation; see
55.Xr syslogd 8
56for more information.
57.Pp
58This section contains both devices which may be configured into
59the system and network related information.
60The networking support is introduced in
61.Xr netintro 4 .
62.Sh DEVICE SUPPORT
63This section describes the hardware supported by
64.Nx Ns /arc .
65Software support for these devices comes in two forms.
66A hardware device may be supported with a character or block
67.Em device driver ,
68or it may be used within the networking subsystem and have a
69.Em network interface driver .
70Block and character devices are accessed through files in the file
71system of a special type; see
72.Xr mknod 8 .
73Network interfaces are indirectly accessed through the interprocess
74communication facilities provided by the system; see
75.Xr socket 2 .
76.Pp
77A hardware device is identified to the system at configuration time
78and the appropriate device or network interface driver is then
79compiled into the system.
80When the resultant system is booted, the autoconfiguration facilities
81in the system probe for the device and, if found, enable the software
82support for it.
83If a device does not respond at autoconfiguration time it is not
84accessible at any time afterwards.
85To enable a device which did not autoconfigure, the
86system must be rebooted.
87.Pp
88The autoconfiguration system is described in
89.Xr autoconf 4 .
90A list of the supported devices is given below.
91.Sh SEE ALSO
92.Xr autoconf 4 ,
93.Xr config 8
94.Sh HARDWARE
95.Nx Ns /arc
96supports a variety of systems conforming to the ARC machine
97specification.
98The following systems are supported:
99.Pp
100.Bl -tag -width XXXXXX -offset indent -compact
101.It Acer PICA
102.It DESKstation rPC44
103.It DESKstation Tyne
104.It MIPS Magnum 4000
105.It NEC Express 5800/230 PCI R4K
106.It NEC Express 5800/240 EISA R4K
107.It NEC Express RISCserver
108.It NEC ImageRISCstation
109.It NEC RISCserver 2200
110.It NEC RISCstation 2200 EISA
111.It NEC RISCstation 2200 PCI
112.It NEC RISCstation 2250
113.El
114.Sh LIST OF DEVICES
115The devices listed below are supported in this incarnation of the
116system.
117Devices are indicated by their functional interface.
118Not all supported devices are listed.
119.Pp
120.Bl -tag -width jazzisabr -offset indent -compact
121.It arcsisabr
122DESKstation rPC44 ISA host bridge
123.It jazzio
124Jazz internal bus host bridge
125.It jazzisabr
126Jazz ISA/EISA bus bridge
127.It necpb
128NEC RISCstation PCI host bridge
129.It tyneisabr
130DESKstation Tyne ISA host bridge
131.El
132.Pp
133The following devices on the Jazz internal bus are supported.
134.Pp
135.Bl -tag -width mcclock -offset indent -compact
136.It asc
137NCR 53c9x-based SCSI interface
138.It com
139NS16550-based serial communications interface
140.It fdc
141Floppy disk controller
142.It lpt
143Parallel port
144.It mcclock
145DS1287 real-time clock
146.It oosiop
147Symbios/NCR 53c700-based SCSI interface
148.It osiop
149Symbios/NCR 53c710-based SCSI interface
150.It pckbc
151PC keyboard controller
152.It sn
153SONIC Ethernet
154.It timer
155Interval timer
156.It vga
157VGA graphics
158.El
159.Pp
160PCI devices are supported through the
161.Xr pci 4
162bus and associated device drivers.
163.Pp
164ISA devices are supported through the
165.Xr isa 4
166bus and associated device drivers.
167.Pp
168.\"EISA devices are supported through the
169.\".Xr eisa 4
170.\"bus and associated device drivers.
171.\".Pp
172Console devices using ISA, Jazzio, or PCI video adaptors and standard AT
173or PS/2 keyboards are supported by the machine independent
174.Xr wscons 4
175console driver.
176.Sh UNSUPPORTED DEVICES
177The following devices are not supported, due to unavailability of
178either documentation or sample hardware:
179.Pp
180.Bl -tag -width XXXXXX -offset indent -compact
181.It AD1848 audio on Jazzio
182.It EISA devices
183.It VXL framebuffer on MIPS Magnum and RISCstation 2200 EISA
184.El
185.Sh HISTORY
186This
187.Tn arc
188.Nm intro
189appeared in
190.Nx 2.0 .
191.Sh BUGS
192DESKstation rPC44 and Tyne support is currently broken.
193