1.\" $NetBSD: intro.4,v 1.4 2017/02/17 22:19:00 christos 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 February 17, 2017 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 1 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 acorn32/autoconf 4 . 91A list of the supported devices is given below. 92.Sh SEE ALSO 93.Xr config 1 , 94.Xr acorn32/autoconf 4 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 vidcvideo 102VIDC20 device interface 103.It com 104NS8250-, NS16450-, and NS16550-based asynchronous serial 105communications device interface 106.It ea 107Ether3/Ether5 podule device interface. 108.It eb 109EtherB network slot device interface. 110.It eh 111EtherH network slot device interface. 112.It ie 113Ether1 podule device interface. 114.It lpt 115Parallel port device interface 116.It mem 117Main memory interface 118.It wd 119Standard Internal RiscPC IDE device interface 120.It fd 121Standard Internal RiscPC floppy device interface 122.It asc 123Acorn SCSI I card device interface 124.It csc 125Cumana SCSI II card device interface 126.It ptsc 127Powertec SCSI II card device interface 128.It oak 129Oak SCSI I card device interface 130.El 131.Sh HISTORY 132The 133.Tn acorn32 134.Nm intro 135appeared in 136.Nx 1.2 . 137