xref: /openbsd-src/share/man/man4/man4.macppc/intro.4 (revision 8500990981f885cbe5e6a4958549cacc238b5ae6)
1.\"	$OpenBSD: intro.4,v 1.18 2003/11/08 16:55:02 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.\"
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 November 8, 2003
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 ahc 4
101Adaptec PCI SCSI host adapter driver.
102.It Xr akbd 4
103ADB keyboard.
104.It Xr ams 4
105ADB mouse.
106.It Xr an 4
107Aironet Communications 4500/4800 IEEE 802.11DS wireless network adapter.
108.It Xr aue 4
109ADMtek AN986-based USB Ethernet adapters.
110.It Xr awacs 4
111Apple audio device.
112.It Xr bktr 4
113Video capture driver.
114.It Xr bm 4
115BMAC ethernet.
116.It Xr dc 4 , Xr de 4
117DEC tulip-based ethernet cards.
118.It Xr eap 4
119Ensoniq AudioPCI based audio.
120.It Xr em 4
121Intel i82542, i82543, and i82544 Pro/1000 Gigabit ethernet.
122.It Xr fxp 4
123Intel EtherExpress PRO/100 Ethernet driver.
124.It Xr gem 4
125GMAC ethernet.
126.It Xr gpio 4
127PMU interrupt router.
128.It Xr hifn 4
129Hifn 7751 crypto accelerator.
130.It Xr hme 4
131National DP83840 ethernet cards.
132.It Xr iop 4
133I2O adapter.
134.It Xr kue 4
135Kawasaki LSI KL5KUSB101B-based USB ethernet.
136.It Xr lofn 4
137Hifn 6500 crypto accelerator.
138.It Xr safe 4
139SafeNet SafeXcel 1141/1741.
140.It Xr siop 4
141LSI/Symbios Logic/NCR 53c8xx SCSI adapter boards.
142.It Xr ti 4
143Alteon Networks Tigon I and II Gigabit Ethernet driver.
144.It Xr uaudio 4
145USB audio devices.
146.It Xr ubsec 4
147Broadcom and BlueStell uBsec 5x0x crypto accelerator.
148.It Xr ukbd 4
149USB keyboard.
150.It Xr ulpt 4
151USB printers.
152.It Xr umass 4
153USB mass storage.
154.It Xr ums 4
155USB mouse.
156.It Xr uplcom 4
157I/O Data USB-RSAQ2 USB serial adapters.
158.It Xr uscanner 4
159USB scanners.
160.It Xr usscanner 4
161SCSI-over-USB scanners.
162.It Xr vgafb 4
163PCI VGA graphics.
164.It Xr wi 4
165WaveLAN/IEEE and PRISM-II 802.11DS wireless network adapters.
166.It Xr xl 4
1673Com EtherLink XL and Fast EtherLink XL Ethernet driver.
168.It Xr zs 4
169Zilog 8530 serial controller.
170.El
171.Sh SEE ALSO
172.Xr autoconf 4 ,
173.Xr config 8
174.Sh HISTORY
175The
176MacPPC
177.Nm
178first appeared in
179.Ox 3.0 .
180