From owner-freebsd-current@FreeBSD.ORG Thu Oct 10 23:28:00 2013 Return-Path: Delivered-To: freebsd-current@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 44BCE68A for ; Thu, 10 Oct 2013 23:28:00 +0000 (UTC) (envelope-from lyndon@orthanc.ca) Received: from orthanc.ca (orthanc.ca [IPv6:2607:fc50:1000:8200::42]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 14FB526F1 for ; Thu, 10 Oct 2013 23:28:00 +0000 (UTC) Received: from [192.168.42.129] (d66-183-220-167.bchsia.telus.net [66.183.220.167] (may be forged)) (authenticated bits=0) by orthanc.ca (8.14.7/8.14.7) with ESMTP id r9ANRteZ011987 (version=TLSv1/SSLv3 cipher=AES128-SHA bits=128 verify=NO); Thu, 10 Oct 2013 16:27:56 -0700 (PDT) (envelope-from lyndon@orthanc.ca) Content-Type: multipart/mixed; boundary="Apple-Mail=_C497258F-6A46-4B82-9FAD-98E4838ABE2F" Mime-Version: 1.0 (Mac OS X Mail 6.6 \(1510\)) Subject: Re: FreeBSD 10 and zfsd From: Lyndon Nerenberg In-Reply-To: <52572213.2050307@allanjude.com> Date: Thu, 10 Oct 2013 16:27:54 -0700 Message-Id: References: <5256B761.4050301@gmail.com> <1381421583.19140.32451849.084D8E32@webmail.messagingengine.com> <5256E2D5.4060101@allanjude.com> <5256E680.4000008@allanjude.com> <1381430466.14387.32509497.13949CED@webmail.messagingengine.com> <20131010215949.3214f4c2@thor.walstatt.dyndns.org> <52572213.2050307@allanjude.com> To: Allan Jude X-Mailer: Apple Mail (2.1510) Cc: freebsd-current@freebsd.org X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 10 Oct 2013 23:28:00 -0000 --Apple-Mail=_C497258F-6A46-4B82-9FAD-98E4838ABE2F Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=us-ascii 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 --Apple-Mail=_C497258F-6A46-4B82-9FAD-98E4838ABE2F Content-Disposition: attachment; filename=zpool.diff.txt Content-Type: text/plain; name="zpool.diff.txt" Content-Transfer-Encoding: quoted-printable Index: zpool.8 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- 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 . --Apple-Mail=_C497258F-6A46-4B82-9FAD-98E4838ABE2F Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=us-ascii --Apple-Mail=_C497258F-6A46-4B82-9FAD-98E4838ABE2F--