Date: Thu, 10 Oct 2013 19:59:54 -0400 From: Allan Jude <freebsd@allanjude.com> To: freebsd-doc@freebsd.org Subject: Fwd: Re: FreeBSD 10 and zfsd Message-ID: <52573F7A.9060408@allanjude.com> In-Reply-To: <DACF4AD9-E963-4CE6-BE1E-C679DBEA8784@orthanc.ca> References: <DACF4AD9-E963-4CE6-BE1E-C679DBEA8784@orthanc.ca>
next in thread | previous in thread | raw e-mail | index | archive | help
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 <lyndon@orthanc.ca> To: Allan Jude <freebsd@allanjude.com> CC: freebsd-current@freebsd.org On 2013-10-10, at 2:54 PM, Allan Jude <freebsd@allanjude.com> 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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?52573F7A.9060408>