share/man/man4/man4.macppc/intro.4

   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 .\"
  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
  37 This section describes the special files, related driver functions,
  38 and networking support
  39 available in the system.
  40 In this part of the manual, the
  41 .Tn SYNOPSIS
  42 section of
  43 each configurable device gives a sample specification
  44 for use in constructing a system description for the
  45 .Xr config 1
  46 program.
  47 The
  48 .Tn DIAGNOSTICS
  49 section lists messages which may appear on the console
  50 and/or in the system error log
  51 .Pa /var/log/messages
  52 due to errors in device operation;
  53 see
  54 .Xr syslogd 8
  55 for more information.
  56 .Pp
  57 This section contains both devices
  58 which may be configured into the system
  59 and network related information.
  60 The networking support is introduced in
  61 .Xr netintro 4 .
  62 .Sh MACPPC DEVICE SUPPORT
  63 This section describes the hardware supported on the
  64 .Tn Power Macintosh .
  65 Software support for these devices comes in two forms.  A hardware
  66 device may be supported with a character or block
  67 .Em device driver ,
  68 or it may be used within the networking subsystem and have a
  69 .Em network interface driver .
  70 Block and character devices are accessed through files in the file
  71 system of a special type; see
  72 .Xr mknod 8 .
  73 Network interfaces are indirectly accessed through the interprocess
  74 communication facilities provided by the system; see
  75 .Xr socket 2 .
  76 .Pp
  77 A hardware device is identified to the system at configuration time
  78 and the appropriate device or network interface driver is then compiled
  79 into the system.  When the resultant system is booted, the
  80 autoconfiguration facilities in the system probe for the device
  81 and, if found, enable the software support for it.
  82 If a device does not respond at autoconfiguration
  83 time it is not accessible at any time afterwards.
  84 To enable a device which did not autoconfigure,
  85 the system will have to be rebooted.
  86 .Pp
  87 The autoconfiguration system is described in
  88 .Xr autoconf 4 .
  89 A 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
  99 The
 100 .Tn macppc
 101 .Nm intro
 102 man page first appeared in
 103 .Nx 1.5.1 ,
 104 based on the
 105 .Nx Ns /mac68k
 106 .Xr intro 4 .
 107 .Sh LIST OF DEVICES
 108 The devices listed below are supported in this incarnation of
 109 the system.
 110 Devices are indicated by their functional interface.
 111 Not all supported devices are listed.
 112 .Pp
 113 PCMCIA devices are supported through the
 114 .Xr pcmcia 4
 115 bus and associated devices.
 116 .Pp
 117 Cardbus devices are supported through the
 118 .Xr cardbus 4
 119 bus and associated devices.
 120 .Pp
 121 USB devices are supported through the
 122 .Xr usb 4
 123 bus and associated devices.
 124 .Pp
 125 Additionally, the following specific devices are supported:
 126 .Bl -tag -width "xxxxxxxx" -compact -offset indent
 127 .It Em adb
 128 Apple Desktop Bus event interface.
 129 .It Em awacs
 130 Audio Waveform Amplifier and Converter \(em Apple Sound Chip
 131 (supported systems include 603 and 604 based
 132 machines, and
 133 .Tn Open Firmware 3
 134 based machines).
 135 .It Em bm
 136 BMac Ethernet.
 137 .It Em de
 138 DECchip 21x4x based Ethernet cards (see also
 139 .Xr tlp 4 ) .
 140 .It Em esp
 141 .Tn NCR
 142 53C9x built-in SCSI interface.
 143 .It Em gm
 144 GMac Ethernet.
 145 .It Em kmem
 146 kernel virtual memory.
 147 .It Em mc
 148 MACE Ethernet.
 149 .It Em mem
 150 physical memory.
 151 .It Em mesh
 152 MESH built-in SCSI interface (most Old World machines up to the 1999
 153 series of G3 PowerBooks).
 154 .It Em nvram
 155 NVRAM access.
 156 .It Em ofb
 157 PCI based frame buffer with
 158 .Tn Open Firmware
 159 support.
 160 .It Em openfirm
 161 .Tn Open Firmware
 162 access.
 163 .It Em tlp
 164 DECchip 21x4x based Ethernet cards.
 165 .It Em wdc
 166 Standard on-board IDE controller.
 167 .It Em zsc
 168 .Tn Zilog
 169 Z8530 built-in serial interface.
 170 .El