Annotation of 43BSDReno/share/man/man4/man4.vax/up.4, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1980,1988 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)up.4        6.3 (Berkeley) 6/13/88
                      6: .\"
                      7: .TH UP 4 "June 13, 1988"
                      8: .UC 4
                      9: .SH NAME
                     10: up \- unibus storage module controller/drives
                     11: .SH SYNOPSIS
                     12: .B "controller sc0 at uba? csr 0176700 vector upintr
                     13: .br
                     14: .B "disk up0 at sc0 drive 0"
                     15: .SH DESCRIPTION
                     16: This is a generic UNIBUS storage module disk driver.
                     17: It is specifically designed to work with the
                     18: Emulex SC-21 and SC-31 controllers.
                     19: It can be easily
                     20: adapted to other controllers (although bootstrapping will
                     21: not necessarily be directly possible.)
                     22: .PP
                     23: Files with minor device numbers 0 through 7 refer to various portions
                     24: of drive 0;
                     25: minor devices 8 through 15 refer to drive 1, etc.
                     26: The standard device names begin with ``up'' followed by
                     27: the drive number and then a letter a-h for partitions 0-7 respectively.
                     28: The character ? stands here for a drive number in the range 0-7.
                     29: .PP
                     30: The block files access the disk via the system's normal
                     31: buffering mechanism and may be read and written without regard to
                     32: physical disk records.  There is also a `raw' interface
                     33: which provides for direct transmission between the disk
                     34: and the user's read or write buffer.
                     35: A single read or write call results in exactly one I/O operation
                     36: and therefore raw I/O is considerably more efficient when
                     37: many words are transmitted.  The names of the raw files
                     38: conventionally begin with an extra `r.'
                     39: .PP
                     40: In raw I/O counts should be a multiple of 512 bytes (a disk sector).
                     41: Likewise
                     42: .I seek
                     43: calls should specify a multiple of 512 bytes.
                     44: .SH "DISK SUPPORT"
                     45: The driver interrogates the controller's holding register
                     46: to determine the type of drive attached.  The driver recognizes
                     47: seven different drives:
                     48: CDC 9762, CDC 9766,
                     49: AMPEX DM980, AMPEX 9300, AMPEX Capricorn,
                     50: FUJITSU 160, and FUJITSU Eagle
                     51: (the Eagle is not supported by the SC-21).
                     52: The origin and size of the pseudo-disks on each drive are
                     53: as follows:
                     54: .PP
                     55: .nf
                     56: .ta .5i +\w'000000    'u +\w'000000    'u +\w'000000    'u
                     57: CDC 9762 partitions
                     58:        disk    start   length  cyls
                     59:        hp?a    0       15884   0-99
                     60:        hp?b    16000   33440   100-309
                     61:        hp?c    0       131680  0-822
                     62:        hp?d    49600   15884   309-408
                     63:        hp?e    65440   55936   409-758
                     64:        hp?f    121440  10080   759-822
                     65:        hp?g    49600   82080   309-822
                     66: .PP
                     67: CDC 9766 300M drive partitions:
                     68:        disk    start   length  cyl
                     69:        up?a    0       15884   0-26
                     70:        up?b    16416   33440   27-81
                     71:        up?c    0       500384  0-822
                     72:        up?d    341696  15884   562-588
                     73:        up?e    358112  55936   589-680
                     74:        up?f    414048  861760  681-822
                     75:        up?g    341696  158528  562-822
                     76:        up?h    49856   291346  82-561
                     77: .PP
                     78: AMPEX DM980 partitions
                     79:        disk    start   length  cyls
                     80:        hp?a    0       15884   0-99
                     81:        hp?b    16000   33440   100-309
                     82:        hp?c    0       131680  0-822
                     83:        hp?d    49600   15884   309-408
                     84:        hp?e    65440   55936   409-758
                     85:        hp?f    121440  10080   759-822
                     86:        hp?g    49600   82080   309-822
                     87: .PP
                     88: AMPEX 9300 300M drive partitions:
                     89:        disk    start   length  cyl
                     90:        up?a    0       15884   0-26
                     91:        up?b    16416   33440   27-81
                     92:        up?c    0       495520  0-814
                     93:        up?d    341696  15884   562-588
                     94:        up?e    358112  55936   589-680
                     95:        up?f    414048  81312   681-814
                     96:        up?g    341696  153664  562-814
                     97:        up?h    49856   291346  82-561
                     98: .PP
                     99: AMPEX Capricorn 330M drive partitions:
                    100:        disk    start   length  cyl
                    101:        hp?a    0       15884   0-31
                    102:        hp?b    16384   33440   32-97
                    103:        hp?c    0       524288  0-1023
                    104:        hp?d    342016  15884   668-699
                    105:        hp?e    358400  55936   700-809
                    106:        hp?f    414720  109408  810-1023
                    107:        hp?g    342016  182112  668-1023
                    108:        hp?h    50176   291346  98-667
                    109: .PP
                    110: FUJITSU 160M drive partitions:
                    111:        disk    start   length  cyl
                    112:        up?a    0       15884   0-49
                    113:        up?b    16000   33440   50-154
                    114:        up?c    0       263360  0-822
                    115:        up?d    49600   15884   155-204
                    116:        up?e    65600   55936   205-379
                    117:        up?f    121600  141600  380-822
                    118:        up?g    49600   213600  155-822
                    119: .PP
                    120: FUJITSU Eagle partitions
                    121:        disk    start   length  cyls
                    122:        hp?a    0       15884   0-16
                    123:        hp?b    16320   66880   17-86
                    124:        hp?c    0       808320  0-841
                    125:        hp?d    375360  15884   391-407
                    126:        hp?e    391680  55936   408-727
                    127:        hp?f    698880  109248  728-841
                    128:        hp?g    375360  432768  391-841
                    129:        hp?h    83520   291346  87-390
                    130: .DT
                    131: .fi
                    132: .PP
                    133: It is unwise for all of these files to be present in one installation,
                    134: since there is overlap in addresses and protection becomes
                    135: a sticky matter.
                    136: The up?a partition is normally used for the root file system,
                    137: the up?b partition as a paging area,
                    138: and the up?c partition for pack-pack copying (it maps the entire disk).
                    139: On 160M drives the up?g partition maps the rest of the pack.
                    140: On other drives both up?g and up?h are used to map the
                    141: remaining cylinders.
                    142: .SH FILES
                    143: /dev/up[0-7][a-h]      block files
                    144: .br
                    145: /dev/rup[0-7][a-h]     raw files
                    146: .SH SEE ALSO
                    147: hk(4), hp(4), uda(4)
                    148: .SH DIAGNOSTICS
                    149: \fBup%d%c: hard error %sing fsbn %d[-%d] cs2=%b er1=%b er2=%b\fR.
                    150: An unrecoverable error occurred during transfer of the specified
                    151: filesystem block number(s),
                    152: which are logical block numbers on the indicated partition.
                    153: The contents of the cs2, er1 and er2 registers are printed
                    154: in octal and symbolically with bits decoded.
                    155: The error was either unrecoverable, or a large number of retry attempts
                    156: (including offset positioning and drive recalibration) could not
                    157: recover the error.
                    158: .PP
                    159: \fBup%d: write locked\fR.  The write protect switch was set on the drive
                    160: when a write was attempted.  The write operation is not recoverable.
                    161: .PP
                    162: \fBup%d: not ready\fR.  The drive was spun down or off line when it was
                    163: accessed.  The i/o operation is not recoverable.
                    164: .PP
                    165: \fBup%d: not ready (flakey)\fR.  The drive was not ready, but after
                    166: printing the message about being not ready (which takes a fraction
                    167: of a second) was ready.  The operation is recovered if no further
                    168: errors occur.
                    169: .PP
                    170: \fBup%d%c: soft ecc reading fsbn %d[-%d]\fP.
                    171: A recoverable ECC error occurred on the
                    172: specified sector of the specified disk partition.
                    173: This happens normally
                    174: a few times a week.  If it happens more frequently than
                    175: this the sectors where the errors are occurring should be checked to see
                    176: if certain cylinders on the pack, spots on the carriage of the drive
                    177: or heads are indicated.
                    178: .PP
                    179: \fBsc%d: lost interrupt\fR.  A timer watching the controller detecting
                    180: no interrupt for an extended period while an operation was outstanding.
                    181: This indicates a hardware or software failure.  There is currently a
                    182: hardware/software problem with spinning down drives while they are
                    183: being accessed which causes this error to occur.
                    184: The error causes a UNIBUS reset, and retry of the pending operations.
                    185: If the controller continues to lose interrupts, this error will recur
                    186: a few seconds later.
                    187: .SH BUGS
                    188: In raw I/O
                    189: .I read
                    190: and
                    191: .IR write (2)
                    192: truncate file offsets to 512-byte block boundaries,
                    193: and
                    194: .I write
                    195: scribbles on the tail of incomplete blocks.
                    196: Thus,
                    197: in programs that are likely to access raw devices,
                    198: .I read, write
                    199: and
                    200: .IR lseek (2)
                    201: should always deal in 512-byte multiples.
                    202: .PP
                    203: A program to analyze the logged error information (even in its
                    204: present reduced form) is needed.
                    205: .PP
                    206: The partition tables for the file systems should be read off of each
                    207: pack, as they are never quite what any single installation would prefer,
                    208: and this would make packs more portable.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.