xref: /netbsd-src/share/man/man4/man4.macppc/intro.4 (revision 1ca5c1b28139779176bd5c13ad7c5f25c0bcd5f8)
1.\"	$NetBSD: intro.4,v 1.5 2002/01/15 01:48:57 wiz Exp $
2.\"
3.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
4.\" All rights reserved.
5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Tsubai Masanari and Thomas Klausner.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions
11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright
13.\"    notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\"    notice, this list of conditions and the following disclaimer in the
16.\"    documentation and/or other materials provided with the distribution.
17.\" 3. All advertising materials mentioning features or use of this software
18.\"    must display the following acknowledgement:
19.\"        This product includes software developed by the NetBSD
20.\"        Foundation, Inc. and its contributors.
21.\" 4. Neither the name of The NetBSD Foundation nor the names of its
22.\"    contributors may be used to endorse or promote products derived
23.\"    from this software without specific prior written permission.
24.\"
25.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
26.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
27.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
29.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35.\" POSSIBILITY OF SUCH DAMAGE.
36.\"
37.Dd April 4, 2001
38.Dt INTRO 4 macppc
39.Os
40.Sh NAME
41.Nm intro
42.Nd introduction to macppc special files and hardware support
43.Sh DESCRIPTION
44This section describes the special files, related driver functions,
45and networking support
46available in the system.
47In this part of the manual, the
48.Tn SYNOPSIS
49section of
50each configurable device gives a sample specification
51for use in constructing a system description for the
52.Xr config 8
53program.
54The
55.Tn DIAGNOSTICS
56section lists messages which may appear on the console
57and/or in the system error log
58.Pa /var/log/messages
59due to errors in device operation;
60see
61.Xr syslogd 8
62for more information.
63.Pp
64This section contains both devices
65which may be configured into the system
66and network related information.
67The networking support is introduced in
68.Xr netintro 4 .
69.Sh MACPPC DEVICE SUPPORT
70This section describes the hardware supported on the
71.Tn Power Macintosh .
72Software support for these devices comes in two forms.  A hardware
73device may be supported with a character or block
74.Em device driver ,
75or it may be used within the networking subsystem and have a
76.Em network interface driver .
77Block and character devices are accessed through files in the file
78system of a special type; see
79.Xr mknod 8 .
80Network interfaces are indirectly accessed through the interprocess
81communication facilities provided by the system; see
82.Xr socket 2 .
83.Pp
84A hardware device is identified to the system at configuration time
85and the appropriate device or network interface driver is then compiled
86into the system.  When the resultant system is booted, the
87autoconfiguration facilities in the system probe for the device
88and, if found, enable the software support for it.
89If a device does not respond at autoconfiguration
90time it is not accessible at any time afterwards.
91To enable a device which did not autoconfigure,
92the system will have to be rebooted.
93.Pp
94The autoconfiguration system is described in
95.Xr autoconf 4 .
96A list of the supported devices is given below.
97.Sh SEE ALSO
98.Xr autoconf 4 ,
99.Xr awacs 4 ,
100.Xr config 8
101.Sh HISTORY
102The
103.Tn macppc
104.Nm intro
105man page first appeared in
106.Nx 1.5.1 ,
107based on the
108.Nx Ns /mac68k
109.Xr intro 4 .
110.Sh LIST OF DEVICES
111The devices listed below are supported in this incarnation of
112the system.
113Devices are indicated by their functional interface.
114Not all supported devices are listed.
115.Pp
116PCMCIA devices are supported through the
117.Xr pcmcia 4
118bus and associated devices.
119.Pp
120Cardbus devices are supported through the
121.Xr cardbus 4
122bus and associated devices.
123.Pp
124USB devices are supported through the
125.Xr usb 4
126bus and associated devices.
127.Pp
128Additionally, the following specific devices are supported:
129.Bl -tag -width "xxxxxxxx" -compact -offset indent
130.It Em adb
131Apple Desktop Bus event interface.
132.It Em awacs
133Audio Waveform Amplifier and Converter \(em Apple Sound Chip
134(supported systems include 603 and 604 based
135machines, and
136.Tn Open Firmware 3
137based machines).
138.It Em bm
139bmac ethernet (at least in the G3 series).
140.It Em esp
141.Tn NCR
14253C9x built-in SCSI interface.
143.It Em gmac
144gmac ethernet.
145.It Em kmem
146kernel virtual memory.
147.It Em mc
148MACE ethernet.
149.It Em mem
150physical memory.
151.It Em mesh
152MESH built-in SCSI interface (most Old World machines up to the 1999
153series of G3 PowerBooks).
154.It Em nvram
155NVRAM access.
156.It Em ofb
157PCI based frame buffer with
158.Tn Open Firmware
159support.
160.It Em openfirm
161.Tn Open Firmware
162access.
163.It Em wdc
164Standard on-board IDE controller.
165.It Em zsc
166.Tn Zilog
167Z8530 built-in serial interface.
168.El
169