1.\" $OpenBSD: intro.4,v 1.4 2001/10/05 14:45:54 mpech Exp $ 2.\" 3.\" Copyright (c) 2001 Peter Valchev. 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 Peter Valchev. 17.\" 4. The name of the author may not be used to endorse or promote products 18.\" derived from this software without specific prior written permission 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 21.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 22.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 23.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 24.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 25.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 26.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 27.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 28.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 29.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 30.\" 31.\" 32.Dd August 3, 2001 33.Dt INTRO 4 MacPPC 34.Os 35.Sh NAME 36.Nm intro 37.Nd introduction to special files and hardware support 38.Sh DESCRIPTION 39The manual pages in section 4 describe the special files, 40related driver functions, and 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 MacPPC 66platform. 67Software support for these devices comes in two forms. 68A hardware device 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. 82When the resultant system is booted, the autoconfiguration facilities 83in the system probe for the device and, if found, enable the software 84support for it. 85If a device does not respond at autoconfiguration 86time it is not accessible at any time afterwards. 87To enable a device which did not autoconfigure, 88the system will have to be rebooted. 89.Pp 90The configuration system is described in 91.Xr autoconf 4 . 92A list of the supported devices is given below. 93.Sh LIST OF DEVICES 94The devices listed below are supported in this incarnation of 95the system. 96Pseudo-devices are not listed. 97Devices are indicated by their functional interface. 98Not all supported devices are listed. 99.Pp 100.Bl -tag -width usscanner -compact -offset indent 101.It abtn 102ADB button. 103.It aed 104ADB Event Device. 105.It akbd 106ADB keyboard. 107.It ams 108ADB mouse. 109.It an 110Cisco/Aironet. 111.It aue 112USB ethernet. 113.It awacs 114Apple audio device. 115.It bm 116BMAC ethernet. 117.It gm 118GMAC ethernet. 119.It gpio 120PMU interrupt router. 121.It iop 122I2O processor, arrays, SCSI pass-through. 123.It kue 124Kawasaki KL5KUSB101B. 125.It ohci 126Open Host Controller, Opti RM861HA. 127.It ugen 128USB Generic Driver. 129.It uhid 130USB Generic HID devices. 131.It ukbd 132USB HID Keyboard devices. 133.It ulpt 134USB Printer. 135.It umass 136USB Mass Storage Device. 137.It ums 138USB Mice. 139.It uscanner 140USB Scanner. 141.It usscanner 142USB SCSI Scanner. 143.It vgafb 144PCI VGA graphics. 145.It wi 146WaveLAN. 147.El 148.Sh SEE ALSO 149.Xr autoconf 4 , 150.Xr config 8 151.Sh HISTORY 152The 153MacPPC 154.Nm 155first appeared in 156.Ox 3.0 . 157