From nobody@FreeBSD.org  Wed Jun  8 04:26:15 2011
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 02563106564A
	for <freebsd-gnats-submit@FreeBSD.org>; Wed,  8 Jun 2011 04:26:15 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id E68C08FC28
	for <freebsd-gnats-submit@FreeBSD.org>; Wed,  8 Jun 2011 04:26:14 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p584QEZL027736
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 8 Jun 2011 04:26:14 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id p584QEjE027735;
	Wed, 8 Jun 2011 04:26:14 GMT
	(envelope-from nobody)
Message-Id: <201106080426.p584QEjE027735@red.freebsd.org>
Date: Wed, 8 Jun 2011 04:26:14 GMT
From: Robert Simmons <rsimmons0@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: gpart(8) man page contains old/incorrect size for /boot/gptboot
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         157698
>Category:       docs
>Synopsis:       [patch] 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:  Sun Sep 02 03:09:09 UTC 2012
>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:
Responsible-Changed-From-To: freebsd-doc->eadler 
Responsible-Changed-By: eadler 
Responsible-Changed-When: Fri May 4 04:18:15 UTC 2012 
Responsible-Changed-Why:  
I'll take it. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=157698 
Responsible-Changed-From-To: eadler->freebsd-doc 
Responsible-Changed-By: eadler 
Responsible-Changed-When: Sun Sep 2 03:09:08 UTC 2012 
Responsible-Changed-Why:  
I won't be looking at this PR for a while and I need to clear some out 
of my queue 

http://www.freebsd.org/cgi/query-pr.cgi?pr=157698 
>Unformatted:
