Date: Tue, 04 Sep 2012 13:48:03 +1200 From: Ian Collins <ian@ianshome.com> To: zfs@lists.illumos.org Cc: freebsd-fs <freebsd-fs@freebsd.org>, Matthew Ahrens <mahrens@delphix.com>, Yuri Pankov <yuri.pankov@nexenta.com> Subject: Re: [zfs] Re: zfs send -r missing - but documented in zfs(8) Message-ID: <50455DD3.9070808@ianshome.com> In-Reply-To: <CAJjvXiHHxxYNzYsi%2BA0QQg4T-tZYEivOizKCYxVHC8KAo9wmmg@mail.gmail.com> References: <50438BF5.8030004@gibfest.dk> <CAPS9%2BSvR5APTZof99RZ=0_zqTFWLLLzefaTBG94R464wLdVe8Q@mail.gmail.com> <5043B0CB.8040907@gibfest.dk> <20120902193100.GG1266@glenbarber.us> <5043B866.6060204@nexenta.com> <CAJjvXiHHxxYNzYsi%2BA0QQg4T-tZYEivOizKCYxVHC8KAo9wmmg@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On 09/ 4/12 05:25 AM, Matthew Ahrens wrote: > On Sun, Sep 2, 2012 at 12:49 PM, Yuri Pankov<yuri.pankov@nexenta.com> wrote: >> On Sun, 2 Sep 2012 15:31:00 -0400, Glen Barber wrote: >>> On Sun, Sep 02, 2012 at 09:17:31PM +0200, Thomas Steen Rasmussen wrote: >>>>> Hello list, >>>>> >>>>> For some reason it seems like the -r argument to "zfs send" isn't >>>>> implemented in FreeBSD. It is documented in the usage output >>>>> seen below: >>>>> >>>>> >>>>> I had a similar experience with out-of-sync docs and then I think a >>>>> missing mergemaster might have had something to do with it. >>>>> >>>> Hello, >>>> >>>> This is not just the manpage out of sync. Ironically >>>> the zfs tool itself reports the lower-case -r option >>>> in the usage output that it shows me because -r >>>> is an invalid option: >>>> >>>> ------------------------------------------------------------ >>>> $ zfs send -r >>>> invalid option 'r' >>>> usage: >>>> send [-DnPpRrv] [-i snapshot | -I snapshot]<snapshot> >>>> >>> I reported this to Martin a few days ago, but not yet had time myself to >>> check if this is also a bug upstream. >> >> Talking about upstream, looks like -r was added to usage and man page in >> r13524 by Matthew Ahrens (CCed), but the functionality itself is missing. > Indeed. This was a mistake. A long time ago we intended to implement > this flag, but it was never integrated. I think I typo'ed the options > string in the zfs command; and then when writing the manpage I > remembered that long-lost implementation. > > In any case, we should remove the documentation of the "zfs send -r" > flag, as that flag doesn't actually exist. It is implemented (and useful, I used it today!) in Solaris 11. Will it ever follow on to illumos? -- Ian.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?50455DD3.9070808>