1.\" $OpenBSD: intro.4,v 1.51 2013/06/29 16:57:33 jmc 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.\" 15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 16.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 17.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 18.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 19.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 20.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 21.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 22.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 23.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 24.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 25.\" 26.\" 27.Dd $Mdocdate: June 29 2013 $ 28.Dt INTRO 4 macppc 29.Os 30.Sh NAME 31.Nm intro 32.Nd introduction to special files and hardware support 33.Sh DESCRIPTION 34The manual pages in section 4 describe the special files, 35related driver functions, and networking support 36available in the system. 37In this part of the manual, the SYNOPSIS section of 38each configurable device gives a sample specification 39for use in constructing a system description for the 40.Xr config 8 41program. 42The DIAGNOSTICS section lists messages which may appear on the console 43and/or in the system error log 44.Pa /var/log/messages 45due to errors in device operation; 46see 47.Xr syslogd 8 48for more information. 49.Pp 50This section contains both devices 51which may be configured into the system 52and network related information. 53The networking support is introduced in 54.Xr netintro 4 . 55.Sh DEVICE SUPPORT 56This section describes the hardware supported on the MacPPC 57platform. 58Software support for these devices comes in two forms. 59A hardware device may be supported with a character or block 60.Em device driver , 61or it may be used within the networking subsystem and have a 62.Em network interface driver . 63Block and character devices are accessed through files in the file 64system of a special type; see 65.Xr mknod 8 . 66Network interfaces are indirectly accessed through the interprocess 67communication facilities provided by the system; see 68.Xr socket 2 . 69.Pp 70A hardware device is identified to the system at configuration time 71and the appropriate device or network interface driver is then compiled 72into the system. 73When the resultant system is booted, the autoconfiguration facilities 74in the system probe for the device and, if found, enable the software 75support for it. 76If a device does not respond at autoconfiguration 77time it is not accessible at any time afterwards. 78To enable a device which did not autoconfigure, 79the system will have to be rebooted. 80.Pp 81The configuration system is described in 82.Xr autoconf 4 . 83.Sh LIST OF DEVICES 84A complete list of available devices is contained within the pages 85describing the system buses and controllers. 86For example, a PCI device would be listed in the 87.Xr pci 4 88man page. 89The following buses and controllers list these devices: 90.Pp 91.Bl -tag -width "cardbus(4)XX" -offset 3n -compact 92.It Xr adb 4 93introduction to Apple Desktop Bus support 94.It Xr cardbus 4 95introduction to CardBus support 96.It Xr iic 4 97Inter IC (I2C) bus 98.It Xr macobio 4 99introduction to Apple PowerPC onboard I/O bus support 100.It Xr onewire 4 1011-Wire bus 102.It Xr pci 4 103introduction to PCI bus support 104.It Xr pcmcia 4 105introduction to PCMCIA (PC Card) support 106.It Xr usb 4 107introduction to Universal Serial Bus support 108.El 109.Sh SEE ALSO 110.Xr autoconf 4 , 111.Xr config 8 112.Sh HISTORY 113The 114MacPPC 115.Nm 116first appeared in 117.Ox 3.0 . 118