zstream —
manipulate ZFS send streams
zstream |
dump
[-Cvd
]
[file ] |
zstream |
decompress
[-v
]
[] |
zstream |
token
resume_token |
The
zstream utility manipulates ZFS send streams
output by the
zfs send command.
zstream
dump
[-Cvd
]
[file
]- Print information about the specified send stream, including headers and
record counts. The send stream may either be in the specified
file, or provided on standard input.
-C- Suppress the validation of checksums.
-v- Verbose. Print metadata for each record.
-d- Dump data contained in each record. Implies verbose.
The zstreamdump alias is provided for
compatibility and is equivalent to running
zstream
dump.
zstream
token
resume_token- Dumps zfs resume token information
zstream
decompress
[-v
]
[]- Decompress selected records in a ZFS send stream provided on standard
input, when the compression type recorded in ZFS metadata may be
incorrect. Specify the object number and byte offset of each record that
you wish to decompress. Optionally specify the compression type. Valid
compression types include gzip,
lz4, lzjb,
zstd, and zle.
The default is lz4. Every record for that
object beginning at that offset will be decompressed, if possible. It may
not be possible, because the record may be corrupted in some but not all
of the stream's snapshots. The repaired stream will be written to standard
output.
-v- Verbose. Print summary of decompressed records.
zstream
redup
[-v
]
file- Deduplicated send streams can be generated by using the
zfs
send
-D command. The ability to send
deduplicated send streams is deprecated. In the future, the ability to
receive a deduplicated send stream with
zfs
receive will be removed. However,
deduplicated send streams can still be received by utilizing
zstream
redup.
The zstream
redup command is provided a
file containing a deduplicated send
stream, and outputs an equivalent non-deduplicated send stream on standard
output. Therefore, a deduplicated send stream can be received by running:
#
zstream
redup
DEDUP_STREAM_FILE |
zfs
receive
…
-v- Verbose. Print summary of converted records.
Heal a dataset that was corrupted due to OpenZFS bug #12762. First, determine
which records are corrupt. That cannot be done automatically; it requires
information beyond ZFS's metadata. If object
128
is corrupted at offset
0 and is compressed using
lz4, then run this command:
# zfs send -c … | zstream decompress 128,0,lz4 | zfs recv …
zfs(8),
zfs-receive(8),
zfs-send(8),
https://github.com/openzfs/zfs/issues/12762