1.\" $OpenBSD: intro.4,v 1.5 2007/10/09 15:01:40 jmc Exp $ 2.\" 3.\" Copyright (c) 1994 Christopher G. Demetriou 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 Christopher G. Demetriou. 17.\" 3. The name of the author may not be used to endorse or promote products 18.\" derived from this software without specific prior written permission 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 21.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 22.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 23.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 24.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 25.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 26.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 27.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 28.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 29.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 30.\" 31.Dd $Mdocdate: October 9 2007 $ 32.Dt INTRO 4 landisk 33.Os 34.Sh NAME 35.Nm intro 36.Nd introduction to special files and hardware support 37.Sh DESCRIPTION 38The manual pages in section 4 describe the special files, 39related driver functions, and networking support 40available in the system. 41In this part of the manual, the 42.Sx SYNOPSIS 43section of 44each configurable device gives a sample specification 45for use in constructing a system description for the 46.Xr config 8 47program. 48The 49.Sx DIAGNOSTICS 50section lists messages which may appear on the console 51and/or in the system error log 52.Pa /var/log/messages 53due to errors in device operation; 54see 55.Xr syslogd 8 56for more information. 57.Pp 58This section contains both devices 59which may be configured into the system 60and network related information. 61The networking support is introduced in 62.Xr netintro 4 . 63.Sh DEVICE SUPPORT 64This section describes the hardware supported on the landisk platform. 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 compiled 79into 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 84time it is not accessible at any time afterwards. 85To enable a device which did not autoconfigure, 86the system will have to be rebooted. 87.Pp 88The autoconfiguration system is described in 89.Xr autoconf 4 . 90A list of the supported devices is given below. 91.Sh LIST OF DEVICES 92The devices listed below are supported in this incarnation of 93the system. 94Pseudo-devices are not listed. 95.\" Devices are indicated by their functional interface. 96Not all supported devices are listed. 97.Pp 98.Bl -tag -width lotsofletters -compact -offset indent 99.It Xr cd 4 100ATAPI and SCSI CD-ROM driver 101.It Xr obio 4 102landisk onboard I/O bus device 103.It Xr pciide 4 104PCI IDE controller driver 105.It Xr power 4 106power switch 107.\" cpu 108.\" rsclock 109.It Xr sd 4 110SCSI disk driver 111.\" shb 112.\" scif 113.It Xr shpcic 4 114landisk SuperH PCI-Host Bridge 115.It Xr wd 4 116WD100x compatible hard disk driver 117.It Xr wdc 4 118WD100x compatible hard disk controller driver 119.El 120.Pp 121A further list of available devices is contained within the pages 122describing the system buses and controllers. 123For example, a PCI device would be listed in the 124.Xr pci 4 125man page. 126The following buses and controllers list these devices: 127.Pp 128.Bl -tag -width "cardbus(4)XX" -offset 3n -compact 129.It Xr onewire 4 1301-Wire bus 131.It Xr pci 4 132introduction to PCI bus support 133.It Xr usb 4 134introduction to Universal Serial Bus support 135.El 136.Sh SEE ALSO 137.Xr autoconf 4 , 138.Xr config 8 139.Sh HISTORY 140The 141landisk 142.Nm intro 143first appeared in 144.Ox 4.1 . 145