xref: /netbsd-src/share/man/man4/man4.dreamcast/intro.4 (revision 23c8222edbfb0f0932d88a8351d3a0cf817dfb9e)
1.\"	$NetBSD: intro.4,v 1.6 2003/08/24 18:12:58 wiz 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.\" 3. All advertising materials mentioning features or use of this software
18.\"    must display the following acknowledgement:
19.\"        This product includes software developed by the NetBSD
20.\"        Foundation, Inc. and its contributors.
21.\" 4. Neither the name of The NetBSD Foundation nor the names of its
22.\"    contributors may be used to endorse or promote products derived
23.\"    from this software without specific prior written permission.
24.\"
25.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
26.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
27.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
29.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35.\" POSSIBILITY OF SUCH DAMAGE.
36.\"
37.Dd August 24, 2003
38.Dt INTRO 4 dreamcast
39.Os
40.Sh NAME
41.Nm intro
42.Nd introduction to dreamcast special files and hardware support
43.Sh DESCRIPTION
44This section describes the special files, related driver functions,
45and networking support
46available in the system.
47In this part of the manual, the
48.Tn SYNOPSIS
49section of each configurable device gives a sample specification
50for use in constructing a system description for the
51.Xr config 8
52program.
53The
54.Tn DIAGNOSTICS
55section lists messages which may appear on the console
56and/or in the system error log
57.Pa /var/log/messages
58due to errors in device operation;
59see
60.Xr syslogd 8
61for more information.
62.Pp
63This section contains both devices which may be configured into
64the system and network related information.
65The networking support is introduced in
66.Xr netintro 4 .
67.Sh DEVICE SUPPORT
68This section describes the hardware supported on the
69.Tn Dreamcast
70platform.
71Software support for these devices come in two forms.
72A hardware device may be supported with a character or block
73.Em device driver ,
74or it may be used within the networking subsystem and have a
75.Em network interface driver .
76Block and character devices are accessed through files in the file
77system of a special type; see
78.Xr mknod 8 .
79Network interfaces are indirectly accessed through the interprocess
80communication facilities provided by the system; see
81.Xr socket 2 .
82.Pp
83A hardware device is identified to the system at configuration time
84and the appropriate device or network interface driver is then
85compiled into the system.
86When the resultant system is booted, the autoconfiguration facilities
87in the system probe for the device and, if found, enable the software
88support for it.
89If a device does not respond at autoconfiguration time, it is not
90accessible at any time afterwards.
91To enable a device which did not autoconfigure,
92the system must be rebooted.
93.Pp
94The autoconfiguration system is described in
95.Xr autoconf 4 .
96A list of the supported devices is given below.
97.Sh LIST OF DEVICES
98The devices listed below are supported in this incarnation of
99the system.
100Devices are indicated by their functional interface.
101Not all supported devices are listed.
102.\"
103.Pp
104Standard builtin devices:
105.Bl -tag -width gapspci -offset indent -compact
106.It g2bus
107.Dq Tn G2
108internal I/O bus
109.It gapspci
110.Tn PCI
111bridge used in expansion port peripherals
112.It gdrom
113Builtin GD-ROM optical disc drive
114.It pvr
115Framebuffer device using the builtin NEC PVR graphics subsystem
116.It aica
117Builtin AICA sound system
118.El
119.\"
120.Pp
121Controller port peripherals are supported though the
122.Xr maple 4
123bus and associated device drivers.
124.\"
125.Pp
126Network interfaces:
127.Bl -tag -width gapspci -offset indent -compact
128.It rtk
129Ethernet driver for the HIT-0400 Broadband Adapter
130.It mbe
131Ethernet driver for the HIT-0300 LAN Adapter
132.El
133.\"
134.Sh SEE ALSO
135.Xr autoconf 4 ,
136.Xr netintro 4 ,
137.Xr config 8
138.Sh HISTORY
139The
140.Nm
141man page appeared in
142.Nx 2.0 .
143.\"  LocalWords:  NetBSD its INCIDENTAL EXEMPLARY SERVICES INTERRUPTION
144