xref: /netbsd-src/share/man/man4/man4.luna68k/intro.4 (revision d437c8ecadc1a5432b2bf118ec07502213c3f3a8)
1.\"	$NetBSD: intro.4,v 1.2 2022/06/12 20:17:35 wiz Exp $
2.\"	$OpenBSD: intro.4,v 1.10 2022/03/31 17:27:22 naddy Exp $
3.\"
4.\" Copyright (c) 1983, 1986, 1991 Regents of the University of California.
5.\" All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\" 3. Neither the name of the University nor the names of its contributors
16.\"    may be used to endorse or promote products derived from this software
17.\"    without specific prior written permission.
18.\"
19.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
23.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29.\" SUCH DAMAGE.
30.\"
31.\"     from: @(#)intro.4	5.2 (Berkeley) 3/27/91
32.\"
33.Dd June 12, 2022
34.Dt INTRO 4 luna68k
35.Os
36.Sh NAME
37.Nm intro
38.Nd introduction to luna68k special files and hardware support
39.Sh DESCRIPTION
40The manual pages in section 4 describe the special files,
41related driver functions, and networking support
42available in the 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 the hardware supported on the
67luna68k platform.
68Software support for these devices comes in two forms.
69A hardware device 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 autoconfiguration facilities
84in the system probe for the device and, if found, enable the software
85support 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 will have to be rebooted.
90.Pp
91The autoconfiguration system is described in
92.Xr luna68k/autoconf 4 .
93.Sh LIST OF DEVICES
94The devices listed below are supported in this incarnation of
95the system.
96Pseudo-devices are not listed.
97Devices are indicated by their functional interface.
98Not all supported devices are listed.
99.Pp
100.Bl -tag -width "luna68k/lcd(4)" -offset indent -compact
101.\".It Xr clock 4
102.\"battery-backed clock
103.\".It Xr fb 4
104.\"on-board frame buffer
105.It Xr luna68k/lcd 4
106front panel LCD display
107.It Xr le 4
108AMD LANCE Ethernet device
109.\".It Xr sio 4
110.\"on-board serial ports
111.It Xr spc 4
112Fujitsu MB87030/MB89352 SCSI device
113.\".It Xr ws 4
114.\"on-board keyboard and mouse ports
115.It Xr luna68k/xp 4
116HD647180X I/O processor
117.El
118.Sh SEE ALSO
119.Xr config 1 ,
120.Xr luna68k/autoconf 4
121