From owner-cvs-all Tue May 15 0:26:27 2001 Delivered-To: cvs-all@freebsd.org Received: from whale.sunbay.crimea.ua (whale.sunbay.crimea.ua [212.110.138.65]) by hub.freebsd.org (Postfix) with ESMTP id AB0FD37B424; Tue, 15 May 2001 00:26:05 -0700 (PDT) (envelope-from ru@whale.sunbay.crimea.ua) Received: (from ru@localhost) by whale.sunbay.crimea.ua (8.11.2/8.11.2) id f4F7Q1818606; Tue, 15 May 2001 10:26:01 +0300 (EEST) (envelope-from ru) Date: Tue, 15 May 2001 10:26:01 +0300 From: Ruslan Ermilov To: Joerg Wunsch Cc: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/usr.sbin/fdread - Imported sources Message-ID: <20010515102601.B16971@sunbay.com> Mail-Followup-To: Joerg Wunsch , cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org References: <200105142022.f4EKMnQ84359@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="G4iJoqBmSsgzjUCe" Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <200105142022.f4EKMnQ84359@freefall.freebsd.org>; from joerg@FreeBSD.org on Mon, May 14, 2001 at 01:22:49PM -0700 Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG --G4iJoqBmSsgzjUCe Content-Type: text/plain; charset=us-ascii Content-Disposition: inline On Mon, May 14, 2001 at 01:22:49PM -0700, Joerg Wunsch wrote: > joerg 2001/05/14 13:22:49 PDT > > src/usr.sbin/fdread - Imported sources > Update of /home/ncvs/src/usr.sbin/fdread > In directory freefall.freebsd.org:/d/home/joerg/fdread > > Log Message: > Initial import of fdread(1), a logical counterpart to fdwrite(1). > > Its main purpose is to adapt automatically to the floppy parameters > (in particular the track size for efficient reading), and to allow a > simple error recovery for CRC-errored sectors. Requires the newly > added fdc(4) options. > > > Status: > > Vendor Tag: JOERG > Release Tags: v20010514 > > N src/usr.sbin/fdread/fdread.c > N src/usr.sbin/fdread/fdread.1 > N src/usr.sbin/fdread/Makefile > > No conflicts created by this import > The attached patch cleans up the manpage formatting. Cheers, -- Ruslan Ermilov Oracle Developer/DBA, ru@sunbay.com Sunbay Software AG, ru@FreeBSD.org FreeBSD committer, +380.652.512.251 Simferopol, Ukraine http://www.FreeBSD.org The Power To Serve http://www.oracle.com Enabling The Information Age --G4iJoqBmSsgzjUCe Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename=p Index: fdread.1 =================================================================== RCS file: /home/ncvs/src/usr.sbin/fdread/fdread.1,v retrieving revision 1.1.1.1 diff -u -p -r1.1.1.1 fdread.1 --- fdread.1 2001/05/14 20:22:49 1.1.1.1 +++ fdread.1 2001/05/15 07:24:00 @@ -27,25 +27,24 @@ .\" .\" .Dd May 14, 2001 -.Os FreeBSD +.Os .Dt FDREAD 1 .Sh NAME .Nm fdread .Nd read floppy disks .Sh SYNOPSIS .Nm -.Op Fl q -.Op Fl r +.Op Fl qr .Op Fl d Ar device .Op Fl f Ar fillbyte .Op Fl o Ar file .Sh DESCRIPTION -.Nm Fdread +.Nm reads floppy disks. Effective read blocking based on the track size is performed, and floppy-specific error recovery of otherwise bad blocks can be enabled. .Pp -.Nm Fdread +.Nm will always read an entire floppy medium, and write its contents to the respective output file. Unlike other tools like .Xr dd 1 , @@ -58,9 +57,9 @@ While .Nm is working, kernel error reporting for floppy errors is turned off, so the console and/or syslog are not flooded with kernel error messages. -.Sh Options +.Sh OPTIONS The options are as follows: -.Bl -tag -width XXXX -offset indent +.Bl -tag -width indent .It Fl q Turn on quiet mode. By default, the medium parameters of the device are being written to standard error output, progress will be indicated @@ -75,13 +74,15 @@ stops after the first unrecovered read e .Xr dd 1 does. In recovery mode, however, one of two recovery actions will be taken: -.Bl -bullet -offset indent +.Bl -bullet .It If the error was a CRC error in the data field, the kernel is told to ignore the error, and data are transferred to the output file anyway. -.Em Note that this will cause the erroneous data -.Em to be included in the output file ! +.Bf -emphasis +Note that this will cause the erroneous data +to be included in the output file! +.Ef Still, this is the best recovery action that can be taken at all. .It All other errors are really fatal (usually, the FDC didn't find the @@ -111,15 +112,16 @@ Specify the output file to be By default, the data will be written to standard output. .El .Sh FILES -.Bl -tag -width XXXXXXXX -offset indent +.Bl -tag -width /dev/fd0 .It Pa /dev/fd0 Default device to read from. +.El .Sh DIAGNOSTICS -.Nm Fdread +.Nm sets the exit value according to .Xr sysexits 3 . In recovery mode, the exit value will be set to -.Sy EX_IOERR +.Dv EX_IOERR if any error occurred during processing (even in quiet mode). .Pp Unless running in quiet mode, upon encountering an error, the status @@ -146,12 +148,12 @@ location of the bad block in the output of transfer errors will be printed before exiting. .Sh SEE ALSO .Xr dd 1 , -.Xr fdc 4 , -.Xr fdcontrol 8 , .Xr fdwrite 1 , -.Xr sysexits 3 +.Xr sysexits 3 , +.Xr fdc 4 , +.Xr fdcontrol 8 .Sh HISTORY -.Nm Fdread +.Nm was written mainly to provide a means of recovering at least some of the data on bad media, and to obviate the need to invoke .Xr dd 1 @@ -162,8 +164,7 @@ The command appeared in .Fx 5.0 . .Sh AUTHORS Program and man page by -.ie t J\(:org Wunsch. -.el Joerg Wunsch. +.An J\(:org Wunsch . .Sh BUGS Concurrent traffic on the second floppy drive located at the same FDC will make error recovery attempts pointless, since the FDC status @@ -181,4 +182,4 @@ without errors by trying multiple times. .Pp Bits that are (no longer) available on the floppy medium cannot be guessed by -.Nm fdread . +.Nm . --G4iJoqBmSsgzjUCe-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message