share/man/man4/man4.dreamcast/intro.4

   1 .\"     $NetBSD: intro.4,v 1.7 2005/06/20 13:25:24 peter Exp $
   2 .\"
   3 .\" Copyright (c) 2003 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" This code is derived from software contributed to The NetBSD Foundation
   7 .\" by Marcus Comstedt.
   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 August 24, 2003
  31 .Dt INTRO 4 dreamcast
  32 .Os
  33 .Sh NAME
  34 .Nm intro
  35 .Nd introduction to dreamcast special files and hardware support
  36 .Sh DESCRIPTION
  37 This section describes the special files, related driver functions,
  38 and networking support
  39 available in the system.
  40 In this part of the manual, the
  41 .Tn SYNOPSIS
  42 section of each configurable device gives a sample specification
  43 for use in constructing a system description for the
  44 .Xr config 1
  45 program.
  46 The
  47 .Tn DIAGNOSTICS
  48 section lists messages which may appear on the console
  49 and/or in the system error log
  50 .Pa /var/log/messages
  51 due to errors in device operation;
  52 see
  53 .Xr syslogd 8
  54 for more information.
  55 .Pp
  56 This section contains both devices which may be configured into
  57 the system and network related information.
  58 The networking support is introduced in
  59 .Xr netintro 4 .
  60 .Sh DEVICE SUPPORT
  61 This section describes the hardware supported on the
  62 .Tn Dreamcast
  63 platform.
  64 Software support for these devices come 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
  78 compiled into the system.
  79 When the resultant system is booted, the autoconfiguration facilities
  80 in the system probe for the device and, if found, enable the software
  81 support for it.
  82 If a device does not respond at autoconfiguration time, it is not
  83 accessible at any time afterwards.
  84 To enable a device which did not autoconfigure,
  85 the system must 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 LIST OF DEVICES
  91 The devices listed below are supported in this incarnation of
  92 the system.
  93 Devices are indicated by their functional interface.
  94 Not all supported devices are listed.
  95 .\"
  96 .Pp
  97 Standard builtin devices:
  98 .Bl -tag -width gapspci -offset indent -compact
  99 .It g2bus
 100 .Dq Tn G2
 101 internal I/O bus
 102 .It gapspci
 103 .Tn PCI
 104 bridge used in expansion port peripherals
 105 .It gdrom
 106 Builtin GD-ROM optical disc drive
 107 .It pvr
 108 Framebuffer device using the builtin NEC PVR graphics subsystem
 109 .It aica
 110 Builtin AICA sound system
 111 .El
 112 .\"
 113 .Pp
 114 Controller port peripherals are supported though the
 115 .Xr maple 4
 116 bus and associated device drivers.
 117 .\"
 118 .Pp
 119 Network interfaces:
 120 .Bl -tag -width gapspci -offset indent -compact
 121 .It rtk
 122 Ethernet driver for the HIT-0400 Broadband Adapter
 123 .It mbe
 124 Ethernet driver for the HIT-0300 LAN Adapter
 125 .El
 126 .\"
 127 .Sh SEE ALSO
 128 .Xr config 1 ,
 129 .Xr autoconf 4 ,
 130 .Xr netintro 4
 131 .Sh HISTORY
 132 The
 133 .Nm
 134 man page appeared in
 135 .Nx 2.0 .
 136 .\"  LocalWords:  NetBSD its INCIDENTAL EXEMPLARY SERVICES INTERRUPTION