Update raw send documentation

This patch simply clarifies some of the limitations related to
raw sends in the man page. No functional changes.

Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Reviewed-by: Jason Cohen <jwittlincohen@gmail.com>
Signed-off-by: Tom Caputi <tcaputi@datto.com>
Closes #8503
Closes #8544

diff --git a/man/man8/zfs.8 b/man/man8/zfs.8
index 52143f7fcb94f5a8f48105874c8eaa95fd3e9d0e..0d6f3731a4189f0b2ea307fbbb51c431995e44bc 100644 (file)
--- a/man/man8/zfs.8
+++ b/man/man8/zfs.8
@@ -3500,7 +3500,11 @@ set when the stream is received.
 If the
 .Fl F
 flag is specified when this stream is received, snapshots and file systems that
-do not exist on the sending side are destroyed.
+do not exist on the sending side are destroyed. If the
+.Fl R
+flag is used to send encrypted datasets, then
+.Fl w
+must also be specified.
 .It Fl e, -embed
 Generate a more compact stream by using
 .Sy WRITE_EMBEDDED
@@ -3573,7 +3577,7 @@ system for incrementals.
 Generate a stream package that includes any snapshot holds (created with the
 .Sy zfs hold
 command), and indicating to
-.Sy zfs receive 
+.Sy zfs receive
 that the holds be applied to the dataset on the receiving system.
 .It Fl i Ar snapshot
 Generate an incremental stream from the first
@@ -3843,7 +3847,13 @@ recompressed by the receive process. Unencrypted streams can be received as
 encrypted datasets, either through inheritance or by specifying encryption
 parameters with the
 .Fl o
-options.
+options. Note that the
+.Sy keylocation
+property cannot be overridden to
+.Sy prompt
+during a receive. This is because the receive process itself is already using
+stdin for the send stream. Instead, the property can be overridden after the
+receive completes.
 .Pp
 The added security provided by raw sends adds some restrictions to the send
 and receive process. ZFS will not allow a mix of raw receives and non-raw
@@ -3930,7 +3940,7 @@ snapshot as described in the paragraph above.
 Discard all but the last element of the sent snapshot's file system name, using
 that element to determine the name of the target file system for the new
 snapshot as described in the paragraph above.
-.It Fl h 
+.It Fl h
 Skip the receive of holds.  There is no effect if holds are not sent.
 .It Fl n
 Do not actually receive the stream.