share/man/man4/man4.x68k/intro.4

   1 .\" Copyright (c) 1990, 1991 The Regents of the University of California.
   2 .\" All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. Neither the name of the University nor the names of its contributors
  13 .\"    may be used to endorse or promote products derived from this software
  14 .\"    without specific prior written permission.
  15 .\"
  16 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  26 .\" SUCH DAMAGE.
  27 .\"
  28 .\" Copyright (c) 1997 The NetBSD Foundation.
  29 .\" All rights reserved.
  30 .\"
  31 .\" Redistribution and use in source and binary forms, with or without
  32 .\" modification, are permitted provided that the following conditions
  33 .\" are met:
  34 .\" 1. Redistributions of source code must retain the above copyright
  35 .\"    notice, this list of conditions and the following disclaimer.
  36 .\" 2. Redistributions in binary form must reproduce the above copyright
  37 .\"    notice, this list of conditions and the following disclaimer in the
  38 .\"    documentation and/or other materials provided with the distribution.
  39 .\"
  40 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  41 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  42 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  43 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  44 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  45 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  46 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  47 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  48 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  49 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  50 .\" POSSIBILITY OF SUCH DAMAGE.
  51 .\"
  52 .\"     from: @(#)intro.4       5.2 (Berkeley) 3/27/91
  53 .\"     $NetBSD: intro.4,v 1.14 2005/06/20 13:25:25 peter Exp $
  54 .\"
  55 .Dd September 11, 1997
  56 .Dt INTRO 4 x68k
  57 .Os
  58 .Sh NAME
  59 .Nm intro
  60 .Nd introduction to x68k special files and hardware support
  61 .Sh DESCRIPTION
  62 This section describes the special files, related driver functions,
  63 and networking support
  64 available in the system.
  65 In this part of the manual, the
  66 .Tn SYNOPSIS
  67 section of
  68 each configurable device gives a sample specification
  69 for use in constructing a system description for the
  70 .Xr config 1
  71 program.
  72 The
  73 .Tn DIAGNOSTICS
  74 section lists messages which may appear on the console
  75 and/or in the system error log
  76 .Pa /var/log/messages
  77 due to errors in device operation;
  78 see
  79 .Xr syslogd 8
  80 for more information.
  81 .Pp
  82 This section contains both devices
  83 which may be configured into the system
  84 and network related information.
  85 The networking support is introduced in
  86 .Xr netintro 4 .
  87 .Sh X68k DEVICE SUPPORT
  88 This section describes the hardware supported on the
  89 .Tn x68k
  90 platform.
  91 Software support for these devices comes in two forms.  A hardware
  92 device may be supported with a character or block
  93 .Em device driver ,
  94 or it may be used within the networking subsystem and have a
  95 .Em network interface driver .
  96 Block and character devices are accessed through files in the file
  97 system of a special type; see
  98 .Xr mknod 8 .
  99 Network interfaces are indirectly accessed through the interprocess
 100 communication facilities provided by the system; see
 101 .Xr socket 2 .
 102 .Pp
 103 A hardware device is identified to the system at configuration time
 104 and the appropriate device or network interface driver is then compiled
 105 into the system.  When the resultant system is booted, the
 106 autoconfiguration facilities in the system probe for the device
 107 and, if found, enable the software support for it.
 108 If a device does not respond at autoconfiguration
 109 time it is not accessible at any time afterwards.
 110 To enable a device which did not autoconfigure,
 111 the system will have to be rebooted.
 112 .Pp
 113 The autoconfiguration system is described in
 114 .Xr autoconf 4 .
 115 A list of the supported devices is given below.
 116 .Sh SEE ALSO
 117 .Xr config 1 ,
 118 .Xr autoconf 4 ,
 119 .Xr intio 4 ,
 120 .Xr mfp 4 ,
 121 .Xr neptune 4 ,
 122 .Xr vs 4
 123 .Sh LIST OF DEVICES
 124 The devices listed below are supported in this incarnation of
 125 the system.
 126 Devices are indicated by their functional interface.
 127 Not all supported devices are listed.
 128 .Bl -tag -width "okiadpcm" -compact -offset indent
 129 .It Em intio
 130 Internal I/O virtual device
 131 .It Em mfp
 132 MC68901 MFP (Multi-Function Peripheral)
 133 .It Em spc
 134 Sharp genuine MB89352 SCSI host adaptor
 135 .It Em mha
 136 MK-HA1 Mankai-Seisakusho Mach-2 SCSI host adaptor
 137 .It Em neptune
 138 Neptune-X Ethernet interface
 139 .It Em fdc
 140 Built-in floppy disk controller device
 141 .It Em fd
 142 Floppy disk device
 143 .It Em grf
 144 Built-in frame buffer
 145 .It Em kmem
 146 kernel virtual memory
 147 .It Em ite
 148 x68k Internal Terminal Emulator
 149 .It Em mem
 150 physical memory
 151 .It Em par
 152 Centronics printer interface
 153 .It Em com
 154 NS16450 serial interface
 155 .It Em zs
 156 Z8530 built-in serial interface
 157 .It Em kbd
 158 x68k Keyboard device
 159 .It Em ms
 160 x68k mouse / trackball
 161 .It Em bell
 162 The keyboard bell emulator
 163 .It Em pow
 164 The power switch
 165 .It Em vs
 166 MSM6258V built-in voice synthesizer
 167 .El
 168 .Sh HISTORY
 169 The
 170 .Tn x68k
 171 .Nm intro
 172 man page first appeared in
 173 .Nx 1.3 .