Date: Wed, 24 Sep 2025 14:49:52 GMT From: Benedict Reuschling <bcr@FreeBSD.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org Subject: git: 2f031534d134 - main - recoverdisk.1: Break lines at sentence stops Message-ID: <202509241449.58OEnqLh023739@gitrepo.freebsd.org>
next in thread | raw e-mail | index | archive | help
The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/src/commit/?id=2f031534d1347816a7889674b363975d181f8449 commit 2f031534d1347816a7889674b363975d181f8449 Author: Benedict Reuschling <bcr@FreeBSD.org> AuthorDate: 2025-09-24 14:47:56 +0000 Commit: Benedict Reuschling <bcr@FreeBSD.org> CommitDate: 2025-09-24 14:47:56 +0000 recoverdisk.1: Break lines at sentence stops While here, remove whitespaces at end of lines. Event: EuroBSDcon 2025 Devsummit --- sbin/recoverdisk/recoverdisk.1 | 23 +++++++++++++---------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/sbin/recoverdisk/recoverdisk.1 b/sbin/recoverdisk/recoverdisk.1 index 2eb7ba98348f..76085f3ceb41 100644 --- a/sbin/recoverdisk/recoverdisk.1 +++ b/sbin/recoverdisk/recoverdisk.1 @@ -55,7 +55,7 @@ sessions can be resumed, for instance when a marginal source hard-disk shuts down. .Pp The work-list is initialized with a single item which covers the entire -.Ar source +.Ar source and .Nm always chips away at the first item on the work-list. @@ -71,9 +71,9 @@ is specified, the corresponding range is filled with '_UNREAD_'. .Pp The first pass attempts to read everything in "big-size" chunks, the second pass reads in "medium-size" chunks and third and subsequent -passes read in "small-size" chunks. This three stage process is -an attempt to optimize the case where only a few bad blocks exist -on +passes read in "small-size" chunks. +This three stage process is an attempt to optimize the case where only +a few bad blocks exist on .Ar source . If too many read-errors are encountered, .Nm @@ -103,7 +103,8 @@ every minute. .It Fl l Ar log-file Each successful read is logged with timestamp, offset and length. .It Fl t Ar totalsize -How many bytes should be recovered. The default is what +How many bytes should be recovered. +The default is what .Dv DIOCGMEDIASIZE reports for character and block devices or .Dv st_size @@ -117,14 +118,16 @@ this long between reads. This reduces the load on the device and the system in general. .It Fl p Ar pause .Xr sleep 3 -this long whenever a read fails. This makes the +this long whenever a read fails. +This makes the .Ar source device look less sick to the operating system. .It Fl u Ar pattern By default blocks which cannot be read are filled with the pattern .Ql _UNREAD_ -in the output file. This option can be used to specify a different -pattern. If the pattern is the empty string, nothing is written. +in the output file. +This option can be used to specify a different pattern. +If the pattern is the empty string, nothing is written. .It Fl v Produce a detailed progress report with ANSI escapes and UTF-8. .El @@ -192,7 +195,7 @@ is a problem, use a USB-(S)ATA adapter instead. The .Nm source code is deliberately written to be easily portable to -older versions of +older versions of .Fx and to other operating systems. .It @@ -233,7 +236,7 @@ to the size of a track. The .Nm utility first appeared in -.Fx 7.0 +.Fx 7.0 because Somebody™ forgot to make a backup copy. .Sh AUTHORS .An -nosplit
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202509241449.58OEnqLh023739>