| blob | baabaabb623cc5c4f928f20ece0afd17371bb9ea |
1 .\" $NetBSD: up.4,v 1.15 2009/04/11 21:35:57 joerg Exp $
2 .\"
3 .\" Copyright (c) 1991, 1993, 19801988
4 .\" The Regents of the University of California. 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: @(#)up.4 8.1 (Berkeley) 6/5/93
31 .\"
32 .Dd June 5, 1993
33 .Dt UP 4 vax
34 .Os
35 .Sh NAME
36 .Nm up
37 .Nd UNIBUS storage module controller/disk drives
38 .Sh SYNOPSIS
39 .Cd "sc0 at uba? csr 0176700 vector upintr"
40 .Cd "up0 at sc0 drive 0"
41 .Sh DESCRIPTION
42 NOTE: This driver has not been ported from
43 .Bx 4.4
44 yet.
45 .Pp
46 This is a generic
47 .Tn UNIBUS
48 storage module disk driver.
49 It is specifically designed to work with the
50 Emulex
51 .Tn SC-21
52 and
53 .Tn SC-31
54 controllers.
55 It can be easily
56 adapted to other controllers (although bootstrapping will
57 not necessarily be directly possible.)
58 .Pp
59 The script
60 .Xr MAKEDEV 8
61 should be used to create the
62 .Nm up
63 special files; consult
64 .Xr mknod 8
65 if a special file needs to be made manually.
66 It is recommended as a security precaution to not create special files
67 for devices which may never be installed.
68 .Sh DISK SUPPORT
69 The driver interrogates the controller's holding register
70 to determine the type of drive attached.
71 The driver recognizes seven different drives:
72 .Tn CDC
73 9762,
74 .Tn CDC
75 9766,
76 .Tn AMPEX DM Ns 980 ,
77 .Tn AMPEX
78 9300,
79 .Tn AMPEX
80 Capricorn,
81 .Tn FUJITSU
82 160, and
83 .Tn FUJITSU
84 Eagle
85 (the Eagle is not supported by the SC-21).
86 .Pp
87 Special file names begin with
88 .Sq Li up
89 and
90 .Sq Li rup
91 for the block and character files respectively.
92 The second component of the name, a drive unit number in the range
93 of zero to seven, is represented by a
94 .Sq Li \&?
95 in the disk layouts below.
96 The last component of the name, the file system partition, is
97 designated by a letter from
98 .Sq Li a
99 to
100 .Sq Li h
101 which also corresponds to a minor device number set: zero to seven,
102 eight to 15, 16 to 23 and so forth for drive zero, drive two and drive
103 three respectively (see
104 .Xr physio 4 ) .
105 The location and size (in 512 byte sectors) of the
106 partitions for the above drives:
107 .Pp
108 .Bl -hang
109 .It Tn CDC No 9762 partitions
110 .Bl -column diskx undefined length "xxx-yyyy" -compact
111 .It Sy disk start length cyls
112 .It hp?a 0 15884 0-99
113 .It hp?b 16000 33440 100-309
114 .It hp?c 0 131680 0-822
115 .It hp?d 49600 15884 309-408
116 .It hp?e 65440 55936 409-758
117 .It hp?f 121440 10080 759-822
118 .It hp?g 49600 82080 309-822
119 .El
120 .It Tn CDC No 9766 300M drive partitions
121 .Bl -column diskx undefined length "xxx-yyyy" -compact
122 .It Sy disk start length cyl
123 .It up?a 0 15884 0-26
124 .It up?b 16416 33440 27-81
125 .It up?c 0 500384 0-822
126 .It up?d 341696 15884 562-588
127 .It up?e 358112 55936 589-680
128 .It up?f 414048 861760 681-822
129 .It up?g 341696 158528 562-822
130 .It up?h 49856 291346 82-561
131 .El
132 .It Tn AMPEX DM Ns No 980 partitions
133 .Bl -column diskx undefined length "xxx-yyyy" -compact
134 .It Sy disk start length cyls
135 .It hp?a 0 15884 0-99
136 .It hp?b 16000 33440 100-309
137 .It hp?c 0 131680 0-822
138 .It hp?d 49600 15884 309-408
139 .It hp?e 65440 55936 409-758
140 .It hp?f 121440 10080 759-822
141 .It hp?g 49600 82080 309-822
142 .El
143 .It Tn AMPEX No 9300 300M drive partitions
144 .Bl -column diskx undefined length "xxx-yyyy" -compact
145 .It Sy disk start length cyl
146 .It up?a 0 15884 0-26
147 .It up?b 16416 33440 27-81
148 .It up?c 0 495520 0-814
149 .It up?d 341696 15884 562-588
150 .It up?e 358112 55936 589-680
151 .It up?f 414048 81312 681-814
152 .It up?g 341696 153664 562-814
153 .It up?h 49856 291346 82-561
154 .El
155 .It Tn AMPEX No Capricorn 330M drive partitions
156 .Bl -column diskx undefined length "xxx-yyyy" -compact
157 .It Sy disk start length cyl
158 .It hp?a 0 15884 0-31
159 .It hp?b 16384 33440 32-97
160 .It hp?c 0 524288 0-1023
161 .It hp?d 342016 15884 668-699
162 .It hp?e 358400 55936 700-809
163 .It hp?f 414720 109408 810-1023
164 .It hp?g 342016 182112 668-1023
165 .It hp?h 50176 291346 98-667
166 .El
167 .It Tn FUJITSU No 160M drive partitions
168 .Bl -column diskx undefined length "xxx-yyyy" -compact
169 .It Sy disk start length cyl
170 .It up?a 0 15884 0-49
171 .It up?b 16000 33440 50-154
172 .It up?c 0 263360 0-822
173 .It up?d 49600 15884 155-204
174 .It up?e 65600 55936 205-379
175 .It up?f 121600 141600 380-822
176 .It up?g 49600 213600 155-822
177 .El
178 .It Tn FUJITSU No Eagle partitions
179 .Bl -column diskx undefined length "xxx-yyyy" -compact
180 .It Sy disk start length cyls
181 .It hp?a 0 15884 0-16
182 .It hp?b 16320 66880 17-86
183 .It hp?c 0 808320 0-841
184 .It hp?d 375360 15884 391-407
185 .It hp?e 391680 55936 408-727
186 .It hp?f 698880 109248 728-841
187 .It hp?g 375360 432768 391-841
188 .It hp?h 83520 291346 87-390
189 .El
190 .El
191 .Pp
192 The up?a partition is normally used for the root file system,
193 the up?b partition as a paging area,
194 and the up?c partition for pack-pack copying (it maps the entire disk).
195 On 160M drives the up?g partition maps the rest of the pack.
196 On other drives both up?g and up?h are used to map the
197 remaining cylinders.
198 .Sh FILES
199 .Bl -tag -width Pa -compact
200 .It Pa /dev/up[0-7][a-h]
201 block files
202 .It Pa /dev/rup[0-7][a-h]
203 raw files
204 .El
205 .Sh DIAGNOSTICS
206 .Bl -diag
207 .It "up%d%c: hard error %sing fsbn %d[-%d] cs2=%b er1=%b er2=%b."
208 An unrecoverable error occurred during transfer of the specified
209 filesystem block number(s),
210 which are logical block numbers on the indicated partition.
211 The contents of the cs2, er1 and er2 registers are printed
212 in octal and symbolically with bits decoded.
213 The error was either unrecoverable, or a large number of retry attempts
214 (including offset positioning and drive recalibration) could not
215 recover the error.
216 .Pp
217 .It "up%d: write locked."
218 The write protect switch was set on the drive
219 when a write was attempted.
220 The write operation is not recoverable.
221 .Pp
222 .It "up%d: not ready."
223 The drive was spun down or off line when it was
224 accessed.
225 The I/O operation is not recoverable.
226 .Pp
227 .It "up%d: not ready (flakey)."
228 The drive was not ready, but after
229 printing the message about being not ready (which takes a fraction
230 of a second) was ready.
231 The operation is recovered if no further errors occur.
232 .Pp
233 .It "up%d%c: soft ecc reading fsbn %d[-%d]."
234 A recoverable ECC error occurred on the
235 specified sector of the specified disk partition.
236 This happens normally
237 a few times a week.
238 If it happens more frequently than this the sectors where the errors
239 are occurring should be checked to see if certain cylinders on the
240 pack, spots on the carriage of the drive or heads are indicated.
241 .Pp
242 .It "sc%d: lost interrupt."
243 A timer watching the controller detecting
244 no interrupt for an extended period while an operation was outstanding.
245 This indicates a hardware or software failure.
246 There is currently a hardware/software problem with spinning down
247 drives while they are being accessed which causes this error to
248 occur.
249 The error causes a
250 .Tn UNIBUS
251 reset, and retry of the pending operations.
252 If the controller continues to lose interrupts, this error will recur
253 a few seconds later.
254 .El
255 .Sh SEE ALSO
256 .Xr hk 4 ,
257 .Xr hp 4 ,
258 .Xr uda 4
259 .Sh HISTORY
260 The
261 .Nm up
262 driver appeared in
263 .Bx 4.0 .
264 .Sh BUGS
265 A program to analyze the logged error information (even in its
266 present reduced form) is needed.
267 .Pp
268 The partition tables for the file systems should be read off of each
269 pack, as they are never quite what any single installation would prefer,
270 and this would make packs more portable.