Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 8 Jun 2011 04:26:14 GMT
From:      Robert Simmons <rsimmons0@gmail.com>
To:        freebsd-gnats-submit@FreeBSD.org
Subject:   docs/157698: gpart(8) man page contains old/incorrect size for /boot/gptboot
Message-ID:  <201106080426.p584QEjE027735@red.freebsd.org>
Resent-Message-ID: <201106080430.p584U6ZL063411@freefall.freebsd.org>

next in thread | raw e-mail | index | archive | help

>Number:         157698
>Category:       docs
>Synopsis:       gpart(8) man page contains old/incorrect size for /boot/gptboot
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Jun 08 04:30:05 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Robert Simmons
>Release:        8.2-RELEASE
>Organization:
>Environment:
>Description:
In the gpart(8) man page under examples is the sentence: "A size of 15 blocks (7680 bytes) would be sufficient for booting from UFS but let's use 128 blocks (64 KB) here in this example, in order to reserve some space for potential future need (e.g. from a ZFS partition)."  This is incorrect (maybe because the size of /boot/gptboot has changed since the man page was written, or maybe it's an error).

The current size of gptboot is 13851 bytes:

#ls -l gptboot
-r--r--r--  1 root  0  13851 Feb 17 02:19 gptboot

13851/512 = 27.05 blocks

Rounding up, the minimum size for the freebsd-boot partition is 28 blocks.
>How-To-Repeat:

>Fix:
So, the sentence in the man page should read: "A size of 28 blocks (14336 bytes) would be sufficient for booting from UFS but let's use 128 blocks (64 KB) here in this example, in order to reserve some space for potential future need (e.g. from a ZFS partition)."

Patch attached with submission follows:

850c850
< A size of 15 blocks (7680 bytes) would be sufficient for
---
> A size of 28 blocks (14336 bytes) would be sufficient for


>Release-Note:
>Audit-Trail:
>Unformatted:



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201106080426.p584QEjE027735>