[zfs] Re: zfs send -r missing - but documented in zfs(8)

[Ian Collins]

On 09/ 4/12 05:25 AM, Matthew Ahrens wrote:
> 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.
>>>>>
>>>> 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.