git: 84f773037ee4 - main - bsdinstall.8: Clarify the description of ZFSBOOT_FORCE_4K_SECTORS

From: John Baldwin <jhb_at_FreeBSD.org>
Date: Sat, 18 Nov 2023 19:45:59 UTC
The branch main has been updated by jhb:

URL: https://cgit.FreeBSD.org/src/commit/?id=84f773037ee4fc78585501a2ce2f5398f0bae9f4

commit 84f773037ee4fc78585501a2ce2f5398f0bae9f4
Author:     John Baldwin <jhb@FreeBSD.org>
AuthorDate: 2023-11-18 19:31:07 +0000
Commit:     John Baldwin <jhb@FreeBSD.org>
CommitDate: 2023-11-18 19:45:42 +0000

    bsdinstall.8: Clarify the description of ZFSBOOT_FORCE_4K_SECTORS
    
    This variable does not set the exact sector size of the pool, but
    controls the minimum sector size.  The sector size of the underlying
    disks can always be larger than the minium controlled by this knob.
    
    PR:             274513
    Reported by:    Albin "a12l" Otterhäll <bugs.freebsd.org@a12l.xyz>
---
 usr.sbin/bsdinstall/bsdinstall.8 | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/usr.sbin/bsdinstall/bsdinstall.8 b/usr.sbin/bsdinstall/bsdinstall.8
index 77da9622d4d7..c8bf143322ae 100644
--- a/usr.sbin/bsdinstall/bsdinstall.8
+++ b/usr.sbin/bsdinstall/bsdinstall.8
@@ -23,7 +23,7 @@
 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd September 18, 2023
+.Dd November 18, 2023
 .Dt BSDINSTALL 8
 .Os
 .Sh NAME
@@ -433,8 +433,11 @@ or raidz3 (RAID-Z3 Triple Redundancy RAID).
 Default:
 .Dq stripe
 .It Ev ZFSBOOT_FORCE_4K_SECTORS
-Indicates either the pool will use 4K or 512 sectors.
-If this variable is not empty, 4K sectors will be used.
+Controls the minimum sector size of the pool.
+If this variable is not empty, the minimum sector size is 4K.
+If this variable is empty, the minimum sector size is 512.
+Note that the sector size of the pool will always be at least
+the sector size of the backing disks.
 Default:
 .Dq 1
 .It Ev ZFSBOOT_GELI_ENCRYPTION