No empty .Rs/.Re
[netbsd-mini2440.git] / share / man / man4 / man4.sgimips / intro.4
blob4d53cc6e64cc7eaed6ba008f343578902e221121
1 .\"     $NetBSD: intro.4,v 1.18 2006/12/24 00:47:24 rumble Exp $
2 .\"
3 .\" Copyright (c) 2003 The NetBSD Foundation, Inc.
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 .\"
15 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
16 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
17 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
19 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25 .\" POSSIBILITY OF SUCH DAMAGE.
26 .\"
27 .Dd December 22, 2006
28 .Dt INTRO 4 sgimips
29 .Os
30 .Sh NAME
31 .Nm intro
32 .Nd introduction to sgimips special files and hardware support
33 .Sh DESCRIPTION
34 This section describes the special files, related driver functions,
35 and networking support available in the system.
36 In this part of the manual, the
37 .Tn SYNOPSIS
38 section of each configurable device gives a sample specification
39 for use in constructing a system description for the
40 .Xr config 1
41 program.
42 The
43 .Tn DIAGNOSTICS
44 section lists messages which may appear on the console
45 and/or in the system error log
46 .Pa /var/log/messages
47 due to errors in device operation; see
48 .Xr syslogd 8
49 for more information.
50 .Pp
51 This section contains both devices which may be configured into
52 the system and network related information.
53 The networking support is introduced in
54 .Xr netintro 4 .
55 .Sh DEVICE SUPPORT
56 This section describes the hardware supported by
57 .Nx Ns /sgimips .
58 Software support for these devices comes in two forms.
59 A hardware device may be supported with a character or block
60 .Em device driver ,
61 or it may be used within the networking subsystem and have a
62 .Em network interface driver .
63 Block and character devices are accessed through files in the file
64 system of a special type; see
65 .Xr mknod 8 .
66 Network interfaces are indirectly accessed through the interprocess
67 communication facilities provided by the system; see
68 .Xr socket 2 .
69 .Pp
70 A hardware device is identified to the system at configuration time
71 and the appropriate device or network interface driver is then
72 compiled into the system.
73 When the resultant system is booted, the autoconfiguration facilities
74 in the system probe for the device and, if found, enable the software
75 support for it.
76 If a device does not respond at autoconfiguration time it is not
77 accessible at any time afterwards.
78 To enable a device which did not autoconfigure, the system must be rebooted.
79 .Pp
80 The autoconfiguration system is described in
81 .Xr autoconf 4 .
82 A list of the supported devices is given below.
83 .Sh HARDWARE
84 The following systems are supported:
85 .Pp
86 .Bl -tag -width XXXXXXXXXXXXXXXXXXXXX -offset indent -compact
87 .It O2
88 IP32
89 .Pq Dq Moosehead
90 .It Indy/Challenge S
91 IP24
92 .Pq Dq Guinness
93 .It Indigo 2/Challenge M
94 IP22
95 .Pq Dq Fullhouse
96 .It Indigo R4k
97 IP20
98 .Pq Dq Blackjack
99 .It Indigo R3k
100 IP12
101 .Pq Dq Hollywood
102 .It Personal Iris 4D/3x
103 IP12
104 .Pq Dq Magnum
106 .Sh LIST OF DEVICES
107 The devices listed below are supported in this incarnation of the
108 system.
109 Devices are indicated by their functional interface.
110 Not all supported devices are listed.
112 .Bl -tag -width macepci -offset indent -compact
113 .It crime
114 found on the O2
115 .It dpclock
116 real-time clock
117 .It dsclock
118 real-time clock
119 .It gio
120 PCI-like bus
121 .It hpc
122 High performance Peripheral Controller
123 .It imc
124 Indigo R4k/Indy/Challenge S/Indigo2 bus arbiter
125 .It mace
126 found on the O2
127 .\" .It macepci
128 .It mec
129 O2 MAC110 ethernet
130 .It newport
131 entry framebuffer on Indy and Indigo2
132 .It pic
133 Personal Iris 4D/3x and Indigo R3k bus arbiter
134 .It sq
135 SEEQ 8003/80C03 ethernet
136 .It tl
137 Set Engineering GIO 100baseTX Fast Ethernet
138 .It tlp
139 Phobos G130/G160 10/100 GIO Fast Ethernet
140 .It wdsc
141 WD33C93 SCSI interface
144 PCI devices are supported through the
145 .Xr pci 4
146 bus and associated device drivers.
148 .\" .Sh UNSUPPORTED DEVICES
149 .\" The following devices are not supported, due to unavailability of
150 .\" either documentation or sample hardware:
151 .\" .Pp
152 .\" .Bl -tag -width XXXXX -offset indent -compact
153 .\" .It not yet
154 .\" .El
155 .\" .Pp
156 .Sh SEE ALSO
157 .Xr config 1 ,
158 .Xr autoconf 4 ,
159 .Xr crime 4 ,
160 .Xr dpclock 4 ,
161 .Xr dsclock 4 ,
162 .Xr gio 4 ,
163 .Xr hpc 4 ,
164 .Xr imc 4 ,
165 .Xr mace 4 ,
166 .Xr mec 4 ,
167 .Xr newport 4 ,
168 .Xr pic 4 ,
169 .Xr sq 4 ,
170 .Xr tlp 4 ,
171 .Xr wdsc 4
172 .Sh HISTORY
173 This
174 .Tn sgimips
176 appeared in
177 .Nx 2.0 .