xref: /netbsd-src/share/man/man4/man4.acorn32/intro.4 (revision 001c68bd94f75ce9270b69227c4199fbf34ee396)
1.\" $NetBSD: intro.4,v 1.1 2003/04/17 10:16:13 wiz Exp $
2.\"
3.\" Copyright (c) 1995 Mark Brinicombe
4.\" Copyright (c) 1994 Christopher G. Demetriou
5.\" All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\" 3. All advertising materials mentioning features or use of this software
16.\"    must display the following acknowledgement:
17.\"      This product includes software developed by Christopher G. Demetriou.
18.\" 4. The name of the author may not be used to endorse or promote products
19.\"    derived from this software without specific prior written permission
20.\"
21.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
22.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
23.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
24.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
25.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
26.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
30.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31.\"
32.Dd July 5, 2000
33.Dt INTRO 4 acorn32
34.Os
35.Sh NAME
36.Nm intro
37.Nd introduction to acorn32 special files and hardware support
38.Sh DESCRIPTION
39This section describes the special files, related driver functions,
40and networking support
41available in the system.
42In this part of the manual, the
43.Tn SYNOPSIS
44section of
45each 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;
55see
56.Xr syslogd 8
57for more information.
58.Pp
59This section contains both devices
60which may be configured into the system
61and network related information.
62The networking support is introduced in
63.Xr netintro 4 .
64.Sh DEVICE SUPPORT
65This section describes the hardware supported on the acorn32
66(RiscPC) platform.
67Software support for these devices comes in two forms.  A hardware
68device may be supported with a character or block
69.Em device driver ,
70or it may be used within the networking subsystem and have a
71.Em network interface driver .
72Block and character devices are accessed through files in the file
73system of a special type; see
74.Xr mknod 8 .
75Network interfaces are indirectly accessed through the interprocess
76communication facilities provided by the system; see
77.Xr socket 2 .
78.Pp
79A hardware device is identified to the system at configuration time
80and the appropriate device or network interface driver is then compiled
81into the system.  When the resultant system is booted, the
82autoconfiguration facilities in the system probe for the device
83and, if found, enable the software support for it.
84If a device does not respond at autoconfiguration
85time it is not accessible at any time afterwards.
86To enable a device which did not autoconfigure,
87the system must be rebooted.
88.Pp
89The autoconfiguration system is described in
90.Xr autoconf 4 .
91A list of the supported devices is given below.
92.Sh SEE ALSO
93.Xr autoconf 4 ,
94.Xr config 8
95.Sh LIST OF DEVICES
96The devices listed below are supported in this incarnation of
97the system.  Devices are indicated by their functional interface.
98Not all supported devices are listed.
99.Pp
100.Bl -tag -width speaker -offset indent -compact
101.It beep
102VIDC20 beep device interface
103.It vidcvideo
104VIDC20 device interface
105.It rd
106Ramdisk device interface
107.It com
108NS8250-, NS16450-, and NS16550-based asynchronous serial
109communications device interface
110.It ea
111Ether3/Ether5 podule device interface.
112.It eb
113EtherB network slot device interface.
114.It eh
115EtherH network slot device interface.
116.It ie
117Ether1 podule device interface.
118.It lpt
119Parallel port device interface
120.It mem
121Main memory interface
122.It wd
123Standard Internal RiscPC IDE device interface
124.It fd
125Standard Internal RiscPC floppy device interface
126.It asc
127Acorn SCSI I card device interface
128.It csc
129Cumana SCSI II card device interface
130.It ptsc
131Powertec SCSI II card device interface
132.It oak
133Oak SCSI I card device interface
134.El
135.Sh HISTORY
136The
137.Tn acorn32
138.Nm intro
139appeared in
140.Nx 1.2 .
141