From owner-p4-projects@FreeBSD.ORG Fri Jan 5 23:09:43 2007 Return-Path: X-Original-To: p4-projects@freebsd.org Delivered-To: p4-projects@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 32767) id 6DB4616A55C; Fri, 5 Jan 2007 23:09:43 +0000 (UTC) X-Original-To: perforce@freebsd.org Delivered-To: perforce@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 4B77916A558 for ; Fri, 5 Jan 2007 23:09:43 +0000 (UTC) (envelope-from mjacob@freebsd.org) Received: from repoman.freebsd.org (repoman.freebsd.org [69.147.83.41]) by mx1.freebsd.org (Postfix) with ESMTP id 3620A13C458 for ; Fri, 5 Jan 2007 23:09:43 +0000 (UTC) (envelope-from mjacob@freebsd.org) Received: from repoman.freebsd.org (localhost [127.0.0.1]) by repoman.freebsd.org (8.13.6/8.13.6) with ESMTP id l05N9h0E060491 for ; Fri, 5 Jan 2007 23:09:43 GMT (envelope-from mjacob@freebsd.org) Received: (from perforce@localhost) by repoman.freebsd.org (8.13.6/8.13.4/Submit) id l05N9g5s060487 for perforce@freebsd.org; Fri, 5 Jan 2007 23:09:42 GMT (envelope-from mjacob@freebsd.org) Date: Fri, 5 Jan 2007 23:09:42 GMT Message-Id: <200701052309.l05N9g5s060487@repoman.freebsd.org> X-Authentication-Warning: repoman.freebsd.org: perforce set sender to mjacob@freebsd.org using -f From: Matt Jacob To: Perforce Change Reviews Cc: Subject: PERFORCE change 112578 for review X-BeenThere: p4-projects@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: p4 projects tree changes List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 05 Jan 2007 23:09:43 -0000 http://perforce.freebsd.org/chv.cgi?CH=112578 Change 112578 by mjacob@mjexp_6 on 2007/01/05 23:09:37 Integrate with vendor branch. Affected files ... .. //depot/projects/mjexp_6/sbin/geom/class/mirror/gmirror.8#2 integrate Differences ... ==== //depot/projects/mjexp_6/sbin/geom/class/mirror/gmirror.8#2 (text+ko) ==== @@ -22,9 +22,9 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $FreeBSD: src/sbin/geom/class/mirror/gmirror.8,v 1.16.2.3 2006/03/20 15:48:55 pjd Exp $ +.\" $FreeBSD: src/sbin/geom/class/mirror/gmirror.8,v 1.16.2.4 2006/12/31 18:46:42 ceri Exp $ .\" -.Dd March 8, 2006 +.Dd December 31, 2006 .Dt GMIRROR 8 .Os .Sh NAME @@ -83,10 +83,6 @@ .Op Fl fv .Ar name ... .Nm -.Cm clear -.Op Fl v -.Ar prov ... -.Nm .Cm dump .Ar prov ... .Nm @@ -120,7 +116,9 @@ Create a mirror. The order of components is important, because a component's priority is based on its position (starting from 0). -The component with the biggest priority is used by the prefer balance algorithm +The component with the biggest priority is used by the +.Cm prefer +balance algorithm and is also used as a master component when resynchronization is needed, e.g.\& after a power failure when the device was open for writing. .Pp @@ -291,7 +289,8 @@ First of all, a kernel dump will go only to one component and .Nm always chooses the component with the highest priority. -Reading a dump from the mirror on boot will only work if the prefer +Reading a dump from the mirror on boot will only work if the +.Cm prefer balance algorithm is used (that way .Nm will read only from the component with the highest priority). @@ -320,7 +319,6 @@ If on the next boot a component with the highest priority will be synchronized, the prefer balance algorithm will read from the next one, thus will find nothing there. -.Ed .Sh SEE ALSO .Xr geom 4 , .Xr dumpon 8 ,