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