xref: /netbsd-src/share/man/man4/man4.x68k/intro.4 (revision 633f3639db593aa92599e0f49563a30ce60059e2)
1.\" Copyright (c) 1990, 1991 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\" 3. Neither the name of the University nor the names of its contributors
13.\"    may be used to endorse or promote products derived from this software
14.\"    without specific prior written permission.
15.\"
16.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE.
27.\"
28.\" Copyright (c) 1997 The NetBSD Foundation.
29.\" All rights reserved.
30.\"
31.\" Redistribution and use in source and binary forms, with or without
32.\" modification, are permitted provided that the following conditions
33.\" are met:
34.\" 1. Redistributions of source code must retain the above copyright
35.\"    notice, this list of conditions and the following disclaimer.
36.\" 2. Redistributions in binary form must reproduce the above copyright
37.\"    notice, this list of conditions and the following disclaimer in the
38.\"    documentation and/or other materials provided with the distribution.
39.\"
40.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
41.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
42.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
43.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
44.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
45.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
46.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
47.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
48.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
49.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
50.\" POSSIBILITY OF SUCH DAMAGE.
51.\"
52.\"     from: @(#)intro.4	5.2 (Berkeley) 3/27/91
53.\"	$NetBSD: intro.4,v 1.16 2017/02/17 22:24:47 christos Exp $
54.\"
55.Dd February 17, 2017
56.Dt INTRO 4 x68k
57.Os
58.Sh NAME
59.Nm intro
60.Nd introduction to x68k special files and hardware support
61.Sh DESCRIPTION
62This section describes the special files, related driver functions,
63and networking support
64available in the system.
65In this part of the manual, the
66.Tn SYNOPSIS
67section of
68each configurable device gives a sample specification
69for use in constructing a system description for the
70.Xr config 1
71program.
72The
73.Tn DIAGNOSTICS
74section lists messages which may appear on the console
75and/or in the system error log
76.Pa /var/log/messages
77due to errors in device operation;
78see
79.Xr syslogd 8
80for more information.
81.Pp
82This section contains both devices
83which may be configured into the system
84and network related information.
85The networking support is introduced in
86.Xr netintro 4 .
87.Sh X68k DEVICE SUPPORT
88This section describes the hardware supported on the
89.Tn x68k
90platform.
91Software support for these devices comes in two forms.  A hardware
92device may be supported with a character or block
93.Em device driver ,
94or it may be used within the networking subsystem and have a
95.Em network interface driver .
96Block and character devices are accessed through files in the file
97system of a special type; see
98.Xr mknod 8 .
99Network interfaces are indirectly accessed through the interprocess
100communication facilities provided by the system; see
101.Xr socket 2 .
102.Pp
103A hardware device is identified to the system at configuration time
104and the appropriate device or network interface driver is then compiled
105into the system.  When the resultant system is booted, the
106autoconfiguration facilities in the system probe for the device
107and, if found, enable the software support for it.
108If a device does not respond at autoconfiguration
109time it is not accessible at any time afterwards.
110To enable a device which did not autoconfigure,
111the system will have to be rebooted.
112.Pp
113The autoconfiguration system is described in
114.Xr autoconf 4 .
115A list of the supported devices is given below.
116.Sh SEE ALSO
117.Xr config 1 ,
118.Xr autoconf 4 ,
119.Xr x68k/intio 4 ,
120.Xr x68k/mfp 4 ,
121.Xr x68k/neptune 4 ,
122.Xr x68k/vs 4
123.Sh LIST OF DEVICES
124The devices listed below are supported in this incarnation of
125the system.
126Devices are indicated by their functional interface.
127Not all supported devices are listed.
128.Bl -tag -width "okiadpcm" -compact -offset indent
129.It Em intio
130Internal I/O virtual device
131.It Em mfp
132MC68901 MFP (Multi-Function Peripheral)
133.It Em spc
134Sharp genuine MB89352 SCSI host adaptor
135.It Em mha
136MK-HA1 Mankai-Seisakusho Mach-2 SCSI host adaptor
137.It Em neptune
138Neptune-X Ethernet interface
139.It Em fdc
140Built-in floppy disk controller device
141.It Em fd
142Floppy disk device
143.It Em grf
144Built-in frame buffer
145.It Em kmem
146kernel virtual memory
147.It Em ite
148x68k Internal Terminal Emulator
149.It Em mem
150physical memory
151.It Em par
152Centronics printer interface
153.It Em com
154NS16450 serial interface
155.It Em zs
156Z8530 built-in serial interface
157.It Em kbd
158x68k Keyboard device
159.It Em ms
160x68k mouse / trackball
161.It Em bell
162The keyboard bell emulator
163.It Em pow
164The power switch
165.It Em vs
166MSM6258V built-in voice synthesizer
167.El
168.Sh HISTORY
169The
170.Tn x68k
171.Nm intro
172man page first appeared in
173.Nx 1.3 .
174