xref: /netbsd-src/share/man/man4/man4.macppc/intro.4 (revision 5e4c038a45edbc7d63b7c2daa76e29f88b64a4e3)
1.\"	$NetBSD: intro.4,v 1.6 2002/05/21 00:49:56 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 bm 4 ,
101.Xr de 4 ,
102.Xr gm 4 ,
103.Xr mc 4 ,
104.Xr tlp 4 ,
105.Xr config 8
106.Sh HISTORY
107The
108.Tn macppc
109.Nm intro
110man page first appeared in
111.Nx 1.5.1 ,
112based on the
113.Nx Ns /mac68k
114.Xr intro 4 .
115.Sh LIST OF DEVICES
116The devices listed below are supported in this incarnation of
117the system.
118Devices are indicated by their functional interface.
119Not all supported devices are listed.
120.Pp
121PCMCIA devices are supported through the
122.Xr pcmcia 4
123bus and associated devices.
124.Pp
125Cardbus devices are supported through the
126.Xr cardbus 4
127bus and associated devices.
128.Pp
129USB devices are supported through the
130.Xr usb 4
131bus and associated devices.
132.Pp
133Additionally, the following specific devices are supported:
134.Bl -tag -width "xxxxxxxx" -compact -offset indent
135.It Em adb
136Apple Desktop Bus event interface.
137.It Em awacs
138Audio Waveform Amplifier and Converter \(em Apple Sound Chip
139(supported systems include 603 and 604 based
140machines, and
141.Tn Open Firmware 3
142based machines).
143.It Em bm
144BMac Ethernet.
145.It Em de
146DECchip 21x4x based Ethernet cards (see also
147.Xr tlp 4 ) .
148.It Em esp
149.Tn NCR
15053C9x built-in SCSI interface.
151.It Em gm
152GMac Ethernet.
153.It Em kmem
154kernel virtual memory.
155.It Em mc
156MACE Ethernet.
157.It Em mem
158physical memory.
159.It Em mesh
160MESH built-in SCSI interface (most Old World machines up to the 1999
161series of G3 PowerBooks).
162.It Em nvram
163NVRAM access.
164.It Em ofb
165PCI based frame buffer with
166.Tn Open Firmware
167support.
168.It Em openfirm
169.Tn Open Firmware
170access.
171.It Em tlp
172DECchip 21x4x based Ethernet cards.
173.It Em wdc
174Standard on-board IDE controller.
175.It Em zsc
176.Tn Zilog
177Z8530 built-in serial interface.
178.El
179