From nobody Wed Sep 24 14:49:52 2025 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4cX0B84YGCz67yrw; Wed, 24 Sep 2025 14:49:52 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cX0B83csSz3lFd; Wed, 24 Sep 2025 14:49:52 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1758725392; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=aSESLhQ5w4O3Q6ZorUhS40glrDiBIOCrXmSuSzUQ9L4=; b=In50l4l9RixysdoHGdSp9M+4YVPmto1T/LT8qB1mziPQD/3EEAjMmRnGh4kF1anPPYhD9+ XjQyDIHAy3qViOL1HwH5q0XEa/Z+LMjSL0vpIY0Xq8uqBbjfDfFPABqMJDidP0EwfscSCZ uHlXwhZfOAOn7k0JCKUU0LkQ5qkpVIvdadPl6aanaLmKVOskX4DSv0ofspSG/m6hP1S0MP 20l5lFmouu+d7zvh/30Z10fKCJkuaWuqur8xjpUENS+fbYYwveteDD8KyLp0Mg9eDTbguZ G7JnNS3abI/Im5FDFZyTAJf8tHATcaNhGb3bIStQXwvgC3ImWQFaYhKoBSWpvg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1758725392; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=aSESLhQ5w4O3Q6ZorUhS40glrDiBIOCrXmSuSzUQ9L4=; b=UNNOGBhVoSACEpuJEJ9rciFFj7Z0G+tB1ncbdp6Ykj9av9YG5zULWTTCBM0E+daWTvQ5XG E0qA+mkksvFIdawC58jMUoB7AeBGjq+peM6mXZk4+/yqTZ+4ALUQqrn5oQQTdHF7j5Eiu6 bX71tKo3ZuwbwoRu/ImkWjPuCF4HL+zgU1swKvXkNaQ5JdZ11Font5PU2P8evVq9TFfP/i vseoC0oObF15jAR6O9Tq/WJ7HEMt1IQtpfoiDhp/RPy89mjeSUi4YgwE/wx4KnMMEVFrHG yDKVr574WefwIerVZw6UKCVZ73LoJsUG08Pc8mpn0adqitcwCdfBYLGYj7OoJA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1758725392; a=rsa-sha256; cv=none; b=vbHDanwsaRY08qj4K6f6QU++oZnj23Sh+HetgWS3oRcJYffuT3w8zPd+Ll+W7JAwRCy9ye hQCiIvXEe3KyaPN741+t5uT9YqOlSZvUIqVgcMagamjbTVAFf+egv9k7GmPn1sPxv7DPwc vC95+YvknFt9L8GKpigNPR09Td9J2VO3oikgRSvoWobZZdKvcP/1yvQpknKKy3apmnjzKQ yy8+lbD/uukg2wz3wO0gmfL5N228b4IeW1XiCExa+dHUG4yLX2riKuoIxOAvanfYAgnIvL Ys7AuAJDmy8ZvHe33kdRO0tNnm3vAXzLpmfkqk0z9FMaIRekoOBaNiPSgw2JMA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4cX0B835zBzc5Q; Wed, 24 Sep 2025 14:49:52 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 58OEnqjo023742; Wed, 24 Sep 2025 14:49:52 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 58OEnqLh023739; Wed, 24 Sep 2025 14:49:52 GMT (envelope-from git) Date: Wed, 24 Sep 2025 14:49:52 GMT Message-Id: <202509241449.58OEnqLh023739@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Benedict Reuschling Subject: git: 2f031534d134 - main - recoverdisk.1: Break lines at sentence stops List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 2f031534d1347816a7889674b363975d181f8449 Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/src/commit/?id=2f031534d1347816a7889674b363975d181f8449 commit 2f031534d1347816a7889674b363975d181f8449 Author: Benedict Reuschling AuthorDate: 2025-09-24 14:47:56 +0000 Commit: Benedict Reuschling 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