1.\" $NetBSD: intro.4,v 1.6 2017/02/17 22:24:46 christos 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 February 17, 2017 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 34This section describes the special files, related driver functions, 35and networking support available in the system. 36In this part of the manual, the 37.Tn SYNOPSIS 38section of each configurable device gives a sample specification 39for use in constructing a system description for the 40.Xr config 1 41program. 42The 43.Tn DIAGNOSTICS 44section lists messages which may appear on the console 45and/or in the system error log 46.Pa /var/log/messages 47due to errors in device operation; see 48.Xr syslogd 8 49for more information. 50.Pp 51This section contains both devices which may be configured into 52the system and network related information. 53The networking support is introduced in 54.Xr netintro 4 . 55.Sh DEVICE SUPPORT 56This section describes the hardware supported by 57.Nx Ns /cobalt . 58Software support for these devices comes in two forms. 59A hardware device may be supported with a character or block 60.Em device driver , 61or it may be used within the networking subsystem and have a 62.Em network interface driver . 63Block and character devices are accessed through files in the file 64system of a special type; see 65.Xr mknod 8 . 66Network interfaces are indirectly accessed through the interprocess 67communication facilities provided by the system; see 68.Xr socket 2 . 69.Pp 70A hardware device is identified to the system at configuration time 71and the appropriate device or network interface driver is then 72compiled into the system. 73When the resultant system is booted, the autoconfiguration facilities 74in the system probe for the device and, if found, enable the software 75support for it. 76If a device does not respond at autoconfiguration time it is not 77accessible at any time afterwards. 78To enable a device which did not autoconfigure, the system must be 79rebooted. 80.Pp 81The autoconfiguration system is described in 82.Xr autoconf 4 . 83A list of the supported devices is given below. 84.Sh HARDWARE 85The 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 92The devices listed below are supported in this incarnation of the 93system. 94Devices are indicated by their functional interface. 95Not all supported devices are listed. 96.Pp 97.Bl -tag -width com -offset indent -compact 98.It gt 99PCI bridge 100.It com 101serial communications interface 102.El 103.Pp 104PCI devices are supported through the 105.Xr pci 4 106bus 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 cobalt/gt 4 119.Sh HISTORY 120This 121.Tn cobalt 122.Nm intro 123appeared in 124.Nx 2.0 . 125