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