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 Subject: Re: FreeBSD 10 and zfsd Message-ID: <DACF4AD9-E963-4CE6-BE1E-C679DBEA8784@orthanc.ca> In-Reply-To: <52572213.2050307@allanjude.com> References: <5256B761.4050301@gmail.com> <CAOtMX2i5hxdp8=4sHQgu2MOjpv9jqd6D7LV-a8y7S6cuCBgYuw@mail.gmail.com> <1381421583.19140.32451849.084D8E32@webmail.messagingengine.com> <5256E2D5.4060101@allanjude.com> <CAOtMX2hRDCFzmyi2s76j=0AufqAab_UzVi73dBR9t_AsZ6n6=g@mail.gmail.com> <5256E680.4000008@allanjude.com> <1381430466.14387.32509497.13949CED@webmail.messagingengine.com> <20131010215949.3214f4c2@thor.walstatt.dyndns.org> <52572213.2050307@allanjude.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--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 <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 --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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?DACF4AD9-E963-4CE6-BE1E-C679DBEA8784>