zfs 快照发送与接收

      zfs send [-DnPpRveL] [-[iI] snapshot] snapshot

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

       zfs receive | recv [-vnFu] filesystem|volume|snapshot

       zfs receive | recv [-vnFu] [-d|-e] filesystem

       zfs send [-DnPpRveL] [-[iI] snapshot] snapshot

           Creates  a  stream  representation  of the second snapshot, which is written to standard output. The output can be redirected to a file or to a different system (for example, using ssh(1). By default, a
           full stream is generated.

           -i snapshot

               Generate an incremental stream from the first snapshot (the incremental source) to the second snapshot (the incremental target).  The incremental source can be specified as the last component of the
               snapshot name (the @ character and following) and it is assumed to be from the same file system as the incremental target.

               If the destination is a clone, the source may be the origin snapshot, which must be fully specified (for example, pool/fs@origin, not just @origin).

           -I snapshot

               Generate  a  stream package that sends all intermediary snapshots from the first snapshot to the second snapshot. For example, -I @a fs@d is similar to -i @a fs@b; -i @b fs@c; -i @c fs@d. The incre-
               mental source may be specified as with the -i option.

           -R

               Generate a replication stream package, which will replicate the specified filesystem, and all descendent file systems, up to the named snapshot. When received, all properties, snapshots,  descendent
               file systems, and clones are preserved.

               If  the  -i or -I flags are used in conjunction with the -R flag, an incremental replication stream is generated. The current values of properties, and current snapshot and file system names are set
               when the stream is received. If the -F flag is specified when this stream is received, snapshots and file systems that do not exist on the sending side are destroyed.

           -D

               Generate a deduplicated stream. Blocks which would have been sent multiple times in the send stream will only be sent once. The receiving system must also support this feature to receive a  dedupli-
               cated stream.  This flag can be used regardless of the dataset’s dedup  property, but performance will be much better if the filesystem uses a dedup-capable checksum (eg.  sha256).

           -L

               Generate  a  stream which may contain blocks larger than 128KB.  This flag has no effect if the large_blocks pool feature is disabled, or if the recordsize property of this filesystem has never been
               set above 128KB.  The receiving system must have the large_blocks pool feature enabled as well.  See zpool-features(5) for details on ZFS feature flags and the large_blocks feature.

           -e

               Generate a more compact stream by using WRITE_EMBEDDED records for blocks which are stored more compactly on disk by the embedded_data pool feature.  This flag has no  effect  if  the  embedded_data
               feature is disabled.  The receiving system must have the embedded_data feature enabled.  If the lz4_compress feature is active on the sending system, then the receiving system must have that feature
               enabled as well. See zpool-features(5) for details on ZFS feature flags and the embedded_data feature.

           -p

               Include the dataset’s properties in the stream.  This flag is implicit when -R is specified.  The receiving system must also support this feature.

           -n

               Do a dry-run ("No-op") send.  Do not generate any actual send data.  This is useful in conjunction with the -v or -P flags to determine what data will be sent.  In this case, the verbose output will
               be written to standard output (contrast with a non-dry-run, where the stream is written to standard output and the verbose output goes to standard error).

           -P

               Print machine-parsable verbose information about the stream package generated.

           -v


               Print verbose information about the stream package generated.  This information includes a per-second report of how much data has been sent.

           The format of the stream is committed. You will be able to receive your streams on future versions of ZFS.

       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 snapshot|bookmark

               Generate an incremental send stream.  The incremental source must be an earlier snapshot in the destination’s history. It will commonly be an earlier snapshot in  the  destination’s  filesystem,  in
               which case it can be specified as the last component of the name (the # or @ character and following).

               If the incremental target is a clone, the incremental source can be the origin snapshot, or an earlier snapshot in the origin’s filesystem, or the origin’s origin, etc.

           -L

               Generate  a  stream which may contain blocks larger than 128KB.  This flag has no effect if the large_blocks pool feature is disabled, or if the recordsize property of this filesystem has never been
               set above 128KB.  The receiving system must have the large_blocks pool feature enabled as well.  See zpool-features(5) for details on ZFS feature flags and the large_blocks feature.

           -e

               Generate a more compact stream by using WRITE_EMBEDDED records for blocks which are stored more compactly on disk by the embedded_data pool feature.  This flag has no  effect  if  the  embedded_data
               feature is disabled.  The receiving system must have the embedded_data feature enabled.  If the lz4_compress feature is active on the sending system, then the receiving system must have that feature
               enabled as well. See zpool-features(5) for details on ZFS feature flags and the embedded_data feature.

       zfs receive [-vnFu] filesystem|volume|snapshot
       zfs receive [-vnFu] [-d|-e] filesystem

           Creates a snapshot whose contents are as specified in the stream provided on standard input. If a full stream is received, then a new file system is created as well. Streams are created  using  the  zfs
           send subcommand, which by default creates a full stream. zfs recv can be used as an alias for zfs receive.

           If an incremental stream is received, then the destination file system must already exist, and its most recent snapshot must match the incremental stream’s source. For zvols, the destination device link
           is destroyed and recreated, which means the zvol cannot be accessed during the receive operation.

           When a snapshot replication package stream that is generated by using the zfs send -R command is  received, any snapshots that do not exist on the sending location are destroyed by using the zfs destroy
           -d command.

           The name of the snapshot (and file system, if a full stream is received) that this subcommand creates depends on the argument type and the use of the -d or -e options.

           If the argument is a snapshot name, the specified snapshot is created. If the argument is a file system or volume name, a snapshot with the same name as the sent snapshot is created within the specified
           filesystem or volume.  If neither of the -d or -e options are specified, the provided target snapshot name is used exactly as provided.

           The -d and -e options cause the file system name of the target snapshot to be determined by appending a portion of the sent snapshot’s name to the specified target filesystem. If the -d option is speci-
           fied, all but the first element of the sent snapshot’s file system path (usually the pool name) is used and any required intermediate file systems within the specified one are created.  If the -e option
           is specified, then only the last element of the sent snapshot’s file system name (i.e. the name of the source file system itself) is used as the target file system name.

           -d

               Discard the first element of the sent snapshot’s file system name, using the remaining elements to determine the name of the target file system for the new snapshot as  described  in  the  paragraph
               above.

           -e

               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.

           -u

               File system that is associated with the received stream is not mounted.

           -v

               Print verbose information about the stream and the time required to perform the receive operation.

           -n

               Do not actually receive the stream. This can be useful in conjunction with the -v option to verify the name the receive operation would use.

           -F

               Force a rollback of the file system to the most recent snapshot before performing the receive operation. If receiving an incremental replication stream (for example, one generated  by  zfs  send  -R
               -[iI]), destroy snapshots and file systems that do not exist on the sending side.

       Example 12 Remotely Replicating ZFS Data

       The following commands send a full stream and then an incremental stream to a remote machine, restoring them into poolB/received/fs@aand poolB/received/fs@b, respectively. poolB must contain the file system
       poolB/received, and must not initially contain poolB/received/fs.

         # zfs send pool/fs@a | \
            ssh host zfs receive poolB/received/fs@a
         # zfs send -i a pool/fs@b | ssh host \
            zfs receive poolB/received/fs

       Example 13 Using the zfs receive -d Option

       The  following  command  sends  a full stream of poolA/fsA/fsB@snap to a remote machine, receiving it into poolB/received/fsA/fsB@snap. The fsA/fsB@snap portion of the received snapshot’s name is determined
       from the name of the sent snapshot. poolB must contain the file system poolB/received. If poolB/received/fsA does not exist, it is created as an empty file system.

         # zfs send poolA/fsA/fsB@snap | \
            ssh host zfs receive -d poolB/received

       Example 24 Creating a bookmark

       The following example create a bookmark to a snapshot. This bookmark can then be used instead of snapshot in send streams.

         # zfs bookmark rpool@snapshot rpool#bookmark