Date: Mon, 3 Sep 2012 10:25:17 -0700 From: Matthew Ahrens <mahrens@delphix.com> To: Yuri Pankov <yuri.pankov@nexenta.com> Cc: freebsd-fs <freebsd-fs@freebsd.org>, illumos-zfs <zfs@lists.illumos.org> Subject: Re: zfs send -r missing - but documented in zfs(8) Message-ID: <CAJjvXiHHxxYNzYsi%2BA0QQg4T-tZYEivOizKCYxVHC8KAo9wmmg@mail.gmail.com> In-Reply-To: <5043B866.6060204@nexenta.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>
next in thread | previous in thread | raw e-mail | index | archive | help
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. --matt
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAJjvXiHHxxYNzYsi%2BA0QQg4T-tZYEivOizKCYxVHC8KAo9wmmg>