Bug 215666 - man page zfs(8) confusing for sending a filesystem
Summary: man page zfs(8) confusing for sending a filesystem
Status: New
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: freebsd-bugs (Nobody)
Depends on:
Reported: 2016-12-30 11:45 UTC by joost
Modified: 2018-04-10 19:54 UTC (History)
1 user (show)

See Also:


Note You need to log in before you can comment on or make changes to this bug.
Description joost 2016-12-30 11:45:20 UTC
The man page states:

     zfs send [-eL] [-i snapshot|bookmark] filesystem|volume|snapshot

         Generate a send stream, which may be of a filesystem, and may be
         incremental from a bookmark.  If the destination is a filesystem or
         volume, the pool must be read-only, or the filesystem must not be
         mounted.  When the stream generated from a filesystem or volume is
         received, the default snapshot name will be (--head--).

I believe the destination is always stdout and never a filesystem or volume.
However the source can be a filesystem or a volume and I think it makes sense modifications should not be possible while sending.

IMO the text would be better understood (at least by me) if "destination" is replaced with "source".