share/man/man4/man4.prep/intro.4

   1 .\" $NetBSD: intro.4,v 1.4 2009/05/27 19:24:00 snj Exp $
   2 .\"
   3 .\" Copyright (c) 2007 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" This code is derived from software contributed to The NetBSD Foundation
   7 .\" by Tim Rightnour
   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 March 1, 2007
  31 .Dt INTRO 4 prep
  32 .Os
  33 .Sh NAME
  34 .Nm intro
  35 .Nd introduction to prep special files and hardware support
  36 .Sh DESCRIPTION
  37 This section describes the special files, related driver functions,
  38 and networking support available in the system.
  39 In this part of the manual, the
  40 .Tn SYNOPSIS
  41 section of each configurable device gives a sample specification
  42 for use in constructing a system description for the
  43 .Xr config 1
  44 program.
  45 The
  46 .Tn DIAGNOSTICS
  47 section lists messages which may appear on the console
  48 and/or in the system error log
  49 .Pa /var/log/messages
  50 due to errors in device operation;
  51 see
  52 .Xr syslogd 8
  53 for more information.
  54 .Pp
  55 This section contains both devices
  56 which may be configured into the system
  57 and network related information.
  58 The networking support is introduced in
  59 .Xr netintro 4 .
  60 .Sh PMPPC DEVICE SUPPORT
  61 This section describes the hardware supported on the
  62 .Tn PowerPC Reference Platform
  63 machines.
  64 Software support for these devices comes in two forms.
  65 A hardware device may be supported with a character or block
  66 .Em device driver ,
  67 or it may be used within the networking subsystem and have a
  68 .Em network interface driver .
  69 Block and character devices are accessed through files in the file
  70 system of a special type; see
  71 .Xr mknod 8 .
  72 Network interfaces are indirectly accessed through the interprocess
  73 communication facilities provided by the system; see
  74 .Xr socket 2 .
  75 .Pp
  76 A hardware device is identified to the system at configuration time
  77 and the appropriate device or network interface driver is then compiled
  78 into the system.
  79 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 nvram 4 ,
  94 .Xr pnpbus 4
  95 .Sh HISTORY
  96 The
  97 .Tn prep
  98 .Nm intro
  99 man page first appeared in
 100 .Nx 4.0 .
 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 .Pp
 107 The pnpbus is a pseudo-bus which is a configuration interface for certain
 108 devices on PReP machines.
 109 These devices are defined in the PReP
 110 residual data with configuration information, similar to
 111 .Xr isapnp 4 .
 112 The underlying bus is generally ISA.
 113 .Pp
 114 ISA devices are supported through the
 115 .Xr isa 4
 116 bus and associated devices.
 117 .Pp
 118 PCI devices are supported through the
 119 .Xr pci 4
 120 bus and associated devices.
 121 .Pp
 122 USB devices are supported through the
 123 .Xr usb 4
 124 bus and associated devices.
 125 .Pp
 126 Additionally, the following specific devices are supported:
 127 .Bl -tag -width "xxxxxxxx" -compact -offset indent
 128 .It Em com
 129 serial ports
 130 .It Em nvram
 131 NVRAM chip
 132 .It Em wdc
 133 ISA IDE controller
 134 .It Em we
 135 Western Digital/SMC WD80x3 ethernet driver
 136 .It Em mcclock
 137 mc146818 compatible time-of-day clock
 138 .It Em mkclock
 139 Mostek MK48T18 time-of-day chip
 140 .El