From owner-svn-src-all@FreeBSD.ORG Tue Jan 13 21:55:39 2009 Return-Path: Delivered-To: svn-src-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id AE5D0106564A; Tue, 13 Jan 2009 21:55:39 +0000 (UTC) (envelope-from luigi@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 8207E8FC13; Tue, 13 Jan 2009 21:55:39 +0000 (UTC) (envelope-from luigi@FreeBSD.org) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.3/8.14.3) with ESMTP id n0DLtd1N017396; Tue, 13 Jan 2009 21:55:39 GMT (envelope-from luigi@svn.freebsd.org) Received: (from luigi@localhost) by svn.freebsd.org (8.14.3/8.14.3/Submit) id n0DLtdIe017395; Tue, 13 Jan 2009 21:55:39 GMT (envelope-from luigi@svn.freebsd.org) Message-Id: <200901132155.n0DLtdIe017395@svn.freebsd.org> From: Luigi Rizzo Date: Tue, 13 Jan 2009 21:55:39 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org X-SVN-Group: head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r187195 - head/usr.sbin/boot0cfg X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 13 Jan 2009 21:55:40 -0000 Author: luigi Date: Tue Jan 13 21:55:39 2009 New Revision: 187195 URL: http://svn.freebsd.org/changeset/base/187195 Log: Extend the geom-related info and put in the NOTE section, not in BUGS, as this is a feature. Bump the date, as it was forgotten in previous commits and the page has had significant changes recently Modified: head/usr.sbin/boot0cfg/boot0cfg.8 Modified: head/usr.sbin/boot0cfg/boot0cfg.8 ============================================================================== --- head/usr.sbin/boot0cfg/boot0cfg.8 Tue Jan 13 21:19:27 2009 (r187194) +++ head/usr.sbin/boot0cfg/boot0cfg.8 Tue Jan 13 21:55:39 2009 (r187195) @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd June 7, 2007 +.Dd January 13, 2009 .Dt BOOT0CFG 8 .Os .Sh NAME @@ -153,6 +153,21 @@ Set the timeout value to .It Fl v Verbose: display information about the slices defined, etc. .El +.Sh NOTE +Protection mechanisms in the +.Xr geom 4 +subsystem might prevent +.Nm +from being able to update the MBR on a mounted disk. +Instructions for temporarily disabling these protection mechanisms +can be found in the +.Xr geom 4 +manpage. Specifically, do a +.Pp +.Dl sysctl kern.geom.debugflags=0x10 +.Pp +to allow writing to the MBR, and restore it to 0 afterwards. +.Pp .Sh FILES .Bl -tag -width /boot/boot0sio -compact .It Pa /boot/boot0 @@ -186,16 +201,6 @@ to install the default MBR: .Sh AUTHORS .An Robert Nordier Aq rnordier@FreeBSD.org . .Sh BUGS -Protection mechanisms in the -.Xr geom 4 -subsystem might prevent -.Nm -from being able to update the MBR on a mounted disk. -Instructions for temporarily disabling these protection mechanisms -can be found in the -.Xr geom 4 -manpage. -.Pp Use of the .Sq packet option may cause @@ -204,6 +209,6 @@ to fail, depending on the nature of BIOS .Pp Use of the .Sq setdrv -option with an incorrect -d operand may cause the MBR to be written -to the wrong disk. -Be careful! +option with an incorrect -d operand may cause the boot0 code +to write the MBR to the wrong disk, thus trashing its previous +content. Be careful.