share/man/man4/man4.sun2/intro.4

   1 .\"
   2 .\" Copyright (c) 1996 Jonathan Stone.
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\" 3. All advertising materials mentioning features or use of this software
  14 .\"    must display the following acknowledgement:
  15 .\"      This product includes software developed by Jonathan Stone.
  16 .\" 4. The name of the author may not be used to endorse or promote products
  17 .\"    derived from this software without specific prior written permission
  18 .\"
  19 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  20 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  21 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  22 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  23 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  24 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  25 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  26 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  27 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  28 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  29 .\"
  30 .\"     $NetBSD: intro.4,v 1.4 2003/05/06 07:44:56 wiz Exp $
  31 .\"
  32 .Dd August 13, 1997
  33 .Dt INTRO 4 sun2
  34 .Os
  35 .Sh NAME
  36 .Nm intro
  37 .Nd introduction to sun2 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 DEVICE SUPPORT
  65 This section describes the hardware supported on the Sun2
  66 platform.
  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 must 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 .Xr cd 4 ,
  96 .Xr sd 4 ,
  97 .Xr ss 4 ,
  98 .Xr st 4
  99 .Sh SUPPORTED SYSTEMS
 100 The following Sun2 system architectures and models are supported:
 101 .Bl -tag -width eeprom
 102 .It sun2
 103 Sun2 systems: (MC68010)
 104 .br
 105 Sun 2/120, 2/170 (10 MHz)
 106 .br
 107 .El
 108 .Sh LIST OF DEVICES
 109 The devices listed below are supported in this incarnation of
 110 the system.  Devices are indicated by their functional interface.
 111 Not all supported devices are listed.
 112 .Pp
 113 .Bl -tag -width eeprom
 114 .It bwtwo
 115 black and white obio frame buffer
 116 .It ie
 117 Intel 82586 Ethernet controller (Sun 2/120, 2/170)
 118 .It ec
 119 3Com 3c400 Multibus Ethernet controller (Sun 2/120, 2/170)
 120 .It kbd
 121 Sun type 2, type 3, type 4, and type 5 keyboards (on zstty)
 122 .It ms
 123 Sun mouse (on zstty)
 124 .It sc
 125 Sun "SCSI-2" Multibus SCSI controller
 126 .It zs
 127 Zilog 8530 serial controller
 128 .El
 129 .Sh HISTORY
 130 This
 131 .Tn sun2
 132 .Nm intro
 133 appeared in
 134 .Nx 1.6 .
 135 Large chunks of text carefully recycled (shamelessly appropriated)
 136 from
 137 .Nx Ns /sun3
 138 .Xr intro 4 .