share/man/man4/man4.acorn32/intro.4

   1 .\" $NetBSD: intro.4,v 1.2 2004/03/13 19:54:32 bjh21 Exp $
   2 .\"
   3 .\" Copyright (c) 1995 Mark Brinicombe
   4 .\" Copyright (c) 1994 Christopher G. Demetriou
   5 .\" All rights reserved.
   6 .\"
   7 .\" Redistribution and use in source and binary forms, with or without
   8 .\" modification, are permitted provided that the following conditions
   9 .\" are met:
  10 .\" 1. Redistributions of source code must retain the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer.
  12 .\" 2. Redistributions in binary form must reproduce the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer in the
  14 .\"    documentation and/or other materials provided with the distribution.
  15 .\" 3. All advertising materials mentioning features or use of this software
  16 .\"    must display the following acknowledgement:
  17 .\"      This product includes software developed by Christopher G. Demetriou.
  18 .\" 4. The name of the author may not be used to endorse or promote products
  19 .\"    derived from this software without specific prior written permission
  20 .\"
  21 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  22 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  23 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  24 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  25 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  26 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  27 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  28 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  29 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  30 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  31 .\"
  32 .Dd March 13, 2004
  33 .Dt INTRO 4 acorn32
  34 .Os
  35 .Sh NAME
  36 .Nm intro
  37 .Nd introduction to acorn32 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 acorn32
  66 (RiscPC) 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 .Sh LIST OF DEVICES
  96 The devices listed below are supported in this incarnation of
  97 the system.  Devices are indicated by their functional interface.
  98 Not all supported devices are listed.
  99 .Pp
 100 .Bl -tag -width speaker -offset indent -compact
 101 .It vidcvideo
 102 VIDC20 device interface
 103 .It com
 104 NS8250-, NS16450-, and NS16550-based asynchronous serial
 105 communications device interface
 106 .It ea
 107 Ether3/Ether5 podule device interface.
 108 .It eb
 109 EtherB network slot device interface.
 110 .It eh
 111 EtherH network slot device interface.
 112 .It ie
 113 Ether1 podule device interface.
 114 .It lpt
 115 Parallel port device interface
 116 .It mem
 117 Main memory interface
 118 .It wd
 119 Standard Internal RiscPC IDE device interface
 120 .It fd
 121 Standard Internal RiscPC floppy device interface
 122 .It asc
 123 Acorn SCSI I card device interface
 124 .It csc
 125 Cumana SCSI II card device interface
 126 .It ptsc
 127 Powertec SCSI II card device interface
 128 .It oak
 129 Oak SCSI I card device interface
 130 .El
 131 .Sh HISTORY
 132 The
 133 .Tn acorn32
 134 .Nm intro
 135 appeared in
 136 .Nx 1.2 .