git: 2f031534d134 - main - recoverdisk.1: Break lines at sentence stops
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Wed, 24 Sep 2025 14:49:52 UTC
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