From owner-freebsd-doc@FreeBSD.ORG Thu Oct 10 23:59:35 2013 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id BABBFD3C for ; Thu, 10 Oct 2013 23:59:35 +0000 (UTC) (envelope-from freebsd@allanjude.com) Received: from mx1.scaleengine.net (beauharnois2.bhs1.scaleengine.net [142.4.218.15]) by mx1.freebsd.org (Postfix) with ESMTP id 9359F2861 for ; Thu, 10 Oct 2013 23:59:34 +0000 (UTC) Received: from [10.1.1.1] (S01060001abad1dea.hm.shawcable.net [50.70.108.129]) (Authenticated sender: allan.jude@scaleengine.com) by mx1.scaleengine.net (Postfix) with ESMTPSA id B395C2D037 for ; Thu, 10 Oct 2013 23:59:32 +0000 (UTC) Message-ID: <52573F7A.9060408@allanjude.com> Date: Thu, 10 Oct 2013 19:59:54 -0400 From: Allan Jude User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:24.0) Gecko/20100101 Thunderbird/24.0 MIME-Version: 1.0 To: freebsd-doc@freebsd.org Subject: Fwd: Re: FreeBSD 10 and zfsd References: In-Reply-To: X-Forwarded-Message-Id: Content-Type: multipart/mixed; boundary="------------000908080203010702040801" X-Content-Filtered-By: Mailman/MimeDel 2.1.14 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 10 Oct 2013 23:59:35 -0000 This is a multi-part message in MIME format. --------------000908080203010702040801 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit -------- Original Message -------- Subject: Re: FreeBSD 10 and zfsd Date: Thu, 10 Oct 2013 16:27:54 -0700 From: Lyndon Nerenberg To: Allan Jude CC: freebsd-current@freebsd.org On 2013-10-10, at 2:54 PM, Allan Jude wrote: > I've been working on the handbook section on ZFS and made certain to > mention that, I'll have to look at improving the man page as well, but > as far as I know, the man page is imported from IllumOS, where spares do > work. This is probably worthy of an in-tree man page update. FreeBSD has a reputation for having highly accurate man pages, therefore people tend to take what they read as gospel. Right now zpool(8) clearly spells out that hot spare substitution works. When 10.0 goes live, people are going to believe that, and unknowingly put themselves in a position where Bad Things could happen. Until zfsd goes into the tree, zpool(8) should have a warning that the hot spare functionality is not available under FreeBSD. Proposed diff attached. --lyndon --------------000908080203010702040801 Content-Type: text/plain; charset=windows-1252; name="zpool.diff.txt" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename="zpool.diff.txt" Index: zpool.8 =================================================================== --- zpool.8 (revision 255198) +++ zpool.8 (working copy) @@ -283,6 +283,7 @@ For more information, see the .Qq Sx Hot Spares section. +.Sy "(The hot spare functionality is not currently implemented on FreeBSD.)" .It Sy log A separate-intent log device. If more than one log device is specified, then writes are load-balanced between devices. Log devices can be mirrored. However, @@ -425,6 +426,8 @@ attempts to put the device online automatically. Device attach detection is hardware-dependent and might not be supported on all platforms. .Ss Hot Spares +.Sy "(The hot spare functionality is not currently implemented on FreeBSD.)" +.Pp .Tn ZFS allows devices to be associated with pools as .Qq hot spares . @@ -1946,3 +1949,6 @@ .Xr mdoc 7 implementation of this manual page was initially written by .An Martin Matuska Aq mm@FreeBSD.org . +.Sh BUGS +Hot spare substitution awaits the import of +.Xr zfsd 8 . --------------000908080203010702040801--