From owner-freebsd-doc@FreeBSD.ORG Wed Jun 8 04:30:06 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9F44C1065672 for ; Wed, 8 Jun 2011 04:30:06 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 5A3798FC19 for ; Wed, 8 Jun 2011 04:30:06 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p584U6aj063419 for ; Wed, 8 Jun 2011 04:30:06 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p584U6ZL063411; Wed, 8 Jun 2011 04:30:06 GMT (envelope-from gnats) Resent-Date: Wed, 8 Jun 2011 04:30:06 GMT Resent-Message-Id: <201106080430.p584U6ZL063411@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Robert Simmons Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 02563106564A for ; 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 ; 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 ; 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 To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/157698: gpart(8) man page contains old/incorrect size for /boot/gptboot X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 08 Jun 2011 04:30:06 -0000 >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: