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