From 31514763c4cd2d1eba35f615ee793ba35108e96e Mon Sep 17 00:00:00 2001 From: Brandon Creighton Date: Wed, 18 Apr 2001 11:14:24 +0000 Subject: - .Dt FOO 8 -> .Dt FOO 8 vax (where needed) - convert format.8 to mdoc - rearrange sections in installboot.8 - spelling/other misc. errors --- share/man/man8/man8.vax/MAKEDEV.8 | 6 +- share/man/man8/man8.vax/drtest.8 | 4 +- share/man/man8/man8.vax/format.8 | 187 ++++++++++++++++++---------------- share/man/man8/man8.vax/installboot.8 | 23 +++-- 4 files changed, 115 insertions(+), 105 deletions(-) diff --git a/share/man/man8/man8.vax/MAKEDEV.8 b/share/man/man8/man8.vax/MAKEDEV.8 index def947934d7..0a1ac38fb28 100644 --- a/share/man/man8/man8.vax/MAKEDEV.8 +++ b/share/man/man8/man8.vax/MAKEDEV.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: MAKEDEV.8,v 1.6 2001/01/27 22:53:43 brad Exp $ +.\" $OpenBSD: MAKEDEV.8,v 1.7 2001/04/18 11:14:22 bjc Exp $ .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. .\" @@ -34,8 +34,10 @@ .\" .Dd March 22, 1991 .Dt MAKEDEV 8 vax +.Os .Sh NAME -MAKEDEV \- create system and device special files +.Nm MAKEDEV +.Nd create system and device special files .Sh SYNOPSIS .Nm MAKEDEV .Ar name diff --git a/share/man/man8/man8.vax/drtest.8 b/share/man/man8/man8.vax/drtest.8 index afe73ef5a2c..16ddd835bd6 100644 --- a/share/man/man8/man8.vax/drtest.8 +++ b/share/man/man8/man8.vax/drtest.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: drtest.8,v 1.7 2000/12/15 14:31:20 aaron Exp $ +.\" $OpenBSD: drtest.8,v 1.8 2001/04/18 11:14:23 bjc Exp $ .\" .\" Copyright (c) 1983, 1991 Regents of the University of California. .\" All rights reserved. @@ -34,7 +34,7 @@ .\" from: @(#)drtest.8 6.3 (Berkeley) 3/16/91 .\" .Dd March 16, 1991 -.Dt DRTEST 8 +.Dt DRTEST 8 vax .Os .Sh NAME .Nm drtest diff --git a/share/man/man8/man8.vax/format.8 b/share/man/man8/man8.vax/format.8 index 1138d17f6e6..b366c8d2f6b 100644 --- a/share/man/man8/man8.vax/format.8 +++ b/share/man/man8/man8.vax/format.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: format.8,v 1.4 2000/10/13 04:09:23 aaron Exp $ +.\" $OpenBSD: format.8,v 1.5 2001/04/18 11:14:23 bjc Exp $ .\" Copyright (c) 1980, 1983 The Regents of the University of California. .\" All rights reserved. .\" @@ -32,28 +32,29 @@ .\" .\" from: @(#)format.8 6.6 (Berkeley) 4/20/91 .\" -.TH FORMAT 8 "April 20, 1991" -.UC 4 -.SH NAME -format \- how to format disk packs -.SH DESCRIPTION -.PP +.Dd April 20, 1991 +.Dt FORMAT 8 vax +.Os +.Sh NAME +.Nm format +.Nd how to format disk packs +.Sh DESCRIPTION There are two ways to format disk packs. The simplest is to use the -.I format +.Nm program. The alternative is to use the DEC standard formatting software which operates under the DEC diagnostic supervisor. This manual page describes the operation of -.IR format , +.Nm format , then concludes with some remarks about using the DEC formatter. -.PP -.I Format +.Pp +.Nm is a standalone program used to format and check disks prior to constructing file systems. In addition to the formatting operation, -.I format +.Nm records any bad sectors encountered according to DEC standard 144. Formatting is performed one track at a @@ -65,8 +66,10 @@ A sector is marked bad if an unrecoverable media error is detected, or if a correctable ECC error too many bits in length is detected (such errors are indicated as -``ECC'' in the summary printed upon +.Dq ECC +in the summary printed upon completing the format operation). +.Pp After the entire disk has been formatted and checked, the total number of errors are reported, @@ -76,28 +79,33 @@ is written to the disk in the first five even numbered sectors of the last track. It is also possible to reformat sections of the disk in units of tracks. -.I Format +.Nm may be used on any UNIBUS or MASSBUS drive -supported by the \fIup\fP and \fIhp\fP device +supported by the +.Xr up 4 +and +.Xr hp 4 +device drivers which uses 4-byte headers (everything except RP's). -.PP +.Pp The test pattern used during the media check may be selected from one of: 0xf00f (RH750 worst case), 0xec6d (media worst case), and 0xa5a5 (alternating 1's and 0's). Normally the media worst case pattern is used. -.PP -.I Format -also has an option to perform an extended \*(lqsevere burn-in,\*(rq +.Pp +.Nm +also has an option to perform an extended +.Dq severe burn-in, which makes a number of passes using different patterns. The number of passes can be selected at run time, up to a maximum of 48, with provision for additional passes or termination after the preselected number of passes. This test runs for many hours, depending on the disk and processor. -.PP +.Pp Each time -.I format +.Nm is run to format an entire disk, a completely new bad sector table is generated based on errors encountered while formatting. @@ -108,82 +116,84 @@ Thus, if a disk pack has never previously been formatted, or has been formatted with different sectoring, five error messages will be printed when the driver attempts to read the bad sector table; these diagnostics should be ignored. -.PP +.Pp Formatting a 400 megabyte disk on a MASSBUS disk controller usually takes about 20 minutes. Formatting on a UNIBUS disk controller takes significantly longer. -For every hundredth cylinder formatted -.I format +For every hundredth cylinder formatted, +.Nm format prints a message indicating the current cylinder being formatted. (This message is just to reassure people that nothing is amiss.) -.PP -.I Format +.Pp +.Nm uses the standard notation of the standalone I/O library in identifying a drive to be formatted. A drive is specified as -.IR zz ( x , y ), +.Do +.Ar zz Ns (x,y), +.Dc where -.I zz +.Ar zz refers to the controller type (either -.I hp +.Ar hp or -.IR up ), -.I x +.Ar up ) , +.Ar x is the unit number of the drive; 8 times the UNIBUS or MASSBUS adaptor number plus the MASSBUS drive number or UNIBUS drive unit number; and -.I y +.Ar y is the file system partition on drive -.I x +.Ar x (this should always be 0). -For example, ``hp(1,0)'' indicates that drive +For example, +.Dq hp(1,0) +indicates that drive 1 on MASSBUS adaptor 0 should be formatted; while -``up(10,0)'' indicates that UNIBUS drive 2 on UNIBUS adaptor 1 +.Dq up(10,0) +indicates that UNIBUS drive 2 on UNIBUS adaptor 1 should be formatted. -.PP +.Pp Before each formatting attempt, -.I format +.Nm prompts the user in case debugging should be enabled in the appropriate device driver. A carriage return disables debugging information. -.PP -.I Format +.Pp +.Nm should be used prior to building file systems (with -.IR newfs (8)) -to insure that all sectors with uncorrectable media errors +.Xr newfs 8 +to ensure that all sectors with uncorrectable media errors are remapped. If a drive develops uncorrectable defects after formatting, either -.IR bad144 (8) +.Xr bad144 8 or -.IR badsect (8) +.Xr badsect 8 should be able to avoid the bad sectors. -.SH EXAMPLE +.Sh EXAMPLE A sample run of -.I format +.Nm is shown below. In this example (using a VAX-11/780), -.I format +.Nm is loaded from the console floppy; -on an 11/750 -.I format +on an 11/750, +.Nm will be loaded from the root file system with -.IR boot (8) -following a \*(lqB/3\*(rq command. +.Xr boot 8 +following a B/3 command. Boldface means user input. As usual, ``#'' and ``@'' may be used to edit input. -.nf -.in +0.5i -.ta 1i -.sp 1 +.Bd -literal -offset indent >>>\fBL FORMAT\fP LOAD DONE, 00004400 BYTES LOADED >>>\fBS 2\fP Disk format/check utility -.sp + Enable debugging (0=none, 1=bse, 2=ecc, 3=bse+ecc)? \fB0\fP Device to format? \fBhp(8,0)\fP (\fIerror messages may occur as old bad sector table is read\fP) @@ -194,12 +204,14 @@ Starting track (0): Ending cylinder (841): Ending track (19): Available test patterns are: -.in +1.0i +.Ed +.Bd -literal -offset indent-two 1 - (f00f) RH750 worst case 2 - (ec6d) media worst case 3 - (a5a5) alternating 1's and 0's 4 - (ffff) Severe burnin (up to 48 passes) -.in -1.0i +.Ed +.Bd -literal -offset indent Pattern (one of the above, other to restart)? \fB2\fP Maximum number of bit errors to allow for soft ECC (3): Start formatting...make sure the drive is online @@ -221,30 +233,29 @@ Writing bad sector table at block 808272 Done (\fI...program restarts to allow formatting other disks\fP) (\fI...to abort halt machine with ^P\fP) -.fi -.sp 1 -.SH DIAGNOSTICS +.Ed + +.Sh DIAGNOSTICS The diagnostics are intended to be self explanatory. -.SH "USING DEC SOFTWARE TO FORMAT" -.PP -.B "Warning: These instructions are for people with 11/780 CPU's." +.Sh USING DEC SOFTWARE TO FORMAT +.Pp +.Sy Warning: These instructions are for people with 11/780 CPU's. The steps needed for 11/750 or 11/730 cpu's are similar, but not covered in detail here. -.I -.PP +.Pp The formatting procedures are different for each type of disk. Listed here are the formatting procedures for RK07's, RP0X, and RM0X disks. -.PP +.Pp You should shut down UNIX and halt the machine to do any disk formatting. Make certain you put in the pack you want formatted. It is also a good idea to spin down or write protect the disks you don't want to format, just in case. -.PP -.B "Formatting an RK07." +.Pp +.Ss Formatting an RK07 Load the console floppy labeled, "RX11 VAX DSK LD DEV #1" in the console disk drive, and type the following commands: .RS -.nf +.Bd -literal >>>BOOT DIAGNOSTIC SUPERVISOR. ZZ-ESSAA-X5.0-119 23-JAN-1980 12:44:40.03 DS>ATTACH DW780 SBI DW0 3 5 @@ -253,42 +264,38 @@ DS>ATTACH RK07 DW0 DMA0 DS>SELECT DMA0 DS>LOAD EVRAC DS>START/SEC:PACKINIT -.fi -.RE -.PP -.B "Formatting an RP0X." +.Ed +.Pp +.Ss Formatting an RP0X Follow the above procedures except that the ATTACH and SELECT lines should read: -.RS .nf +.Bd -literal DS>ATTACH RH780 SBI RH0 8 5 DS>ATTACH RP0X RH0 DBA0 (RP0X is, e.g. RP06) DS>SELECT DBA0 -.fi -.RE -.PP +.Ed +.Pp This is for drive 0 on mba0; use 9 instead of 8 for mba1, etc. -.PP -.B "Formatting an RM0X." +.Pp +.Ss Formatting an RM0X Follow the above procedures except that the ATTACH and SELECT lines should read: -.RS -.nf +.Bd -literal DS>ATTACH RH780 SBI RH0 8 5 DS>ATTACH RM0X RH0 DRA0 DS>SELECT DRA0 -.fi -.RE -.PP +.Ed +.Pp Don't forget to put your UNIX console floppy back in the floppy disk drive. -.SH SEE ALSO -bad144(8), -badsect(8), -newfs(8) -.SH BUGS +.Sh SEE ALSO +.Xr bad144 8 , +.Xr badsect 8 , +.Xr newfs 8 +.Sh BUGS An equivalent facility should be available which operates under a running UNIX system. -.PP +.Pp It should be possible to reformat or verify part or all of a disk, then update the existing bad sector table. diff --git a/share/man/man8/man8.vax/installboot.8 b/share/man/man8/man8.vax/installboot.8 index 05ae7a9cb39..1824609238a 100644 --- a/share/man/man8/man8.vax/installboot.8 +++ b/share/man/man8/man8.vax/installboot.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: installboot.8,v 1.6 2000/03/02 14:46:51 todd Exp $ +.\" $OpenBSD: installboot.8,v 1.7 2001/04/18 11:14:23 bjc Exp $ .\" Copyright (c) 1986, 1991 Regents of the University of California. .\" All rights reserved. .\" @@ -33,10 +33,10 @@ .\" from: @(#)installboot.8 7.2 (Berkeley) 3/16/91 .\" .Dd March 16, 1991 -.Dt INSTALLBOOT 8 +.Dt INSTALLBOOT 8 vax .Os .Sh NAME -.Nm VAX installboot +.Nm installboot .Nd installs a boot program in a file system .Sh SYNOPSIS .Nm installboot @@ -60,22 +60,23 @@ boot blocks .It Pa /usr/mdec/boot?? boot programs .El -.Sh SEE ALSO -.Xr dd 1 , -.Xr newfs 8 .Sh EXAMPLES .Bd -literal -offset indent -compact cd /usr/mdec installboot raboot bootra /dev/ra0a .Ed -.Sh BUGS -There is no convenient way to determine the names of the boot blocks -and boot programs without -.Em a priori -knowledge of one's make of disk. +.Sh SEE ALSO +.Xr dd 1 , +.Xr newfs 8 .Sh HISTORY The .Nm command appeared in .Bx 4.3 tahoe . +.Sh AUTHORS This manual page was written by Geoff Collyer. +.Sh BUGS +There is no convenient way to determine the names of the boot blocks +and boot programs without +.Em a priori +knowledge of one's make of disk. \ No newline at end of file -- cgit v1.2.3