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