xref: /netbsd/share/man/man4/man4.macppc/intro.4 (revision 6550d01e)
1.\"	$NetBSD: intro.4,v 1.9 2008/04/30 13:10:56 martin 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.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE.
29.\"
30.Dd April 4, 2001
31.Dt INTRO 4 macppc
32.Os
33.Sh NAME
34.Nm intro
35.Nd introduction to macppc special files and hardware support
36.Sh DESCRIPTION
37This section describes the special files, related driver functions,
38and networking support
39available in the system.
40In this part of the manual, the
41.Tn SYNOPSIS
42section of
43each configurable device gives a sample specification
44for use in constructing a system description for the
45.Xr config 1
46program.
47The
48.Tn DIAGNOSTICS
49section lists messages which may appear on the console
50and/or in the system error log
51.Pa /var/log/messages
52due to errors in device operation;
53see
54.Xr syslogd 8
55for more information.
56.Pp
57This section contains both devices
58which may be configured into the system
59and network related information.
60The networking support is introduced in
61.Xr netintro 4 .
62.Sh MACPPC DEVICE SUPPORT
63This section describes the hardware supported on the
64.Tn Power Macintosh .
65Software support for these devices comes in two forms.  A hardware
66device may be supported with a character or block
67.Em device driver ,
68or it may be used within the networking subsystem and have a
69.Em network interface driver .
70Block and character devices are accessed through files in the file
71system of a special type; see
72.Xr mknod 8 .
73Network interfaces are indirectly accessed through the interprocess
74communication facilities provided by the system; see
75.Xr socket 2 .
76.Pp
77A hardware device is identified to the system at configuration time
78and the appropriate device or network interface driver is then compiled
79into the system.  When the resultant system is booted, the
80autoconfiguration facilities in the system probe for the device
81and, if found, enable the software support for it.
82If a device does not respond at autoconfiguration
83time it is not accessible at any time afterwards.
84To enable a device which did not autoconfigure,
85the system will have to be rebooted.
86.Pp
87The autoconfiguration system is described in
88.Xr autoconf 4 .
89A list of the supported devices is given below.
90.Sh SEE ALSO
91.Xr config 1 ,
92.Xr autoconf 4 ,
93.Xr awacs 4 ,
94.Xr bm 4 ,
95.Xr gem 4 ,
96.Xr mc 4 ,
97.Xr tlp 4
98.Sh HISTORY
99The
100.Tn macppc
101.Nm intro
102man page first appeared in
103.Nx 1.5.1 ,
104based on the
105.Nx Ns /mac68k
106.Xr intro 4 .
107.Sh LIST OF DEVICES
108The devices listed below are supported in this incarnation of
109the system.
110Devices are indicated by their functional interface.
111Not all supported devices are listed.
112.Pp
113PCMCIA devices are supported through the
114.Xr pcmcia 4
115bus and associated devices.
116.Pp
117Cardbus devices are supported through the
118.Xr cardbus 4
119bus and associated devices.
120.Pp
121USB devices are supported through the
122.Xr usb 4
123bus and associated devices.
124.Pp
125Additionally, the following specific devices are supported:
126.Bl -tag -width "xxxxxxxx" -compact -offset indent
127.It Em adb
128Apple Desktop Bus event interface.
129.It Em awacs
130Audio Waveform Amplifier and Converter \(em Apple Sound Chip
131(supported systems include 603 and 604 based
132machines, and
133.Tn Open Firmware 3
134based machines).
135.It Em bm
136BMac Ethernet.
137.It Em de
138DECchip 21x4x based Ethernet cards (see also
139.Xr tlp 4 ) .
140.It Em esp
141.Tn NCR
14253C9x built-in SCSI interface.
143.It Em gm
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 tlp
164DECchip 21x4x based Ethernet cards.
165.It Em wdc
166Standard on-board IDE controller.
167.It Em zsc
168.Tn Zilog
169Z8530 built-in serial interface.
170.El
171