1.\" $NetBSD: intro.4,v 1.9 2017/02/17 22:24:46 christos 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 February 17, 2017 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 37This section describes the special files, related driver functions, 38and networking support 39available in the system. 40In this part of the manual, the 41.Tn SYNOPSIS 42section of each configurable device gives a sample specification 43for use in constructing a system description for the 44.Xr config 1 45program. 46The 47.Tn DIAGNOSTICS 48section lists messages which may appear on the console 49and/or in the system error log 50.Pa /var/log/messages 51due to errors in device operation; 52see 53.Xr syslogd 8 54for more information. 55.Pp 56This section contains both devices which may be configured into 57the system and network related information. 58The networking support is introduced in 59.Xr netintro 4 . 60.Sh DEVICE SUPPORT 61This section describes the hardware supported on the 62.Tn Dreamcast 63platform. 64Software support for these devices come in two forms. 65A hardware device may be supported with a character or block 66.Em device driver , 67or it may be used within the networking subsystem and have a 68.Em network interface driver . 69Block and character devices are accessed through files in the file 70system of a special type; see 71.Xr mknod 8 . 72Network interfaces are indirectly accessed through the interprocess 73communication facilities provided by the system; see 74.Xr socket 2 . 75.Pp 76A hardware device is identified to the system at configuration time 77and the appropriate device or network interface driver is then 78compiled into the system. 79When the resultant system is booted, the autoconfiguration facilities 80in the system probe for the device and, if found, enable the software 81support for it. 82If a device does not respond at autoconfiguration time, it is not 83accessible at any time afterwards. 84To enable a device which did not autoconfigure, 85the system must be rebooted. 86.Pp 87The autoconfiguration system is described in 88.Xr autoconf 4 . 89A list of the supported devices is given below. 90.Sh LIST OF DEVICES 91The devices listed below are supported in this incarnation of 92the system. 93Devices are indicated by their functional interface. 94Not all supported devices are listed. 95.\" 96.Pp 97Standard builtin devices: 98.Bl -tag -width gapspci -offset indent -compact 99.It g2bus 100.Dq Tn G2 101internal I/O bus 102.It gapspci 103.Tn PCI 104bridge used in expansion port peripherals 105.It gdrom 106Builtin GD-ROM optical disc drive 107.It pvr 108Framebuffer device using the builtin NEC PVR graphics subsystem 109.It aica 110Builtin AICA sound system 111.El 112.\" 113.Pp 114Controller port peripherals are supported though the 115.Xr dreamcast/maple 4 116bus and associated device drivers. 117.\" 118.Pp 119Network interfaces: 120.Bl -tag -width gapspci -offset indent -compact 121.It rtk 122Ethernet driver for the HIT-0400 Broadband Adapter 123.It mbe 124Ethernet 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 132The 133.Nm 134man page appeared in 135.Nx 2.0 . 136.\" LocalWords: NetBSD its INCIDENTAL EXEMPLARY SERVICES INTERRUPTION 137