share/man/man4/man4.cobalt/intro.4

   1 .\"     $NetBSD: intro.4,v 1.4 2005/06/20 13:25:24 peter Exp $
   2 .\"
   3 .\" Copyright (c) 2003 The NetBSD Foundation, Inc.
   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 .\"
  15 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  16 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  17 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  18 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  19 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  20 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  21 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  22 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  23 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  24 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  25 .\" POSSIBILITY OF SUCH DAMAGE.
  26 .\"
  27 .Dd April 29, 2003
  28 .Dt INTRO 4 cobalt
  29 .Os
  30 .Sh NAME
  31 .Nm intro
  32 .Nd introduction to special files and hardware support
  33 .Sh DESCRIPTION
  34 This section describes the special files, related driver functions,
  35 and networking support available in the system.
  36 In this part of the manual, the
  37 .Tn SYNOPSIS
  38 section of each configurable device gives a sample specification
  39 for use in constructing a system description for the
  40 .Xr config 1
  41 program.
  42 The
  43 .Tn DIAGNOSTICS
  44 section lists messages which may appear on the console
  45 and/or in the system error log
  46 .Pa /var/log/messages
  47 due to errors in device operation; see
  48 .Xr syslogd 8
  49 for more information.
  50 .Pp
  51 This section contains both devices which may be configured into
  52 the system and network related information.
  53 The networking support is introduced in
  54 .Xr netintro 4 .
  55 .Sh DEVICE SUPPORT
  56 This section describes the hardware supported by
  57 .Nx Ns /cobalt .
  58 Software support for these devices comes in two forms.
  59 A hardware device may be supported with a character or block
  60 .Em device driver ,
  61 or it may be used within the networking subsystem and have a
  62 .Em network interface driver .
  63 Block and character devices are accessed through files in the file
  64 system of a special type; see
  65 .Xr mknod 8 .
  66 Network interfaces are indirectly accessed through the interprocess
  67 communication facilities provided by the system; see
  68 .Xr socket 2 .
  69 .Pp
  70 A hardware device is identified to the system at configuration time
  71 and the appropriate device or network interface driver is then
  72 compiled into the system.
  73 When the resultant system is booted, the autoconfiguration facilities
  74 in the system probe for the device and, if found, enable the software
  75 support for it.
  76 If a device does not respond at autoconfiguration time it is not
  77 accessible at any time afterwards.
  78 To enable a device which did not autoconfigure, the system must be
  79 rebooted.
  80 .Pp
  81 The autoconfiguration system is described in
  82 .Xr autoconf 4 .
  83 A list of the supported devices is given below.
  84 .Sh HARDWARE
  85 The following systems are supported:
  86 .Pp
  87 .Bl -tag -width XXXXXX -offset indent -compact
  88 .It Qube/Raq 1
  89 .It Qube/Raq 2
  90 .El
  91 .Sh LIST OF DEVICES
  92 The devices listed below are supported in this incarnation of the
  93 system.
  94 Devices are indicated by their functional interface.
  95 Not all supported devices are listed.
  96 .Pp
  97 .Bl -tag -width com -offset indent -compact
  98 .It gt
  99 PCI bridge
 100 .It com
 101 serial communications interface
 102 .El
 103 .Pp
 104 PCI devices are supported through the
 105 .Xr pci 4
 106 bus and associated device drivers.
 107 .\" .Sh UNSUPPORTED DEVICES
 108 .\" The following devices are not supported, due to unavailability of
 109 .\" either documentation or sample hardware:
 110 .\" .Pp
 111 .\" .Bl -tag -width XXXXX -offset indent -compact
 112 .\" .It not yet
 113 .\" .El
 114 .\" .Pp
 115 .Sh SEE ALSO
 116 .Xr config 1 ,
 117 .Xr autoconf 4 ,
 118 .Xr gt 4
 119 .Sh HISTORY
 120 This
 121 .Tn cobalt
 122 .Nm intro
 123 appeared in
 124 .Nx 2.0 .