diff options
| author | Tom Caputi <[email protected]> | 2019-03-29 18:05:55 -0400 |
|---|---|---|
| committer | Brian Behlendorf <[email protected]> | 2019-03-29 15:05:55 -0700 |
| commit | dd29864b01e899cd6af9feebe6f604e43ff1333a (patch) | |
| tree | 26f0f34fdd9eb9e9081b1cc5a01923b36b4ed61e | |
| parent | 1b939560be5c51deecf875af9dada9d094633bf7 (diff) | |
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 <[email protected]>
Reviewed-by: Jason Cohen <[email protected]>
Signed-off-by: Tom Caputi <[email protected]>
Closes #8503
Closes #8544
| -rw-r--r-- | man/man8/zfs.8 | 18 |
1 files changed, 14 insertions, 4 deletions
diff --git a/man/man8/zfs.8 b/man/man8/zfs.8 index 52143f7fc..0d6f3731a 100644 --- 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. |