1.\" $NetBSD: intro.4,v 1.6 2020/05/27 13:49:16 nia Exp $ 2.\" 3.\" Copyright (c) 2003 ARM Ltd 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. The name of the company may not be used to endorse or promote 15.\" products derived from this software without specific prior written 16.\" permission. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY ARM LTD ``AS IS'' AND 19.\" 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 ARM LTD 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 May 27, 2020 31.Dt INTRO 4 evbarm 32.Os 33.Sh NAME 34.Nm intro 35.Nd introduction to evbarm special files and hardware support 36.Sh DESCRIPTION 37The evbarm port is really a collection of ports of 38.Nx 39to a range of development and evaluation boards based on the ARM Architecture. 40.Pp 41This section describes the supported boards, the special files, 42related driver functions, and networking support available in each system. 43In this part of the manual, the 44.Tn SYNOPSIS 45section of 46each configurable device gives a sample specification 47for use in constructing a system description for the 48.Xr config 1 49program. 50The 51.Tn DIAGNOSTICS 52section lists messages which may appear on the console 53and/or in the system error log 54.Pa /var/log/messages 55due to errors in device operation; 56see 57.Xr syslogd 8 58for more information. 59.Pp 60This section contains both devices 61which may be configured into the system 62and network related information. 63The networking support is introduced in 64.Xr netintro 4 . 65.Sh DEVICE SUPPORT 66This section describes some of the hardware supported on the various boards. 67Software support for these devices comes in two forms. 68A hardware 69device may be supported with a character or block 70.Em device driver , 71or it may be used within the networking subsystem and have a 72.Em network interface driver . 73Block and character devices are accessed through files in the file 74system of a special type; see 75.Xr mknod 8 . 76Network interfaces are indirectly accessed through the interprocess 77communication facilities provided by the system; see 78.Xr socket 2 . 79.Pp 80A hardware device is identified to the system at configuration time 81and the appropriate device or network interface driver is then compiled 82into the system. 83When the resultant system is booted, the 84autoconfiguration facilities in the system probe for the device 85and, if found, enable the software support for it. 86If a device does not respond at autoconfiguration 87time it is not accessible at any time afterwards. 88To enable a device which did not autoconfigure, 89the system must be rebooted. 90.Pp 91The autoconfiguration system is described in 92.Xr autoconf 4 . 93.Sh SEE ALSO 94.Xr config 1 , 95.Xr autoconf 4 96.Sh HISTORY 97The 98.Tn evbarm 99.Nm intro 100appeared in 101.Nx 2.0 . 102