diff options
| author | Alan Somers <[email protected]> | 2022-10-14 14:40:00 -0600 |
|---|---|---|
| committer | GitHub <[email protected]> | 2022-10-14 13:40:00 -0700 |
| commit | a1034ee90978042c3c744ef11549cd732dd1dcfd (patch) | |
| tree | d5ddbf3486841c93bce5365fc643a748fca00c1d /man/man8 | |
| parent | 6a42939fcd62533b7675e4c3fce12ded70806583 (diff) | |
zstream: allow decompress to fix metadata for uncompressed records
If a record is uncompressed on-disk but the block pointer insists
otherwise, reading it will return EIO. This commit adds an "off" type
to the "zstream decompress" command. Using it will set the compression
field in a zfs stream to "off" without changing the record's data.
Reviewed-by: Brian Behlendorf <[email protected]>
Reviewed-by: George Melikov <[email protected]>
Signed-off-by: Alan Somers <[email protected]>
Sponsored by: Axcient
Closes #13997
Diffstat (limited to 'man/man8')
| -rw-r--r-- | man/man8/zstream.8 | 8 |
1 files changed, 7 insertions, 1 deletions
diff --git a/man/man8/zstream.8 b/man/man8/zstream.8 index dd5342000..bfe7ac3f6 100644 --- a/man/man8/zstream.8 +++ b/man/man8/zstream.8 @@ -20,7 +20,7 @@ .\" .\" Copyright (c) 2020 by Delphix. All rights reserved. .\" -.Dd March 25, 2022 +.Dd October 4, 2022 .Dt ZSTREAM 8 .Os . @@ -96,6 +96,7 @@ Specify the object number and byte offset of each record that you wish to decompress. Optionally specify the compression type. Valid compression types include +.Sy off , .Sy gzip , .Sy lz4 , .Sy lzjb , @@ -108,6 +109,11 @@ 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. +Specifying a compression type of +.Sy off +will change the stream's metadata accordingly, without attempting decompression. +This can be useful if the record is already uncompressed but the metadata +insists otherwise. The repaired stream will be written to standard output. .Bl -tag -width "-v" .It Fl v |