xref: /netbsd-src/share/man/man4/man4.arc/intro.4 (revision 1ffa7b76c40339c17a0fb2a09fac93f287cfc046)
1.\"     $NetBSD: intro.4,v 1.3 2003/04/29 22:02:44 tsutsui 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.  The following systems are supported:
98.Pp
99.Bl -tag -width XXXXXX -offset indent -compact
100.It Acer PICA
101.It DESKstation rPC44
102.It DESKstation Tyne
103.It MIPS Magnum 4000
104.It NEC Express 5800/230 PCI R4K
105.It NEC Express 5800/240 EISA R4K
106.It NEC Express RISCserver
107.It NEC ImageRISCstation
108.It NEC RISCserver 2200
109.It NEC RISCstation 2200 EISA
110.It NEC RISCstation 2200 PCI
111.It NEC RISCstation 2250
112.El
113.Sh LIST OF DEVICES
114The devices listed below are supported in this incarnation of the
115system.
116Devices are indicated by their functional interface.
117Not all supported devices are listed.
118.Pp
119.Bl -tag -width jazzisabr -offset indent -compact
120.It arcsisabr
121DESKstation rPC44 ISA host bridge
122.It jazzio
123Jazz internal bus host bridge
124.It jazzisabr
125Jazz ISA/EISA bus bridge
126.It necpb
127NEC RISCstation PCI host bridge
128.It tyneisabr
129DESKstation Tyne ISA host bridge
130.El
131.Pp
132The following devices on the Jazz internal bus are supported.
133.Pp
134.Bl -tag -width mcclock -offset indent -compact
135.It asc
136NCR 53c9x-based SCSI interface
137.It com
138NS16550-based serial communications interface
139.It fdc
140Floppy disk controller
141.It lpt
142Parallel port
143.It mcclock
144DS1287 real-time clock
145.It oosiop
146Symbios/NCR 53c700-based SCSI interface
147.It osiop
148Symbios/NCR 53c710-based SCSI interface
149.It pckbc
150PC keyboard controller
151.It sn
152SONIC Ethernet
153.It timer
154Interval timer
155.It vga
156VGA graphics
157.El
158.Pp
159PCI devices are supported through the
160.Xr pci 4
161bus and associated device drivers.
162.Pp
163ISA devices are supported through the
164.Xr isa 4
165bus and associated device drivers.
166.Pp
167.\"EISA devices are supported through the
168.\".Xr eisa 4
169.\"bus and associated device drivers.
170.\".Pp
171Console devices using ISA, Jazzio, or PCI video adaptors and standard AT
172or PS/2 keyboards are supported by the machine independent
173.Xr wscons 4
174console driver.
175.Sh UNSUPPORTED DEVICES
176The following devices are not supported, due to unavailability of
177either documentation or sample hardware:
178.Pp
179.Bl -tag -width XXXXXX -offset indent -compact
180.It AD1848 audio on Jazzio
181.It EISA devices
182.It VXL framebuffer on MIPS Magnum and RISCstation 2200 EISA
183.El
184.Pp
185.Sh HISTORY
186This
187.Tn arc
188.Nm intro
189appeared with
190.Nx 2.0 .
191.Sh BUGS
192DESKstation rPC44 and Tyne support is currently broken.
193