xref: /openbsd-src/share/man/man4/man4.macppc/intro.4 (revision db3296cf5c1dd9058ceecc3a29fe4aaa0bd26000)
1.\"	$OpenBSD: intro.4,v 1.16 2003/06/06 10:29:42 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 August 3, 2001
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
38.Tn SYNOPSIS
39section of
40each configurable device gives a sample specification
41for use in constructing a system description for the
42.Xr config 8
43program.
44The
45.Tn DIAGNOSTICS
46section lists messages which may appear on the console
47and/or in the system error log
48.Pa /var/log/messages
49due to errors in device operation;
50see
51.Xr syslogd 8
52for more information.
53.Pp
54This section contains both devices
55which may be configured into the system
56and network related information.
57The networking support is introduced in
58.Xr netintro 4 .
59.Sh DEVICE SUPPORT
60This section describes the hardware supported on the MacPPC
61platform.
62Software support for these devices comes in two forms.
63A hardware device may be supported with a character or block
64.Em device driver ,
65or it may be used within the networking subsystem and have a
66.Em network interface driver .
67Block and character devices are accessed through files in the file
68system of a special type; see
69.Xr mknod 8 .
70Network interfaces are indirectly accessed through the interprocess
71communication facilities provided by the system; see
72.Xr socket 2 .
73.Pp
74A hardware device is identified to the system at configuration time
75and the appropriate device or network interface driver is then compiled
76into the system.
77When the resultant system is booted, the autoconfiguration facilities
78in the system probe for the device and, if found, enable the software
79support for it.
80If a device does not respond at autoconfiguration
81time it is not accessible at any time afterwards.
82To enable a device which did not autoconfigure,
83the system will have to be rebooted.
84.Pp
85The configuration system is described in
86.Xr autoconf 4 .
87A list of the supported devices is given below.
88.Sh LIST OF DEVICES
89The devices listed below are supported in this incarnation of
90the system.
91Pseudo-devices are not listed.
92Devices are indicated by their functional interface.
93Not all supported devices are listed.
94.Pp
95.Bl -tag -width usscanner(4) -compact -offset indent
96.It Xr abtn 4
97ADB button.
98.It Xr aed 4
99ADB Event Device.
100.It Xr akbd 4
101ADB keyboard.
102.It Xr ams 4
103ADB mouse.
104.It Xr an 4
105Aironet Communications 4500/4800 IEEE 802.11DS wireless network adapter.
106.It Xr aue 4
107ADMtek AN986-based USB Ethernet adapters.
108.It Xr awacs 4
109Apple audio device.
110.It Xr bktr 4
111Video capture driver.
112.It Xr bm 4
113BMAC ethernet.
114.It Xr de 4
115DEC tulip-based ethernet cards.
116.It Xr eap 4
117Ensoniq AudioPCI based audio.
118.It Xr em 4
119Intel i82542, i82543, and i82544 Pro/1000 Gigabit ethernet.
120.It Xr fxp 4
121Intel EtherExpress PRO/100 Ethernet driver.
122.It Xr gem 4
123GMAC ethernet.
124.It Xr gpio 4
125PMU interrupt router.
126.It Xr hifn 4
127Hifn 7751 crypto accelerator.
128.It Xr hme 4
129National DP83840 ethernet cards.
130.It Xr iop 4
131I2O adapter.
132.It Xr kue 4
133Kawasaki LSI KL5KUSB101B-based USB ethernet.
134.It Xr siop 4
135LSI/Symbios Logic/NCR 53c8xx SCSI adapter boards.
136.It Xr ti 4
137Alteon Networks Tigon I and II Gigabit Ethernet driver.
138.It Xr uaudio 4
139USB audio devices.
140.It Xr ukbd 4
141USB keyboard.
142.It Xr ulpt 4
143USB printers.
144.It Xr umass 4
145USB mass storage.
146.It Xr ums 4
147USB mouse.
148.It Xr uplcom 4
149I/O Data USB-RSAQ2 USB serial adapters.
150.It Xr uscanner 4
151USB scanners.
152.It Xr usscanner 4
153SCSI-over-USB scanners.
154.It Xr vgafb 4
155PCI VGA graphics.
156.It Xr wi 4
157WaveLAN/IEEE and PRISM-II 802.11DS wireless network adapters.
158.It Xr xl 4
1593Com EtherLink XL and Fast EtherLink XL Ethernet driver.
160.It Xr zs 4
161Zilog 8530 serial controller.
162.El
163.Sh SEE ALSO
164.Xr autoconf 4 ,
165.Xr config 8
166.Sh HISTORY
167The
168MacPPC
169.Nm
170first appeared in
171.Ox 3.0 .
172