zfs send -r missing - but documented in zfs(8)
mahrens at delphix.com
Mon Sep 3 17:25:18 UTC 2012
On Sun, Sep 2, 2012 at 12:49 PM, Yuri Pankov <yuri.pankov at 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.
>>> 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'
>>> 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.
More information about the freebsd-fs