share/man/man4/man4.mac68k/intro.4

   1 .\"     $NetBSD: intro.4,v 1.11 2003/08/07 10:31:07 agc Exp $
   2 .\"
   3 .\" Copyright (c) 1990, 1991 Regents of the University of California.
   4 .\" All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\" 3. Neither the name of the University nor the names of its contributors
  15 .\"    may be used to endorse or promote products derived from this software
  16 .\"    without specific prior written permission.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  21 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  22 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  24 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  28 .\" SUCH DAMAGE.
  29 .\"
  30 .\"     from: @(#)intro.4       5.2 (Berkeley) 3/27/91
  31 .\"
  32 .Dd June 8, 1997
  33 .Dt INTRO 4 mac68k
  34 .Os
  35 .Sh NAME
  36 .Nm intro
  37 .Nd introduction to mac68k special files and hardware support
  38 .Sh DESCRIPTION
  39 This section describes the special files, related driver functions,
  40 and networking support
  41 available in the system.
  42 In this part of the manual, the
  43 .Tn SYNOPSIS
  44 section of
  45 each configurable device gives a sample specification
  46 for use in constructing a system description for the
  47 .Xr config 1
  48 program.
  49 The
  50 .Tn DIAGNOSTICS
  51 section lists messages which may appear on the console
  52 and/or in the system error log
  53 .Pa /var/log/messages
  54 due to errors in device operation;
  55 see
  56 .Xr syslogd 8
  57 for more information.
  58 .Pp
  59 This section contains both devices
  60 which may be configured into the system
  61 and network related information.
  62 The networking support is introduced in
  63 .Xr netintro 4 .
  64 .Sh MAC68K DEVICE SUPPORT
  65 This section describes the hardware supported on the
  66 .Tn Mac .
  67 Software support for these devices comes in two forms.  A hardware
  68 device may be supported with a character or block
  69 .Em device driver ,
  70 or it may be used within the networking subsystem and have a
  71 .Em network interface driver .
  72 Block and character devices are accessed through files in the file
  73 system of a special type; see
  74 .Xr mknod 8 .
  75 Network interfaces are indirectly accessed through the interprocess
  76 communication facilities provided by the system; see
  77 .Xr socket 2 .
  78 .Pp
  79 A hardware device is identified to the system at configuration time
  80 and the appropriate device or network interface driver is then compiled
  81 into the system.  When the resultant system is booted, the
  82 autoconfiguration facilities in the system probe for the device
  83 and, if found, enable the software support for it.
  84 If a device does not respond at autoconfiguration
  85 time it is not accessible at any time afterwards.
  86 To enable a device which did not autoconfigure,
  87 the system will have to be rebooted.
  88 .Pp
  89 The autoconfiguration system is described in
  90 .Xr autoconf 4 .
  91 A list of the supported devices is given below.
  92 .Sh SEE ALSO
  93 .Xr config 1 ,
  94 .Xr autoconf 4
  95 .Sh HISTORY
  96 The
  97 .Tn Mac68k
  98 .Nm intro
  99 man page first appeared in
 100 .Nx 1.3 .
 101 .Sh LIST OF DEVICES
 102 The devices listed below are supported in this incarnation of
 103 the system.
 104 Devices are indicated by their functional interface.
 105 Not all supported devices are listed.
 106 .Bl -tag -width "xxxxxx" -compact -offset indent
 107 .It Em adb
 108 Apple Desktop Bus event interface
 109 .It Em ae
 110 DP8390-based Ethernet interface
 111 .It Em asc
 112 Apple Sound Chip
 113 .It Em esp
 114 .Tn NCR
 115 53C9x built-in SCSI interface
 116 .It Em grf
 117 on-board and NuBus-based video interface
 118 .It Em kmem
 119 kernel virtual memory
 120 .It Em ite
 121 Mac68k Internal Terminal Emulator
 122 .It Em mem
 123 physical memory
 124 .It Em ncrscsi
 125 .Tn NCR
 126 5380 built-in SCSI interface
 127 .It Em sbc
 128 .Tn NCR
 129 5380 built-in SCSI interface
 130 .It Em sn
 131 DP83932-based Ethernet interface (SONIC)
 132 .It Em zsc
 133 .Tn Zilog
 134 Z8530 built-in serial interface
 135 .El