1.\" $OpenBSD: intro.4,v 1.2 2001/09/02 19:36:55 miod 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. 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 . 72Character and block 73devices are accessed through files in the file 74system of a special type; see 75.Xr mknod 8 . 76Network interfaces are indirectly accessed through the interprocess 77communication facilities provided by the system; see 78.Xr socket 2 . 79.Pp 80A hardware device is identified to the system at configuration time 81and the appropriate device or network interface driver is then compiled 82into the system. When the resultant system is booted, the 83autoconfiguration facilities in the system probe for the device 84and, if found, enable the software support 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 must be rebooted. 89.Pp 90A list of the supported devices is given below. 91.Sh SEE ALSO 92.Xr autoconf 4 , 93.Xr config 8 94.Sh SUPPORTED SYSTEMS 95The following MacPPC models are 96.Em supported: 97.Pp 98PowerMac G4 99.br 100PowerMac Dual G4 101.br 102PowerMac G4 Cube 103.br 104iMac Rev A 105.br 106iMac Rev B 107.br 108iMac Rev C 109.br 110iMac DV 111.br 112iMac DV+ 113.br 114PowerBook G3 (FireWire) 115.br 116PowerBook G4 117.br 118iBook (only limited testing) 119.br 120StarMax (development in progress) 121.Pp 122The following are 123.Em not supported: 124.Pp 125Support for older PREP style machines has been removed; lack of availability 126of the hardware and relatively slow speed compared to more recent machines has 127contributed to this decision. 128.Pp 129Apple PowerMac systems with a 601 processor or lack OpenFirmware will likely 130never be supported. 131.Pp 132At the current time, older OpenFirmware machines are not supported. This is 133mostly due to lack of developer resources to work onthe support in addition 134to limited availability of hardware. 135.Sh LIST OF DEVICES 136The devices listed below are supported in this incarnation of 137the system. Devices are indicated by their functional interface. 138Not all supported devices are listed. 139.Pp 140.Bl -tag -width adb/mouse 141.It abtn 142ADB button 143.It aed 144ADB Event Device 145.It akbd 146ADB keyboard 147.It ams 148ADB mouse 149.It an 150Cisco/Aironet 151.It aue 152USB ethernet 153.It awacs 154Apple audio device 155.It bm 156BMAC ethernet 157.It gm 158GMAC ethernet 159.It gpio 160PMU interrupt router 161.It iop 162I2O processor, arrays, SCSI pass-through 163.It kue 164Kawasaki KL5KUSB101B 165.It ohci 166Open Host Controller, Opti RM861HA 167.It ugen 168USB Generic Driver 169.It uhid 170USB Generic HID devices 171.It ukbd 172USB HID Keyboard devices 173.It ulpt 174USB Printer 175.It umass 176USB Mass Storage Device 177.It ums 178USB Mice 179.It uscanner 180USB Scanner 181.It usscanner 182USB SCSI Scanner 183.It vgafb 184PCI VGA graphics 185.It wi 186WaveLAN 187.El 188.Sh UNSUPPORTED DEVICES 189The following are recognized, but not supported: 190.Bl -tag -width macppc 191.It Texas Instruments TSB12LV23 FireWire 192.El 193.Sh HISTORY 194The 195MacPPC 196.Nm 197first appeared with 198.Ox 3.0 . 199