xref: /openbsd/share/man/man4/man4.luna88k/intro.4 (revision d415bd75)
1.\"	$OpenBSD: intro.4,v 1.10 2022/03/31 17:27:22 naddy Exp $
2.\"
3.\" Copyright (c) 1983, 1986, 1991 Regents of the University of California.
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. Neither the name of the University nor the names of its contributors
15.\"    may be used to endorse or promote products derived from this software
16.\"    without specific prior written permission.
17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28.\" SUCH DAMAGE.
29.\"
30.\"     from: @(#)intro.4	5.2 (Berkeley) 3/27/91
31.\"
32.Dd $Mdocdate: March 31 2022 $
33.Dt INTRO 4 luna88k
34.Os
35.Sh NAME
36.Nm intro
37.Nd introduction to special files and hardware support
38.Sh DESCRIPTION
39The manual pages in section 4 describe the special files,
40related driver functions, and networking support
41available in the system.
42In this part of the manual, the SYNOPSIS section of
43each configurable device gives a sample specification
44for use in constructing a system description for the
45.Xr config 8
46program.
47The DIAGNOSTICS section lists messages which may appear on the console
48and/or in the system error log
49.Pa /var/log/messages
50due to errors in device operation;
51see
52.Xr syslogd 8
53for more information.
54.Pp
55This section contains both devices
56which may be configured into the system
57and network related information.
58The networking support is introduced in
59.Xr netintro 4 .
60.Sh DEVICE SUPPORT
61This section describes the hardware supported on the
62luna88k platform.
63Software support for these devices comes in two forms.
64A hardware device may be supported with a character or block
65.Em device driver ,
66or it may be used within the networking subsystem and have a
67.Em network interface driver .
68Block and character devices are accessed through files in the file
69system of a special type; see
70.Xr mknod 8 .
71Network interfaces are indirectly accessed through the interprocess
72communication facilities provided by the system; see
73.Xr socket 2 .
74.Pp
75A hardware device is identified to the system at configuration time
76and the appropriate device or network interface driver is then compiled
77into the system.
78When the resultant system is booted, the autoconfiguration facilities
79in the system probe for the device and, if found, enable the software
80support for it.
81If a device does not respond at autoconfiguration
82time, it is not accessible at any time afterwards.
83To enable a device which did not autoconfigure,
84the system will have to be rebooted.
85.Pp
86The autoconfiguration system is described in
87.Xr autoconf 4 .
88A list of the supported devices is given below.
89.Sh LIST OF DEVICES
90The devices listed below are supported in this incarnation of
91the system.
92Pseudo-devices are not listed.
93Devices are indicated by their functional interface.
94Not all supported devices are listed.
95.Pp
96.Bl -tag -compact -width "pcctwo(4)" -offset 3n
97.\".It Xr clock 4
98.\"battery-backed clock
99.\".It Xr fb 4
100.\"on-board frame buffer
101.It Xr lcd 4
102front panel LCD display
103.It Xr le 4
104AMD LANCE Ethernet device
105.\".It Xr sio 4
106.\"on-board serial ports
107.It Xr spc 4
108Fujitsu MB87030/MB89352 SCSI device
109.\".It Xr ws 4
110.\"on-board keyboard and mouse ports
111.El
112.Sh SEE ALSO
113.Xr autoconf 4 ,
114.Xr config 8
115.Sh HISTORY
116The luna88k
117.Nm
118appeared in
119.Ox 3.6 .
120